Aangepaste factortoewijzingen (preview)

Gratis proefperiode

Belangrijk

Een gedeelte van of alle functionaliteit is beschikbaar als onderdeel van een preview-release. De inhoud en functionaliteit zijn aan verandering onderhevig.

Microsoft Sustainability Manager maakt gebruik van ingebouwde verwijzingsgegevens in factortoewijzingen. U kunt de beschikbare set factortoewijzingen uitbreiden met aangepaste factortoewijzingen. U wilt bijvoorbeeld uw activiteitsberekeningen laten draaien op basis van factoren zoals fiscaal jaar of aangepaste regio. Dit artikel leidt u door deze geavanceerde configuratie, die u moet voltooien in het Power Platform-beheercentrum.

Opmerking

De procedures in dit artikel vereisen geavanceerde expertise op het gebied van Microsoft Dataverse-beheer en API's. In dit artikel worden algemene platformbewerkingen niet in detail beschreven. Alleen geautoriseerde beheerders met volledige toegang tot het Power Platform-beheercentrum kunnen deze configuratiestappen voltooien.

Om Sustainability Manager uit te breiden met aangepaste factortoewijzingen, volgt u deze stappen:

• Aangepaste referentiegegevens maken
• koppelen-factoren naar Sustainability Manager-factortoewijzingen
• koppelen Sustainability Manager referentiegegevens naar nieuwe factoren
• Autoriseer Sustainability Manager om toegang te krijgen tot externe tabellen
• Geef gebruikers toegang tot de tabellen
• Test de koppelen tussen de aangepaste referentiegegevens en de factortoewijzingen
• Uitgebreide factoren gebruiken in rekenmodellen

Aangepaste referentiegegevens maken

Nieuwe tabel maken

1. Maak in de Power Apps portal de nieuwe tabel die u wilt gebruiken in factortoewijzingen als referentiegegevens.

2. Wijzig de primaire kolom in Naam.

   In het volgende voorbeeld ziet u een nieuwe tabel voor Aangepaste regio.

   

   In ons voorbeeld hebben we ook een nieuwe aangepaste factorentabel gemaakt voor Fiscaal jaar.

3. Stel de kolom Naam in als een alternatieve sleutel met de naam naturalkey.

   

Tabel toevoegen aan Sustainability Manager

Wanneer u een nieuwe tabel toevoegt in Power Apps, moet u deze ook toevoegen aan de app-module Sustainability Manager.

1. Selecteer in de Power Apps portal Sustainability Manager.

2. Selecteer op de tegel Sustainability Manager de ellips (...) en selecteer vervolgens OPENEN IN APP DESIGNER.

   

3. Selecteer in de app-ontwerper Gegevens en selecteer vervolgens Tabelnaam zoeken.

4. Selecteer de ellips (...), selecteer Toevoegen aan app, selecteer Opslaan en selecteer vervolgens Publiceren.

   

De tabel wordt toegevoegd aan Sustainability Manager en verschijnt in de lijst met referentiegegevens en in de navigatie.

Als u het uit de navigatie wilt verwijderen, selecteert u Pagina's in het linkernavigatiedeelvenster. Selecteer de tabel, selecteer Verwijderen uit navigatie, selecteer Opslaan en selecteer vervolgens Publiceren.

Creëer een oplossing voor maatwerk

Omdat standaardentiteiten zich in een beheerde oplossing bevinden, moet u een nieuwe oplossing maken en hierin activiteitsentiteiten en nieuwe aangepaste referentiegegevensentiteiten importeren.

1. Selecteer Nieuwe oplossing op de pagina Oplossingen. Voer de informatie voor uw nieuwe oplossing in en selecteer vervolgens Maken.

   

2. Selecteer Bestaande toevoegen op de pagina Objecten en selecteer vervolgens Tabel.

   

3. Selecteer op de pagina Bestaande tabellen toevoegen de activiteit en de aangepaste referentiegegevenstabellen die u hebt gemaakt. In ons voorbeeld hebben we de activiteitentabel Aangeschafte energie en de referentiegegevenstabel Aangepaste regio toegevoegd.

   

   

De activiteitentabel uitbreiden met zoekopdrachten

