Δημιουργία σύνδεσης προτύπου Power Query
Σημαντικό
Ορισμένες ή όλες οι λειτουργίες είναι διαθέσιμες ως μέρος μιας έκδοσης προεπισκόπησης. Το περιεχόμενο και η λειτουργικότητα υπόκεινται σε αλλαγές.
Αυτό το άρθρο εμφανίζει στους συνεργάτες τον τρόπο δημιουργίας μιας σύνδεσης προτύπου Power Query για το Microsoft Sustainability Manager. Για να δημιουργήσετε με επιτυχία έναν σύνδεσμο προτύπου Power Query, πρέπει να γνωρίζετε κάποια βασική ανάπτυξη λύσεων για το Dynamics 365 και τον τρόπο δόμησης ενός προτύπου Power Query στο Sustainability Manager.
Εάν πρέπει να δημιουργήσετε έναν σύνδεσμο Power Automate, μεταβείτε στην ενότητα Δημιουργία συνδέσμου Power Automate.
Βήμα 1: Δημιουργία περιβάλλοντος
Σε αυτό το βήμα, δημιουργείτε μια λύση για να τη διανείμετε στους χρήστες του Sustainability Manager που πρέπει να εισάγουν δεδομένα με τον σύνδεσμό σας.
Δημιουργήστε μια νέα μη διαχειριζόμενη λύση στο Power Apps ακολουθώντας τις οδηγίες στην ενότητα Δημιουργία λύσης.
Εγκαταστήστε το Sustainability Manager σε αυτό το περιβάλλον.
Βήμα 2: Δημιουργία προτύπου Power Query
Για να δημιουργήσετε το πρότυπο Power Query για το σύνδεσμο, ακολουθήστε τις οδηγίες στην Σχεδίαση προτύπου Power Query.
Βήμα 3: Προετοιμασία της λύσης σας
Τώρα που διαθέτετε ένα περιβάλλον με εγκατεστημένο το Sustainability Manager και έχετε δημιουργήσει ένα πρότυπο Power Query, μπορείτε να συσκευάσετε το πρότυπο Power Query σε μια λύση σύνδεσης.
Κατ' ελάχιστο, η παρακάτω δομή φακέλων στη μη συσκευασία της λύσης σας θα πρέπει να περιέχει:
- Φάκελος: Πάγια στοιχεία
- Αρχείο: msdyn_dataconnectors.xml
- Αρχείο: msdyn_dataflowtemplates.xml
- Φάκελος: Άλλο
- Αρχείο: Customizations.xml
- Αρχείο: Solution.xml
- Αρχείο: <solution>.cdsproj
Τα αρχεία στην περιοχή Πάγια στοιχεία περιέχουν τις απαραίτητες πληροφορίες για τη φιλοξενία του συνδέσμου προτύπου Power Query σας. Το αρχείο msdyn_dataconnectors.xml περιέχει σημαντικά μεταδεδομένα για τον σύνδεσμό σας. Μετά την εγκατάσταση, καθορίζει τον τρόπο με τον οποίο εμφανίζεται ο σύνδεσμος στο Sustainability Manager. Το αρχείο msdyn_dataflowtemplates.xml περιέχει πληροφορίες σχετικά με το πρότυπο Power Query σας, συμπεριλαμβανομένων όλων των μετασχηματισμών που περιέχει το πρότυπο Power Query σας. Μπορείτε να χρησιμοποιήσετε αυτά τα αρχεία για να δημιουργήσετε μία ή περισσότερες συνδέσεις εντός μίας λύσης.
Ακολουθήστε τις οδηγίες αυτής της ενότητας για να δημιουργήσετε κάθε αρχείο.
Δημιουργήστε το αρχείο msdyn_dataconnectors.xml
Στο πρόγραμμα επεξεργασίας κειμένου της προτίμησής σας, δημιουργήστε ένα νέο αρχείο με όνομα msdyn_dataconnectors.xml.
Αντιγράψτε και τροποποιήστε τα παρακάτω XML για να ταιριάζουν με τα στοιχεία σας:
<msdyn_dataconnectors> <msdyn_dataconnector msdyn_dataconnectorid="bc9e9b1e-45fa-4d6e-b799-9dcb49aaf981"> <msdyn_connectorstatus>700610001</msdyn_connectorstatus> <msdyn_connectortype>700610007</msdyn_connectortype> <msdyn_description>Demo Power Query templates connector</msdyn_description> <msdyn_supportlinkurl>https://www.microsoft.com</msdyn_supportlinkurl> <msdyn_logo_text> </msdyn_logo_text> <msdyn_name>Demo Power Query templates connector</msdyn_name> <msdyn_title>Demo Power Query templates connector</msdyn_title> <msdyn_dataflowtemplateid> <msdyn_dataflowtemplateid></msdyn_dataflowtemplateid> </msdyn_dataflowtemplateid> </msdyn_dataconnector> </msdyn_dataconnectors>
Παράμετρος Λεπτομέρειες msdyn_dataconnectorid Δημιουργήστε ένα νέο GUID για τον προσδιορισμό του συνδέσμου σας, το οποίο θα μορφοποιηθεί σε μορφή GUID. Στο δικό μας παράδειγμα, χρησιμοποιούμε το GUID = bc9e9b1e-45fa-4d6e-b799-9dcb49aaf981. Το GUID είναι το αναγνωριστικό σύνδεσης, το οποίο χρειάζεστε στα επόμενα βήματα. msdyn_connectorstatus Αφήστε αυτήν την τιμή στο 700610001. Αυτή η τιμή αντιπροσωπεύει μια δημοσιευμένη σύνδεση. msdyn_connectortype Αφήστε αυτήν την τιμή στο 700610007. Αυτή η τιμή αντιπροσωπεύει τον τύπο της σύνδεσης. Σε αυτή την περίπτωση, είναι η τιμή για ένα σύνδεσμο προτύπου Power Query. msdyn_description Προσθέστε μια σύντομη περιγραφή του συνδέσμου σας. msdyn_supportlinkurl Αντικαταστήστε το κείμενο με τη διεύθυνση URL με την οποία θέλετε να επικοινωνούν οι χρήστες σε περίπτωση που η σύνδεση αποτύχει. Για πληροφορίες σχετικά με τη δοκιμή αποτυχημένων συνδέσεων, μεταβείτε στη δοκιμή για χειρισμό σφαλμάτων. Ο σύνδεσμός σας δεν θα εμφανιστεί στο Sustainability Manager χωρίς αυτή τη διεύθυνση URL. msdyn_logo_text Χρησιμοποιήστε έναν κωδικό της επιλογής σας για να κωδικοποιήσετε και να αποθηκεύσετε την εικόνα λογότυπου στη Βάση 64. Η εικόνα πρέπει να είναι 36 x 36 px. Επικολλήστε τη βασική κωδικοποίηση 64 σε αυτήν την παράμετρο.
msdyn_name msdyn_titleΑλλάξτε τον σύνδεσμο προτύπων επίδειξης Power Query με το όνομα του συνδέσμου σας. msdyn_dataflowtemplateid Αλλάξτε αυτήν την τιμή με αυτήν που αφορά το πρότυπό Power Query σας. Αυτή η τιμή είναι ένα GUID, το οποίο χρησιμοποιείτε επίσης στο αρχείο msdyn_dataflowtemplates.xml.
Δημιουργήστε το αρχείο msdyn_dataflowtemplates.xml
Στο πρόγραμμα επεξεργασίας κειμένου της προτίμησής σας, δημιουργήστε ένα νέο αρχείο με όνομα msdyn_dataflowtemplates.xml.
Αντιγράψτε και τροποποιήστε τα παρακάτω XML για να ταιριάζουν με τα στοιχεία σας:
<msdyn_dataflowtemplates> <msdyn_dataflowtemplate msdyn_dataflowtemplateid=""> <msdyn_uniquename>msm_sustainabilitySamplePQTemplate</msdyn_uniquename> <msdyn_category>msdyn_sustainability</msdyn_category> <msdyn_configuration>{\"msdyn_sustainability\":{\"dataDefinitions\":\", , , \",\"dataDefinitionNames\":\"6. Business travel, Facilities, Organizational units, Business travel types\",\"map\":{\"Business Travel\":\"{\\\"fields\\\":[{\\\"destinationField\\\":\\\"msdyn_businesstraveltypeid\\\",\\\"sourceField\\\":\\\"Business Travel Type\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_consumptionstartdate\\\",\\\"sourceField\\\":\\\"Consumption Start Date\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_consumptionenddate\\\",\\\"sourceField\\\":\\\"Consumption End Date\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_name\\\",\\\"sourceField\\\":\\\"Name\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_description\\\",\\\"sourceField\\\":\\\"Description\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_facilityid\\\",\\\"sourceField\\\":\\\"Facility\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_cost\\\",\\\"sourceField\\\":\\\"Cost\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_costunit\\\",\\\"sourceField\\\":\\\"Cost Unit\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_distance\\\",\\\"sourceField\\\":\\\"Distance\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_distanceunit\\\",\\\"sourceField\\\":\\\"Distance Unit\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_organizationalunitid\\\",\\\"sourceField\\\":\\\"Organizational unt\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_dataqualitytype\\\",\\\"sourceField\\\":\\\"Data Quality\\\",\\\"isCustomDimension\\\":false},{\\\"sourceField\\\":\\\"Production value\\\",\\\"destinationField\\\":\\\"Production Amplifier\\\",\\\"isCustomDimension\\\":true}]}\",\"biz trav types\":\"{\\\"fields\\\":[{\\\"destinationField\\\":\\\"msdyn_name\\\",\\\"sourceField\\\":\\\"Name\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_description\\\",\\\"sourceField\\\":\\\"Description\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_origincorrelationid\\\",\\\"sourceField\\\":\\\"Origin correlation id\\\",\\\"isCustomDimension\\\":false}]}\",\"orgs\":\"{\\\"fields\\\":[{\\\"destinationField\\\":\\\"msdyn_name\\\",\\\"sourceField\\\":\\\"Name\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_organizationalunittype\\\",\\\"sourceField\\\":\\\"Organizational unit type\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_addressstreet1\\\",\\\"sourceField\\\":\\\"Address\\\",\\\"isCustomDimension\\\":false}]}\",\"facilities\":\"{\\\"fields\\\":[{\\\"destinationField\\\":\\\"msdyn_name\\\",\\\"sourceField\\\":\\\"Name\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_addresscity\\\",\\\"sourceField\\\":\\\"City\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_addresscountryisocode\\\",\\\"sourceField\\\":\\\"Country/Region\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_addresszippostalcode\\\",\\\"sourceField\\\":\\\"Zip/Postal\\\",\\\"isCustomDimension\\\":false},{\\\"destinationField\\\":\\\"msdyn_addressstreet1\\\",\\\"sourceField\\\":\\\"Address \\\",\\\"isCustomDimension\\\":false}]}\"},\"mapSdds\":{\"Business Travel\":\"aaaa0000-bb11-2222-33cc-444444dddddd\",\"biz trav types\":\"bbbb1111-cc22-3333-44dd-555555eeeeee\",\"orgs\":\"cccc2222-dd33-4444-55ee-666666ffffff\",\"facilities\":\"dddd3333-ee44-5555-66ff-777777aaaaaa\"}}}</msdyn_configuration> <msdyn_description>Demo Power Query template connector</msdyn_description> <msdyn_mashupdocument>{\"hostContext\":{\"type\":\"SustainabilityCloud\",\"details\":{\"EnvironmentId\":\"\"}},\"mashupName\":\"Sustainability--04000419112812547\",\"mashupDocument\":\"section Section1;\\r\\nshared #\\\"Business Travel\\\" = let\\n Source = Excel.Workbook(Web.Contents(\\\"contoso/Documents/Apps/Microsoft Power Query/Uploaded Files/business travel 9.xlsx\\\"), null, true),\\n #\\\"Navigation 1\\\" = Source{[Item = \\\"Business Travel\\\", Kind = \\\"Sheet\\\"]}[Data],\\n #\\\"Promoted headers\\\" = Table.PromoteHeaders(#\\\"Navigation 1\\\", [PromoteAllScalars = true]),\\n #\\\"Changed column type\\\" = Table.TransformColumnTypes(#\\\"Promoted headers\\\", {{\\\"Business Travel Type\\\", type text}, {\\\"Consumption Start Date\\\", type datetime}, {\\\"Consumption End Date\\\", type datetime}, {\\\"Data Quality\\\", type text}, {\\\"Name\\\", type text}, {\\\"Organizational unt\\\", type text}, {\\\"Description\\\", type text}, {\\\"Facility\\\", type text}, {\\\"Cost\\\", Int64.Type}, {\\\"Cost Unit\\\", type text}, {\\\"Distance\\\", Int64.Type}, {\\\"Distance Unit\\\", type text}, {\\\"Traveler\\\", type text}, {\\\"Is Good use of money\\\", type text}, {\\\"Budget\\\", Int64.Type}, {\\\"Had Fun\\\", type text}, {\\\"Personal Note\\\", type text}, {\\\"Production value\\\", Int64.Type}}),\\n #\\\"Filtered rows\\\" = Table.SelectRows(#\\\"Changed column type\\\", each ([Traveler] = FullName))\\nin\\n #\\\"Filtered rows\\\";\\r\\nshared #\\\"biz trav types\\\" = let\\r\\n Source = Excel.Workbook(Web.Contents(\\\"contoso/Documents/Apps/Microsoft Power Query/Uploaded Files/business travel 9.xlsx\\\"), null, true),\\r\\n #\\\"Navigation 1\\\" = Source{[Item = \\\"biz trav types\\\", Kind = \\\"Sheet\\\"]}[Data],\\r\\n #\\\"Changed column type\\\" = Table.TransformColumnTypes(#\\\"Navigation 1\\\", {{\\\"Column1\\\", type text}, {\\\"Column2\\\", type text}, {\\\"Column3\\\", type text}}),\\r\\n #\\\"Promoted headers\\\" = Table.PromoteHeaders(#\\\"Changed column type\\\", [PromoteAllScalars = true])\\r\\nin\\r\\n #\\\"Promoted headers\\\";\\r\\nshared orgs = let\\r\\n Source = Excel.Workbook(Web.Contents(\\\"https://contoso/Documents/Apps/Microsoft Power Query/Uploaded Files/business travel 9.xlsx\\\"), null, true),\\r\\n #\\\"Navigation 1\\\" = Source{[Item = \\\"orgs\\\", Kind = \\\"Sheet\\\"]}[Data],\\r\\n #\\\"Changed column type\\\" = Table.TransformColumnTypes(#\\\"Navigation 1\\\", {{\\\"Column1\\\", type text}, {\\\"Column2\\\", type text}, {\\\"Column3\\\", type text}}),\\r\\n #\\\"Promoted headers\\\" = Table.PromoteHeaders(#\\\"Changed column type\\\", [PromoteAllScalars = true])\\r\\nin\\r\\n #\\\"Promoted headers\\\";\\r\\nshared facilities = let\\r\\n Source = Excel.Workbook(Web.Contents(\\\"https://contoso/Documents/Apps/Microsoft Power Query/Uploaded Files/business travel 9.xlsx\\\"), null, true),\\r\\n #\\\"Navigation 1\\\" = Source{[Item = \\\"facilities\\\", Kind = \\\"Sheet\\\"]}[Data],\\r\\n #\\\"Promoted headers\\\" = Table.PromoteHeaders(#\\\"Navigation 1\\\", [PromoteAllScalars = true]),\\r\\n #\\\"Changed column type\\\" = Table.TransformColumnTypes(#\\\"Promoted headers\\\", {{\\\"Name\\\", type text}, {\\\"Address \\\", type text}, {\\\"City\\\", type text}, {\\\"Country/Region\\\", type text}, {\\\"Zip/Postal\\\", Int64.Type}, {\\\"IsLeased\\\", type text}}),\\r\\n #\\\"Renamed columns\\\" = Table.RenameColumns(#\\\"Changed column type\\\", {{\\\"Address \\\", \\\"Address\\\"}})\\r\\nin\\r\\n #\\\"Renamed columns\\\";\\r\\n[Description = \\\"first name last name of the user doing the business travel\\\"]\\r\\nshared FullName = \\\"Stanko Gutalj\\\" meta [IsParameterQuery = true, IsParameterQueryRequired = true, Type = type any];\\r\\n\",\"queryGroups\":[],\"documentLocale\":\"en-US\",\"gatewayObjectId\":null,\"queriesMetadata\":{\"Business Travel\":{\"queryId\":\"c7b76ec4-8e29-42d1-b63d-7710f85a7d4b\",\"queryName\":\"Business Travel\",\"queryGroupId\":null,\"entityName\":null,\"lastKnownIsCalculatedEntity\":false,\"lastKnownIsLinkedEntity\":false,\"lastKnownIsParameter\":false,\"isHidden\":false,\"lastKnownResultTypeName\":\"table\",\"loadEnabled\":true,\"fieldsMetadata\":{},\"deleteExistingDataOnLoad\":false,\"hostProperties\":{},\"jsonOutputDestinations\":null,\"bindToDefaultOutputDestination\":null,\"jsonIncrementalRefreshSettings\":null,\"stagingDefinition\":null},\"biz trav types\":{\"queryId\":\"0c8434c7-29c6-4f7b-a5f5-b5791604061d\",\"queryName\":\"biz trav types\",\"queryGroupId\":null,\"entityName\":null,\"lastKnownIsCalculatedEntity\":false,\"lastKnownIsLinkedEntity\":false,\"lastKnownIsParameter\":false,\"isHidden\":false,\"lastKnownResultTypeName\":\"table\",\"loadEnabled\":true,\"fieldsMetadata\":{},\"deleteExistingDataOnLoad\":false,\"hostProperties\":{},\"jsonOutputDestinations\":null,\"bindToDefaultOutputDestination\":null,\"jsonIncrementalRefreshSettings\":null,\"stagingDefinition\":null},\"orgs\":{\"queryId\":\"94756842-bfc6-4459-9703-627d2f95594a\",\"queryName\":\"orgs\",\"queryGroupId\":null,\"entityName\":null,\"lastKnownIsCalculatedEntity\":false,\"lastKnownIsLinkedEntity\":false,\"lastKnownIsParameter\":false,\"isHidden\":false,\"lastKnownResultTypeName\":\"table\",\"loadEnabled\":true,\"fieldsMetadata\":{},\"deleteExistingDataOnLoad\":false,\"hostProperties\":{},\"jsonOutputDestinations\":null,\"bindToDefaultOutputDestination\":null,\"jsonIncrementalRefreshSettings\":null,\"stagingDefinition\":null},\"facilities\":{\"queryId\":\"87485e4a-ecdb-4617-9c8c-a7c96a2092f7\",\"queryName\":\"facilities\",\"queryGroupId\":null,\"entityName\":null,\"lastKnownIsCalculatedEntity\":false,\"lastKnownIsLinkedEntity\":false,\"lastKnownIsParameter\":false,\"isHidden\":false,\"lastKnownResultTypeName\":\"table\",\"loadEnabled\":true,\"fieldsMetadata\":{},\"deleteExistingDataOnLoad\":false,\"hostProperties\":{},\"jsonOutputDestinations\":null,\"bindToDefaultOutputDestination\":null,\"jsonIncrementalRefreshSettings\":null,\"stagingDefinition\":null},\"FullName\":{\"queryId\":\"488f10a8-9f01-4674-a004-c8a6493785a6\",\"queryName\":\"FullName\",\"queryGroupId\":null,\"entityName\":null,\"lastKnownIsCalculatedEntity\":false,\"lastKnownIsLinkedEntity\":false,\"lastKnownIsParameter\":true,\"isHidden\":false,\"lastKnownResultTypeName\":\"text\",\"loadEnabled\":false,\"fieldsMetadata\":{},\"deleteExistingDataOnLoad\":false,\"hostProperties\":{},\"jsonOutputDestinations\":null,\"bindToDefaultOutputDestination\":null,\"jsonIncrementalRefreshSettings\":null,\"stagingDefinition\":null}},\"connectionOverrides\":[{\"path\":\"https://contoso/Documents/Apps/Microsoft Power Query/Uploaded Files/business travel 9.xlsx\",\"kind\":\"Web\",\"provider\":\"PowerApps\",\"environmentName\":\"\",\"apiName\":\"webcontents\",\"connectionName\":\"926cadb147e044fa9da7cffce4f70e82\",\"credentialDetails\":{},\"connectionParameters\":{}}],\"trustedConnections\":null,\"useHostConnectionProvider\":false,\"fastCombine\":false,\"allowNativeQueries\":false,\"allowedModules\":null,\"skipAutomaticTypeAndHeaderDetection\":false,\"disableAutoAnonymousConnectionUpsert\":false,\"hostProperties\":null,\"defaultOutputDestinationConfiguration\":null,\"stagingDefinition\":null}</msdyn_mashupdocument> <msdyn_templatename>Demo Power Query template connector</msdyn_templatename> <msdyn_templateversion>1.0</msdyn_templateversion> </msdyn_dataflowtemplate> </msdyn_dataflowtemplates>
Παράμετρος Λεπτομέρειες msdyn_dataflowtemplateid Δημιουργήστε ένα νέο GUID για τον προσδιορισμό του προτύπου σας, το οποίο θα μορφοποιηθεί σε μορφή GUID. msdyn_uniquename Εισάγετε ένα μοναδικό όνομα για την καρτέλα του προτύπου σας. msdyn_category Η κατηγορία της καρτέλας προτύπου σας. Αφήστε αυτή την τιμή ως έχει. msdyn_configuration Αλλάξτε αυτό το στοιχείο στο JSON που αντιπροσωπεύει τη ρύθμιση παραμέτρων αντιστοίχισης του προτύπου σας στις κατηγορίες δεδομένων που υποστηρίζονται στο Sustainability Manager. Οδηγίες για τη λήψη αυτού του JSON παρέχονται μετά από αυτόν τον πίνακα. msdyn_description Εισάγετε μια περιγραφή για το πρότυπο Power Query. msdyn_mashupdocument Αυτή η παράμετρος είναι μια αναπαράσταση κειμένου όλων των μετασχηματισμών στο σύνδεσμο. Οδηγίες για τη λήψη αυτού του κειμένου παρέχονται μετά από αυτόν τον πίνακα. msdyn_templatename Εισαγάγετε ένα όνομα για το πρότυπό σας. msdyn_templateversion Εισάγετε τον αριθμό έκδοσης του προτύπου σας. Για να εξαγάγετε τις πληροφορίες που θα χρησιμοποιηθούν στις παραμέτρους msdyn_configuration και msdyn_mashupdocument, αντιγράψτε και επικολλήστε το ακόλουθο κείμενο στο πρόγραμμα περιήγησής σας. Αντικαταστήστε το <your_organization> με το όνομα του περιβάλλοντος της εταιρείας σας.
https://<your_organization>.crm10.dynamics.com/api/data/v9.0/msdyn_dataflowtemplates
Εμφανίζεται ένα JSON με όλες τις καρτέλες του msdyn_dataflowtemplates, όπου μπορείτε να βρείτε το πρότυπο που θέλετε να μετακινήσετε. Αντιγράψτε και επικολλήστε τα πεδία στο αρχείο msdyn_dataflowtemplates.xml σας.