Share via

Benutzerdefinierte Faktorenzuordnungen (Vorschauversion)

  • Artikel

Microsoft Cloud for Sustainability Technical Summit, Mai 2024

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:

Erweiterte Faktortabellen erstellen

Benutzerdefinierte Faktorenzuordnungstypen erstellen

  1. Erstellen Sie im Power Apps Portal neue Tabellen, um Faktorenzuordnungsoptionen anzugeben.

  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“.

Benutzerdefinierte Faktortabelle erstellen

Da sich Standardentitäten in einer verwalteten Lösung befinden, müssen Sie eine neue Lösung erstellen und Aktivitäten und neue benutzerdefinierte Faktorentitäten hineinimportieren.

  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 ObjekteVorhandenes hinzufügen und dann eine Tabelle aus.

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

  3. Wählen Sie auf der Seite Vorhandene Tabellen hinzufügen die Aktivität und die erweiterten Faktortabellen aus, die Sie erstellt haben. In unserem Beispiel haben wir eine Aktivitätstabelle Gekaufte Energie und eine erweiterte Faktortabelle Benutzerdefinierte Region erstellt.

    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 n:1-Beziehung aus der Aktivitätstabelle Gekaufte Energie zur erweiterten Faktortabelle Benutzerdefinierte Region hinzu.

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

  2. Fügen Sie zur neuen Lösung Sustainability Manager hinzu und fügen Sie die benutzerdefinierten Faktorentitäten zur modellgesteuerten App hinzu, um sie Sustainability Manager zur Verfügung zu stellen.

    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.

  3. Wählen Sie Sustainability Manager und dann Neu aus. Wählen Sie im Fenster Neue SeiteDataverse Tabelle aus.

    Screenshot vom Hinzufügen einer Dataverse-Tabelle.

  4. Wählen Sie Vorhandene Tabelle auswählen und wählen Sie jede der benutzerdefinierten Tabellen aus, die Sie für Faktorenzuordnungen verwenden möchten. Deaktivieren Sie das Kontrollkästchen In Navigation anzeigen. Wählen Sie Hinzufügen aus.

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

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

  5. 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 verwenden. Informationen zum Senden authentifizierter POST-Anfragen 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 Regioncr040_newtable und der logische Name für Geschäftsjahrcr040_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, 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

Der SchemaName muss in Ihrer Dataverse-Umgebung eindeutig sein.

{
  "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). Zum 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:

  • Anfügen an zur Erfassung

  • Lesen zum Erstellen von Faktorenzuordnungen oder zur Verwendung von Faktorenzuordnungen innerhalb einer Berechnung, die eine benutzerdefinierte Tabelle verwendet

Tabellen mit erweiterten Faktoren füllen

  1. Veröffentlichen Sie alle Anpassungen im Power Apps Portal.

  2. Importieren Sie die Faktortypen für die neuen Tabellen (in unserem Beispiel Benutzerdefinierte Regionen und Geschäftsjahr) im Power Apps Portal.

    Screenshot der Tabelle „Geschäftsjahr“ mit Werten.

  3. Importieren Sie Emissionsfaktoren mit dem Sustainability Manager oder dem Power Apps Portal.

  4. Importieren Sie Faktorenzuordnungen mit dem Sustainability Manager oder dem Power Apps Portal.

  5. Aktivitätsdaten mit Sustainability Manager importieren.

  6. Ordnen Sie die benutzerdefinierten Faktorenzuordnungen im Sustainability Manager zu.

    Screenshot der Zuordnung benutzerdefinierter Faktoren.

Die Erweiterte Faktorenbibliothek verfügt jetzt über die neuen Emissionsfaktoren und die benutzerdefinierten erweiterten Faktorenzuordnungen.

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

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 Faktorenzuordnungen ist fehlgeschlagen, da für Benutzende die Berechtigung prvAppendTo_[Ihre benutzerdefinierte Tabelle] fehlt

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.

Wenn ich Faktorenzuordnungen manuell vornehme, 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. Laden Sie die Seite neu.

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.