Freigeben über


Benutzerdefinierte Faktorenzuordnungen (Vorschauversion)

Wichtig

Einige oder alle dieser Funktionen sind als Teil einer Vorschauversion verfügbar. Inhalt und Funktionalität können sich ändern.

Microsoft Sustainability Manager verwendet in Faktorenzuordnungen integrierte Referenzdaten. Sie können den Satz verfügbarer Faktorenzuordnungen durch benutzerdefinierte Faktorenzuordnungen erweitern. Vielleicht möchten Sie ja Ihre Aktivitätsberechnungen basierend auf Faktoren wie Geschäftsjahr oder einer benutzerdefinierten Region anpassen. Dieser Artikel führt Sie durch diese erweiterte Konfiguration, die Sie im Power Platform Admin Center bearbeiten müssen.

Anmerkung

Die in diesem Artikel beschriebenen Verfahren erfordern fortgeschrittene Kenntnisse in Microsoft Dataverse Verwaltung und APIs. Allgemeine Plattformvorgänge werden in diesem Artikel nicht im Detail beschrieben. Nur befugte Administrierende mit vollständigem Zugriff auf das Power Platform Admin Center können diese Konfigurationsschritte durchführen.

Um Sustainability Manager für die Verwendung benutzerdefinierter Faktorenzuordnungen zu erweitern, führen Sie die folgenden Schritte aus:

Erstellen benutzerdefinierter Referenzdaten

Neue Tabelle erstellen

  1. Erstellen Sie im Power Apps Portal die neue Tabelle, die Sie in Faktorzuordnungen als Referenzdaten verwenden möchten.

  2. Benennen Sie die primäre Spalte in Name um.

    Das folgende Beispiel zeigt eine neue Tabelle für Benutzerdefinierte Region.

    Screenshot einer neuen Tabelle mit dem Namen „Benutzerdefinierte Region“.

    In unserem Beispiel haben wir auch eine neue Tabelle mit benutzerdefinierten Faktoren für Geschäftsjahr erstellt.

  3. Legen Sie die Spalte Name als Alternativschlüssel mit dem Namen naturalkey fest.

    Screenshot der Festlegung der Spalte „Name“ als „naturalkey“.

Tabelle zu Sustainability Manager hinzufügen

Wenn Sie in Power Apps eine neue Tabelle hinzufügen, müssen Sie sie auch zum App-Modul Sustainability Manager hinzufügen.

  1. Im Power Apps Portal, Auswählen Sustainability Manager.

  2. Klicken Sie auf Sustainability Manager tile, Auswählen die Auslassungspunkte (...) und dann auf Auswählen IN APP DESIGNER ÖFFNEN.

    Screenshot des Öffnens der App im App-Designer.

  3. Geben Sie im App-Designer Auswählen Daten und dann Auswählen Tabellennamen suchen ein.

  4. Auswählen die Auslassungspunkte (...), Auswählen Zur App hinzufügen, Auswählen Speichern und dann Auswählen Veröffentlichen.

    Screenshot des Hinzufügens der Tabelle zur App.

Die Tabelle wird zu Sustainability Manager hinzugefügt und erscheint in der Referenzdatenliste und in der Navigation.

Wenn Sie es aus der Navigation entfernen möchten, Auswählen Seiten im linken Navigationsbereich. Auswählen die Tabelle, Auswählen Aus Navigation entfernen, Auswählen Speichern und dann Auswählen Veröffentlichen.

Screenshot des Entfernens der Tabelle aus der Navigation.

Lösung für Anpassungen erstellen

