Εγκατάσταση και ρύθμιση παραμέτρων του Connected Field Service for Azure IoT Hub

Ακολουθήστε τα βήματα σε αυτό το άρθρο για να ρυθμίσετε το Connected Field Service για χρήση με το Azure IoT Hub.

• Βήμα 1: Ανάπτυξη του Connected Field Service και πόρων Azure από ένα πρότυπο ARM
• Βήμα 2: Δημιουργήστε μια παρουσία παρόχου IoT
• Βήμα 3: Ρύθμιση τελικού σημείου IoT
• Βήμα 4: Εξουσιοδότηση σύνδεσης εφαρμογής Azure
• Βήμα 5: Ενημέρωση του devicerules.json
• Βήμα 6: Έναρξη εργασιών Ανάλυσης ροής Azure
• Βήμα 7: Ρυθμίστε τη σύνδεση Azure Time Series Insights
• Βήμα 8: Ορίστε τις παραμέτρους του προσομοιωτή (προαιρετικό)

Σημείωμα

Το Time Series Insights θα αποσυρθεί μετά τον Μάρτιο του 2025. Το Connected Field Service μεταβαίνει στο Azure Data Explorer. Περισσότερες πληροφορίες για τη μετάβαση θα είναι διαθέσιμες σύντομα.

Προϋποθέσεις

• Το Dynamics 365 Field Service εγκαταστάθηκε.

• Βεβαιωθείτε ότι διαθέτετε ρόλο ασφαλείας Διαχειριστή συστήματος και Διαχειριστή IoT.

• Έχετε μια ενεργή συνδρομή Azure με δικαιώματα δημιουργίας πόρων και υπηρεσιών.

• Έχετε δημιουργήσει μια εγγραφή εφαρμογής για το Azure Time Series Insights στην πύλη Azure και έχετε το αναγνωριστικό εφαρμογής (πρόγραμμα-πελάτης) και το αναγνωριστικό αντικειμένου. Προσθέστε ένα μυστικό πελάτη και καταγράψτε την τιμή. Χρειάζεστε αυτές τις τιμές πολλές φορές σε αυτήν τη διαδικασία.

Φιλοδώρημα

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

Ανάπτυξη του Connected Field Service και πόρων Azure από ένα πρότυπο ARM

Χρησιμοποιήστε ένα πρότυπο διαχείρισης πόρων Azure (Azure Resource Manager) για να αναπτύξετε το Azure IoT Hub και να το συνδέσετε στο περιβάλλον Field Service.

1. Επιλέξτε Ανάπτυξη στο Azure στη σελίδα https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

2. Επιλογή συνδρομής Azure.

3. Επιλέξτε μια ομάδα πόρων ή δημιουργήστε μία.

4. Ορίστε την περιοχή στην ίδια περιοχή με το περιβάλλον Field Service.

   

5. Πληκτρολογήστε το μοναδικό όνομα του οργανισμού σας και τη διεύθυνση URL του οργανισμού στο περιβάλλον Field Service.

6. Επιλέξτε τους προαιρετικούς πόρους που θέλετε να αναπτύξετε.

   • Επιλέξτε Ανάπτυξη προσομοιωτή (προαιρετικό) για δοκιμή και επικύρωση σεναρίων IoT με δείγματα δεδομένων.
   • Επιλέξτε Azure Time Series Insights (προαιρετικό) για να ενεργοποιήσετε τις απεικονίσεις των ενδείξεων της συσκευής και των πλακιδίων σύνοψης.
   • Επιλέξτε Ανάπτυξη SQL Server για Power BI (προαιρετικά) και εισαγάγετε τον διακομιστή SQL και τα διαπιστευτήρια για να δημιουργήσετε τις δικές σας αναφορές Power BI.

7. Επιλέξτε Αναθεώρηση + δημιουργία.

Βεβαιωθείτε ότι η ανάπτυξη έχει ολοκληρωθεί πριν προχωρήσετε.

Δημιουγήστε μια παρουσία παρόχου IoT

1. Συνδεθείτε στο Dynamics 365 και ανοίξτε την εφαρμογή Connected Field Service.

