Εκμάθηση: Ανάπτυξη απεικόνισης κάρτας κύκλου Power BI

Σε αυτή την εκμάθηση, θα αναπτύξετε μια απεικόνιση Power BI που ονομάζεται κάρτα κύκλου, η οποία εμφανίζει μια μορφοποιημένη τιμή μέτρησης μέσα σε έναν κύκλο. Η απεικόνιση κάρτας κύκλου υποστηρίζει την προσαρμογή του χρώματος γεμίσματος και του πάχους του περιγράμματος.

Σε αυτό το εκπαιδευτικό βοήθημα, θα μάθετε πώς μπορείτε να κάνετε τα εξής:

  • Δημιουργήστε ένα έργο ανάπτυξης για την απεικόνισή σας.
  • Αναπτύξτε την απεικόνισή σας με στοιχεία απεικόνισης D3.
  • Ρυθμίστε τις παραμέτρους της απεικόνισης για την επεξεργασία δεδομένων.
  • Ρυθμίστε τις παραμέτρους της απεικόνισης για προσαρμογή στις αλλαγές μεγέθους.
  • Ρυθμίστε τις παραμέτρους προσαρμόσιμου χρώματος και περιγράμματος για την απεικόνισή σας.

Σημείωμα

Για τον πλήρη πηγαίο κώδικα αυτής της απεικόνισης, ανατρέξτε στο θέμα Απεικόνιση Power BI κάρτας κύκλου.

Προαπαιτούμενα στοιχεία

Προτού ξεκινήσετε την ανάπτυξη της απεικόνισης Power BI, επαληθεύστε ότι έχετε όλα τα στοιχεία που παρατίθενται σε αυτήν την ενότητα.

Δημιουργία έργου ανάπτυξης

Σε αυτή την ενότητα, θα δημιουργήσετε ένα έργο για την απεικόνιση κάρτας κύκλου.

Σημείωμα

Σε αυτή την εκμάθηση, ο Κώδικας Visual Studio (VS Code) χρησιμοποιείται για την ανάπτυξη της απεικόνισης Power BI.

  1. Ανοίξτε ένα νέο τερματικό στο VS Code και μεταβείτε στον φάκελο στον οποίο θέλετε να δημιουργήσετε το έργο σας.

  2. Εισαγάγετε την ακόλουθη εντολή στο τερματικό PowerShell:

    pbiviz new CircleCard
    
  3. Ανοίξτε τον φάκελο CircleCard στην εξερεύνηση του VS Code . (Αρχείο>Άνοιγμα φακέλου).

    Screenshot of VS code window opened to the circle card folder.

    Για μια λεπτομερή επεξήγηση της λειτουργίας καθενός εκ των αρχείων αυτών, ανατρέξτε στο θέμα Δομή έργου απεικόνισης Power BI.

  4. Ελέγξτε το παράθυρο του τερματικού και επιβεβαιώστε ότι βρίσκεστε στον κατάλογο circleCard. Εγκαταστήστε τις εξαρτήσεις εργαλείων απεικονίσεων του Power BI.

    npm install
    

    Φιλοδώρημα

    Για να δείτε ποιες εξαρτήσεις έχουν εγκατασταθεί στην απεικόνισή σας, ελέγξτε το αρχείο package.json .

  5. Ξεκινήστε την απεικόνιση κάρτας κύκλου.

    pbiviz start
    

    Η απεικόνισή σας πλέον εκτελείται ενώ φιλοξενείται στον υπολογιστή σας.

    Σημαντικό

    Μην κλείνετε το παράθυρο του PowerShell μέχρι το τέλος της εκμάθησης. Για να διακόψετε την εκτέλεση της απεικόνισης, πληκτρολογήστε Ctrl+C και, εάν σας ζητηθεί, για να τερματίσετε τη μαζική εργασία, πληκτρολογήστε Y και, στη συνέχεια, Enter.

Προβολή της απεικόνισης στο Υπηρεσία Power BI