Da sich Standardentitäten in einem verwaltete Lösung befinden, müssen Sie eine neue Lösung erstellen und Aktivitätsentitäten sowie neue benutzerdefinierte Referenzdatenentitäten darin importieren.

  1. Wählen Sie auf der Seite Lösungen die Option Neue Lösung aus. Geben Sie die Informationen für Ihre neue Lösung ein und wählen Sie dann Erstellen aus.

    Screenshot des Erstellens einer neuen Lösung.

  2. Wählen Sie auf der Seite Objekte Vorhandenes hinzufügen und dann eine Tabelle aus.

    Screenshot des Hinzufügens von Tabellen zur neuen Lösung.

  3. Auswählen Sie auf der Seite vorhandene Tabellen hinzufügen die Aktivität und die benutzerdefinierten Referenzdatentabellen, die Sie erstellt haben. In unserem Beispiel haben wir die Aktivitätstabelle Gekaufte Energie und die Referenzdatentabelle Benutzerdefinierte Region hinzugefügt.

    Screenshot des Hinzufügens der Tabelle „Gekaufte Energie“ zur neuen Lösung.

    Screenshot des Hinzufügens der Tabelle „Benutzerdefinierte Region“ zur neuen Lösung.

Die Aktivitätstabelle mit Suchvorgängen erweitern

  1. Fügen Sie eine neue n:1-Beziehung aus der Aktivitätstabelle zur erweiterten Faktorentabelle hinzu. In unserem Beispiel fügen wir eine Viele-zu-eins-Beziehung von der Aktivitätstabelle Gekaufte Energie zur Referenzdatentabelle Benutzerdefinierte Region hinzu.

    Screenshot des Hinzufügens einer n:1-Beziehung.

Fügen Sie der App die benutzerdefinierte Referenzdatentabelle hinzu

Anmerkung

Dies ist ein erforderliches Schritt. Auch wenn Sie die benutzerdefinierte Referenzdatentabelle nicht in das Navigationsmenü einbinden möchten, ist es dennoch notwendig, die Tabelle zur App hinzuzufügen. Wenn dieser Schritt übersprungen wird, sind die Referenzdaten beim Import des Faktors Zuordnung oder bei der manuellen Eingabe nicht verfügbar.

  1. Fügen Sie der neuen Lösung das App-Objekt Sustainability Manager hinzu.

    Screenshot des Hinzufügens von Sustainability Manager.

    Das folgende Beispiel zeigt die neue Lösung und ihre Ressourcen.

    Screenshot der Lösung und ihrer Ressourcen.

  2. Auswählen Sustainability Manager, öffnen Sie es in Bearbeitungsmodus und dann Auswählen Neu. Wählen Sie im Fenster Seite hinzufügen die Option Dataverse-Tabelle aus.

    Screenshot vom Hinzufügen einer Dataverse-Tabelle.

  3. Wählen Sie Vorhandene Tabelle auswählen aus. Auswählen Sie im Bereich Auswählen „Tabelle“ alle benutzerdefinierten Referenzdatentabellen, die Sie für Faktorzuordnungen verwenden möchten. Wählen Sie Hinzufügen aus.

    Anmerkung

    Wenn die benutzerdefinierten Referenztabellen nicht im Navigationsmenü angezeigt werden sollen, deaktivieren Sie das Kontrollkästchen In Navigation anzeigen .

    Screenshot des Hinzufügens von Dataverse Tabellen zu den einzelnen benutzerdefinierten Faktortabellen.

    Unter Alle anderen Seiten werden die neu hinzugefügten benutzerdefinierten Tabellen angezeigt.

  4. Speichern und veröffentlichen Sie Ihre Änderungen.

Dieses Verfahren erfordert Entwicklerkenntnisse, da es nur über Dataverse APIs verfügbar ist.

Sie müssen die Suche in mehreren Tabellen für Faktorenzuordnungen für Ihre benutzerdefinierten Tabellen anpassen. Sie können die Power Apps Web-API mit einem Tool wie Insomnia oder Ihrem bevorzugten API-Client verwenden. Informationen zum Senden authentifizierter POST-Anfragen mit Isomnica finden Sie unter Insomnia mit Dataverse Web-API verwenden.

