Mapeamentos de fatores personalizados (versão preliminar)
Importante
Algumas ou todas estas funcionalidades estão disponíveis como parte de uma versão preliminar. O conteúdo e a funcionalidade estão sujeitos a alterações.
o Microsoft Sustainability Manager usa dados de referência integrados nos mapeamentos de fatores. Você pode estender o conjunto disponível de mapeamentos de fatores com mapeamentos de fatores personalizados. Por exemplo, você pode querer dinamizar seus cálculos de atividade com base em fatores como ano fiscal ou região personalizada. Este artigo orienta você nessa configuração avançada, que deve ser concluída no centro de administração do Power Platform.
Observação
Os procedimentos neste artigo exigem conhecimento avançado no gerenciamento e nas APIs do Microsoft Dataverse. Este artigo não descreve detalhadamente as operações comuns da plataforma. Somente administradores autorizados com acesso total ao centro de administração do Power Platform poderão concluir essas etapas de configuração.
Para estender o Sustainability Manager para usar mapeamentos de fatores personalizados, siga estas etapas:
- Crie dados de referência personalizados
- Fatores vincular para mapeamentos de fatores Sustainability Manager
- vincular Sustainability Manager dados de referência para novos fatores
- Autorizar Sustainability Manager a acessar tabelas externas
- Autorizar usuários a acessar as tabelas
- Teste o vincular entre os dados de referência personalizados e os mapeamentos de fatores
- Use fatores estendidos em modelos de cálculo
Crie dados de referência personalizados
Criar tabela
No Power Apps portal, crie a nova tabela que você deseja usar nos mapeamentos de fatores como dados de referência.
Renomeie a coluna principal como Nome.
O exemplo a seguir mostra uma nova tabela para Região Personalizada.
Em nosso exemplo, também criamos uma tabela de fatores personalizados para Ano Fiscal.
Defina a coluna Nome como uma chave alternativa chamada naturalkey.
Adicionar tabela a Sustainability Manager
Ao adicionar uma nova tabela em Power Apps, você também precisa adicioná-la ao módulo de aplicativo Sustainability Manager.
No Power Apps portal, Select Sustainability Manager.
Em Sustainability Manager tile, Select as reticências (...) e, em seguida, Select ABRIR NO APP DESIGNER.
No designer de aplicativos, Select Dados e depois Select Encontrar nome da tabela.
Select as reticências (...), Select Adicionar ao aplicativo, Select Salvar e então Select Publicar.
A tabela é adicionada a Sustainability Manager e aparece na lista de dados de referência e na navegação.
Se você quiser removê-lo da navegação, Select Páginas no painel de navegação esquerdo. Select a tabela, Select Remover da navegação, Select Salvar e então Select Publicar.
Criar solução para personalizações
Como as entidades padrão estão em um solução gerenciada, você deve criar uma nova solução e importar entidades de atividade e novas entidades de dados de referência personalizadas para ela.
Na página Soluções, selecione Nova solução. Insira as informações para a nova solução e selecione Criar.
Na página Objetos, selecione Adicionar existente e, em seguida, selecione Tabela.
Na página Adicionar tabelas existentes , Select a atividade e as tabelas de dados de referência personalizadas que você criou. Em nosso exemplo, adicionamos a tabela de atividades Energia comprada e a tabela de dados de referência Região personalizada .
Estenda a tabela de atividades com pesquisas
Adicione um novo relacionamento muitos para um da tabela de atividades à tabela de fatores estendidos. Em nosso exemplo, estamos adicionando um relacionamento de muitos para um da tabela de atividades Energia comprada à tabela de dados de referência Região personalizada .
Adicione a tabela de dados de referência personalizada ao aplicativo
Observação
Este é um etapa obrigatório. Mesmo que você não queira incluir a tabela de dados de referência personalizada no menu de navegação, ainda é necessário adicionar a tabela ao aplicativo. Se este etapa for ignorado, os dados de referência não estarão disponíveis na importação do fator mapeamento ou na experiência de entrada manual.
Adicione o objeto Sustainability Manager App à nova solução.
O exemplo a seguir mostra a nova solução e seus recursos.
Select Sustainability Manager, abra-o em modo de edição e depois em Select Novo. Na janela Adicionar página, selecione Tabela do Dataverse .
Selecione Selecionar tabela existente. No painel Select uma tabela , Select cada uma das tabelas de dados de referência personalizadas que você deseja usar para mapeamentos de fatores. Selecione Adicionar.
Observação
Se você não quiser que as tabelas de referência personalizadas apareçam no menu de navegação, desmarque a caixa de seleção Mostrar na navegação .
Em Todas as outras páginas, as novas tabelas personalizadas adicionadas serão exibidas.
Salve e publique suas alterações.
Vincular fatores aos mapeamentos de fatores do Sustainability Manager
Este procedimento requer experiência de desenvolvedor porque ele só está disponível por meio das APIs do Dataverse.
Você deve personalizar pesquisas de várias tabelas para mapeamentos de fatores para suas tabelas personalizadas. Você pode usar a API Web do Power Apps com uma ferramenta como o Insomnia ou seu cliente de API preferido. Para obter informações sobre como enviar solicitações POST autenticadas com o Insomnia, acesse Usar o Insomnia com a API Web do Dataverse.
Para cada tabela personalizada, você deve habilitar mapeamentos de fatores nos cálculos. Em nosso exemplo, precisamos fazer isso para as tabelas Região Personalizada e Ano Fiscal. Você precisa do nome lógico para cada tabela. Por exemplo, o nome lógico de Região Personalizada é cr040_newtable e o nome lógico de Ano Fiscal é cr040_newtable1.
Para cada tabela personalizada, precisamos atualizar cada uma das pesquisas polimórficas usadas para mapeamentos de fatores, uma tabela com o nome lógico msdyn_emissionlookup. Essas pesquisas têm os seguintes nomes lógicos:
- msdyn_referencedataid
- msdyn_referencedata2id
- msdyn_referencedata3id
- msdyn_referencedata4id
Para uma única tabela personalizada, você deve enviar quatro solicitações POST, uma para cada uma das quatro pesquisas usadas nos mapeamentos de fatores. Use uma ferramenta avançada, como o Insomnia ou seu cliente de API preferido para fazer solicitações POST à API RelationshipDefinitions da organização.
No nosso caso, o ponto de extremidade é https://<orgurl>/api/data/v9.2/RelationshipDefinitions. Usamos o seguinte exemplo de conteúdo para cada uma das oito solicitações POST (duas tabelas com quatro solicitações cada):
Observação
"Nome do esquema" deve ser único dentro do seu Dataverse ambiente.
{
"SchemaName": "msdyn_msdyn_emissionlookup_<custom factor table name>",
"@odata.type": "Microsoft.Dynamics.CRM.OneToManyRelationshipMetadata",
"CascadeConfiguration": {
"Assign": "NoCascade",
"Delete": "RemoveLink",
"Merge": "NoCascade",
"Reparent": "NoCascade",
"Share": "NoCascade",
"Unshare": "NoCascade"
},
"ReferencedEntity": "<custom factor table logical name>",
"ReferencingEntity": "msdyn_emissionlookup",
"ReferencingAttribute": "<polymorphic lookup name>",
"Lookup": {
"AttributeType": "Lookup",
"AttributeTypeName": {
"Value": "LookupType"
},
"SchemaName": "<polymorphic lookup name>",
"@odata.type": "Microsoft.Dynamics.CRM.LookupAttributeMetadata"
}
}
A tabela a seguir mostra os valores que usamos para <nome da tabela de fatores personalizados>, <nome lógico da tabela de fatores personalizados> e <nome da pesquisa polimórfica> para nossas oito solicitações POST.
| Solicitar | Nome da tabela de fatores personalizados | Nome lógico da tabela de fatores personalizados | Nome da pesquisa polimórfica |
|---|---|---|---|
| 1 | FiscalYear_RDId | cr040_newtable1 | msdyn_referencedataid |
| 2 | FiscalYear_RDId2 | cr040_newtable1 | msdyn_referencedata2id |
| 3 | FiscalYear_RDId3 | cr040_newtable1 | msdyn_referencedata3id |
| 4 | FiscalYear_RDId4 | cr040_newtable1 | msdyn_referencedata4id |
| 5 | CustomRegion_RDId | cr040_newtable | msdyn_referencedataid |
| 6 | CustomRegion_RDId2 | cr040_newtable | msdyn_referencedata2id |
| 7 | CustomRegion_RDId3 | cr040_newtable | msdyn_referencedata3id |
| 8 | CustomRegion_RDId4 | cr040_newtable | msdyn_referencedata4id |
Uma solicitação POST bem-sucedida fornece uma resposta HTTP 204.
Você pode verificar essas operações inspecionando os relacionamentos da tabela Mapeamento de fatores.
Se quiser exportar suas alterações para um ambiente diferente, você poderá incluir os relacionamentos adicionados anteriormente em uma solução e exportá-los.
Vincular dados de referência do Sustainability Manager a novos fatores
Em Tabelas, selecione a guia Todos e selecione Dados de referência (msdyn_referencedata).
Adicione as seguintes informações para cada novo tipo de fator:
Campo Descrição Nome Nome plural para sua tabela. Por exemplo, Regiões personalizadas ou Anos fiscais. Categoria Dados de referência Nome da entidade Nome lógico da sua tabela, tudo em letras minúsculas (não o nome do esquema da tabela). Por exemplo, cr040_newtable ou cr040_newtable1.
Autorizar o Sustainability Manager a acessar tabelas externas
Se ainda não tiver sido fornecido, o Sustainability Manager precisa ter acesso a tabelas externas para poder usá-las nos cálculos.
Acesse Soluções > Aplicativo Microsoft Sustainability Manager.
Selecione Direitos de acesso e, em seguida, selecione Função do Aplicativo de Serviço do Sustainability – Personalizada. Uma nova guia do navegador é aberta.
Na nova guia do navegador, selecione a guia Entidades Personalizadas.
Para cada uma das tabelas personalizadas que você deseja usar para mapeamentos de fatores, forneça privilégios Ler e Anexar a no nível organizacional.
Observação
Para cada tabela personalizada, você também deve conceder privilégios Leitura em toda a organização a qualquer tabela para a qual ela aponta por meio de uma pesquisa. Por exemplo, se Região Personalizada tiver uma pesquisa na tabela SKU da Contoso, você deverá fornecer privilégios de Leitura para a tabela SKU da Contoso.
Salve e feche.
Autorizar usuários a acessar as tabelas
Para cada tabela personalizada, como Regiões Personalizadas ou Ano Fiscal, certifique-se de que o usuário do Power Apps que ingere mapeamentos de fatores ou executa cálculos tenha os seguintes privilégios em toda a organização para a tabela:
Acrescentar a para ingestão
Ler para criar mapeamentos de fatores ou usar mapeamentos de fatores em um cálculo que usa uma tabela personalizada
Teste o vincular entre os dados de referência personalizados e os mapeamentos de fatores
Garanta que todas as personalizações sejam publicadas no Power Apps portal.
Preencha as tabelas de dados de referência personalizadas (Regiões personalizadas e ano fiscal em nosso exemplo).
Importe ou insira os mapeamentos de fatores com Sustainability Manager ou no portal. Power Apps
Importe ou insira os dados da atividade com Sustainability Manager.
A imagem a seguir mostra um exemplo de uma biblioteca de fatores chamada Biblioteca de Fatores Estendidos contendo mapeamentos que usam dados de referência personalizados (Regiões Personalizadas e ano fiscal).
Usar fatores estendidos em modelos de cálculo
No portal do Power Apps, crie o modelo de cálculo e use-o no perfil de cálculo.
Observação
Você pode usar a filtragem no perfil de cálculo para garantir que a pesquisa tenha um valor.
Você pode usar atributos estendidos no perfil de cálculo conforme necessário.
Perguntas frequentes
Quando crio um novo fator mapeamento manualmente, não vejo minha tabela personalizada como uma opção para dados de referência
Certifique-se de que o usuário tenha os privilégios adequados para a tabela personalizada.
Certifique-se de que a tabela personalizada tenha pelo menos um registro.
Certifique-se de ter adicionado o nome do esquema (com distinção entre maiúsculas e minúsculas) da sua tabela personalizada em msdyn_referencedata.
Certifique-se de que a tabela personalizada seja adicionada ao objeto Sustainability Manager App conforme descrito anteriormente neste artigo.
Atualize a página com força no seu navegador.
Quando importo mapeamentos de fatores, não vejo minha tabela de dados de referência personalizada como uma opção no campo mapeamento experience
Certifique-se de que o usuário tenha os privilégios adequados para a tabela personalizada.
Certifique-se de ter adicionado o nome do esquema (com distinção entre maiúsculas e minúsculas) da sua tabela personalizada em msdyn_referencedata.
Certifique-se de que a tabela personalizada seja adicionada ao objeto Sustainability Manager App conforme descrito anteriormente neste artigo.
Atualize a página com força no seu navegador.
Os registros de tabelas personalizadas são considerados "aprovados" ou "pendentes" para fins de aprovação de dados?
Todos os registros de tabelas personalizadas são considerados "aprovados" para fins de aprovação de dados no contexto de mapeamentos de fatores para cálculos.
Minha importação de mapeamentos de fatores falhou com um privilégio ausente prvAppendTo_[sua tabela personalizada] para um usuário
O usuário do aplicativo Sustainability Manager ou o usuário atual não recebeu o privilégio Anexar a para a tabela personalizada. Certifique-se de que tanto o Sustainability Manager quanto o usuário tenham os privilégios apropriados e tente importar novamente.
No modelo de cálculo, não vejo minha tabela personalizada como uma opção na seção Mapeamentos de fatores do Fator de emissão do nó Relatório ou na lista suspensa Fator de estimativa do nó Fator de estimativa
Certifique-se de ter adicionado o registro msdyn_referencedata à sua tabela personalizada.
Verifique se o valor de Nome da entidade no registro msdyn_referencedata da sua tabela personalizada tem o nome lógico da sua tabela (diferencia maiúsculas de minúsculas), e não o nome do esquema. Acesse Tabela > Propriedades, expanda Opções avançadas e exiba o nome lógico.
Certifique-se de que os dados de atividade da origem do cálculo tenham um campo de pesquisa que aponte para sua tabela personalizada. Por exemplo, se você personalizou Combustão estacionária para ter uma pesquisa para Região Personalizada, mas não personalizou Combustão móvel, os cálculos de Combustão móvel não poderão usar mapeamentos de fatores com base na região da Contoso.
Personalizar vários ambientes
Talvez seja necessário fazer essas personalizações em um ambiente e depois aplicá-las a outro. Por exemplo, você pode fazer todas as suas personalizações em um ambiente de desenvolvimento e depois precisar importá-las para seu ambiente de produção. Nesse caso, você poderá seguir essas etapas para minimizar o trabalho em dobro.
Em qualquer solução usada para exportar alterações de um ambiente para outro, você deve incluir estas personalizações nessa solução:
As adições de suas tabelas personalizadas ao Sustainability Manager.
As adições de mais relacionamentos às pesquisas polimórficas dos mapeamentos de fatores.
Em seguida, você poderá importar a solução para o gerenciamento do ciclo de vida de aplicativos (ALM).
Execute as seguintes ações por ambiente:
Adicione os registros msdyn_referencedata.
Personalize o direito de acesso do aplicativo Sustainability Manager.