Για να δοκιμάσουμε την απεικόνιση σε Υπηρεσία Power BI, θα χρησιμοποιήσουμε την αναφορά Ανάλυση πωλήσεων στις Η.Π.Α. Μπορείτε να κάνετε λήψη αυτής της αναφοράς και να την αποστείλετε στη Υπηρεσία Power BI.

Μπορείτε επίσης να χρησιμοποιήσετε τη δική σας αναφορά για να ελέγξετε την απεικόνιση.

Σημείωμα

Προτού συνεχίσετε, επαληθεύστε ότι ενεργοποιήσατε τις ρυθμίσεις προγραμματιστή απεικονίσεων.

  1. Εισέλθετε για να PowerBI.com και να ανοίξετε την αναφορά Ανάλυση πωλήσεων στις Η.Π.Α.

  2. Επιλέξτε Επεξεργασία.

    Screenshot of the edit option in Power B I service.

  3. Δημιουργήστε μια νέα σελίδα για δοκιμή, κάνοντας κλικ στο κουμπί Νέα σελίδα στο κάτω μέρος του περιβάλλοντος εργασίας Υπηρεσία Power BI.

    Screenshot of the new page button in Power B I service.

  4. Από το τμήμα παραθύρου Απεικονίσεις , επιλέξτε Απεικόνιση προγραμματιστή.

    Screenshot of the developer visual in the visualizations pane.

    Αυτή η απεικόνιση αντιπροσωπεύει την προσαρμοσμένη απεικόνιση που εκτελείτε στον υπολογιστή σας. Είναι διαθέσιμη μόνο όταν είναι ενεργοποιημένη η ρύθμιση εντοπισμού σφαλμάτων προσαρμοσμένης απεικόνισης .

  5. Επαληθεύστε ότι προστέθηκε μια απεικόνιση στον καμβά αναφορών.

    Screenshot of the new visual added to the report.

    Αυτή είναι μια απλή απεικόνιση που εμφανίζει πόσες φορές έγινε κλήση της μεθόδου ενημέρωσης. Σε αυτό το στάδιο, η απεικόνιση δεν ανακτά δεδομένα.

    Σημείωμα

    Εάν η απεικόνιση εμφανίσει ένα μήνυμα σφάλματος σύνδεσης, ανοίξτε μια νέα καρτέλα στο πρόγραμμα περιήγησής σας, μεταβείτε στο https://localhost:8080/assetsκαι εξουσιοδοτήστε το πρόγραμμα περιήγησής σας να χρησιμοποιήσει αυτή τη διεύθυνση.

    Screenshot of the new visual displaying a connection error.

  6. Ενώ είναι επιλεγμένη η νέα απεικόνιση, μεταβείτε στο τμήμα παραθύρου Πεδία , αναπτύξτε το στοιχείο Πωλήσεις και επιλέξτε Ποσότητα.

    Screenshot of the Power B I service quantity field in the sales table in the U S sales analysis report.

  7. Για να ελέγξετε τον τρόπο απόκρισης της απεικόνισης, αλλάξτε το μέγεθος της και παρατηρήστε ότι η τιμή Πλήθος ενημερώσεων αυξάνεται κάθε φορά που αλλάζετε το μέγεθος της απεικόνισης.

    Screenshot of the new visual displaying a different update count number, after being resized.

Προσθήκη στοιχείων απεικόνισης και κειμένου

Σε αυτή την ενότητα, θα μάθετε πώς μπορείτε να μετατρέψετε την απεικόνιση σε κύκλο και να την εμφανίσετε σε κείμενο.

Τροποποίηση του αρχείου απεικονίσεων

Ρυθμίστε το αρχείο visual.ts .

Φιλοδώρημα

Για τη βελτίωση της αναγνωσιμότητας, συνιστάται να μορφοποιήσετε το έγγραφο κάθε φορά που αντιγράφετε τμήματα κώδικα στο έργο σας. Κάντε δεξί κλικ σε οποιοδήποτε σημείο του κώδικα VS και επιλέξτε Μορφοποίηση εγγράφου (ή πληκτρολογήστε Alt+Shift+F).

  1. Στο VS Code, στο τμήμα παραθύρου Explorer, αναπτύξτε τον φάκελο src και επιλέξτε το αρχείο visual.ts.

    Screenshot of accessing the visual.ts file in V S code.

  2. Καταργήστε όλο τον κώδικα κάτω από το σχόλιο άδειας χρήσης MIT.

    Σημαντικό

    Παρατηρήστε τα σχόλια στο επάνω μέρος του αρχείου visual.ts . Το δικαίωμα χρήσης των πακέτων απεικονίσεων Power BI παρέχεται δωρεάν σύμφωνα με τους όρους της άδειας χρήσης Ινστιτούτου Τεχνολογίας της Μασαχουσέτης (MIT). Ως μέρος της σύμβασης, πρέπει να αφήσετε τα σχόλια στο επάνω μέρος του αρχείου.

  3. Εισαγάγετε τις απαραίτητες βιβλιοθήκες και λειτουργικές μονάδες και ορίστε την επιλογή τύπου για τη βιβλιοθήκη d3:

    "use strict";
    
    import "./../style/visual.less";
    import powerbi from "powerbi-visuals-api";
    import VisualConstructorOptions = powerbi.extensibility.visual.VisualConstructorOptions;
    import VisualUpdateOptions = powerbi.extensibility.visual.VisualUpdateOptions;
    import IVisual = powerbi.extensibility.visual.IVisual;
    import DataView = powerbi.DataView;
    import IVisualHost = powerbi.extensibility.IVisualHost;
    import * as d3 from "d3";
    type Selection<T extends d3.BaseType> = d3.Selection<T, any, any, any>;
    

    Σημείωμα

    Εάν η βιβλιοθήκη D3 JavaScript δεν έχει εγκατασταθεί ως μέρος της εγκατάστασής σας, εγκαταστήστε την τώρα. Από το PowerShell, εκτελέστε npm i d3@latest --save

    Παρατηρήστε ότι μεταξύ των στοιχείων που εισαγάγατε είναι τα εξής:

    • IVisualHost - Μια συλλογή ιδιοτήτων και υπηρεσιών που χρησιμοποιούνται για αλληλεπίδραση με τον κεντρικό υπολογιστή απεικόνισης (Power BI).
    • Βιβλιοθήκη D3 - Βιβλιοθήκη JavaScript για τη δημιουργία εγγράφων που βασίζονται σε δεδομένα.
  4. Κάτω από τις εισαγωγές, δημιουργήστε μια κενή κλάση απεικόνισης . Η κλάση απεικόνισης υλοποιεί τη διασύνδεση IVisual, όπου ξεκινούν όλες οι απεικονίσεις:

    export class Visual implements IVisual {
    
    }
    

    Για πληροφορίες σχετικά με το τι γίνεται στην κλάση απεικόνισης, ανατρέξτε στο θέμα API απεικόνισης. Στα επόμενα τρία βήματα, ορίζουμε αυτή την κλάση.

  5. Προσθέστε ιδιωτικές μεθόδους σε επίπεδο κλάσης στην αρχή της κλάσης απεικόνισης:

    private host: IVisualHost;
    private svg: Selection<SVGElement>;
    private container: Selection<SVGElement>;
    private circle: Selection<SVGElement>;
    private textValue: Selection<SVGElement>;
    private textLabel: Selection<SVGElement>;
    

    Παρατηρήστε ότι ορισμένες από αυτές τις ιδιωτικές μεθόδους χρησιμοποιούν τον τύπο Επιλογή.

  6. Καθορίστε τον κύκλο και τα στοιχεία κειμένου στη μέθοδο κατασκευής . Αυτή η μέθοδος καλείται όταν δημιουργηθεί η απεικόνιση. Τα διανυσματικά γραφικά με δυνατότητα κλιμάκωσης D3 (SVG) επιτρέπουν τη δημιουργία τριών σχημάτων: ενός κύκλου και δύο στοιχείων κειμένου:

    constructor(options: VisualConstructorOptions) {
        this.svg = d3.select(options.element)
            .append('svg')
            .classed('circleCard', true);
        this.container = this.svg.append("g")
            .classed('container', true);
        this.circle = this.container.append("circle")
            .classed('circle', true);
        this.textValue = this.container.append("text")
            .classed("textValue", true);
        this.textLabel = this.container.append("text")
            .classed("textLabel", true);
    }
    
  7. Καθορίστε το πλάτος και ύψος στη μέθοδο ενημέρωσης. Αυτή η μέθοδος καλείται κάθε φορά που υπάρχει μια αλλαγή στο περιβάλλον δεδομένων ή κεντρικού υπολογιστή, όπως μια νέα τιμή ή αλλαγή μεγέθους.

    public update(options: VisualUpdateOptions) {
        let width: number = options.viewport.width;
        let height: number = options.viewport.height;
        this.svg.attr("width", width);
        this.svg.attr("height", height);
        let radius: number = Math.min(width, height) / 2.2;
        this.circle
            .style("fill", "white")
            .style("fill-opacity", 0.5)
            .style("stroke", "black")
            .style("stroke-width", 2)
            .attr("r", radius)
            .attr("cx", width / 2)
            .attr("cy", height / 2);
        let fontSizeValue: number = Math.min(width, height) / 5;
        this.textValue
            .text("Value")
            .attr("x", "50%")
            .attr("y", "50%")
            .attr("dy", "0.35em")
            .attr("text-anchor", "middle")
            .style("font-size", fontSizeValue + "px");
        let fontSizeLabel: number = fontSizeValue / 4;
        this.textLabel
            .text("Label")
            .attr("x", "50%")
            .attr("y", height / 2)
            .attr("dy", fontSizeValue / 1.2)
            .attr("text-anchor", "middle")
            .style("font-size", fontSizeLabel + "px");
    }
    
  8. Αποθηκεύστε το αρχείο visual.ts .