2. Στο Connected Field Service, μεταβείτε στην περιοχή Ρυθμίσεις.

3. Επιλέξτε Πάροχοι και έπειτα επιλέξτε Νέος.

4. Πληκτρολογήστε τις παρακάτω πληροφορίες:

   

   • Ονομα: Το όνομα της ομάδας πόρων στο Azure όπου αναπτύξατε πόρους IoT
   • Πάροχος IoT: Ο πάροχος IoT για το IoT Hub
   • Αναγνωριστικό παρουσίας παρόχου: Το όνομα του πόρου IoT Hub που αναπτύξατε στην ομάδα πόρων σας στο Azure
   • URL: Η διεύθυνση URL της επισκόπησης για την ομάδα πόρων στην πύλη Azure. για παράδειγμα, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

5. Επιλέξτε Αποθήκευση.

Τώρα πρέπει να ενημερώσετε τις ρυθμίσεις για τη νέα παρουσία παρόχου.

1. Στην περιοχή Ρυθμίσεις, επιλέξτε Ρυθμίσεις IoT>Ρυθμίσεις υπηρεσίας παροχής IoT.

   

2. Για τον Προεπιλεγμένο πάροχο IoT, επιλέξτε την παρουσία παρόχου IoT που δημιουργήσατε.

3. Επιλέξτε Αποθήκευση και κλείσιμο.

4. Για ένα μεταγενέστερο βήμα, βρείτε τη σειρά Παρουσία παρόχου IoT στον πίνακα msdyn_iotproviderinstance και αντιγράψτε το GUID.

Ρύθμιση τελικού σημείου IoT

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

1. Κάντε λήψη του CLI Power Platform και εγκαταστήστε το.

2. Ανοίξτε το CLI και ξεκινήστε το Plugin Registration Tool (PRT) χρησιμοποιώντας την εντολή pac tool prt.

3. Στο παράθυρο PRT, επιλέξτε Δημιουργία νέας σύνδεσης.

4. ΣτοΕμφάνιση λίστας για διαθέσιμους οργανισμούς, επιλέξτε Office 365.

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

6. Επιλέξτε την περιοχή του περιβάλλοντος Field Service, καταχωρίστε τα διαπιστευτήρια Field Service και, στη συνέχεια, επιλέξτε Σύνδεση.

   Εάν έχετε πρόσβαση σε πολλούς οργανισμούς Dynamics 365, επιλέξτε το όνομα του οργανισμού με τον οποίο θέλετε να εργαστείτε.

Τώρα πρέπει να ενημερώσετε το τελικό σημείο της υπηρεσίας μηνυμάτων IoT.

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

2. Επιλέξτε Ενημέρωση.

3. Για τη Διεύθυνση χώρου ονομάτων, εισαγάγετε το όνομα κεντρικού υπολογιστή του χώρου ονομάτων διαύλου υπηρεσίας στο Εργαλείο εγγραφής προσθηκών, με πρόθεμα sb://, για παράδειγμα, sb://myServiceBusNamespace.servicebus.windows.net.

4. Στον πόρο χώρου ονομάτων του διαύλου υπηρεσίας, μεταβείτε στις Ουρές και βρείτε την ουρά με ένα όνομα που λήγει σε -crm. Αντιγράψτε το πλήρες όνομα και καταχωρίστε το ως Όνομα θέματος στο Εργαλείο καταχώρισης προσθήκης.

5. Για τη μορφή μηνύματος, επιλέξτε XML.

6. Στον πόρο χώρου ονομάτων διαύλου υπηρεσίας, μεταβείτε στις Πολιτικές κοινόχρηστης πρόσβασης>RootManageSharedAccessKey.

7. Αντιγράψτε το όνομα και επικολλήστε το στο Όνομα κλειδιού SaS.

8. Αντιγράψτε το πρωτεύον κλειδί και επικολλήστε το στο Κλειδί SAS.

9. Επιλέξτε Αποθήκευση.

   

Εξουσιοδότηση σύνδεσης εφαρμογής Azure

