Dela via


Anpassade faktormappningar (förhandsversion)

Microsoft Cloud for Sustainability-ikon. Microsoft Cloud for Sustainability

Viktigt

Några eller alla dessa funktioner ingår som en del av en förhandsversion. Innehållet och funktionerna kan komma att ändras.

Microsoft Sustainability Manager använder inbyggda referensdata i faktormappningar. Du kan utöka den tillgängliga uppsättningen faktormappningar med anpassade faktormappningar. Du kanske till exempel vill fästa dina aktivitetsberäkningar utifrån faktorer som till exempel räkenskapsår eller anpassad region. I den här artikeln beskrivs denna avancerade konfiguration, som du måste slutföra i Power Platform-administrationscentret.

Anteckning

Procedurerna i denna artikel kräver avancerad expertis inom Microsoft Dataverse-hantering och API:er. Denna artikel innehåller ingen detaljerad beskrivning av vanliga plattformsåtgärder. Endast behöriga administratörer med fullständig åtkomst till administrationscentret för Power Platform kan slutföra dessa konfigurationssteg.

Följ stegen nedan om du vill utöka Sustainability Manager för att använda anpassade faktormappningar:

Skapa utökade faktortabeller

Skapa anpassade faktormappningstyper

  1. Skapa nya tabeller i Power Apps-portalen för att ange alternativ för faktormappningar.

  2. Byt namn på den primära kolumnen till Namn.

    I följande exempel visas en ny tabell för Anpassad region.

    Skärmbild av en ny tabell kallad Anpassad region.

    I vårt exempel har vi även skapat en ny tabell med anpassade faktorer för räkenskapsår.

  3. Ange kolumnen Namn som en alternativ nyckel kallad naturalkey.

    Skärmbild av hur kolumnen Namn anges som naturalkey.

Skapa anpassad faktorstabell

Eftersom standardentiteter finns i en hanterad lösning måste du skapa en ny lösning och importera aktiviteter och nya anpassade faktorentiteter till den.

  1. På sidan Lösningar väljer du Ny lösning. Ange informationen för din nya lösning och välj sedan Skapa.

    Skärmbild av att skapa en ny lösning.

  2. På sidan Objekt väljer du Lägg till befintlig och sedan Tabell.

    Skärmbild av hur du lägger till tabeller i den nya lösningen.

  3. På sidan Lägg till befintliga tabeller väljer du de aktivitets- och utökade faktortabeller du skapat. I vårt exempel skapade vi aktivitetstabellen Inköpt energi och en tabell över utökade faktorer kallad Anpassad redion.

    Skärmbild av hur du lägger till tabellen Inköpt energi i den nya lösningen.

    Skärmbild av hur du lägger till tabellen Anpassad region i den nya lösningen.

Utöka aktivitetstabellen med sökningar

  1. Lägg till en ny flera-till-en-relation från aktivitetstabellen i tabellen med utökade faktorer. I vårt exempel lägger vi till en flera-till-en-relation från aktivitetstabellen Inköpt energi i tabellen Anpassad region för utökade faktorer.

    Skärmbild av hur du lägger till en flera-till-en-relation.

  2. Lägg till Sustainability Manager i den nya lösningen och lägg till anpassade faktorentiteter i den modellbaserade appen så att dessa blir tillgängliga för Sustainability Manager.

    Skärmbild på tillägg av Sustainability Manager.

    I följande exempel visas den nya lösningen och dess resurser.

    Skärmbild av lösningen och dess resurser.

  3. Välj Sustainability Manager och sedan Ny. I fönstret Lägg till sida välj Dataverse-tabellen.

    Skärmbild över tillägg av Dataverse-tabell.

  4. Markera Välj befintlig tabell. I rutan Välj en tabell väljer du de anpassade tabeller du vill använda för faktormappningar. Avmarkera kryssrutan Visa i navigering. Markera Lägga till.

    Skärmbild av hur du lägger till Dataverse-tabeller för varje tabell med anpassade faktorer.

    Under Alla andra sidor visas de nya anpassade tabellerna.

  5. Spara och publicera ändringarna.

Denna procedur kräver expertområden för utvecklare eftersom den endast är tillgänglig via API:er för Dataverse.

Du måste anpassa sökningar med flera tabeller för faktormappningar för dina egna tabeller. Du kan använda webb-API:t för Power Apps med ett verktyg som exempelvis Insomnia. Information om hur du skickar autentiserade POST-förfrågningar finns i Använd Insomnia med webb-API för Dataverse.

För varje anpassad tabell måste du aktivera faktormappningar i beräkningarna. I vårt exempel måste vi göra detta för tabellerna Anpassad region och Räkenskapsår. Du behöver det logiska namnet för varje enskild tabell. Det logiska namnet för Anpassad region är till exempel cr040_newtable, medan det logiska namnet för Räkenskapsår är cr040_newtable1.

För varje anpassad tabell måste vi uppdatera alla de polymorfiska sökningar om används för faktormappningar, en tabell med det logiska namnet msdyn_emissionlookup. Dessa sökningar har följande logiska namn:

  • msdyn_referencedataid
  • msdyn_referencedata2id
  • msdyn_referencedata3id
  • msdyn_referencedata4id

För en enskild anpassad tabell måste du skicka fyra PUBLICERA-förfrågningar, en för vardera av de fyra sökningar som används i faktormappningarna. Använd ett avancerat verktyg som till exempel Insomnia för att göra förfrågningar av typen PUBLICERA till organisationens RelationshipDefinitions-API.

I vårt fall är slutpunkten https://<orgurl>/api/data/v9.2/RelationshipDefinitions. Vi använde följande exempel på nyttolast för var och en av åtta PUBLICERA-begäranden (två tabeller med fyra förfrågningar vardera):

Anteckning

"SchemaName" måste vara unikt inom din Dataverse-miljö.

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

I följande tabell visas värdena som vi använde för <tabellnamn för anpassade faktorer>, <logiskt namn för anpassade faktortabeller>, samt <polymorfiskt sökningsnamn> för våra åtta PUBLICERA-förfrågningar.

Begär Namn på tabell för anpassade faktorer Logiskt namn på tabell för anpassade faktorer Polymorfiskt sökningsnamn
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

En lyckad PUBLICERA-förfrågan ger dig ett HTTP 204-svar.

Du kan kontrollera dessa åtgärder genom att kontrollera relationerna för tabellen Faktorsmappning.

Skärmbild av relationerna i mappningstabellen för Faktor.

Om du vill exportera ändringarna till en annan miljö kan du inkludera de relationer du lade till tidigare i en lösning och exportera denna.

  1. I Tabeller markerar du fliken Alla och väljer sedan Referensdata (msdyn_referencedata).

  2. Lägg till följande information för respektive ny faktortyp:

    Fält Beskrivning
    Namn Pluralnamn för din tabell. Till exempel Anpassad regioner eller Räkenskapsår.
    Kategori Referensdata
    Entitetsnamn Tabellens logiska namn, alla gemener (inte tabellens schemanamn). Till exempel cr040_newtable eller cr040_newtable1.

Bevilja Sustainability Manager åtkomst till externa tabeller

Om så inte redan skett måste Sustainability Manager beviljas åtkomst till externa tabeller så att dessa kan användas vid beräkningar.

  1. Gå till Lösningar > programmet Microsoft Sustainability Manager.

  2. Välj Säkerhetsroller och välj sedan Programroll för hållbarhetstjänst – Anpassad. En ny webbläsarflik öppnas.

  3. Välj fliken Egna entiteter i den nya webbläsarfliken.

  4. För alla anpassade tabeller som du vill använda för faktormappningar tillhandahåller du privilegierna Läs och Lägg till i på organisationsnivå.

    Anteckning

    För varje anpassad tabell måste du även ge organisationstäckande Läs-behörigheter till samtliga tabeller som den hänvisar till via en sökning. Om exempelvis Anpassad region har en sökning i tabellen Contoso SKU måste du bevilja behörigheten Läs till tabellen Contoso SKU.

  5. Spara och stäng.

Bevilja användare åtkomst till tabellerna

För varje anpassad tabell, till exempel Anpassade regioner eller Räkenskapsår kontrollerar du att den Power Apps-användare som matar in faktormappningar eller kör beräkningar har följande organisationsomfattande behörigheter för tabellen:

  • Lägg till i för inmatning

  • Läsa för att skapa faktormappningar eller använda faktormappningar i en beräkning som använder en anpassad tabell

