Utilizzare il modello a oggetti Xrm.Page
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Quando si scrivono gli script dei moduli, si interagisce con gli oggetti nello spazio dei nomi Xrm.Page per eseguire le azioni seguenti:
Ottenere o impostare i valori di attributi.
Mostrare e nasconde gli elementi di interfaccia utente.
Fare riferimento a più controlli per ogni attributo.
Accedere a più moduli per ogni entità.
Modificare gli elementi di navigazione del modulo.
Interagire con il processo aziendale.
Per ulteriori esempi, vedere Riferimento rapido dello scripting dei moduli.
In questo argomento
Gerarchia dell'oggetto Xrm.Page
Contesto di esecuzione
Raccolte
Descrizioni oggetto
attributo
contesto
controllo
entità
formSelector
spostamento
processo
Sezione
fase
passaggio
scheda
Gerarchia dell'oggetto Xrm.Page
Come illustrato nel diagramma seguente, Xrm.Page offre un contenitore di spazio dei nomi per tre oggetti descritti nella tabella seguente:
Oggetto |
Descrizione |
|---|---|
context |
Offre metodi per recuperare informazioni specifiche di un'organizzazione o un utente o parametri che erano stati passati al modulo in una stringa di query. |
data |
Fornisce accesso ai dati dell'entità e ai metodi per gestire i dati nel modulo e nel controllo del processo aziendale |
ui |
Contiene i metodi per recuperare informazioni sull'interfaccia utente e sulle raccolte per diversi sottocomponenti del modulo. |
.jpeg "Modello a oggetti Xrm.Page")
Contesto di esecuzione
Quando si registra una funzione per il gestore eventi è possibile passare un oggetto di contesto di esecuzione come primo parametro alla funzione. Questo oggetto contiene i metodi che consente di gestire le variabili che si desidera condividere con altri gestori eventi e l'evento di salvataggio. Per ulteriori informazioni, vedere Contesto di esecuzione (riferimento sul lato client) e Argomenti dell'evento di salvataggio (riferimento sul lato client).
Raccolte
Nella seguente tabella sono descritte le raccolte di modello a oggetti Xrm.Page. Per informazioni sui modelli disponibili per le raccolte, vedere Raccolte (riferimento lato client).
Ritiro |
Descrizione |
|---|---|
attributes |
La raccolta Xrm.Page.data.entity.attributes consente di accedere a ogni attributo di entità disponibile nel modulo. Solo gli attributi corrispondenti ai campi aggiunti al modulo sono disponibili. |
controls |
Tre oggetti contengono una raccolta di controlli:
|
navigation.items |
La raccolta Xrm.Page.ui.navigation.items consente di accedere agli elementi di navigazione definiti utilizzando l'area di navigazione dell'editor di moduli. Con TechNet: Moduli aggiornati, gli utenti si spostano utilizzando la barra dei comandi. In TechNet: Moduli classiciquesti si trovano sul lato sinistro del modulo. |
formSelector.items |
Se sono disponibili più moduli per un'entità, è possibile associare ogni modulo con ruoli di sicurezza. Quando i ruoli di sicurezza associati a un utente consentono di visualizzare più di un modulo, la raccolta Xrm.Page.ui.formSelector.items consente di accedere a ogni definizione dei moduli disponibili per tale utente. |
tabs |
È possibile organizzare ogni modulo utilizzando una o più schede. La raccolta Xrm.Page.ui.tabs consente l'accesso a ognuna di tali schede. |
sections |
È possibile organizzare ogni scheda del modulo utilizzando una o più sezioni. La scheda sections consente l'accesso a ognuna di tali sezioni. |
Raccolte processo aziendale
Le raccolte per le fasi e i passaggi in Xrm.Page.data.process sono basate sulla stessa struttura della raccolta ma consentono anche l'aggiunta e la rimozione degli elementi dalle raccolte.
Utilizzare il metodo processo.getStages per accedere alla raccolta di fasi. Utilizzare il metodo fase.getSteps per accedere alla raccolta di fasi.
Descrizioni oggetto
Ogni oggetto ha a disposizione diversi metodi per recuperare i dati, per ottenere o impostare le proprietà dell'oggetto o per eseguire azioni:
attributo
Ogni attributo corrispondente a un attributo dell'entità che è stato aggiunto al modulo come campo. In genere solo agli attributi dell'entità che sono stati aggiunti al modulo come campo sono disponibili. Ogni istanza di un campo è un controllo. Un campo può essere aggiunto a un modulo più volte, il che porta alla creazione di più controlli che fanno riferimento allo stesso attributo.
Nota
Gli attributi compositi hanno comportamenti speciali.Ulteriori informazioni:Scrivere script per gli attributi compositi
Gli attributi vengono suddivisi in categorie per tipo. È possibile determinare il tipo di un attributo utilizzando il metodo getAttributeType.
Anche se tutti gli attributi condividono alcuni metodi comuni, alcuni metodi sono disponibili solo per tipi di attributo specifici. Per ulteriori informazioni, vedere Attributo Xrm.Page.data.entity (riferimento lato client).
Nota
Le informazioni sul tipo di attributo rappresentano il comportamento dell'attributo nel modulo. Non corrisponde necessariamente al tipo di campo definito nell'applicazione o ai tipi AttributeMetadata. Gli attributi di un tipo di campo specifico possono comportarsi in modo diverso a seconda di come vengono formattati.
Nella tabella seguente sono elencati i valori stringa del tipo di attributo previsti per ogni tipo di attributo, tipo di schema e opzione di formattazione.
Tipo di campo applicazione |
Opzione di formattazione |
Tipo di attributo |
|---|---|---|
Valuta |
ND |
money |
Data e ora |
Data e ora, Solo data |
datetime |
Numero decimale |
ND |
decimal |
Numero a virgola mobile |
ND |
double |
Ricerca |
ND |
lookup |
Più righe di testo |
ND |
memo |
Set di opzioni |
ND |
optionset |
Una riga di testo |
Posta elettronica, Testo, Simbolo del titolo, URL, Telefono |
string |
Una riga di testo |
Area testo |
memo |
Stato |
ND |
optionset |
Motivo stato |
ND |
optionset |
Due opzioni |
Due pulsanti di opzione, Casella di controllo, Elenco |
boolean |
Numero intero |
Nessuno, Durata |
integer |
Numero intero |
Lingua, Fuso orario |
optionset |
contesto
Xrm.Page.context offre metodi per recuperare informazioni specifiche di un'organizzazione o un utente o parametri che erano stati passati al modulo in una stringa di query. Per ulteriori informazioni, vedere Contesto sul lato client (riferimento sul lato client).
controllo
Rappresenta un elemento HTML presente nel modulo. Alcuni controlli sono associati a un attributo specifico, mentre altri possono rappresentare controlli non associati ad esempio un IFRAME, risorse Web o una griglia secondaria che è stata aggiunta al modulo.
Utilizzare nomi specifici di controllo nel codice per i controlli IFrame, risorsa Web e griglia secondaria. Tali controlli non sono associati a un attributo. Evitare di includere nomi specifici di controllo nel codice quando il controllo è associato a un attributo. Quando più controlli sono associati a un attributo, i nomi di controllo sono determinati in runtime e possono variare a seconda di dove si trova controllo nel modulo.
Per la maggior parte delle attività correlate a controlli associati ad attributi, si accede ai controlli utilizzando la raccolta di controlli di attributo o attraverso la raccolta dei controlli di una sezione. Anziché fare riferimento a un controllo per nome, si otterrà un riferimento allo stesso in base al contesto della raccolta. In questo caso, il nome non è importante. Vedere l'esempio trovato per l'attributo controls per una modalità di creazione di per l'esecuzione di azioni su tutti i comandi associati a un attributo specifico.
Nota
Gli attributi compositi hanno comportamenti speciali.Ulteriori informazioni:Scrivere script per gli attributi compositi.
Nota
Per la maggior parte del lavoro di sviluppo degli script di Microsoft Dynamics 365, gli sviluppatori possono abituarsi a fare riferimento agli elementi della pagina utilizzando il metodo document.getElementById. Per gli script dei moduli di Microsoft Dynamics 365 questa procedura non è supportata. È importante tenere presente che nell'attributo vengono archiviati i dati e il controllo è semplicemente la presentazione dell'attributo nel modulo. Per i controlli associati agli attributi, potrebbe essere necessario modificare la modalità alla quale si è abituati per accedere ai dati nel modulo.
I controlli vengono suddivisi in categorie per tipo. È possibile determinare il tipo di un controllo utilizzando il metodo 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getControlType. Alcuni metodi di controllo sono disponibili solo per tipi specifici di controlli. Ad esempio, il metodo 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addOption è disponibile solo per i controlli che vengono presentati come set di opzioni. Per ulteriori informazioni, vedere Controllo Xrm.Page.ui (riferimento lato client).
entità
Xrm.Page.data.entity offre i metodi per recuperare informazioni specifiche del record visualizzate nella pagina, il metodo save e una raccolta di tutti gli attributi inclusi nel modulo. Per ulteriori informazioni, vedere Xrm.Page.data.entity (riferimento lato client).
formSelector
RmSelector di Xrm.Page.ui.fo contiene una raccolta di elementi che offre funzionalità per eseguire query sui moduli disponibili per l'utente corrente. Utilizzare il metodo bcf42b09-b672-4f4b-b866-ea7b24cc3ae0#BKMK_navigate per chiudere il modulo corrente e aprirne uno differente. Per ulteriori informazioni, vedere Elemento Xrm.Page.ui.formSelector (riferimento sul lato client).
spostamento
Non contiene alcun metodo. Consente di accedere agli elementi di navigazione attraverso la raccolta di elementi.
processo
Contiene i metodi per recuperare le proprietà di un flusso aziendale.Ulteriori informazioni:Metodi di processo
Sezione
Una sezione contiene i metodi per gestire le modalità di visualizzazione, oltre che di accesso alla scheda che contiene la sezione. Una sezione consente anche di accedere ai controlli al suo interno attraverso una raccolta di controlli.Ulteriori informazioni:Sezione Xrm.Page.ui (riferimento lato client)
fase
Ogni processo ha una raccolta di fasi a cui è possibile accedere utilizzando il metodo getStages di processo.
Una fase è quella attiva.Ulteriori informazioni:Struttura dei processi aziendali
passaggio
I passaggi rappresentano i singoli elementi di dati da raccogliere durante la fase. Ogni fase ha una raccolta di fasi a cui è possibile accedere utilizzando il metodo getSteps del processo.Ulteriori informazioni:Struttura dei processi aziendali
È possibile accedere a un controllo del passaggio nella fase attiva di un controllo di processo aziendale facendo riferimento al nome del controllo con il prefisso speciale “header_process_<control name>”. Ad esempio, per nascondere il passaggio che rappresenta l'attributo purchaseprocess utilizzare le opzioni seguenti:
Xrm.Page.getControl("header_process_purchaseprocess").setVisible(false);
scheda
Una scheda è un gruppo di sezioni in una pagina. Contiene i metodi per modificare la presentazione della scheda. Si accede alle sezioni nella scheda attraverso la raccolta di sezioni. Per ulteriori informazioni, vedere Scheda Xrm.Page.ui (riferimento lato client).
Vedere anche
Riferimento rapido dello scripting dei moduli
Scrivere ed eseguire il debug di script per Dynamics 365 per telefoni e tablet
Creare il codice per moduli di Microsoft Dynamics 365
Scrivere script per gli attributi compositi
Scrivere gli script per i processi aziendali
Utilizzare JavaScript con Microsoft Dynamics 365
Riferimento programmazione sul lato client
Riferimento programmazione sul lato client
Librerie JavaScript per Microsoft Dynamics 365
Personalizzare moduli di entità
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright