Anpassen von Entitäts- und Attributzuordnungen

Sie können Attributen zwischen Entitäten zuordnen, die eine Entitätsbeziehung haben. Hiermit können Sie Standardwerte für einen Datensatz festlegen, der im Kontext eines anderen Datensatzes erstellt wird. Verwenden Sie die Anpassungstools in der Anwendung, um Attributen zuzuordnen. Soehe Erstellen und Bearbeiten von Entitätsbeziehungen: Zuordnen von Entitätsfeldern.

Verhaltensweise in der Anwendung

Durch Zuordnungen in Dynamics 365 Customer Engagement (on-premises) wird die Dateneingabe beim Erstellen neuer Datensätze optimiert, die einem anderen Datensatz zugeordnet sind. Wenn eine Entität eine Entitätsbeziehung mit einer anderen Entität aufweist, können Sie verknüpfte Entitätsdatensätze erstellen, indem Sie die Verknüpfte erstellen-Registerkarte auf dem Menüband verwenden. Wenn Sie in dieser Weise einen neuen Datensatz erstellen, werden die zugeordneten Daten aus dem Datensatz der primären Entität in das Formular des Datensatzes der neuen zugeordneten Entität kopiert. Durch due Zuordnung von Entitätsattributen steuern Sie, welche Daten kopiert werden, indem Sie der Beziehung zwischen den beiden Entitäten neue Zuordnungen hinzufügen. Wenn ein Datensatz auf andere Weise als über die zugeordnete Ansicht der primären Entität erstellt wird, werden keine Daten zugeordnet.

Beispielsweise können Sie eine Zuordnung zwischen den Adressfeldern in Konten und den Adressfeldern in Kontakten einrichten. Mit dieser Zuordnung gilt: Wenn ein Benutzer einen Kontakt hinzufügt, der einem bestimmten Konto zugeordnet ist, werden die Adressfelder für den Kontakt automatisch ausgefüllt.

Ein Attribut kann mehreren Zielattributen zugeordnet werden. Beispielsweise können Sie die Adressinformationen eines Kontos sowohl der Rechnungs- als auch der Lieferadresse in einem Auftrag zuordnen.

Die Zuordnung geschieht, bevor ein neuer, verwandter Datensatz erstellt wird. Dadurch können die Benutzer vor dem Speichern des Datensatzes Änderungen vornehmen. und spätere Änderungen an den Daten im primären Datensatz werden nicht auf den verknüpften Datensatz angewendet.

Verwendung von Entitäts- und Attributzuordnungsdaten

Verwenden von Web-API

Wenn Sie mit der Web-API arbeiten, können Sie die InitializeFrom Funktion verwenden, um neue Datensätze im Kontext bestehender Datensätze zu erstellen, wenn eine Zuordnung zwischen den Entitäten besteht.

Die Antwort, die von InitializeFrom-Anforderung empfangen wird, besteht aus zugeordneten Attributen zwischen Quellentität und Zielentität und der GUID des übergeordneten Datensatzes. Die Attributzuordnung zwischen Entitäten, die eine Entitätsbeziehung haben, ist für verschiedene Entitätssätze verschieden und kann angepasst werden, deshalb variieren die Reaktion von der InitializeFrom-Funktionsanforderung für verschiedene Entitäten und Organisationen. Wenn diese Antwort im Text der Erstellungsanforderung an den neuen Datensatz übergeben wird, werden diese Attributwerte im neuen Datensatz repliziert. Die Werte von benutzerdefinierten zugeordneten Attributen werden auch im neuen Datensatz während des Prozesses festgelegt.

Notiz

So bestimmen Sie, ob zwei Entitäten mit der folgenden Web-API-Anforderung zugeordnet werden können:
GET [Organization URI]/api/data/v9.1/entitymaps?$select=sourceentityname,targetentityname&$orderby=sourceentityname

Weitere Informationen finden Sie unter Erstellen einer neuen Entität aus einer anderen Entität.

Mit Organisationsservice

