Condividi tramite


Personalizzare moduli di entità

 

Data di pubblicazione: gennaio 2017

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

I moduli forniscono l'interfaccia utente (UI) che gli utenti utilizzano per creare, visualizzare o modificare i record di entità. Utilizzare la finestra di progettazione modulo degli strumenti di personalizzazione per creare e modificare i moduli di entità.Ulteriori informazioni:TechNet: Creare e progettare moduli per informazioni sulle attività correlate all'utilizzo dei moduli nell'applicazione.

Questo argomento contiene le informazioni necessarie per creare o modificare i moduli a livello di programmazione.

In questo argomento

Accedere alle definizioni di modulo

Proprietà del modulo

Creare e modificare i moduli

Accedere alle definizioni di modulo

I moduli delle entità sono archiviati nell'entità SystemForm insieme ai dashboard e alle visualizzazioni. Vi sono due modi per controllare le definizioni di modulo di un'entità:

  • Includere l'entità in una soluzione non gestita ed esportare la soluzione.

  • Eseguire una query per l'entità SystemForm

Visualizzare FormXML da un'entità esportata

Solo le definizioni dei moduli di entità di sistema che sono state personalizzate sono incluse nella soluzione gestita esportata. Per visualizzare la definizione di un modulo di entità di sistema, è necessario modificarlo in qualche modo o creare un nuovo modulo salvando il modulo esistente con un nuovo nome.

Dopo l'esportazione della soluzione, estrarre il contenuto e visualizzare il file customizations.xml. La definizione dei moduli è disponibile in ImportExportXml > Entities > Entity > FormXml. Nel nodo <FormXml> (FormXml) è disponibile ogni tipo di modulo raggruppato in un elemento <forms> (FormXml) con l'attributo type che specifica il tipo di modulo.

Proprietà del modulo

Nella tabella seguente vengono descritti i principali attributi di entità SystemForm e i corrispondenti dati inclusi negli elementi XML esportati nella soluzione.

Proprietà SystemForm

Elemento FormXML

Descrizione

AncestorFormId

<Ancestor> (FormXml)

Identificatore univoco del modulo padre. Viene impostato quando crei un nuovo modulo utilizzando Salva con nome per un modulo esistente oppure utilizzando CopySystemFormRequest.

CanBeDeleted

<CanBeDeleted> (FormXml)

Informazioni che specificano se il componente può essere eliminato. Questa proprietà gestita viene applicata solo se il modulo è stato creato tramite l'importazione di una soluzione gestita.

Description

<Descriptions> (FormXml)

Description è una stringa e <Descriptions> (FormXml) contiene tutte le etichette localizzate per la descrizione del modulo.

Le etichette localizzate possono essere recuperate tramite RetrieveLocLabelsRequest.

FormActivationState

<FormActivationState> (FormXml)

Specifica lo stato del modulo.

Solo i moduli di tipo "principale" possono essere disattivati.

Valori validi:

  • 0 : Inattivo

  • 1 : Attivo

FormId

<formid> (FormXml)

Identificatore univoco del modulo

FormPresentation

<FormPresentation> (FormXml)

Specifica se il modulo ha il layout aggiornato dell'interfaccia utente in Microsoft Dynamics 365 (online e locale).

FormXml

<form> (FormXml)

Rappresentazione XML del layout del modulo.

Per informazioni dettagliate sulla struttura del modulo, vedere <form> (FormXml).

IntroducedVersion

<IntroducedVersion> (FormXml)

Versione della soluzione in cui il modulo è stato aggiunto.

IsAIRMerged

N/D

Specifica se il modulo è stato unito al layout aggiornato dell'interfaccia utente in Microsoft Dynamics 365 (online e locale).

IsCustomizable

<IsCustomizable> (FormXml)

Specifica se il componente può essere personalizzato.

Questa proprietà gestita viene applicata solo se il modulo è stato creato tramite l'importazione di una soluzione gestita.

IsDefault

N/D

Specifica se il modulo o il dashboard è quello predefinito del sistema.

Name

<LocalizedNames> (FormXml)

Name è una stringa e <Descriptions> (FormXml) contiene tutte le etichette localizzate per il nome del modulo.

Le etichette localizzate possono essere recuperate tramite RetrieveLocLabelsRequest.

ObjectTypeCode

Il modulo è un elemento discendente dell'elemento Entity.

Il valore ObjectTypeCode è il nome logico dell'entità.

Type

Attributo type dell'elemento <forms> (FormXml)

I valori validi per i moduli sono:

  • 2: main

  • 5: mobile

  • 6: quick

  • 7: quickCreate

Creare e modificare i moduli

Puoi creare solo nuovi moduli per un'entità dove EntityMetadata.CanCreateForms lo consente.

È possibile creare nuovi moduli con CreateRequest o CopySystemFormRequest. Quando si utilizza CopySystemFormRequest o Salva con nome nell'editor di moduli, si noti che non esiste ereditarietà tra i moduli. Pertanto, le modifiche del modulo di base non si applicano ai moduli da cui è stato creato.

La modifica delle definizioni dei moduli da una soluzione gestita esportata e quindi la reimportazione della soluzione costituisce un metodo supportato per modificare i moduli di entità. Per modificare manualmente i moduli è consigliabile utilizzare un editor XML che consente la convalida dello schema.Ulteriori informazioni:Modificare il file XML delle personalizzazioni con convalida dello schema

Vedere anche

Personalizzare le applicazioni di Microsoft Dynamics 365
TechNet: Creare e progettare i moduli
Messaggi e metodi dell'entità SystemForm (dashboard di sistema)
Creare o modificare la modalità di inizializzazione delle regole di business
Form XML reference
Form XML schema

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright