Mapeamentos de fatores personalizados (pré-visualização)
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.
O Microsoft Sustainability Manager utiliza dados de referência incorporados em mapeamentos de fatores. Pode expandir o conjunto disponível de mapeamentos fatores com mapeamentos de fatores personalizados. Por exemplo, pode pretender criar pivôs dos seus cálculos de atividades com base em fatores como a ano fiscal ou a região personalizada. Este artigo orienta-o através desta configuração avançada, que tem de concluir no centro de administração do Power Platform.
Nota
Os procedimentos neste artigo requerem conhecimentos avançados de gestão do Microsoft Dataverse e APIs. Este artigo não descreve em detalhe operações de plataforma comuns. Apenas administradores autorizados com acesso completo ao centro de administração do Power Platform podem concluir estes passos de configuração.
Para expandir o Sustainability Manager para utilizar mapeamentos de fatores personalizados, siga estes passos:
- Criar tabelas de fatores estendidas
- Vincular fatores a mapeamentos de fatores do Sustainability Manager
- Vincule os dados de referência do Sustainability Manager a novos fatores
- Autorizar o Sustainability Manager a acessar tabelas externas
- Autorizar os usuários a acessar as tabelas
- Preencher tabelas com fatores estendidos
- Usar fatores estendidos em modelos de cálculo
Criar tabelas de fatores expandidas
Criar tipos de mapeamentos de fatores personalizados
No portal do Power Apps, crie novas tabelas para especificar opções de mapeamentos de fatores.
Mude o nome da coluna primária para Nome.
O exemplo que se segue mostra uma nova tabela para Região Personalizada.
No nosso exemplo, também criámos uma nova tabela de fatores personalizados para Ano Fiscal.
Defina a coluna Nome como uma chave alternativa chamada naturalkey.
Criar tabela de fatores personalizado
Uma vez que as entidades predefinidas estão num solução gerida, tem de criar uma nova solução e importar atividades e novas entidades de fator personalizadas para ela.
Na página Soluções, selecione Nova solução. Introduza as informações para a sua solução nova e, em seguida, selecione Criar.
Na página Objetos, selecione Adicionar existente e, em seguida, selecione Tabela.
Na página Adicionar tabelas existentes, selecione a atividade e as tabelas de fator expandidas que criou. No nosso exemplo, criámos uma tabela de atividade Energia comprada e uma tabela de fatores expandida Região Personalizada.
Expandir a tabela de atividades com procuras
Adicione uma nova relação muitos para um a partir da tabela de atividades à tabela de fatores expandida. No nosso exemplo, estamos a adicionar uma relação muitos para um a partir da tabela de atividades Energia comprada para a tabela de fatores Região Personalizada expandida.
Adicione o Sustainability Manager à solução nova e adicione as entidades de fator personalizadas à aplicação condicionada por modelo para as disponibilizar para o Sustainability Manager.
O exemplo que se segue mostra a solução nova e os respetivos recursos.
Selecione o Sustainability Manager e, em seguida, selecione Novo. Na janela Adicionar página, selecione Tabela do Dataverse.
Selecione Selecionar tabela existente. No painel Selecionar uma tabela, selecione cada uma das tabelas personalizadas que pretende utilizar para mapeamentos de fatores. Desmarque a caixa de verificação Mostrar na navegação. Selecione Adicionar.
Em Todas as outras páginas, aparecem as novas tabelas personalizadas adicionadas.
Guarde e publique as alterações.
Ligar fatores a mapeamentos de fatores do Sustainability Manager
Este procedimento requer conhecimentos de programador, pois só está disponível através de APIs do Dataverse.
Necessita de personalizar procuras com várias tabelas para mapeamentos de fatores para as suas tabelas personalizadas. Pode usar a API Web do Power Apps com uma ferramenta, como o Insomnia, ou o seu cliente de API preferido. Para informações sobre como enviar pedidos POST autenticados com o Insomnia, aceda a Utilizar o Insomnia com a API Web do Dataverse.
Para cada tabela personalizada, tem de ativar mapeamentos de fatores em cálculos. No nosso exemplo, temos de o fazer para as tabelas Região Personalizada e Ano Fiscal. Necessita do nome lógico para cada tabela. Por exemplo, o nome lógico para Região Personalizada é cr040_newtable e o nome lógico de Ano Fiscal é cr040_newtable1.
Para cada tabela personalizada, precisamos de atualizar cada uma das procuras polimórficas utilizadas para mapeamentos de fatores, uma tabela com o nome lógico msdyn_emissionlookup. Estas procuras têm os seguintes nomes lógicos:
- msdyn_referencedataid
- msdyn_referencedata2id
- msdyn_referencedata3id
- msdyn_referencedata4id
Para uma única tabela personalizada, necessita de enviar quatro pedidos POST, um para cada uma das quatro procuras utilizadas nos mapeamentos de fatores. Utilize uma ferramenta avançada, como o Insomnia, ou o seu cliente de API preferido, para fazer os pedidos POST à API RelationshipDefinitions da sua organização.
No nosso caso, o ponto final é https://<orgurl>/api/data/v9.2/RelationshipDefinitions. Utilizamos o seguinte payload de exemplo para cada um dos oito pedidos POST (duas tabelas com quatro pedidos cada):
Nota
"SchemaName" deve ser exclusivo em 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 seguinte mostra os valores que utilizámos para o <nome da tabela de fatores personalizada>, <nome lógico da tabela de fatores personalizada> e <nome da procura polimórfica> para os nossos oito pedidos POST.
| Pedir | Nome da tabela de fatores personalizada | Nome lógica da tabela de fatores personalizada | Nome da procura 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 |
Um pedido POST bem-sucedido dá-lhe uma resposta HTTP 204.
Pode verificar estas operações ao inspecionar as relações da tabela Mapeamento de fatores.
Se pretende exportar as suas alterações para outro ambiente, pode incluir as relações que adicionou anteriormente numa solução e exportá-la.
Ligar dados de referência do Sustainability Manager a novos fatores
Em Tabelas, selecione o separador Todos e, em seguida, selecione Dados de referência (msdyn_referencedata).
Adicione as seguintes informações para cada tipo de fator:
Campo Descrição Nome Nome plural para a tabela. Por exemplo, Regiões personalizadas ou Anos fiscais. Categoria Dados de referência Nome da entidade Nome lógico da tabela, tudo em letra minúscula (não o nome de esquema da tabela). Por exemplo, cr040_newtable ou cr040_newtable1.
Autorizar o Sustainability Manager para aceder a tabelas externas
Se ainda não tiver sido fornecido, é necessário conceder acesso ao Sustainability Manager para aceder a tabelas externas, para que possa utilizá-las em cálculos.
Aceda a Soluções > Aplicação Microsoft Sustainability Manager.
Selecione Direitos de acesso e, em seguida, selecione Função da Aplicação do Serviço de Sustentabilidade — Personalizado. Abre-se um novo separador do browser.
No novo separador do browser, selecione o separador Entidades Personalizadas.
Para cada uma das tabelas personalizadas que pretende utilizar para mapeamentos de fatores, forneça os privilégios de Ler e Anexar A ao nível organizacional.
Nota
Para cada tabela personalizada, também tem de conceder privilégios de Ler ao nível da organização a qualquer tabela a que esta aponta através de uma procura. Por exemplo, se Região Personalizada tiver uma procura para a tabela SKU Contoso, tem de conceder privilégios de Ler à tabela SKU Contoso.
Guarde e feche.
Autorizar os utilizadores a aceder a tabelas
Para cada tabela personalizada, como Regiões Personalizadas ou Ano Fiscal, certifique-se de que o utilizador do Power Apps que ingere mapeamentos de fatores ou que executa cálculos tem os seguintes privilégios para a tabela ao nível da organização:
Anexar para ingestão
Leia para criar mapeamentos de fatores ou usar mapeamentos de fatores em um cálculo que usa uma tabela personalizada
Preencher tabelas com fatores expandidos
Publicar todas as personalizações no portal do Power Apps.
Importe os tipos de fator para as novas tabelas (Regiões Personalizadas e Ano Fiscal no nosso exemplo) no portal do Power Apps.
Importar fatores de emissão com o Sustainability Manager ou o portal do Power Apps.
Importar mapeamentos de fatores com o Sustainability Manager ou o portal do Power Apps.
Importar dados de atividade com o Sustainability Manager.
Mapeie os mapeamentos de fator personalizados no Sustainability Manager.
A Biblioteca de Fatores Expandida tem agora os novos fatores de emissão e os mapeamentos de fatores expandidos personalizados.
Utilizar fatores expandidos em modelos de cálculo
No portal do Power Apps, conceba o modelo de cálculo e utilize-o no perfil de cálculo.
Nota
Pode utilizar a filtragem no perfil de cálculo para se certificar de que a procura tem um valor.
Pode utilizar atributos expandidos no perfil de cálculo, conforme necessário.
FAQ
Os registos de tabelas personalizadas são considerados como "aprovados" ou "pendentes" para efeitos de aprovação de dados?
Todos os dados para tabelas personalizadas são considerados como "aprovados" para efeitos de aprovação de dados no contexto de mapeamentos de fatores para cálculos.
A minha importação de mapeamentos de fatores falhou com a informação que há um privilégio prvAppendTo_[a sua tabela personalizada] em falta para um utilizador
O utilizador da aplicação Sustainability Manager ou o utilizador atual não recebeu o privilégio de Anexar A para a tabela personalizada. Certifique-se de que o Sustainability Manager e o utilizador têm os privilégios apropriados e, em seguida, tente novamente a importação.
No modelo de cálculo, não vejo a minha tabela personalizada como uma opção na secção Mapeamentos de fatores da lista pendente Fator de emissão do nó do Relatório ou Fator de estimativa do nó do Fator de Estimativa
Certifique-se de que adicionou o registo msdyn_referencedata à tabela personalizada.
Certifique-se de que o valor do Nome da entidade no msdyn_referencedata da tabela personalizada tem o nome lógico da tabela (sensível às maiúsculas e minúsculas), não o nome de esquema. Aceda a Tabela > Propriedades, expanda Opções avançadas e veja o nome lógico.
Certifique-se de que os dados de atividade para a origem do cálculo têm um campo de procura que aponta para a tabela personalizada. Por exemplo, se personalizou Combustão estacionária para ter uma procura para Região Personalizada, mas não a Combustão móvel, os cálculos da Combustão móvel não poderão utilizar mapeamentos de fatores baseados na região da Contoso.
Quando crio mapeamentos de fatores manualmente, não vejo a minha tabela personalizada como uma opção para os Dados de referência
Certifique-se de que o utilizador tem privilégios adequados para a tabela personalizada.
Certifique-se de que a tabela personalizada tem, pelo menos, um registo.
Recarregue a página.
Personalizar vários ambientes
Poderá precisar de efetuar estas personalizações num ambiente e, em seguida, aplicá-las a outro. Por exemplo, poderá fazer todas as suas personalizações num ambiente de programação e, em seguida, precisar de as importar para o ambiente de produção. Neste caso, pode seguir estes passos para minimizar o trabalho de duplicação.
Para qualquer solução utilizada para exportar alterações de um ambiente para outro, tem de incluir estas personalizações nessa solução:
As adições das suas tabelas personalizadas ao Sustainability Manager.
As adições de mais relações às procuras polimórficas dos mapeamentos de fatores.
Em seguida, pode importar a solução para gestão do ciclo de vida das aplicações (ALM).
Numa base por ambiente, efetue as seguintes ações:
Adicione os registos msdyn_referencedata.
Personalize a direito de acesso da aplicação Sustainability Manager.
