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

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

Δείγμα Hello World

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

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

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

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

• Μια section δήλωση.
• Μια συνάρτηση πηγής δεδομένων με μεταδεδομένα που την καθιερώνει ως ορισμό πηγής δεδομένων με το Είδος HelloWorld και δημοσίευση HelloWorld.Publish.
• Μια Authentication εγγραφή που δηλώνει ότι ο έμμεσος (ανώνυμος) είναι ο μόνος τύπος ελέγχου ταυτότητας για αυτήν την προέλευση.
• Μια καρτέλα δημοσίευσης που δηλώνει ότι αυτή η σύνδεση είναι σε έκδοση Beta, το κείμενο που θα φορτωθεί από το αρχείο resx, την εικόνα προέλευσης και την εικόνα τύπου προέλευσης.
• Μια εγγραφή που συσχετίζει μεγέθη εικονιδίων με συγκεκριμένα PNG στο φάκελο κατασκευής.

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 στο ερώτημα. Δεδομένου ότι δεν υπάρχει έλεγχος ταυτότητας, η οθόνη ελέγχου ταυτότητας εμφανίζει μια καρτέλα για ανώνυμο έλεγχο ταυτότητας χωρίς πεδία. Πατήστε ξανά Connect για να ολοκληρώσετε.

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

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