1. Voeg een nieuwe veel-op-één-relatie uit de activiteitentabel toe aan de uitgebreide factortabel. In ons voorbeeld voegen we een veel-op-één-relatie toe van de activiteitentabel Aangeschafte energie aan de referentiegegevenstabel Aangepaste regio .

   

Voeg de aangepaste referentiegegevenstabel toe aan de app

Notitie

Dit is een vereiste stap. Ook als u de aangepaste referentiegegevenstabel niet in het navigatiemenu wilt opnemen, moet u de tabel toch aan de app toevoegen. Als stap wordt overgeslagen, zijn de referentiegegevens niet beschikbaar bij het importeren of handmatig invoeren van factor toewijzing.

1. Voeg het Sustainability Manager App-object toe aan de nieuwe oplossing.

   

   In het volgende voorbeeld ziet u de nieuwe oplossing en de bijbehorende resources.

   

2. Selecteer Sustainability Manager, open het in bewerkingsmodus en selecteer vervolgens Nieuw. In het venster Pagina toevoegen selecteert u Dataverse-tabel.

   

3. Selecteer Bestaande tabel selecteren. Selecteer in het deelvenster Selecteer een tabel elke aangepaste referentiegegevenstabel die u wilt gebruiken voor factortoewijzingen. Selecteer Toevoegen.

   Notitie

   Als u niet wilt dat de aangepaste referentietabellen in het navigatiemenu worden weergegeven, schakelt u het selectievakje Weergeven in navigatie uit.

   

   Onder Alle andere pagina's verschijnen de nieuw toegevoegde aangepaste tabellen.

4. Sla uw wijzigingen op en publiceer deze.

Factoren koppelen aan factortoewijzingen van Sustainability Manager

Voor deze procedure is expertise van ontwikkelaars vereist, omdat deze alleen beschikbaar is via Dataverse API's.

U moet zoekopdrachten met meerdere tabellen aanpassen voor factortoewijzingen voor uw aangepaste tabellen. U kunt de Power Apps Web-API gebruiken met een tool als Insomnia of uw favoriete API-client. Voor informatie over het verzenden van geverifieerde POST-aanvragen met Insomnia gaat u naar Insomnia gebruiken met Dataverse Web-API.

Voor elke aangepaste tabel moet u factortoewijzingen in berekeningen inschakelen. In ons voorbeeld moeten we dat doen voor de tabellen Aangepaste regio en Fiscaal jaar. U hebt voor elke tabel de logische naam nodig. De logische naam voor Aangepaste regio is cr040_newtable en de logische naam voor Fiscaal jaar is cr040_newtable1.

Voor elke aangepaste tabel moeten we alle polymorfe zoekopdrachten bijwerken die worden gebruikt voor factortoewijzingen, een tabel met de logische naam msdyn_emissionlookup. Deze zoekopdrachten hebben de volgende logische namen:

• msdyn_referencedataid
• msdyn_referencedata2id
• msdyn_referencedata3id
• msdyn_referencedata4id

Voor een enkele aangepaste tabel moet u vier POST-aanvragen verzenden, één voor elk van de vier zoekopdrachten die in de factortoewijzingen worden gebruikt. Gebruik een geavanceerd hulpmiddel zoals Insomnia of uw geprefereerde API-client om de POST-aanvragen in te dienen bij de RelationshipDefinitions-API van uw organisatie.

In ons geval is dat eindpunt https://<orgurl>/api/data/v9.2/RelationshipDefinitions. We hebben de volgende voorbeeldpayload gebruikt voor elk van de acht POST-aanvragen (twee tabellen met elk vier aanvragen):

Opmerking

"SchemaNaam" moet uniek zijn binnen uw Dataverse omgeving.

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

De volgende tabel toont de waarden die we hebben gebruikt voor <aangepaste factortabelnaam>, <logische naam van de aangepaste factortabel> en <polymorfe opzoeknaam> voor onze acht POST-aanvragen.

Aanvragen	Naam aangepaste factortabel	Logische naam aangepaste factortabel	Polymorfe opzoeknaam
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

Een succesvolle POST-aanvraag geeft u een HTTP 204-antwoord.

