Δημιουργία αναφορών Power BI με δεδομένα NowMetrix

Η σύνδεση περιλαμβάνει δύο προαιρετικά στάδια:

NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service

• Το Power BI Desktop δημιουργεί το ερώτημα, το μοντέλο δεδομένων και την αναφορά.
• Το Power BI Service δημοσιεύει την αναφορά για πρόσβαση από το πρόγραμμα περιήγησης, κοινή χρήση και προγραμματισμένη ανανέωση.

Το έτοιμο παράδειγμα εισάγει τις τελευταίες 30 διαθέσιμες ημερήσιες εγγραφές από το /v1/overview. Κάθε εγγραφή περιλαμβάνει την ημερομηνία, το tracker, τη ζώνη ώρας του tracker, τις Προβολές σελίδας και τις επισκέψεις.

Χρειάζεστε:

• λογαριασμό NowMetrix με πρόσβαση στο REST API,
• πρόσβαση στο tracker για το οποίο θέλετε να δημιουργήσετε αναφορά,
• Microsoft Power BI Desktop για τη δημιουργία της αναφοράς και
• κατάλληλο λογαριασμό Power BI και χώρο εργασίας, εάν θέλετε να δημοσιεύσετε την αναφορά ή να προγραμματίσετε ανανεώσεις.

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

1. Συνδεθείτε στο NowMetrix.
2. Ανοίξτε τις Ρυθμίσεις → API.
3. Δημιουργήστε νέο κλειδί με την ετικέτα Microsoft Power BI.
4. Αντιγράψτε αμέσως ολόκληρο το κλειδί. Εμφανίζεται μόνο μία φορά.
5. Σημειώστε το αναγνωριστικό του tracker για τον ιστότοπο που θέλετε να εισαγάγετε.

1. Ανοίξτε το Power BI Desktop και δημιουργήστε μια κενή αναφορά.
2. Επιλέξτε Κεντρική → Λήψη δεδομένων → Κενό ερώτημα. Εάν δεν εμφανίζεται στη λίστα, επιλέξτε Λήψη δεδομένων → Περισσότερα και αναζητήστε το Κενό ερώτημα.
3. Ανοίγει το Power Query Editor με ένα νέο ερώτημα.
4. Επιλέξτε Κεντρική → Επεξεργαστής για προχωρημένους.

Μην επιλέξετε τον βασικό διάλογο Web για αυτό το παράδειγμα. Χρησιμοποιείται ο Advanced Editor, επειδή το NowMetrix απαιτεί κεφαλίδα εξουσιοδότησης Bearer και η απόκριση πρέπει να μετατραπεί από JSON σε γραμμές πίνακα.

1. Αφαιρέστε το υπάρχον περιεχόμενο από τον Advanced Editor.
2. Επικολλήστε ολόκληρο το παρακάτω ερώτημα.
3. Αντικαταστήστε τα nm_YOUR_KEY και TRACKER_ID στις δύο πρώτες γραμμές.
4. Διατηρήστε και τις δύο τιμές μέσα σε εισαγωγικά.
5. Επιλέξτε Done.

let
    ApiKey = "nm_YOUR_KEY",
    TrackerId = "TRACKER_ID",

    Response = Json.Document(
        Web.Contents(
            "https://api.nowmetrix.com",
            [
                RelativePath = "v1/overview",
                Query = [
                    site = TrackerId,
                    days = "30"
                ],
                Headers = [
                    Authorization = "Bearer " & ApiKey,
                    Accept = "application/json"
                ],
                Timeout = #duration(0, 0, 0, 30)
            ]
        )
    ),

    DailyRows = if List.IsEmpty(Response[daily]) then
        #table(type table [date = text, pageviews = Int64.Type, visits = Int64.Type], {})
    else
        Table.FromRecords(Response[daily]),

    AddTracker = Table.AddColumn(
        DailyRows,
        "tracker",
        each Response[site],
        type text
    ),
    AddTimezone = Table.AddColumn(
        AddTracker,
        "timezone",
        each Response[timezone],
        type text
    ),
    ReorderedColumns = Table.ReorderColumns(
        AddTimezone,
        {"date", "tracker", "timezone", "pageviews", "visits"}
    ),
    TypedColumns = Table.TransformColumnTypes(
        ReorderedColumns,
        {
            {"date", type date},
            {"tracker", type text},
            {"timezone", type text},
            {"pageviews", Int64.Type},
            {"visits", Int64.Type}
        }
    )