Wenn Sie neue Datensätze im Kontext eines vorhandenen Datensatzes anlegen, wobei eine Zuordnung zwischen den Entitäten vorhanden ist, können Sie die InitializeFromRequest-Meldung verwenden, um einen neuen Datensatz zu definieren, der die Werte enthält, die in der Zuordnung angegeben sind. Anschließend können Sie den IOrganizationService verwenden. Create-Methode zum Speichern des Datensatzes. Auf diese Weise werden alle definierten Zuordnungen angewendet.

Gültige Entitätszuordnungen werden erstellt, wenn eine Entitätsbeziehung erstellt wird. Verwenden Sie die entity_map_attribute_maps-Entitätsbeziehung, um Attributzuordnungen für das von der Entitätszuordnung angegebene Paar von Entitäten abzurufen.
Sie können Attributzuordnungsdatensätze erstellen oder aktualisieren. Die folgenden Voraussetzungen müssen für Attributzuordnungen erfüllt sein:

• Der AttributeMetadata-Typ muss übereinstimmen.
• Das Zielfeld darf nicht kürzer sein als das Quellfeld.
• Das Format muss übereinstimmen.
• Das Zielfeld darf nicht in einer anderen Zuordnung verwendet werden.
• Das Quellfeld muss im Entitätsformular sichtbar sein.
• Beim Zielfeld muss es sich um ein Feld handeln, in das der Benutzer Daten eingeben kann.
• Adresskennungswerte können nicht zugeordnet werden.
• PartyList-Attribute, wobei AttributeMetadata.AttributeType gleich AttributeTypeCode.PartyList kann nicht zugeordnet werden.

Attribute der automatischen Zuordnung zwischen Entitäten

Sie können Attributzuordnungen zwischen Entitäten für Entitätsbeziehungen bearbeiten, die die Zuordnung unterstützen.

Zusätzlich zum manuellen Erstellen jeder Attributzuordnung können Sie die Nachricht AutoMapEntity (AutoMapEntity Aktion oder Klasse AutoMapEntityRequest) verwenden, um eine neue Zuordnung von Attributen zu generieren. Diese Meldung führt die Aktion aus, die unter der Menüoption Zuordng. generieren im Menü Weitere Aktionen auf der Symbolleiste zu finden ist. Dieses Meldung ordnet alle Attribute zwischen den beiden verknüpften Entitäten zu, bei denen die Attributnamen und die Typen identisch sind. Diese Meldung wird als Produktivitätserweiterung bereitgestellt, so dass Sie nicht alle Attributzuordnungen manuell hinzufügen müssen. Stattdessen können Sie einen Satz wahrscheinlicher Zuordnungen generieren und die manuelle Arbeit für das Hinzufügen oder Entfernen einzelner Zuordnungen je nach Ihren Anforderungen minimieren.

Notiz

Die automatische Erstellung von Zuordnungen auf diese Weise entfernt alle vorher definierten Attributzuordnungen und kann Zuordnungen beinhalten, die Sie nicht wünschen.

Abrufen von Entitäts- und Attributzuordnungen

Eine einfache Möglichkeit, die Zuordnungen zu finden, die erstellt wurden, ist es, die folgende FetchXML-Abfrage zu verwenden. Weitere Informationen dazu, wie diese Abfrage ausgeführt wird, siehe Verwendung von FetchXML, um eine Abfrage zu erstellen.

<fetch version='1.0' mapping='logical' distinct='false'>
   <entity name='entitymap'>
      <attribute name='sourceentityname'/>
      <attribute name='targetentityname'/>
      <link-entity name='attributemap' alias='attributemap' to='entitymapid' from='entitymapid' link-type='inner'>
         <attribute name='sourceattributename'/>
         <attribute name='targetattributename'/>
      </link-entity>
   </entity>
 </fetch>

Siehe auch

Erweitern des Metadatenmodells für Dynamics 365 Customer Engagement (on-premises)
Siehe Erstellen und Bearbeiten von Entitätsbeziehungen: Zuordnen von Entitätsfeldern