U kunt deze bewerkingen verifiëren door de relaties van de tabel Factortoewijzing te inspecteren.

Als u uw wijzigingen naar een andere omgeving wilt exporteren, kunt u de relaties die u eerder hebt toegevoegd in een oplossing opnemen en die exporteren.

Verwijzingsgegevens van Sustainability Manager aan nieuwe factoren koppelen

1. Selecteer in Tabellen het tabblad Alle en selecteer vervolgens Verwijzingsgegevens (msdyn_referencedata).

2. Voeg de volgende informatie toe voor elk nieuw factortype:

   Veld	Beschrijving
   Meetcriterium	Meervoudsnaam voor uw tabel. Bijvoorbeeld Aangepaste regio's of Fiscale jaren.
   Categorie	Verwijzingsgegevens
   Naam van entiteit	Logische naam van uw tabel, geheel in kleine letters (niet de schemanaam van de tabel). Bijvoorbeeld cr040_newtable of cr040_newtable1.

Sustainability Manager toestemming geven om toegang te krijgen tot externe tabellen

Als dit nog niet is gebeurd, moet Sustainability Manager toegang krijgen tot externe tabellen, zodat deze in berekeningen kunnen worden gebruikt.

1. Ga naar Oplossingen > Microsoft Sustainability Manager-toepassing.

2. Selecteer Beveiligingsrollen en selecteer vervolgens Rol van toepassing voor duurzaamheidsservice – Aangepast. Er wordt een nieuw browsertabblad geopend.

3. Selecteer op het nieuwe browsertabblad het tabblad Aangepaste entiteiten.

4. Verstrek voor elk van de aangepaste tabellen die u wilt gebruiken voor factortoewijzingen de bevoegdheden Lezen en Toevoegen aan op organisatieniveau.

   Opmerking

   Voor elke aangepaste tabel moet u ook de hele organisatie bevoegdheden Lezen geven voor elke tabel waarnaar deze verwijst via een zoekopdracht. Als Aangepaste regio bijvoorbeeld een zoekopdracht bevat naar de tabel Contoso SKU, moet u bevoegdheden Lezen verstrekken aan de tabel Contoso SKU.

5. Sla op en sluit het venster.

Gebruikers toestemming geven om toegang te krijgen tot de tabellen

Zorg er bij elke aangepaste tabel, zoals Aangepaste regio's of Fiscaal jaar voor dat de Power Apps-gebruiker die factortoewijzingen opneemt of berekeningen uitvoert over de volgende organisatiebrede bevoegdheden voor de tabel beschikt:

• Toevoegen aan voor inname

• Lezen voor het maken van factortoewijzingen of het gebruiken van factortoewijzingen binnen een berekening die een aangepaste tabel gebruikt

Test de koppelen tussen de aangepaste referentiegegevens en de factortoewijzingen

1. Zorg ervoor dat alle aanpassingen worden gepubliceerd in de Power Apps portal.

