Mappature dei fattori personalizzati (anteprima)

Importante

Alcune o tutte queste funzionalità sono disponibili come parte di una versione di anteprima. Il contenuto e la funzionalità sono soggetti a modifiche. Le funzionalità di anteprima non sono destinate all'uso in produzione e potrebbero avere funzionalità limitate. Queste funzionalità sono soggette a condizioni per l'utilizzo supplementari e sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso in anteprima e fornire feedback.

Microsoft Dynamics 365 Sustainability usa i dati di riferimento predefiniti nei mapping dei fattori. Puoi estendere il set di mappature dei fattori disponibili con mappature dei fattori personalizzati. Ad esempio, potresti voler ruotare i calcoli delle tue attività in base a fattori come anno fiscale o area personalizzata. Questo articolo ti guida attraverso la configurazione avanzata, che devi completare nell'interfaccia di amministrazione di Power Platform.

Note

Le procedure descritte in questo articolo richiedono competenze avanzate nella gestione e nelle API di Microsoft Dataverse. Questo articolo non descrive in dettaglio le operazioni comuni della piattaforma. Solo gli amministratori autorizzati con accesso completo all'interfaccia di amministrazione di Power Platform possono completare questi passaggi di configurazione.

Per estendere Dynamics 365 Sostenibilità per usare mapping dei fattori personalizzati, seguire questa procedura:

Creare dati di riferimento personalizzati

Crea nuova tabella

  1. Nel portale Power Apps , crea la nuova tabella che desideri utilizzare nei mapping dei fattori come dati di riferimento.

  2. Rinomina la colonna primaria in Nome.

    L'esempio seguente mostra una nuova tabella per Area personalizzata.

    Screenshot di una nuova tabella denominata Area personalizzata.

    Nell'esempio viene creata anche una nuova tabella dei fattori personalizzati per Fiscal Year.

  3. Imposta la colonna Nome come un chiave alternativa denominata naturalkey.

    Screenshot dell'impostazione della colonna Nome come chiave naturale.

Aggiungere una tabella a Dynamics 365 Sustainability

Quando si aggiunge una nuova tabella in Power Apps, aggiungerla anche al modulo app Dynamics 365 Sustainability.

  1. Nel portale di Power Apps selezionare Dynamics 365 Sustainability.

  2. Nel riquadro Dynamics 365 Sustainability seleziona i puntini di sospensione (...) e quindi APRI IN PROGETTAZIONE APP.

    Screenshot dell'apertura dell'app in progettazione app.

  3. In progettazione app seleziona Dati, quindi seleziona Trova nome tabella.

  4. Seleziona i puntini di sospensione (...), seleziona Aggiungi all'app, seleziona Salva e quindi seleziona Pubblica.

    Screenshot per aggiungere la tabella all'app.

La tabella viene aggiunta a Dynamics 365 Sustainability e viene visualizzata nell'elenco dei dati di riferimento e nel riquadro di spostamento.

Per rimuovere la tabella dal riquadro di spostamento, selezionare Pagine nel riquadro di spostamento a sinistra. Seleziona la tabella, seleziona Rimuovi dallo spostamento, seleziona Salva e quindi seleziona Pubblica.

Screenshot della rimozione della tabella dal riquadro di spostamento.

Creare una soluzione per le personalizzazioni

Poiché le entità predefinite si trovano in una soluzione gestita, devi creare una nuova soluzione e importarvi le entità attività e le nuove entità dati di riferimento personalizzate.

  1. Nella pagina Soluzioni, seleziona Nuova soluzione. Immetti le informazioni per la nuova soluzione e quindi seleziona Crea.

    Screenshot della creazione di una nuova soluzione

  2. Nella pagina Oggetti seleziona Aggiungi esistente e quindi seleziona Tabella.

    Screenshot dell'aggiunta di tabelle alla nuova soluzione.

  3. Nella pagina Aggiungi tabelle esistenti seleziona l'attività e le tabelle di dati di riferimento personalizzati che hai creato. Nell'esempio, l'utente aggiunge la tabella attività di Energia Acquistata e la tabella dei dati di riferimento per Area Personalizzata.

    Screenshot dell'aggiunta della tabella Energia acquistata alla nuova soluzione.

    Screenshot dell'aggiunta della tabella Regione Personalizzata alla nuova soluzione.

Estendere la tabella delle attività con consultazioni

  1. Aggiungi una nuova associazione molti-a-uno dalla tabella delle attività alla tabella dei fattori estesi. Nell'esempio, aggiungiamo una relazione molti a uno dalla tabella dell'attività Energia acquistata alla tabella dei dati di riferimento Area personalizzata.

    Screenshot dell'aggiunta di una relazione molti-a-uno.

Aggiungere la tabella dei dati di riferimento personalizzati all'app

Note

Questo passaggio è obbligatorio. Anche se non si vuole includere la tabella dei dati di riferimento personalizzata nel menu di spostamento, è comunque necessario aggiungere la tabella all'app. Se si ignora questo passaggio, i dati di riferimento non sono disponibili nell'esperienza di importazione o immissione manuale del mapping dei fattori.

  1. Aggiungere l'oggetto Dynamics 365 Sustainability App alla nuova soluzione.

    Screenshot dell'aggiunta di Dynamics 365 Sustainability.

    L'esempio seguente mostra la nuova soluzione e le relative risorse.

    Screenshot della soluzione e delle relative risorse.

  2. Selezionare Dynamics 365 Sustainability, aprirla in modalità di modifica e quindi selezionare New. Nella finestra Aggiungi pagina, seleziona Tabella Dataverse.

    Screenshot dell'aggiunta di una tabella Dataverse.

  3. Seleziona Seleziona tabella esistente. Nel riquadro Seleziona una tabella, seleziona ciascuna delle tabelle di dati di riferimento personalizzati che desideri utilizzare per i mapping dei fattori. Selezionare Aggiungi.

    Note

    Se non vuoi che le tabelle di riferimento personalizzate siano visualizzate nel menu di spostamento, deseleziona la casella di controllo Mostra in spostamento.

    Screenshot dell'aggiunta di tabelle Dataverse per ciascuna tabella di fattori personalizzati.

    In Tutte le altre pagine vengono visualizzate le tabelle personalizzate appena aggiunte.

  4. Salva e pubblica le modifiche.

Questa procedura richiede competenze da sviluppatore perché è disponibile solo tramite API Dataverse.

È necessario personalizzare le ricerche in tabelle multiple per le mappature dei fattori nelle tabelle personalizzate. Puoi utilizzare l'API Web Power Apps con uno strumento come Insomnia o il tuo client API preferito. Per informazioni sull'invio di richieste POST autenticate tramite insonnia, vedere Use Insomnia with Dataverse Web API (Usare insonnia con l'API Web Dataverse).

Per ogni tabella personalizzata, devi abilitare le mappature dei fattori nei calcoli. In questo esempio abilitare i mapping dei fattori per le tabelle Area personalizzata e Anno fiscale . È necessario il nome logico per ciascuna tabella. Ad esempio, il nome logico di Area personalizzata è cr040_newtable e il nome logico di Anno fiscale è cr040_newtable1.

Per ogni tabella personalizzata, aggiorniamo ciascuna delle ricerche polimorfiche utilizzate per i mapping dei fattori, una tabella con il nome logico msdyn_emissionlookup. Queste ricerche hanno i seguenti nomi logici:

  • msdyn_referencedataid
  • msdyn_referencedata2id
  • msdyn_referencedata3id
  • msdyn_referencedata4id

Per una singola tabella personalizzata, inviare quattro richieste POST, una per ognuna delle quattro ricerche usate nei mapping dei fattori. Utilizza uno strumento avanzato come Insomnia o il tuo client API preferito per effettuare le richieste POST all'API RelationshipDefinitions della tua organizzazione.

In questo caso, l'endpoint è https://<orgurl>/api/data/v9.2/RelationshipDefinitions. Il payload di esempio seguente è per ognuna delle otto richieste POST (due tabelle con quattro richieste ognuna):

Note

"SchemaName" deve essere univoco nell'ambiente 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"
  }
}

La tabella seguente illustra i valori usati per <il nome> della tabella dei fattori personalizzata, <il nome logico della tabella dei fattori personalizzati e il nome><della ricerca polimorfica per le otto richieste POST.>

Richiesta Nome tabella di fattori personalizzati Nome logico della tabella dei fattori personalizzati Nome ricerca polimorfica
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

Una richiesta POST riuscita restituisce una risposta HTTP 204.

Puoi verificare queste operazioni controllando le relazioni della tabella Mapping dei fattori.

Screenshot delle relazioni nella tabella mapping dei fattori.

Se si desidera esportare le modifiche in un ambiente diverso, includere le relazioni aggiunte in precedenza in una soluzione ed esportarla.

  1. In Tabelle seleziona la scheda Tutte, quindi seleziona Dati di riferimento (msdyn_referencedata).

  2. Aggiungi le informazioni seguenti per ogni nuovo tipo di fattore:

    Campo Description
    Name Nome plurale della tua tabella. Ad esempio, Aree personalizzate o Anni fiscali.
    Category Dati di riferimento
    Nome entità Nome logico della tabella, tutto in minuscolo (non il nome dello schema della tabella). Ad esempio, cr040_newtable o cr040_newtable1.

Autorizzare Dynamics 365 Sustainability ad accedere a tabelle esterne

Se non è già stato specificato, concedere a Dynamics 365 Sustainability l'accesso alle tabelle esterne in modo da poterle usare nei calcoli.

  1. Vai a Soluzioni > Applicazione Microsoft Dynamics 365 Sustainability.

  2. Seleziona Ruoli di sicurezza, quindi seleziona Ruolo applicazione servizio di sostenibilità - Personalizzato. Si apre una nuova scheda del browser.

  3. Nella nuova scheda del browser seleziona la scheda Entità personalizzate.

  4. Per ogni tabella personalizzata che si vuole usare per i mapping dei fattori, specificare i privilegi Lettura e Accodamento a a livello di organizzazione.

    Note

    Per ogni tabella personalizzata, devi anche concedere privilegi Lettura a livello di tutta l'organizzazione a qualsiasi tabella a cui punta tramite una ricerca. Ad esempio, se Area personalizzata ha una ricerca nella tabella SKU Contoso, devi fornire privilegi Lettura alla tabella SKU Contoso.

  5. Salva e chiudi.

Autorizzare gli utenti ad accedere alle tabelle

Per ogni tabella personalizzata, come Aree personalizzate o Anno fiscale, assicurati che l'utente Power Apps che inserisce mappature dei fattori o esegue calcoli abbia i seguenti privilegi a livello di organizzazione per la tabella:

  • Aggiungi a per l'inserimento

  • Lettura per creare mappature dei fattori o utilizzare mappature dei fattori in un calcolo che utilizza una tabella personalizzata

  1. Assicurati che tutte le personalizzazioni siano pubblicate nel portale Power Apps.

  2. Popola le tabelle dei dati di riferimento personalizzati (Aree personalizzate e Anno fiscale nell'esempio).

    Screenshot della tabella Anno fiscale con valori.

  3. Importare o immettere i mapping dei fattori con Dynamics 365 Sostenibilità o il portale di Power Apps.

    Screenshot della mappatura dei fattori personalizzati.

  4. Importare o immettere i dati dell'attività con Dynamics 365 Sustainability.

L'immagine seguente mostra un esempio di una raccolta di fattori denominata Raccolta di fattori estesa contenente mapping che utilizzano dati di riferimento personalizzati (Aree personalizzate e Anno fiscale).

Screenshot della raccolta di fattori estesi.

Utilizzare fattori estesi nei modelli di calcolo

Nel portale Power Apps, progetta il modello di calcolo e utilizzalo nel profilo di calcolo.

Screenshot della progettazione di un modello di calcolo.

Note

Usare il filtro nel profilo di calcolo per assicurarsi che la ricerca abbia un valore.

Usare gli attributi estesi nel profilo di calcolo in base alle esigenze.

Screenshot dell'utilizzo di attributi estesi.

FAQs

Quando si crea manualmente un nuovo mapping dei fattori, perché non viene visualizzata la tabella personalizzata come opzione per i dati di riferimento?

  1. Assicurarsi di disporre dei privilegi appropriati per la tabella personalizzata.

  2. Verificare che la tabella personalizzata contenga almeno un record.

  3. Assicurati di aver aggiunto il nome dello schema (con distinzione tra maiuscole e minuscole) della tabella personalizzata in msdyn_referencedata.

  4. Assicurati che la tabella personalizzata sia aggiunta all'oggetto app Dynamics 365 Sustainability come descritto in precedenza in questo articolo.

  5. Esegui un aggiornamento completo della pagina nel browser.

Quando importo le mappature dei fattori, non vedo la mia tabella di dati di riferimento personalizzati come opzione nell'esperienza di mappatura dei campi

  1. Assicurarsi di disporre dei privilegi appropriati per la tabella personalizzata.

  2. Assicurati di aver aggiunto il nome dello schema (con distinzione tra maiuscole e minuscole) della tabella personalizzata in msdyn_referencedata.

  3. Assicurarsi di aver aggiunto la tabella personalizzata all'oggetto Dynamics 365 Sustainability App, come descritto in precedenza in questo articolo.

  4. Esegui un aggiornamento completo della pagina nel browser.

I record delle tabelle personalizzate sono considerati "approvati" o "in attesa" ai fini dell'approvazione dei dati?

Tutti i record delle tabelle personalizzate sono considerati "approvati" ai fini dell'approvazione dei dati nel contesto delle mappature dei fattori per i calcoli.

L'importazione dei mapping dei fattori non è riuscita a causa di un privilegio prvAppendTo_[la tua tabella personalizzata] mancante per un utente.

All'utente dell'applicazione Sostenibilità Dynamics 365 o all'utente corrente non è stato concesso il privilegio Append To per la tabella personalizzata. Assicurarsi che sia Dynamics 365 Sustainability che l'utente disponga dei privilegi appropriati e quindi ritentare l'importazione.

Nel modello di calcolo, non vedo la mia tabella personalizzata come opzione nella sezione mapping dei fattori del menu a discesa Fattore di emissione del nodo Report o Fattore di stima del nodo Fattore di stima

Assicurati di aver aggiunto il record msdyn_referencedata per la tua tabella personalizzata.

Verifica che il valore di Nome entità nel record msdyn_referencedata per la tabella personalizzata abbia il nome logico della tabella (distinzione tra maiuscole e minuscole) e non il nome dello schema. Vai a Tabella > Proprietà, espandi Opzioni avanzate e visualizza il nome logico.

Assicurati che i dati sull'attività per l'origine del calcolo dispongano di un campo di ricerca che punti alla tabella personalizzata. Ad esempio, se hai personalizzato Combustione stazionaria per avere una ricerca in Area personalizzata, ma non Combustione mobile, i calcoli per Combustione mobile non possono utilizzare mappature dei fattori basate sull'area Contoso.

Personalizzare più ambienti

È possibile che tu debba effettuare queste personalizzazioni in un ambiente e quindi applicarle a un altro. Ad esempio, potresti effettuare tutte le personalizzazioni in un ambiente di sviluppo e quindi importarle nell'ambiente di produzione. Per ridurre al minimo il lavoro di duplicazione, seguire questa procedura.

  1. Usare una soluzione per esportare le modifiche da un ambiente a un altro. Includere queste personalizzazioni in tale soluzione:

    • Aggiungere tabelle personalizzate a Dynamics 365 Sustainability.

    • Aggiungere altre relazioni alle ricerche polimorfiche delle mappature dei fattori.

    Importare quindi la soluzione per la gestione del ciclo di vita delle applicazioni .

  2. Per ogni ambiente, eseguire le azioni seguenti:

    • Aggiungi i record msdyn_referencedata.

    • Personalizzare il ruolo di sicurezza dell'applicazione Dynamics 365 Sustainability.