Sie müssen für jede benutzerdefinierte Tabelle Faktorenzuordnungen in Berechnungen aktivieren. In unserem Beispiel müssen wir dies für die Tabellen Benutzerdefinierte Region und Geschäftsjahr tun. Sie benötigen den logischen Namen jeder einzelnen Tabelle. Beispielsweise lautet der logische Name für Benutzerdefinierte Region cr040_newtable und der logische Name für Geschäftsjahr cr040_newtable1.

Für jede benutzerdefinierte Tabelle müssen wir alle polymorphen Suchen aktualisieren, die für Faktorenzuordnungen verwendet werden, eine Tabelle mit dem logischen Namen msdyn_emissionlookup. Diese Suchen weisen folgende logische Namen auf:

  • msdyn_referencedataid
  • msdyn_referencedata2id
  • msdyn_referencedata3id
  • msdyn_referencedata4id

Für eine einzelne benutzerdefinierte Tabelle müssen Sie vier POST-Anforderung senden, für jede der vier in den Faktorenzuordnungen verwendeten Suchen eine. Verwenden Sie ein erweitertes Tool wie Insomnia oder Ihren bevorzugten API-Client, um POST-Anfragen an die RelationshipDefinitions-API Ihrer Organisation zu stellen.

In unserem Fall lautet der Endpunkt https://<orgurl>/api/data/v9.2/RelationshipDefinitions. Wir haben für jede der acht POST-Anforderungen die folgende Beispielnutzdaten verwendet (zwei Tabellen mit jeweils vier Anforderungen):

Anmerkung

"SchemaName" muss innerhalb Ihrer Dataverse Umgebung.

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

Die folgende Tabelle zeigt die Werte, die wir für den <benutzerdefinierten Faktortabellentabelle>, den <logischen Namen der benutzerdefinierter Faktortabelle> und den <Namen der polymorphen Suche> für unsere acht POST-Anforderungen festgelegt haben.

Anfordern Benutzerdefinierter Faktortabellenname Logischer Name der benutzerdefinierter Faktortabelle Name der polymorphen Suche
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

Bei einer erfolgreichen POST-Anforderung erhalten Sie eine HTTP-204-Antwort.

Sie können diese Vorgänge überprüfen, indem Sie Beziehungen der Tabelle Faktorenzuordnung überprüfen.

Screenshot der Beziehungen in der Faktorenzuordnungstabelle.

Wenn Sie Ihre Änderungen in eine andere Umgebung exportieren möchten, können Sie die zuvor hinzugefügten Beziehungen in eine Lösung einbinden und diese exportieren.

  1. Wählen Sie in Tabellen die Registerkarte Alle und dann Referenzdaten (msdyn_referencedata) aus.

  2. Fügen Sie für jeden neuen Faktortyp die folgenden Informationen hinzu:

    Feld Beschreibung
    Name Pluralname für Ihre Tabelle. Zum Beispiel Benutzerdefinierte Regionen oder Geschäftsjahre.
    Kateg. Referenzdaten
    Name der Entität Logischer Name Ihrer Tabelle, kleingeschrieben (nicht der Schemaname der Tabelle). Beispiel: cr040_newtable oder cr040_newtable1.

Den Zugriff auf externe Tabellen durch Sustainability Manager zulassen

Sofern nicht bereits geschehen, muss Sustainability Manager Zugriff auf externe Tabellen erhalten, damit er diese in Berechnungen verwenden kann.

  1. Gehen Sie zu Lösungen > Microsoft Sustainability Manager Anwendung.

  2. Wählen Sie Sicherheitsrollen und dann Nachhaltigkeitsservice-Anwendungsrolle – Benutzerdefiniert aus. Es wird eine neue Browserregisterkarte geöffnet.

  3. Wählen Sie in der neuen Browserregisterkarte die Registerkarte Benutzerdefinierte Entitäten aus.

  4. Stellen Sie für jede der benutzerdefinierten Tabellen, die Sie für Faktorenzuordnungen verwenden möchten, die Berechtigungen Lesen und Anfügen an auf Organisationsebene bereit.

    Anmerkung

    Außerdem müssen Sie für jede benutzerdefinierte Tabelle allen Tabellen, auf die sie über eine Suche verweist, organisationsweite Leseberechtigungen erteilen. Wenn Benutzerdefinierte Region zum Beispiel eine Suche zu der Tabelle Contoso-SKU hat, müssen Sie Leseberechtigungen für die Tabelle Contoso-SKU erteilen.

  5. Speichern und schließen Sie.