1. Συνδεθείτε στον λογαριασμό Azure και μεταβείτε στην πύλη Azure.

2. Μεταβείτε στις Ομάδες πόρων και βρείτε την ομάδα πόρων που αναπτύξατε πρόσφατα στο IoT Hub.

3. Επιλέξτε και επεξεργαστείτε τον πόρο Σύνδεση APIcommondataservice.

4. Στην περιοχή Γενικά, επιλέξτε Επεξεργασία σύνδεσης API και στη συνέχεια, επιλέξτε Εξουσιοδότηση.

5. Συνδεθείτε με τα διαπιστευτήρια Dynamics 365 που χρησιμοποιείτε για να συνδεθείτε στο περιβάλλον Connected Field Service.

   Μπορεί να διαφέρουν από τα διαπιστευτήρια που χρησιμοποιείτε για να συνδεθείτε στην πύλη Azure.

6. Επιλέξτε Αποθήκευση.

Ενημέρωση του devicerules.json

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

Για να χρησιμοποιήσετε τον κανόνα, στείλτε το αρχείο devicerules.json. Πρέπει να αναπαράγετε την ακριβή δομή καταλόγου για να λειτουργήσει το δείγμα ειδοποίησης.

1. Κάντε λήψη του αρχείου devicerules.json από το αποθετήριο GitHub.

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

3. Επιλέξτε Κοντέινερ και, στη συνέχεια, δημιουργήστε ένα κοντέινερ που ονομάζεται devicerules.

4. Ανοίξτε το νέο κοντέινερ devicerules και επιλέξτε Αποστολή.

5. Περιηγηθείτε και επιλέξτε devicerules.json.

6. Αναπτύξτε την ενότητα για προχωρημένους. Στο πεδίο Αποστολή σε φάκελο, πληκτρολογήστε 2016-05-30 και, στη συνέχεια, επιλέξτε Αποστολή.

7. Ανοίξτε το νέο φάκελο 2016-05-30 και επιλέξτε Αποστολή.

8. Περιηγηθείτε και επιλέξτε devicerules.json.

9. Αναπτύξτε την ενότητα για προχωρημένους. Στο πεδίο Αποστολή σε φάκελο, πληκτρολογήστε 22-40 και, στη συνέχεια, επιλέξτε Αποστολή.

Έναρξη εργασιών Ανάλυσης ροής Azure

1. Στην Πύλη Azure, μεταβείτε στις Ομάδες πόρων και βρείτε την ομάδα πόρων όπου αναπτύξατε το IoT Hub.

2. Επιλέξτε κάθε εργασία Ανάλυσης ροής και από την καρτέλα Επισκόπηση επιλέξτε Έναρξη.

Συγχαρητήρια! Είστε πλέον έτοιμοι να μεταβιβάσετε δεδομένα μεταξύ του Διανομέα IoT του Azure και του Dynamics 365, για να χρησιμοποιήσετε το Connected Field Service.

Ρυθμίστε τη σύνδεση Azure Time Series Insights

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

1. Στο Dynamics 365, ανοίξτε την εφαρμογή Connected Field Service.

2. Εκκινήστε τα εργαλεία προγραμματισμού του προγράμματος περιήγησης και μεταβείτε στην κονσόλα.

3. Πληκτρολογήστε ή επικολλήστε το ακόλουθο σκριπτ στην κονσόλα και εκτελέστε το. Αντικαταστήστε την παράμετρο Value με το αναγνωριστικό μισθωτή Azure.

var req = {};

req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"Key": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"Value": {
"typeName": "Edm.String",
"structuralProperty": 1
},
},
operationType: 0,
operationName: "msdyn_IoTSetConfiguration"
};
};

req["Key"]="TSI_PLUGIN_AZURE_TENANT_ID";
req["Value"]="REPLACE";

Xrm.WebApi.online.execute(req).then( 
function (data) { 
console.log("Success Response Status: " + data.status);
}, 
function (error) { 
console.log("Error: " + error.message);
}
);

