Criar um conector de modelo do Power Query

Artigo
05/17/2024

Importante

Algumas ou todas estas funcionalidades estão disponíveis como parte de uma versão de pré-visualização. O conteúdo e a funcionalidade estão sujeitos a alterações.

Este artigo mostra aos parceiros como criar um conector de modelo do Power Query para o Microsoft Sustainability Manager. Para criar com êxito um conector de modelo do Power Query, tem de conhecer algumas das soluções básicas de desenvolvimento do Dynamics 365 e como criar um modelo do Power Query no Sustainability Manager.

Se precisar de criar um conector do Power Automate, aceda a Criar um conector do Power Automate.

Passo 1: Criar um ambiente

Neste passo, cria uma solução para distribuir aos utilizadores do Sustainability Manager que necessitam de importar dados com o seu conector.

Crie uma nova solução não gerida no Power Apps seguindo as instruções em Criar uma solução.
Instale o Sustainability Manager nesse ambiente.

Passo 2: Criar um modelo do Power Query

Para criar o modelo do Power Query para o seu conector, siga as instruções em Estruturar um modelo do Power Query.

Passo 3: Preparar a solução

Agora que tem um ambiente com o Sustainability Manager instalado e criou um modelo do Power Query, pode embalar o modelo do Power Query numa solução de conector.

No mínimo, a seguinte estrutura de pastas na sua solução descompactada deve conter:

Pasta: Ativos
- Ficheiro: msdyn_dataconnectors.xml
- Ficheiro: msdyn_dataflowtemplates.xml
Pasta: Outros
- Ficheiro: Customizations.xml
- Ficheiro: Solution.xml
Ficheiro: <solution>.cdsproj

Os ficheiros em Ativos contêm as informações necessárias para alojar o conector de modelo do Power Query . O ficheiro msdyn_dataconnectors.xml contém metadados importantes sobre o conector. Depois de instalado, determina a forma como o conector aparece no Sustainability Manager. O ficheiro msdyn_dataflowtemplates.xml contém informações sobre o modelo do Power Query , incluindo todas as transformações que o seu modelo do Power Query contém. Pode utilizar estes ficheiros para criar um ou mais conectores numa única solução.

Siga as instruções nesta secção para criar cada ficheiro.

Criar o ficheiro msdyn_dataconnectors.xml

No editor de texto preferencial, crie um novo ficheiro com o nome msdyn_dataconnectors.xml.

Copie e modifique o XML seguinte para se ajustar aos seus detalhes:

<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>

Parâmetro	Detalhes
msdyn_dataconnectorid	Gere um novo GUID para identificar o conector, aderindo ao formato GUID. No nosso exemplo, utilizamos GUID = bc9e9b1e-45fa-4d6e-b799-9dcb49aaf981. O GUID é o identificador do conector, do qual necessitará nos passos posteriores.
msdyn_connectorstatus	Deixe este valor em 700610001. Este valor representa um conector publicado.
msdyn_connectortype	Deixe este valor em 700610007. Este valor representa um tipo de conector. Neste caso, é o valor para um conector de modelo do Power Query.
msdyn_description	Adicione uma breve descrição para o seu conector.
msdyn_supportlinkurl	Substitua o texto pelo URL que pretende que os utilizadores contactem se a ligação falhar. Para obter informações sobre como testar ligações com falha, aceda a Testar processamento de erros. O seu conector não aparecerá no Sustainability Manager sem este URL.
msdyn_logo_text	Utilize um codificador à sua escolha para codificar e guardar a imagem do logótipo em Base 64. A imagem deve ter 36 x 36 px. Cole a codificação de base 64 neste parâmetro.
msdyn_name msdyn_title	Altere Conector de modelos do Power Query de demonstração para o nome do seu connector.
msdyn_dataflowtemplateid	Altere este valor para o do modelo do Power Query. Este valor é um GUID que também utiliza no ficheiro msdyn_dataflowtemplates.xml.

Criar o ficheiro msdyn_dataflowtemplates.xml

No editor de texto preferencial, crie um novo ficheiro com o nome msdyn_dataflowtemplates.xml.

Copie e modifique o XML seguinte para se ajustar aos seus detalhes:

<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\":\"bd182f7f-1b7b-4360-9c02-2d0b7cd75b97\",\"biz trav types\":\"4b1faadb-0ee4-42c8-a3fc-e3afa3987172\",\"orgs\":\"c4f9c6f5-dc68-49ca-8297-acbb29fece79\",\"facilities\":\"6c36ce29-f121-47d6-b146-9eece7e869ec\"}}}</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>

Parâmetro	Detalhes
msdyn_dataflowtemplateid	Gere um novo GUID para identificar o modelo, aderindo ao formato GUID.
msdyn_uniquename	Introduza um nome exclusivo para o seu registo de modelo.
msdyn_category	A categoria do seu registo de modelo. Deixe este valor como está.
msdyn_configuration	Altere este para o JSON que representa a configuração de mapeamento do seu modelo para as categorias de dados suportadas no Sustainability Manager. As instruções para obter este JSON são fornecidas após esta tabela.
msdyn_description	Introduza uma descrição para o seu modelo do Power Query.
msdyn_mashupdocument	Este parâmetro é uma representação de texto de todas as transformações no conector. As instruções para obter este texto são fornecidas após esta tabela.
msdyn_templatename	Introduza um nome para o seu modelo.
msdyn_templateversion	Introduza o número de versão do modelo.

Para extrair as informações a utilizar nos parâmetros msdyn_configuration e msdyn_mashupdocument , copie e cole o seguinte texto no browser. Substitua <a_sua_organização> pelo nome do ambiente da sua organização.

https://<your_organization>.crm10.dynamics.com/api/data/v9.0/msdyn_dataflowtemplates

Um JSON é apresentado com todos os registos msdyn_dataflowtemplates , onde pode encontrar o modelo que pretende mover. Copie e cole os campos para o ficheiro msdyn_dataflowtemplates.xml .