(Προαιρετικό) Εξέταση του κώδικα στο αρχείο απεικονίσεων

Επαληθεύστε ότι ο τελικός κώδικας στο αρχείο visual.ts μοιάζει κάπως έτσι:

/*
*  Power BI Visual CLI
*
*  Copyright (c) Microsoft Corporation
*  All rights reserved.
*  MIT License
*
*  Permission is hereby granted, free of charge, to any person obtaining a copy
*  of this software and associated documentation files (the ""Software""), to deal
*  in the Software without restriction, including without limitation the rights
*  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
*  copies of the Software, and to permit persons to whom the Software is
*  furnished to do so, subject to the following conditions:
*
*  The above copyright notice and this permission notice shall be included in
*  all copies or substantial portions of the Software.
*
*  THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
*  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
*  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
*  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
*  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
*  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
*  THE SOFTWARE.
*/
"use strict";

import "./../style/visual.less";
import powerbi from "powerbi-visuals-api";
import VisualConstructorOptions = powerbi.extensibility.visual.VisualConstructorOptions;
import VisualUpdateOptions = powerbi.extensibility.visual.VisualUpdateOptions;
import IVisual = powerbi.extensibility.visual.IVisual;
import DataView = powerbi.DataView;
import IVisualHost = powerbi.extensibility.IVisualHost;
import * as d3 from "d3";
type Selection<T extends d3.BaseType> = d3.Selection<T, any, any, any>;

export class Visual implements IVisual {
    private host: IVisualHost;
    private svg: Selection<SVGElement>;
    private container: Selection<SVGElement>;
    private circle: Selection<SVGElement>;
    private textValue: Selection<SVGElement>;
    private textLabel: Selection<SVGElement>;
    
