Mapeamentos de fatores personalizados (versão preliminar)

Inscrição em avaliação conduzida pelo administrador

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:

• Criar dados de referência personalizados
• Vincular fatores aos mapeamentos de fatores do Sustainability Manager
• Vincular dados de referência do Sustainability Manager a novos fatores
• Autorizar o Sustainability Manager a acessar tabelas externas
• Autorizar usuários a acessar as tabelas
• Testar o link entre os dados de referência personalizados e os mapeamentos de fator
• Usar fatores estendidos em modelos de cálculo

Criar dados de referência personalizados

Criar tabela

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

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

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

   

Adicionar tabela ao Sustainability Manager

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

1. No portal Power Apps, selecione Sustainability Manager.

2. No bloco Sustainability Manager, selecione as reticências (...) e, depois, selecione ABRIR NO DESIGNER DE APLICATIVO.

   

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

4. Selecione as reticências (...), selecione Adicionar ao aplicativo, selecione Salvar, e selecione Publicar.

   

A tabela é adicionada ao 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 Salvar, e em seguida, selecione Publicar.

Criar solução para personalizações

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

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

   

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

   

3. Na página Adicionar tabelas , selecione 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

1. 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 a partir da tabela de atividades Energia comprada da tabela de dados de referência Região personalizada.

   

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

Observação

Essa é uma etapa obrigató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 essa etapa for ignorada, os dados de referência não estarão disponíveis na importação do mapeamento de fatores ou na experiência de entrada manual.

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

   

   O exemplo a seguir mostra a nova solução e seus recursos.

   

2. Selecione Sustainability Manager, abra-o no modo de edição e selecione Novo. Na janela Adicionar página, selecione a 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 fator. Selecionar Adicionar.

   Observação

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

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

"SchemaName" deve ser único dentro do seu ambiente do Dataverse.

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

1. Em Tabelas, selecione a guia Todos e selecione Dados de referência (msdyn_referencedata).

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

1. Acesse Soluções > Aplicativo Microsoft Sustainability Manager.

2. Selecione Direitos de acesso e, em seguida, selecione Função do Aplicativo de Serviço do Sustainability – Personalizada. Uma nova guia do navegador é aberta.

3. Na nova guia do navegador, selecione a guia Entidades Personalizadas.

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

5. 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 a criação de mapeamentos de fatores ou uso de mapeamentos de fatores em um cálculo que use uma tabela personalizada

Testar o link entre os dados de referência personalizados e os mapeamentos de fator

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

2. Preencha as tabelas de dados de referência personalizadas (Regiões Personalizadas e Ano Fiscal em nosso exemplo).

   

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

   

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

A imagem a seguir mostra um exemplo de uma biblioteca de fatores chamada Biblioteca de Fatores Estendida que contém 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.

FAQs

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

1. Certifique-se de que o usuário tenha os privilégios adequados para a tabela personalizada.

2. Certifique-se de que a tabela personalizada tenha pelo menos um registro.

3. Certifique-se de ter adicionado o nome do esquema (sensível a maiúsculas e minúsculas) de sua tabela personalizada em msdyn_referencedata.

4. Certifique-se de que a tabela personalizada seja adicionada ao aplicativo Sustainability Manager 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 na experiência de mapeamento de campo

1. Certifique-se de que o usuário tenha os privilégios adequados para a tabela personalizada.

2. Certifique-se de ter adicionado o nome do esquema (sensível a maiúsculas e minúsculas) de sua tabela personalizada em msdyn_referencedata.

3. Certifique-se de que a tabela personalizada seja adicionada ao aplicativo Sustainability Manager conforme descrito anteriormente neste artigo.

4. Atualize a página a partir do 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.

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

2. Execute as seguintes ações por ambiente:

   • Adicione os registros msdyn_referencedata.

   • Personalize o direito de acesso do aplicativo Sustainability Manager.