1. Εκτελέστε το σκριπτ ξανά. Αυτή τη φορά, αντικαταστήστε το Key με TSI_PLUGIN_CLIENT_APPLICATION_ID και το Value με το αναγνωριστικό προγράμματος-πελάτη εφαρμογής από την εγγραφή της εφαρμογής Time Series Insights που δημιουργήσατε ως προαπαιτούμενο.

2. Εκτελέστε το σκριπτ άλλη μια φορά. Αυτή τη φορά, αντικαταστήστε το Key με TSI_PLUGIN_CLIENT_SECRET και το Value με το μυστικό πελάτη από την εγγραφή της εφαρμογής Time Series Insights που δημιουργήσατε ως προαπαιτούμενο.

3. Εκτελέστε το ακόλουθο σκριπτ, χρησιμοποιώντας τη διεύθυνση URL Time Series Insights και το GUID της σειράς παρουσίας παρόχου IoT στον πίνακα msdyn_iotproviderinstance για την παρουσία παρόχου IoT που δημιουργήσατε νωρίτερα.

var data = {"msdyn_timeseriesinsightsurl": "Enter Data Access FQDN found on Time Series Insights environment overview"};
Xrm.WebApi.updateRecord("msdyn_iotproviderinstance", "Copy the value for msdyn_iotproviderinstanceid from the json object returned with the API call https://[your-environment-name].crm.dynamics.com/api/data/v9.2/msdyn_iotproviderinstances", data);

Ορίστε τις παραμέτρους του προσομοιωτή (προαιρετικό)

Ο προσομοιωτής σάς επιτρέπει να δοκιμάσετε το Connected Field Service χωρίς να χρειάζεται να συνδέσετε φυσικό υλικό. Με την προσομοίωση συσκευών και δεδομένων IoT, μπορείτε να κατανοήσετε όλα τα διαφορετικά μέρη του συστήματος που συμβάλλουν στη μετατροπή δεδομένων IoT σε παραγγελίες εργασίας.

Για αυτό το βήμα, χρειάζεστε τη διεύθυνση URL του προσομοιωτή και το πρωτεύον κλειδί για την πολιτική iothubowner.

Λάβετε το κλειδί πρόσβασης

1. Συνδεθείτε στον λογαριασμό Azure και μεταβείτε στην πύλη Azure.

2. Μεταβείτε στις Ομάδες πόρων και βρείτε την ομάδα πόρων που αναπτύξατε πρόσφατα στο IoT Hub.

3. Επιλέξτε το IoT hub.

4. Επιλέξτε Πολιτικές κοινόχρηστης πρόσβασης και, στη συνέχεια, αντιγράψτε το πρωτεύον κλειδί για το iothubowner.

   

Λάβετε τη διεύθυνση URL του προσομοιωτή

1. Στην ομάδα πόρων της πύλης Azure στην οποία αναπτύξατε το IoT Hub, επιλέξτε τον τύπο πόρων υπηρεσίας εφαρμογής που ξεκινά με Simulator και αντιγράψτε τη διεύθυνση URL στην επάνω δεξιά γωνία.

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

3. Επιλέξτε Σύνδεση.

4. Εισαγάγετε το όνομα κεντρικού υπολογιστή από τον πόρο IoT Hub και iothubowner ως όνομα πολιτικής. Στο πεδίο Κλειδί επικολλήστε το πρωτεύον κλειδί που αντιγράψατε νωρίτερα.

   

5. Βεβαιωθείτε ότι η Κατάσταση σύνδεσηςείναι Συνδέθηκε και κατόπιν κλείστε το παράθυρο διαλόγου σύνδεσης.

Στείλτε μια εντολή δοκιμής χρησιμοποιώντας τον προσομοιωτή. Για παράδειγμα, κάντε κλικ στη θερμοκρασία και αυξήστε την πάνω από 70 βαθμούς. Ο προσομοιωτής επαναπρογραμματίζεται για τη δημιουργία μιας ειδοποίησης IoT εάν η θερμοκρασία είναι πάνω από 70 βαθμούς.

Επόμενα βήματα

• Καταχώρηση συσκευών
• Άντληση δεδομένων συσκευής
• Οπτικοποίηση ενδείξεων συσκευής