in
    TypedColumns

Το ερώτημα χρησιμοποιεί μια σταθερή βασική διεύθυνση URL μαζί με τα RelativePath και Query. Έτσι η πηγή παραμένει προβλέψιμη στις επόμενες ανανεώσεις και το κλειδί API αποστέλλεται μόνο στην κεφαλίδα HTTPS Authorization.

Το Power BI ενδέχεται να σας ρωτήσει πώς θα συνδεθεί στο https://api.nowmetrix.com.

1. Επιλέξτε Ανώνυμη.
2. Εφαρμόστε τη ρύθμιση στο https://api.nowmetrix.com.
3. Επιλέξτε Connect.
4. Εάν σας ζητηθεί επίπεδο προστασίας προσωπικών δεδομένων, επιλέξτε το επίπεδο που απαιτεί ο οργανισμός σας. Το Private παρέχει τον αυστηρότερο διαχωρισμό από άλλες πηγές δεδομένων.

1. Περιμένετε έως ότου η προεπισκόπηση του ερωτήματος εμφανίσει τα date, tracker, timezone, pageviews και visits.
2. Μετονομάστε το ερώτημα σε NowMetrix Daily.
3. Επιλέξτε Κεντρική → Κλείσιμο και εφαρμογή.
4. Ανοίξτε την προβολή Data και επιβεβαιώστε ότι οι γραμμές και οι τύποι στηλών είναι σωστοί.

Μια απλή αναφορά επιβεβαιώνει ότι τα εισαγόμενα πεδία λειτουργούν σωστά:

1. Επιστρέψτε στην προβολή Report.
2. Προσθέστε ένα Γράφημα γραμμών.
3. Τοποθετήστε το date στον άξονα X.
4. Τοποθετήστε τα pageviews και visits στον άξονα Y.
5. Προσθέστε δύο οπτικοποιήσεις Card για τα αθροίσματα των pageviews και visits.
6. Προαιρετικά, προσθέστε το tracker ως slicer όταν το μοντέλο περιέχει αργότερα πολλαπλά tracker.

Επιλέξτε Κεντρική → Ανανέωση για να δοκιμάσετε την πλήρη ανανέωση στο Desktop. Οι υπάρχουσες οπτικοποιήσεις ενημερώνονται όταν ολοκληρωθεί το ερώτημα.

1. Αποθηκεύστε το αρχείο PBIX σε προστατευμένη τοποθεσία.
2. Στο Power BI Desktop, επιλέξτε Κεντρική → Δημοσίευση.
3. Συνδεθείτε με τον λογαριασμό Power BI του οργανισμού σας.
4. Επιλέξτε τον επιθυμητό χώρο εργασίας.
5. Ανοίξτε τη δημοσιευμένη αναφορά από το παράθυρο επιβεβαίωσης.

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