    constructor(options: VisualConstructorOptions) {
        this.svg = d3.select(options.element)
            .append('svg')
            .classed('circleCard', true);
        this.container = this.svg.append("g")
            .classed('container', true);
        this.circle = this.container.append("circle")
            .classed('circle', true);
        this.textValue = this.container.append("text")
            .classed("textValue", true);
        this.textLabel = this.container.append("text")
            .classed("textLabel", true);
    }
    
    public update(options: VisualUpdateOptions) {
        let width: number = options.viewport.width;
        let height: number = options.viewport.height;
        this.svg.attr("width", width);
        this.svg.attr("height", height);
        let radius: number = Math.min(width, height) / 2.2;
        this.circle
            .style("fill", "white")
            .style("fill-opacity", 0.5)
            .style("stroke", "black")
            .style("stroke-width", 2)
            .attr("r", radius)
            .attr("cx", width / 2)
            .attr("cy", height / 2);
        let fontSizeValue: number = Math.min(width, height) / 5;
        this.textValue
            .text("Value")
            .attr("x", "50%")
            .attr("y", "50%")
            .attr("dy", "0.35em")
            .attr("text-anchor", "middle")
            .style("font-size", fontSizeValue + "px");
        let fontSizeLabel: number = fontSizeValue / 4;
        this.textLabel
            .text("Label")
            .attr("x", "50%")
            .attr("y", height / 2)
            .attr("dy", fontSizeValue / 1.2)
            .attr("text-anchor", "middle")
            .style("font-size", fontSizeLabel + "px");
    }
}

Τροποποίηση του αρχείου δυνατοτήτων

Η απεικόνιση κάρτας κύκλου είναι μια απλή απεικόνιση που δεν δημιουργεί αντικείμενα στο τμήμα παραθύρου Μορφοποίηση. Επομένως, μπορείτε να καταργήσετε με ασφάλεια την ενότητα αντικειμένων του αρχείου.

  1. Ανοίξτε το έργο σας στο VS Code (Αρχείο>Άνοιγμα φακέλου).

  2. Επιλέξτε το αρχείο capabilities.json .

    Screenshot of accessing the capabilities.json file in V S code.

  3. Καταργήστε ολόκληρο τον πίνακα αντικειμένων .
    Μην αφήνετε κενές γραμμές μεταξύ των dataRoles και dataViewMappings.

  4. Αποθηκεύστε το αρχείο capabilities.json .

Επανεκκίνηση της απεικόνισης κάρτας κύκλου

Διακόψτε την εκτέλεση της απεικόνισης και επανεκκινήστε την.

  1. Στο παράθυρο του PowerShell όπου ξεκινήσατε την απεικόνιση, πληκτρολογήστε Ctrl+C. Εάν σας ζητηθεί να τερματίσετε την εργασία δέσμης, πληκτρολογήστε Y και, στη συνέχεια, Enter.

  2. Στο PowerShell, ξεκινήστε ξανά την απεικόνιση.

    pbiviz start
    

Δοκιμή της απεικόνισης με τα στοιχεία που προστέθηκαν

Επαληθεύστε ότι η απεικόνιση εμφανίζει τα στοιχεία που προστέθηκαν πρόσφατα.

  1. Σε Υπηρεσία Power BI, ανοίξτε την αναφορά Ανάλυση πωλήσεων στις Η.Π.Α. του Power BI. Εάν χρησιμοποιείτε διαφορετική αναφορά για να αναπτύξετε την απεικόνιση κάρτας κύκλου, μεταβείτε σε αυτήν την αναφορά.

  2. Σύρετε μια τιμή στο πλαίσιο Μέτρηση και βεβαιωθείτε ότι η απεικόνιση έχει σχήμα κύκλου.

    Screenshot of the circle card visual shaped as a circle.

    Εάν η απεικόνιση δεν εμφανίζει τίποτα, από το τμήμα παραθύρου Πεδία , σύρετε το πεδίο Ποσότητα στην απεικόνιση προγραμματιστή.

  3. Αλλάξτε το μέγεθος της απεικόνισης.

    Παρατηρήστε ότι ο κύκλος και το κείμενο αλλάζουν κλίμακα για να χωρέσουν στις διαστάσεις της απεικόνισης. Η μέθοδος ενημέρωσης καλείται όταν αλλάζετε το μέγεθος της απεικόνισης και, ως αποτέλεσμα, τα στοιχεία της απεικόνισης αλλάζουν κλίμακα.