Benutzenden Zugriff auf die Tabellen erlauben

Stellen Sie für jede benutzerdefinierte Tabelle, z. B. Benutzerdefinierte Regionen oder Geschäftsjahr, sicher, dass Power Apps Benutzende, die Faktorenzuordnungen erfassen oder Berechnungen ausführen, über die folgenden organisationsweiten Berechtigungen für die Tabelle verfügen:

  • Anhängen an zur Einnahme

  • Lesen zum Erstellen von Faktorzuordnungen oder zum Verwenden von Faktorzuordnungen innerhalb einer Berechnung, die eine benutzerdefinierte Tabelle verwendet

  1. Stellen Sie sicher, dass alle Anpassungen im Power Apps Portal veröffentlicht werden.

  2. Füllen Sie die benutzerdefinierten Referenzdatentabellen (in unserem Beispiel Benutzerdefinierte Regionen und Geschäftsjahr ).

    Screenshot der Tabelle „Geschäftsjahr“ mit Werten.

  3. Importieren bzw. geben Sie die Faktorzuordnungen mit Sustainability Manager oder dem Power Apps Portal ein.

    Screenshot der Zuordnung benutzerdefinierter Faktoren.

  4. Importieren oder erfassen Sie die Aktivitätsdaten mit Sustainability Manager.

Das folgende Bild zeigt ein Beispiel eines Faktorbibliothek namens Extended Factors Library , das Zuordnungen enthält, die benutzerdefinierte Referenzdaten verwenden (Custom Regions und Geschäftsjahr).

Screenshot der erweiterten Faktorbibliothek.

Erweiterte Faktoren in Berechnungsmodellen verwenden

Legen Sie im Power Apps Portal das Berechnungsmodell an und verwenden Sie es im Berechnungsprofil.

Screenshot des Erstellens eines Berechnungsmodells.

Anmerkung

Sie können Filter im Berechnungsprofil verwenden, um sicherzustellen, dass die Suche einen Wert hat.

Bei Bedarf können Sie im Berechnungsprofil erweiterte Attribute verwenden.

Screenshot der Verwendung erweiterter Attribute.

Häufig gestellte Fragen

Wenn ich einen neuen Faktor Zuordnung manuell erstelle, wird meine benutzerdefinierte Tabelle nicht als Option für Referenzdaten angezeigt

  1. Stellen Sie sicher, dass die Benutzenden über die entsprechenden Berechtigungen für die benutzerdefinierte Tabelle verfügen.

  2. Stellen Sie sicher, dass die benutzerdefinierte Tabelle mindestens einen Datensatz enthält.

  3. Stellen Sie sicher, dass Sie den Schemanamen (Groß-/Kleinschreibung beachten) Ihrer benutzerdefinierten Tabelle in msdyn_referencedata hinzugefügt haben.

  4. Stellen Sie sicher, dass die benutzerdefinierte Tabelle dem Sustainability Manager App-Objekt hinzugefügt wird, wie weiter oben in diesem Artikel beschrieben.

  5. Führen Sie in Ihrem Browser einen Hard-Refresh der Seite durch.