Fyll i tabellerna med utökade faktorer

  1. Publicera alla anpassningar i Power Apps-portalen.

  2. Importera faktortyperna för de nya tabellerna (Anpassade regioner och Räkenskapsår i vårt exempel) i Power Apps-portalen.

    Skärmbild av tabellen Räkenskapsår med värden.

  3. Importera emissionsfaktorer med Sustainability Manager eller Power Apps-portalen.

  4. Importera faktormappningar med Sustainability Manager eller Power Apps-portalen.

  5. Importera aktivitetsdata med Sustainability Manager.

  6. Mappa de anpassade faktormappningarna i Sustainability Manager.

    Skärmbild av mappning av anpassade faktorer.

Biblioteket för utökade faktorer omfattar nu de nya emissionsfaktorerna och de anpassade, utökade faktormappningarna.

Skärmbild av biblioteket för utökade faktorer.

Använda utökade faktorer i beräkningsmodeller

I Power Apps-portalen utformar du beräkningsmodellen och använder den i beräkningsprofilen.

Skärmbild över utformning av en beräkningsmodell.

Anteckning

Du kan använda filtrering i beräkningsprofilen för att kontrollera att sökningen har ett värde.

Du kan använda utökade attribut i beräkningsprofilen efter behov.

Skärmbild som visar användnign av utökade attribut.

Vanliga frågor och svar

Anses poster för anpassade tabeller vara "godkända" eller "väntande" i datagodkännandesyfte?

Alla poster för anpassade tabeller anses vara "godkända" i datagodkännandesyfte ifråga om faktormappningar för beräkningar.

Det gick inte att importera faktormappningar på grund av en saknad behörighet prvAppendTo_[your custom table] för en användare

Användaren av programmet Sustainability Manager eller den aktuella användaren beviljades inte behörigheten Lägg till i för den anpassade tabellen. Se till att både Sustainability Manager och användaren har rätt behörighet, och försök sedan importera på nytt.

I beräkningsmodellen ser jag inte min anpassade tabell som ett alternativ i avsnittet om faktormappningar i rapportnodens emissionsfaktor eller listrutan Uppskattningsfaktor för noden Uppskattningsfaktor

Kontrollera att du har lagt till posten msdyn_referencedata i din anpassade tabell.

Kontrollera att värdet för Entitetsnamn i posten msdyn_referencedata för den anpassade tabellen har det logiska namnet för din tabell (skriftlägeskänsligt), inte schemanamnet. Gå till Tabell > Egenskaper, visa Avancerade alternativ och visa det logiska namnet.

Kontrollera att aktivitetsdatan för beräkningskällan har ett sökningsfält som pekar på den anpassade tabellen. Om du till exempel har anpassat Stationär förbränning till att ha en sökning gällande Anpassad region men inte Mobil förbränning kan beräkningar för Mobil förbränning inte använda faktormappningar baserade på Contoso-regionen.

När jag skapar faktormappningar manuellt ser jag inte min anpassade tabell som ett alternativ för referensdata

  1. Kontrollera att användaren har rätt privilegier för den anpassade tabellen.

  2. Kontrollera att den anpassade tabellen har minst en post.

  3. Läs in sidan på nytt.

Anpassa flera miljöer

Du kan behöva göra dessa anpassningarna i en miljö och sedan tillämpa dem på en annan. Du kan till exempel göra alla anpassningar i en utvecklingsmiljö och sedan importera dem till produktionsmiljön. I det här fallet kan du följa stegen nedan för att minimera dubbelarbete.

  1. För alla lösningar som du använde för att exportera ändringar från en miljö till en annan måste du ta med dessa anpassningar i lösningen:

    • Tilläggen av dina egna tabeller i Sustainability Manager.

    • Tilläggen av fler relationer i faktormappningars polymorfiska sökningar.

    Du kan sedna importera lösningen för hantering av programmets livscykel (ALM).

  2. Utför följande åtgärder för respektive miljö:

    • Lägg till msdyn_referencedata-posterna.

    • Anpassa säkerhetsrollen för Sustainability Manager-program.

Microsoft Cloud for Sustainability-ikon. ProduktsidaRegistreringsikon.Kostnadsfri utvärderingsversionCommunity-ikon.Community