Ενεργοποίηση αυτόματης επαναφόρτωσης

Χρησιμοποιήστε αυτήν τη ρύθμιση για να εξασφαλίσετε ότι η απεικόνιση επαναφορτώνεται αυτόματα κάθε φορά που αποθηκεύετε αλλαγές στο έργο.

  1. Μεταβείτε στην αναφορά Ανάλυση πωλήσεων Power BI στις Η.Π.Α. (ή στο έργο που διαθέτει την απεικόνιση κάρτας κύκλου).

  2. Επιλέξτε την απεικόνιση κάρτας κύκλου.

  3. Στην κινητή γραμμή εργαλείων, επιλέξτε Εναλλαγή της αυτόματης επαναφόρτωσης.

    Screenshot of clicking the toggle auto reload option, in the circle card visual floating toolbar.

Λήψη της απεικόνισης για επεξεργασία δεδομένων

Σε αυτή την ενότητα, ορίζετε ρόλους δεδομένων και αντιστοιχίσεις προβολής δεδομένων. Τροποποιείτε επίσης την απεικόνιση για να εμφανίσετε το όνομα της τιμής που εμφανίζει.

Ρύθμιση παραμέτρων του αρχείου δυνατοτήτων

Τροποποιήστε το αρχείο capabilities.json για να ορίσετε τον ρόλο δεδομένων, τα αντικείμενα και τις αντιστοιχίσεις προβολής δεδομένων.

  • Ορισμός του ρόλου δεδομένων

    Καθορίστε τον πίνακα dataRoles με έναν μοναδικό ρόλο δεδομένων του τύπου μέτρηση. Αυτός ο ρόλος δεδομένων ονομάζεται μέτρηση και εμφανίζεται ως Μέτρηση. Επιτρέπει τη μεταβίβαση είτε ενός πεδίου μέτρησης είτε ενός πεδίου που συνοψίζεται.

    1. Ανοίξτε το αρχείο capabilities.json σε κώδικα VS.

    2. Καταργήστε όλο το περιεχόμενο στον πίνακα dataRoles .

    3. Εισαγάγετε τον ακόλουθο κώδικα στον πίνακα dataRoles .

      {
          "displayName": "Measure",
          "name": "measure",
          "kind": "Measure"
      }
      
    4. Αποθηκεύστε το αρχείο capabilities.json .

  • Ορισμός της αντιστοίχισης προβολής δεδομένων

    Καθορίστε ένα πεδίο με την ονομασία μέτρηση στον πίνακα dataViewMappings . Αυτό το πεδίο μπορεί να διαβιβαστεί στον ρόλο δεδομένων.

    1. Ανοίξτε το αρχείο capabilities.json σε κώδικα VS.

    2. Καταργήστε όλο το περιεχόμενο στον πίνακα dataViewMappings .

    3. Εισαγάγετε τον ακόλουθο κώδικα στον πίνακα dataViewMappings .

      {
          "conditions": [
              { "measure": { "max": 1 } }
          ],
          "single": {
              "role": "measure"
          }
      }
      
    4. Αποθηκεύστε το αρχείο capabilities.json .

Επιβεβαιώστε ότι το αρχείο capabilities.json μοιάζει κάπως έτσι:

{
    "dataRoles": [
        {
            "displayName": "Measure",
            "name": "measure",
            "kind": "Measure"
        }
    ],
    "dataViewMappings": [
        {
            "conditions": [
                { "measure": { "max": 1 } }
            ],
            "single": {
                "role": "measure"
            }
        }
    ],
    "privileges": []
}

(Προαιρετικό) Έλεγχος των αλλαγών του κώδικα αρχείου δυνατοτήτων

