Condividi tramite


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.

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:

ui.controls

La raccolta Xrm.Page.ui.controls consente di accedere a tutti i controlli presenti nel modulo.

attribute.controls

Poiché un attributo può avere più di un controllo nel modulo, la raccolta consente l'accesso a ognuno di essi. La raccolta conterrà solo un elemento a meno che non siano aggiunti al modulo più controlli per l'attributo.

section.controls

La raccolta contiene solo i controlli disponibili nella sezione.

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