Mappature dei fattori personalizzati (anteprima)

Microsoft Sustainability Manager utilizza dati di riferimento integrati nelle mappature 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.

Per fare in modo che Sustainability Manager utilizzi mappature dei fattori, procedi come segue:

• Creare tabelle di fattori estese
• Collegare fattori a mappature dei fattori di Sustainability Manager
• Collegare dati di riferimento di Sustainability Manager a nuovi fattori
• Autorizzare Sustainability Manager ad accedere a tabelle esterne
• Autorizzare gli utenti ad accedere alle tabelle
• Popolare le tabelle con fattori estesi
• Utilizzare fattori estesi nei modelli di calcolo

Creare tabelle di fattori estese

Creare tipi di mappature dei fattori personalizzati

1. Nel portale di Power Apps, crea nuove tabelle per specificare le opzioni di mappatura dei fattori.

2. Rinomina la colonna primaria in Nome.

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

   

   Nel nostro esempio, abbiamo creato anche una nuova tabella di fattori personalizzati per Anno fiscale.

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

   

Creare una tabella di fattori personalizzati

Poiché le entità predefinite si trovano in un soluzione gestita, devi creare una nuova soluzione e importarvi attività e nuove entità fattore personalizzato.

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

   

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

   

3. Nella pagina Aggiungi tabelle esistenti seleziona le tabelle di attività e di tabelle di fattori estesi che hai creato. Nel nostro esempio, abbiamo creato una tabella di attività Energia acquistata e una tabella di fattori estesi Area personalizzata.

   

   

Estendere la tabella delle attività con ricerche

1. Aggiungi una nuova relazione molti-a-uno dalla tabella delle attività alla tabella di fattori estesi. Nel nostro esempio, stiamo aggiungendo una relazione molti-a-uno dalla tabella delle attività Energia acquistata alla tabella di fattori estesi Area personalizzata.

   

2. Aggiungi Sustainability Manager alla nuova soluzione e aggiungi le entità fattore personalizzato all'app basata su modello per renderle disponibili a Sustainability Manager.

   

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

   

3. Seleziona Sustainability Manager e quindi seleziona Nuovo. Nella finestra Aggiungi pagina, seleziona Tabella Dataverse.

   

4. Seleziona Seleziona tabella esistente. Nel riquadro Seleziona una tabella, seleziona ciascuna delle tabelle personalizzate che desideri utilizzare per i mapping dei fattori. Deseleziona la casella di controllo Mostra durante lo spostamento. Seleziona Aggiungi.

   

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

5. Salva e pubblica le modifiche.

Collegare fattori a mappature dei fattori di Sustainability Manager

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

Devi personalizzare le ricerche in più tabelle per le mappature dei fattori per le 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 con Insomnia, vedi Utilizzare Insomnia con l'API Web di Dataverse.

Per ogni tabella personalizzata, devi abilitare le mappature dei fattori nei calcoli. Nel nostro esempio, dobbiamo farlo 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, dobbiamo aggiornare ciascuna delle ricerche polimorfiche utilizzate per le mappature 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, devi inviare quattro richieste POST, una per ciascuna delle quattro ricerche utilizzate nelle mappature 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.

Nel nostro caso, l'endpoint è https://<orgurl> /api/data/v9.2/RelationshipDefinitions. Abbiamo utilizzato il seguente payload di esempio per ciascuna delle otto richieste POST (due tabelle con quattro richieste ciascuna):

{
  "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 mostra i valori che abbiamo utilizzato per <nome tabella di fattori personalizzati>, <nome logico tabella di fattori personalizzati> e <nome ricerca polimorfica> per le nostre otto richieste POST.

Una richiesta POST riuscita ti fornisce una risposta HTTP 204.

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

Se desideri esportare le modifiche in un ambiente diverso, puoi includere le relazioni che hai aggiunto in precedenza in una soluzione ed esportarla.

Collegare dati di riferimento di Sustainability Manager a nuovi fattori

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	Descrizione
   Nome	Nome plurale della tua tabella. Ad esempio, Aree personalizzate o Anni fiscali.
   Categoria	Dati di riferimento
   Nome dell'entità	Nome logico della tabella, tutto in lettere minuscole (non il nome dello schema della tabella). Ad esempio cr040_newtable o cr040_newtable1.

Autorizzare Sustainability Manager ad accedere a tabelle esterne

Se non lo hai già fatto, devi concedere a Sustainability Manager l'accesso alle tabelle esterne in modo che possa utilizzarle nei calcoli.

1. Vai a Soluzioni > Applicazione Microsoft Sustainability Manager.

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 ciascuna delle tabelle personalizzate che desideri utilizzare per le mappature dei fattori, fornisci i privilegi Lettura e Aggiunta a a livello organizzativo.

   Nota

   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

Popolare le tabelle con fattori estesi

1. Pubblica tutte le personalizzazioni nel portale di Power Apps.

2. Importa i tipi di fattori per le nuove tabelle (Aree personalizzate e Anno fiscale nel nostro esempio) nel portale Power Apps.

   

3. Importa i fattori di emissione con Sustainability Manager o il portale Power Apps.

4. Importa i le mappature dei fattori con Sustainability Manager o il portale Power Apps.

5. Importa i dati delle attività con Sustainability Manager.

6. Mappa le mappature dei fattori personalizzati in Sustainability Manager.

   

La raccolta di fattori estesi ora include i nuovi fattori di emissione e le mappature dei fattori estesi personalizzati.

Utilizzare fattori estesi nei modelli di calcolo

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

Puoi utilizzare gli attributi estesi nel profilo di calcolo come necessario.

Domande frequenti

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 delle mappature dei fattori non è riuscita perché manca il privilegio prvAppendTo_[tabella personalizzata] per un utente

All'utente dell'applicazione Sustainability Manager o all'utente corrente non è stato concesso il privilegio Aggiunta a per la tabella personalizzata. Assicurati che sia Sustainability Manager che l'utente dispongano dei privilegi appropriati, quindi riprova l'importazione.

Nel modello di calcolo, non vedo la mia tabella personalizzata come opzione nella sezione Mappature 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.

Quando eseguo manualmente le mappature dei fattori, non vedo la mia tabella personalizzata come opzione per i dati di riferimento

1. Assicurati che l'utente disponga dei privilegi adeguati per la tabella personalizzata.

2. Assicurati che la tabella personalizzata abbia almeno un record.

3. Ricarica la pagina.

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. In questo caso, puoi seguire questi passaggi per ridurre al minimo la duplicazione del lavoro.

1. Per qualsiasi soluzione utilizzata per esportare le modifiche da un ambiente a un altro, devi includere queste personalizzazioni nella soluzione:

   • Le aggiunte delle tue tabelle personalizzate a Sustainability Manager.

   • L'aggiunta di più relazioni alle ricerche polimorfiche delle mappature dei fattori.

   Successivamente puoi importare la soluzione per la gestione del ciclo di vita delle applicazioni.

2. In base all'ambiente, esegui le seguenti azioni:

   • Aggiungi i record msdyn_referencedata.

   • Personalizza il ruolo di sicurezza dell'applicazione Sustainability Manager.