Επαληθεύστε ότι η απεικόνιση κάρτας κύκλου εμφανίζει το πεδίο μέτρησης και εξετάστε τις αλλαγές που κάνατε χρησιμοποιώντας την επιλογή Εμφάνιση προβολής δεδομένων.

  1. Σε Υπηρεσία Power BI, ανοίξτε την αναφορά Ανάλυση πωλήσεων στις Η.Π.Α. του Power BI. Εάν χρησιμοποιείτε διαφορετική αναφορά για να αναπτύξετε την απεικόνιση κάρτας κύκλου, μεταβείτε σε αυτήν την αναφορά.

  2. Παρατηρήστε ότι η απεικόνιση κάρτας κύκλου μπορεί πλέον να ρυθμιστεί με ένα πεδίο με τίτλο Μέτρηση. Μπορείτε να σύρετε και αποθέσετε στοιχεία από το τμήμα παραθύρου Πεδία στο πεδίο Μέτρηση .

    Screenshot of the circle card measure filed, in the Power BI service visualization pane.

    Σημείωμα

    Το έργο απεικόνισης δεν περιλαμβάνει ακόμα λογική σύνδεσης δεδομένων.

  3. Στην κινητή γραμμή εργαλείων, επιλέξτε Εμφάνιση προβολής δεδομένων.

    Screenshot of the show dataview button, located in the circle card floating toolbar.

  4. Επιλέξτε τις τρεις τελείες για να αναπτύξετε την οθόνη και επιλέξτε μονή για να προβάλετε την τιμή.

    Screenshot of the value figure as it's displayed in the circle card show dataview option.

  5. Αναπτύξτε τα μετα-δεδομένα και, στη συνέχεια, τον πίνακα στήλες και εξετάστε τις τιμές format και displayName .

    Screenshot of the format and display name values as displayed in the circle card show dataview option.

  6. Για να επιστρέψετε στην απεικόνιση, στη γραμμή εργαλείων που βρίσκεται πάνω από την απεικόνιση, επιλέξτε Εμφάνιση προβολής δεδομένων.

Ρύθμιση παραμέτρων της απεικόνισης για κατανάλωση δεδομένων

Μέχρι στιγμής, η απεικόνιση αποδίδεται, αλλά δεν εμφανίζει δεδομένα. Σε αυτή την ενότητα, κάνετε αλλαγές στο αρχείο visual.ts , έτσι ώστε η απεικόνιση κάρτας κύκλου να μπορεί να καταναλώσει δεδομένα.

  1. Ανοίξτε το αρχείο visual.ts σε κώδικα VS.

  2. Στη μέθοδο ενημέρωσης:

    • Προσθέστε την ακόλουθη πρόταση ως την πρώτη πρόταση. Η πρόταση αντιστοιχίζει το dataView σε μια μεταβλητή για εύκολη πρόσβαση και δηλώνει τη μεταβλητή έτσι ώστε να αναφέρεται στο αντικείμενο dataView .

      let dataView: DataView = options.dataViews[0];
      
    • Αντικαταστήστε το .text("Value") με αυτήν τη γραμμή κώδικα:

      .text(<string>dataView.single.value)
      
    • Αντικαταστήστε το .text("Label") με αυτή τη γραμμή κώδικα:

      .text(dataView.metadata.columns[0].displayName)
      
  3. Αποθηκεύστε το αρχείο visual.ts .

  4. Εξετάστε την απεικόνιση στην Υπηρεσία Power BI.

Η απεικόνιση εμφανίζει τώρα το όνομα και την τιμή του επιλεγμένου πεδίου δεδομένων.

Screenshot of a circle card visual displaying the quantity value.

Δημιουργήσατε τώρα μια λειτουργική απεικόνιση Power BI. Μπορείτε να προσθέσετε επιλογές μορφοποίησης σε αυτό ή μπορείτε να το συσκευάσετε όπως προορίζεται για άμεση χρήση.