Wenn ich Faktorzuordnungen importiere, wird meine benutzerdefinierte Referenzdatentabelle im Feld Zuordnung-Erfahrung nicht als Option angezeigt

  1. Stellen Sie sicher, dass die Benutzenden über die entsprechenden Berechtigungen für die benutzerdefinierte Tabelle verfügen.

  2. Stellen Sie sicher, dass Sie den Schemanamen (Groß-/Kleinschreibung beachten) Ihrer benutzerdefinierten Tabelle in msdyn_referencedata hinzugefügt haben.

  3. Stellen Sie sicher, dass die benutzerdefinierte Tabelle dem Sustainability Manager App-Objekt hinzugefügt wird, wie weiter oben in diesem Artikel beschrieben.

  4. Führen Sie in Ihrem Browser einen Hard-Refresh der Seite durch.

Werden Datensätze für benutzerdefinierte Tabellen zum Zweck der Datengenehmigung als „genehmigt“ oder „ausstehend“ betrachtet?

Alle Datensätze für benutzerdefinierte Tabellen gelten zum Zweck der Datengenehmigung im Zusammenhang mit Faktorenzuordnungen für Berechnungen als „genehmigt“.

Mein Import von Faktorzuordnungen ist aufgrund eines fehlenden Privilegs prvAppendTo_[Ihre benutzerdefinierte Tabelle] für einen Benutzer fehlgeschlagen.

Den Sustainability Manager-Anwendungsbenutzenden oder den aktuellen Benutzenden wurde die Berechtigung Anfügen an für die benutzerdefinierte Tabelle nicht gewährt. Stellen Sie sicher, dass sowohl Sustainability Manager als auch die Benutzenden über die entsprechenden Berechtigungen verfügen, und versuchen Sie dann den Import erneut.

Im Berechnungsmodell wird meine benutzerdefinierte Tabelle im Abschnitt „Faktorenzuordnungen“ der Dropdownliste „Emissionsfaktor“ des Berichtsknotens oder „Bewertungsfaktor“ des Bewertungsknotens nicht als Option angezeigt

Stellen Sie sicher, dass Sie den msdyn_referencedata-Datensatz für Ihre benutzerdefinierte Tabelle hinzugefügt haben.

Überprüfen Sie den Wert für Entitätsname im msdyn_referencedata-Datensatz für Ihre benutzerdefinierte Tabelle den logischen Namen Ihrer Tabelle (Groß-/Kleinschreibung beachten) und nicht den Schemanamen. Gehen Sie zu Tabelle > Eigenschaften, klappen Sie Erweiterte Optionen auf und sehen Sie sich den logischen Namen an.

Stellen Sie sicher, dass die Aktivitätsdaten für die Quelle Ihrer Berechnung über ein Suchfeld verfügen, das auf Ihre benutzerdefinierte Tabelle verweist. Wenn Sie beispielsweise Stationäre Verbrennung so angepasst haben, dass sie über eine Suche nach Benutzerdefinierte Region verfügt, Mobile Verbrennung aber nicht, dann können Berechnungen für Mobile Verbrennung keine Faktorenzuordnungen basierend auf der Contoso-Region verwenden.

Mehrere Umgebungen anpassen

Möglicherweise müssen Sie diese Anpassungen in einer Umgebung vornehmen und dann auf eine andere anwenden. Angenommen Sie nehmen alle Ihre Anpassungen in einer Entwicklungsumgebung vor und müssen diese dann in Ihre Produktionsumgebung importieren. In diesem Fall können Sie diese Schritte ausführen, um möglichst wenig doppelt erledigen zu müssen.

  1. Für jede Lösung, die Sie zum Exportieren von Änderungen von einer Umgebung in eine andere verwendet haben, müssen Sie diese Anpassungen in diese Lösung aufnehmen:

    • Das Hinzufügen Ihrer benutzerdefinierten Tabellen zum Sustainability Manager.

    • Das Hinzufügen weiterer Beziehungen zu den polymorphen Suchen von Faktorenzuordnungen.

    Anschließend können Sie die Lösung für das Application Lifecycle Management (ALM) importieren.

  2. Führen Sie für jede Umgebung die folgenden Aktionen aus:

    • Fügen Sie die msdyn_referencedata-Datensätze hinzu.

    • Passen Sie die Sustainability Manager-Anwendungssicherheitsrolle an.