Κοινή χρήση μέσω

Δημιουργία της πρώτης σας σύνδεσης: Hello World

  • Άρθρο

Αυτό το δείγμα παρέχει μια απλή επέκταση προέλευσης δεδομένων που μπορεί να εκτελεστεί στο Visual Studio Code και να φορτωθεί στο Power BI Desktop.

Δείγμα Hello World

Ως επισκόπηση, αυτό το δείγμα εμφανίζει τα εξής:

  • Συνάρτηση εξαγωγής (HelloWorld.Contents), η οποία λαμβάνει μια παράμετρο κειμένου επιλογής.
  • Ορισμός ενός είδους προέλευσης δεδομένων ως εξής:
    • Δηλώνει ότι χρησιμοποιεί Έμμεσο (ανώνυμο) έλεγχο ταυτότητας.
    • Χρησιμοποιεί πόρους συμβολοσειράς που επιτρέπουν την τοπική προσαρμογή.
    • Δήλωση μετα-δεδομένων περιβάλλοντος εργασίας χρήστη, ώστε η επέκταση να μπορεί να εμφανίζεται στο παράθυρο διαλόγου Λήψη δεδομένων του Power BI Desktop.

Ακολουθώντας τις οδηγίες σχετικά με την εγκατάσταση του PowerQuery SDK, δημιουργήστε μια νέα σύνδεση με το όνομα "HelloWorld", αντιγράψτε τον στον παρακάτω κώδικα M και επικολλήστε τον στο αρχείο HelloWorld.pq του χώρου εργασίας σύνδεσης και, στη συνέχεια, ακολουθήστε τις υπόλοιπες οδηγίες για να μπορείτε να την ανοίξετε στο Power BI.

Στον παρακάτω ορισμό σύνδεσης μπορείτε να βρείτε:

  • Μια section δήλωση.
  • Μια συνάρτηση προέλευσης δεδομένων με μετα-δεδομένα που την καθιερώνει ως ορισμό προέλευσης δεδομένων με τις συναρτήσεις Kind HelloWorld και Publish HelloWorld.Publish.
  • Μια Authentication εγγραφή που δηλώνει ότι έμμεσα (ανώνυμα) είναι ο μόνος τύπος ελέγχου ταυτότητας για αυτήν την προέλευση.
  • Μια εγγραφή δημοσίευσης που δηλώνει ότι αυτή η σύνδεση βρίσκεται στη Beta, το κείμενο που θα φορτωθεί από το αρχείο resx, την εικόνα προέλευσης και την εικόνα τύπου προέλευσης.
  • Μια εγγραφή που συσχετίζει μεγέθη εικονιδίων με συγκεκριμένα PNGs στον φάκελο δόμησης.
section HelloWorld;
 
[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;
 
HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];
 
HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];
 
HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Αφού δημιουργήσετε το αρχείο και το αντιγράψετε στον σωστό κατάλογο, ακολουθώντας τις οδηγίες στην εκμάθηση εγκατάστασης του PowerQuery SDK , ανοίξτε το Power BI. Μπορείτε να αναζητήσετε "hello" για να βρείτε τη σύνδεσή σας στο παράθυρο διαλόγου Λήψη δεδομένων .

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

Πατήστε Σύνδεση και το παράθυρο διαλόγου σάς ενημερώνει ότι πρόκειται για "σύνδεση προεπισκόπησης", επειδή Beta έχει οριστεί σε true στο ερώτημα. Δεδομένου ότι δεν υπάρχει έλεγχος ταυτότητας, η οθόνη ελέγχου ταυτότητας εμφανίζει μια καρτέλα για ανώνυμο έλεγχο ταυτότητας χωρίς πεδία. Πατήστε Σύνδεση ξανά για να τελειώσετε.

Τέλος, το πρόγραμμα επεξεργασίας ερωτημάτων εμφανίζει αυτό που περιμένετε, μια συνάρτηση που επιστρέφει το κείμενο "Hello world".

Για το πλήρως υλοποιημένο δείγμα, ανατρέξτε στο δείγμα Hello World στο δείγμα αποθετηρίου δεδομένων Σύνδεση ors.