Mapeamentos de fatores personalizados (pré-visualização)

Versão experimental gratuita

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 dados de referência personalizados
• Vincular fatores a mapeamentos de fatores Sustainability Manager
• Vincular os dados de referência Sustainability Manager a novos fatores
• Autorizar Sustainability Manager a acessar tabelas externas
• Autorizar os usuários a acessar as tabelas
• Testar o vínculo entre os dados de referência personalizados e os mapeamentos de fatores
• Usar fatores estendidos em modelos de cálculo

Criar dados de referência personalizados

Criar nova tabela

1. Power Apps No portal, crie a nova tabela que você deseja usar em mapeamentos de fatores como dados de referência.

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

3. Defina a coluna Nome como uma chave alternativa chamada naturalkey.

   

Adicionar tabela a Sustainability Manager

Ao adicionar uma nova tabela Power Apps, você também precisa adicioná-la ao módulo do aplicativo Sustainability Manager.

1. Power Apps No portal, selecione Sustainability Manager.

2. No mosaico Sustainability Manager , selecione as reticências (...) e, em seguida, selecione ABRIR NO APP DESIGNER.

   

3. No designer de aplicativo, selecione Dados e, em seguida, selecione Localizar nome da tabela.

4. Selecione as reticências (...), selecione Adicionar à aplicação, selecione Guardar e, em seguida, selecione Publicar.

   

A tabela é adicionada a Sustainability Manager e aparece na lista de dados de referência e na navegação.

Se quiser removê-lo da navegação, selecione Páginas no painel de navegação esquerdo. Selecione a tabela, selecione Remover da navegação, selecione Guardar e, em seguida, selecione Publicar.

Criar solução para personalizações

Como as entidades padrão estão em um solução gerida, você deve criar uma nova solução e importar entidades de atividade e novas entidades de dados de referência personalizadas para ela.

1. Na página Soluções, selecione Nova solução. Introduza as informações para a sua solução nova e, em seguida, selecione Criar.

   

2. Na página Objetos, selecione Adicionar existente e, em seguida, selecione Tabela.

   

3. Na página Adicionar tabelas existentes, selecione a atividade e as tabelas de dados de referência personalizadas que você criou. Em nosso exemplo, adicionamos a tabela Atividade de energia comprada e a tabela de dados de referência de região personalizada.

   

   

Expandir a tabela de atividades com procuras

1. Adicione uma nova relação muitos para um a partir da tabela de atividades à tabela de fatores expandida. Em nosso exemplo, estamos a adicionar uma relação muitos-para-um da tabela Atividade de energia comprada à tabela de dados de referência de região personalizada.

   

Adicionar a tabela de dados de referência personalizada ao aplicativo

Nota

Esta é uma passo necessária. 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 esse passo for ignorado, os dados de referência não estarão disponíveis no fator mapeamento importação ou na experiência de entrada manual.

1. Adicione o objeto Sustainability Manager App à nova solução.

   

   O exemplo que se segue mostra a solução nova e os respetivos recursos.

   

2. Selecione Sustainability Manager, abra-o no modo de edição e, em seguida, selecione Novo. Na janela Adicionar página, selecione Tabela do Dataverse.

   

3. Selecione Selecionar tabela existente. No painel Selecionar uma tabela , selecione cada uma das tabelas de dados de referência personalizadas que deseja usar para mapeamentos de fatores. Selecione Adicionar.

   Nota

   Se não quiser que as tabelas de referência personalizadas apareçam no menu de navegação, desmarque a caixa de verificação Mostrar na navegação .

   

   Em Todas as outras páginas, aparecem as novas tabelas personalizadas adicionadas.

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

1. Em Tabelas, selecione o separador Todos e, em seguida, selecione Dados de referência (msdyn_referencedata).

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

1. Aceda a Soluções > Aplicação Microsoft Sustainability Manager.

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

3. No novo separador do browser, selecione o separador Entidades Personalizadas.

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

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

Testar o vínculo entre os dados de referência personalizados e os mapeamentos de fatores

1. Certifique-se de que todas as personalizações sejam publicadas no Power Apps portal.

2. Preencha as tabelas de dados de referência personalizadas (Regiões personalizadas e ano fiscal no nosso exemplo).

   

3. Importe ou insira os mapeamentos de fatores com Sustainability Manager ou o Power Apps portal.

   

4. Importe ou insira os dados da atividade com Sustainability Manager.

A imagem a seguir mostra um exemplo de um biblioteca de fatores chamado Biblioteca de Fatores Estendidos contendo mapeamentos que usam dados de referência personalizados (Regiões Personalizadas e ano fiscal).

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

Quando crio um novo fator mapeamento manualmente, não vejo minha tabela personalizada como uma opção para dados de referência

1. Certifique-se de que o utilizador tem privilégios adequados para a tabela personalizada.

2. Certifique-se de que a tabela personalizada tem, pelo menos, um registo.

3. Certifique-se de que adicionou o nome do esquema (diferencia maiúsculas de minúsculas) da sua tabela personalizada no msdyn_referencedata.

4. Certifique-se de que a tabela personalizada é adicionada ao objeto Sustainability Manager App conforme descrito anteriormente neste artigo.

5. Atualize a página a partir do 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 experiência

1. Certifique-se de que o utilizador tem privilégios adequados para a tabela personalizada.

2. Certifique-se de que adicionou o nome do esquema (diferencia maiúsculas de minúsculas) da sua tabela personalizada no msdyn_referencedata.

3. Certifique-se de que a tabela personalizada é adicionada ao objeto Sustainability Manager App conforme descrito anteriormente neste artigo.

4. Atualize a página a partir do seu navegador.

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.

Minha importação de mapeamentos de fatores falhou com um privilégio ausente prvAppendTo_[sua tabela personalizada] para um utente

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.

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.

1. 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).

2. Numa base por ambiente, efetue as seguintes ações:

   • Adicione os registos msdyn_referencedata.

   • Personalize a direito de acesso da aplicação Sustainability Manager.

📄
🎓 Página do produto Formação

✅ Canal de avaliação
🎥 YouTube gratuita

💻 Grupo Comunidade
LinkedIn