2. Vul de aangepaste referentiegegevenstabellen (Aangepaste regio's en fiscaal jaar in ons voorbeeld).

   

3. Importeer of voer de factortoewijzingen in met Sustainability Manager of via de Power Apps portal.

   

4. Importeer of voer de activiteitsgegevens in met Sustainability Manager.

De volgende afbeelding toont een voorbeeld van een factorbibliotheek met de naam Extended Factors Library die toewijzingen bevat die gebruikmaken van aangepaste referentiegegevens (Custom Regions en fiscaal jaar).

Uitgebreide factoren gebruiken in rekenmodellen

Ontwerp in de Power Apps-portal het berekeningsmodel en gebruik dit in het berekeningsprofiel.

Opmerking

U kunt filteren in het berekeningsprofiel gebruiken om ervoor te zorgen dat de zoekopdracht een waarde heeft.

U kunt indien nodig uitgebreide kenmerken in het berekeningsprofiel gebruiken.

Veelgestelde vragen

Wanneer ik handmatig een nieuwe factor toewijzing aanmaak, zie ik mijn aangepaste tabel niet als een optie voor Referentiegegevens

1. Zorg ervoor dat de gebruiker de juiste bevoegdheden heeft voor de aangepaste tabel.

2. Zorg ervoor dat de aangepaste tabel ten minste één record bevat.

3. Zorg ervoor dat u de schemanaam (hoofdlettergevoelig) van uw aangepaste tabel hebt toegevoegd in msdyn_referencedata.

4. Zorg ervoor dat de aangepaste tabel wordt toegevoegd aan het Sustainability Manager App-object zoals eerder in dit artikel beschreven.

5. Vernieuw de pagina hard via uw browser.

Wanneer ik factortoewijzingen importeer, zie ik mijn aangepaste referentiegegevenstabel niet als een optie in het veld toewijzing-ervaring

1. Zorg ervoor dat de gebruiker de juiste bevoegdheden heeft voor de aangepaste tabel.

2. Zorg ervoor dat u de schemanaam (hoofdlettergevoelig) van uw aangepaste tabel hebt toegevoegd in msdyn_referencedata.

3. Zorg ervoor dat de aangepaste tabel wordt toegevoegd aan het Sustainability Manager App-object zoals eerder in dit artikel beschreven.

4. Vernieuw de pagina hard via uw browser.

Worden records voor aangepaste tabellen 'goedgekeurd' of 'in behandeling' beschouwd als met het oog op gegevensgoedkeuring?

Alle records voor aangepaste tabellen worden als 'goedgekeurd' beschouwd met het oog op gegevensgoedkeuring in de context van factortoewijzingen voor berekeningen.

Mijn import van factortoewijzingen is mislukt vanwege een ontbrekend privilege prvAppendTo_[uw aangepaste tabel] voor een gebruiker

De toepassingsgebruiker van Sustainability Manager of de huidige gebruiker heeft niet de bevoegdheid Toevoegen aan gekregen voor de aangepaste tabel. Zorg ervoor dat zowel Sustainability Manager als de gebruiker de juiste bevoegdheden hebben en probeer vervolgens opnieuw te importeren.

In het berekeningsmodel zie ik mijn aangepaste tabel niet als een optie in de sectie Factortoewijzingen van de vervolgkeuzelijst Uitstootfactor van het knooppunt Rapport of Schattingsfactor van het knooppunt Schattingsfactor.

Zorg ervoor dat u de record msdyn_referencedata voor uw aangepaste tabel hebt toegevoegd.

Controleer of de waarde voor Entiteitsnaam in de msdyn_referencedata-record voor uw aangepaste tabel de logische naam van uw tabel heeft (hoofdlettergevoelig), en niet de schemanaam. Ga naar Tabel > Eigenschappen, vouw Geavanceerde opties uit en bekijk de logische naam.

Zorg ervoor dat de activiteitsgegevens voor de bron van uw berekening een opzoekveld hebben dat naar uw aangepaste tabel verwijst. Als u bijvoorbeeld Stationaire verbranding hebt aangepast om naar Aangepaste regio te zoeken, maar niet Mobiele verbranding, dan kunnen berekeningen voor Mobiele verbranding geen factortoewijzingen gebruiken op basis van de Contoso-regio.

Meerdere omgevingen aanpassen

Het kan zijn dat u deze aanpassingen in de ene omgeving moet aanbrengen en deze vervolgens op een andere omgeving moet toepassen. Het kan bijvoorbeeld zijn dat u al uw aanpassingen in een ontwikkelomgeving doorvoert en deze vervolgens in uw productieomgeving moet importeren. In dit geval kunt u deze stappen volgen om dubbel werk tot een minimum te beperken.

1. Voor elke oplossing die u gebruikt om wijzigingen van de ene omgeving naar de andere te exporteren, moet u deze aanpassingen in die oplossing opnemen:

   • De toevoegingen van uw aangepaste tabellen aan Sustainability Manager.

   • De toevoegingen van meer relaties aan de polymorfe zoekopdrachten van factortoewijzingen.

   Vervolgens kunt u de oplossing voor Application Lifecycle Management (ALM) importeren.

2. Voer per omgeving de volgende acties uit:

   • Voeg de msdyn_referencedata-records toe.

   • Pas de beveiligingsrol van de Sustainability Manager-toepassing aan.

📄 productpagina
🎓 Opleiding

✅ Gratis proefperiode
🎥 YouTube kanaal

💻 Community
LinkedIn groep