1. Ανοίξτε τον χώρο εργασίας στο Power BI Service.
2. Εντοπίστε το σημασιολογικό μοντέλο που δημιουργήθηκε από το δημοσιευμένο αρχείο PBIX.
3. Ανοίξτε τις Ρυθμίσεις ή επιλέξτε Ανανέωση → Προγραμματισμός ανανέωσης.
4. Στην ενότητα Διαπιστευτήρια προέλευσης δεδομένων, επεξεργαστείτε τα διαπιστευτήρια για το https://api.nowmetrix.com.
5. Επιλέξτε Ανώνυμη ως μέθοδο ελέγχου ταυτότητας και το επίπεδο προστασίας προσωπικών δεδομένων που απαιτεί ο οργανισμός σας.
6. Ενεργοποιήστε το πρόγραμμα ανανέωσης και επιλέξτε κατάλληλη συχνότητα και ζώνη ώρας.
7. Ενεργοποιήστε τις ειδοποιήσεις αποτυχίας ανανέωσης για τον κάτοχο του σημασιολογικού μοντέλου ή άλλο υπεύθυνο άτομο.
8. Αποθηκεύστε τις ρυθμίσεις, επιλέξτε Ανανέωση τώρα και ελέγξτε το Ιστορικό ανανεώσεων.

Οι διαθέσιμες συχνότητες ανανέωσης εξαρτώνται από την άδεια Power BI και τη χωρητικότητα του χώρου εργασίας. Η Microsoft τεκμηριώνει τα τρέχοντα στοιχεία ελέγχου, τα όρια, τη συμπεριφορά σε περίπτωση αποτυχίας και το ιστορικό ανανέωσης στον οδηγό προγραμματισμένης ανανέωσης.

Οι παράμετροι του Power Query διευκολύνουν την αλλαγή του tracker ή την αντικατάσταση του κλειδιού χωρίς επεξεργασία ολόκληρου του ερωτήματος. Βελτιώνουν τη συντηρησιμότητα, αλλά δεν αποτελούν χώρο αποθήκευσης μυστικών.

1. Στο Power Query Editor, επιλέξτε Κεντρική → Διαχείριση παραμέτρων → Νέα παράμετρος.
2. Δημιουργήστε μια υποχρεωτική παράμετρο Text με όνομα pNowMetrixApiKey και εισαγάγετε το κλειδί API ως τρέχουσα τιμή.
3. Δημιουργήστε άλλη μία υποχρεωτική παράμετρο Text με όνομα pNowMetrixTrackerId και εισαγάγετε το αναγνωριστικό του tracker.
4. Αντικαταστήστε τις δύο πρώτες γραμμές του ερωτήματος με τις παρακάτω γραμμές.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

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

Δημιουργήστε ξεχωριστό Power Query για κάθε σύνολο δεδομένων και χρησιμοποιήστε σχέσεις στο μοντέλο όπου χρειάζεται:

• Χρησιμοποιήστε αποκλειστικό κλειδί API του NowMetrix για κάθε σημασιολογικό μοντέλο Power BI.
• Παραχωρήστε στον χρήστη του NowMetrix μόνο την απαιτούμενη πρόσβαση στα tracker της αναφοράς.
• Αποθηκεύστε το αρχείο PBIX σε προστατευμένη τοποθεσία και μην το δημοσιεύσετε ποτέ ως δημόσια λήψη.
• Θεωρήστε τους συντάκτες του PBIX και τους κατόχους του σημασιολογικού μοντέλου αξιόπιστους χρήστες που μπορούν να εξετάσουν το ερώτημα.
• Μην τοποθετείτε το κλειδί σε οπτικοποιήσεις, φίλτρα αναφοράς, URL, στιγμιότυπα οθόνης ή τεκμηρίωση.
• Χρησιμοποιήστε το μικρότερο κοινό χρηστών χώρου εργασίας Power BI που καλύπτει την απαίτηση αναφοράς.
• Ελέγξτε τα δικαιώματα αναφοράς, χώρου εργασίας, εφαρμογής, δημιουργίας, εκ νέου κοινής χρήσης και λήψης πριν από τη διανομή.
• Ανακαλέστε αμέσως το κλειδί εάν ενδέχεται να έχουν παραβιαστεί το αρχείο PBIX, ο χώρος εργασίας ή ο λογαριασμός κατόχου.
• Όταν αλλάζει η ιδιοκτησία, επιβεβαιώστε ότι τα διαπιστευτήρια ανανέωσης και οι ειδοποιήσεις αποτυχίας εξακολουθούν να λειτουργούν.