Personalizzare mapping di entità e attributi

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

È possibile eseguire il mapping degli attributi tra entità con una relazione di entità. Questo consente di impostare i valori predefiniti per un record creato nel contesto di un altro record. Utilizzare gli strumenti di personalizzazione nell'applicazione per eseguire il mapping degli attributi. Vedere l'argomento TechNet: Personalizzare il sistema CRMTechNet: Creare e modificare le relazioni di entità: Mapping dei campi delle entità. Vedere la sezione sul mapping dei campi di entità per ulteriori informazioni.

Vedere TechNet: Mapping di attributi ed entità per una tabella che illustri i mapping predefiniti di campi ed entità di sistema.

In questo argomento

Comportamento nell'applicazione

Utilizzo dei dati di mapping di entità e attributi

Attributi del mapping automatico tra entità

Recupera i mapping di entità e attributi

Comportamento nell'applicazione

L'esecuzione del mapping in Microsoft Dynamics 365 semplifica l'immissione dei dati quando si creano nuovi record associati a un altro record. Quando un'entità ha una relazione con un'altra entità, è possibile creare nuovi record di entità correlati tramite la scheda Crea record correlati della barra multifunzione. Quando si crea un nuovo record in questo modo, i dati mappati dal record dell'entità primaria vengono copiati nel modulo del nuovo record di entità correlata. Eseguendo il mapping degli attributi di entità, è possibile controllare i dati copiati aggiungendo nuovi mapping alla relazione tra le due entità. Se si crea un record non utilizzando la visualizzazione associata dell'entità primaria, il mapping dei dati non viene eseguito.

Ad esempio, è possibile impostare un mapping tra i campi di indirizzo negli account e i campi di indirizzo nei contatti. Con questo mapping, quando si aggiunge un contatto associato a un account specifico, i campi di indirizzo del contatto vengono popolati automaticamente.

È possibile eseguire il mapping di un attributo a più attributi di destinazione. È ad esempio possibile eseguire il mapping delle informazioni di indirizzo di un account all'indirizzo di fatturazione e all'indirizzo di spedizione di un ordine.

Il mapping viene applicato prima della creazione di nuovo record correlato. Gli utenti possono apportare modifiche prima del salvataggio del record. Le successive modifiche ai dati nel record principale non vengono applicate al record correlato.

Utilizzo dei dati di mapping di entità e attributi

Quando si creano nuovi record nel contesto di un record esistente in cui esiste un mapping tra entità, è possibile utilizzare il messaggio InitializeFromRequest per definire un nuovo record contenente i valori specificati nel mapping. È possibile utilizzare il metodo IOrganizationService.Create per salvare il record. In questo modo, vengono applicati tutti i mapping definiti.

I mapping di entità validi vengono creati quando viene creata una relazione di entità. Utilizzare la relazione di entità entity_map_attribute_maps per recuperare i mapping di attributi per la coppia di entità specificata dal mapping di entità.

È possibile creare o aggiornare i record del mapping di attributi. I requisiti seguenti devono essere soddisfatti per i mapping di attributi:

• Il tipo AttributeMetadata deve corrispondere.

• La lunghezza del campo di destinazione non inferiore a quella del campo di origine.

• Il formato deve corrispondere.

• Il campo di destinazione non deve essere utilizzato in altri mapping.

• Il campo di origine deve essere visibile sul modulo entità.

• Il campo di destinazione deve essere un campo che consente l'immissione di dati da parte dell'utente.

• Non è possibile eseguire il mapping di valori ID indirizzo.

• Attributi PartyList, dove AttributeMetadata.AttributeType è AttributeTypeCode. Non è possibile eseguire il mapping di PartyList.

Attributi del mapping automatico tra entità

È possibile modificare i mapping di attributo tra entità per le relazioni di entità che supportano il mapping.

Oltre a creare ogni mapping di attributo manualmente, è possibile utilizzare il messaggio AutoMapEntityRequest per generare un nuovo set di mapping di attributi. Questo messaggio esegue l'azione inclusa nell'opzione di menu Genera mapping del menu Altre azioni nella barra degli strumenti. Questo messaggio esegue il mapping di tutti gli attributi tra le due entità correlate in cui i nomi e i tipi degli attributi sono identici. Questo messaggio viene fornito come potenziamento di produttività in modo da evitare di aggiungere manualmente tutti i mapping di attributi. In alternativa, è possibile generare un set di mapping potenziali e ridurre la quantità di lavoro manuale per aggiungere o rimuovere i singoli mapping e soddisfare le necessità.

Recupera i mapping di entità e attributi

Un modo semplice per visualizzare i mapping creati è rappresentato dalla query FetchXML seguente. Per ulteriori informazioni su come eseguire questa query, vedi Utilizzare FetchXML per costruire una query.

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

Vedere anche

Utilizzare il servizio Organizzazione con i metadati di Dynamics 365
Metodi e messaggi dell'entità EntityMap
Metodi e messaggi dell'entità AttributeMap
TechNet: Creare o modificare relazioni di entità: mapping di campi di entità

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright