Riferimento rapido dello scripting dei moduli

Accedere a un attributo per nome

var nameAttribute = Xrm.Page.getAttribute("name");

Assegna l'attributo per il campo Nome account alla variabile nameAttribute

Accedere a tutti gli attributi

var allAttributes = Xrm.Page.getAttribute();

Assegna una matrice di tutti gli attributi nella raccolta Xrm.Page.data.entity.attributes alla variabile allAttributes.

Ottenere il valore di un attributo

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getValue

var nameValue = Xrm.Page.getAttribute("name").getValue();

Assegna il valore del campo Nome account alla variabile nameValue.

Ottenere il valore testuale dell'opzione selezionata di un attributo del set di opzioni

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getText

var addressType = Xrm.Page.getAttribute("address1_addresstypecode").getText();

Assegna il testo dell'opzione selezionata nel campo Tipo di indirizzo alla variabile addressType.

Ottenere il tipo di attributo

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getAttributeType

var attributeType = Xrm.Page.getAttribute(0).getAttributeType();

Assegna il valore stringa che indica il tipo di attributo per il primo attributo alla variabile attributeType.

Ottenere il valore iniziale di un attributo Boolean o optionset

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getInitialValue

var attributeInitialValue = Xrm.Page.getAttribute("address1_addresstypecode").getInitialValue();

Assegna il valore del numero iniziale del campo Tipo di indirizzo alla variabile attributeInitialValue.

Determina se un attributo di ricerca indica una ricerca di partylist.

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getIsPartyList

var isPartyList = Xrm.Page.getAttribute("to").getIsPartyList();

Assegna un valore Boolean che indica se il campo Invia per e-mail entità a indica una ricerca di party list.

Questo metodo è disponibile solo per 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties.

Ottenere la lunghezza massima consentita per un attributo che contiene una stringa

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getMaxLength

var newAccountName = "A Store";
var nameTooLong = (newAccountName.length > Xrm.Page.getAttribute("name").getMaxLength())

Assegna un valore Boolean che indica se il valore della variabile newAccountName supera la lunghezza massima consentita per il campo Nome account alla variabile nameTooLong.

Ottiene il nome logico di un attributo

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getName

var attributeName = Xrm.Page.getAttribute(0).getName();

Assegna il valore del nome logico del primo attributo sulla pagina alla variabile attributeName.

Ottenere un valore del numero che indica il livello di precisione per l'attributo di numero

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getPrecision

var creditLimitPrecision = Xrm.Page.getAttribute("creditlimit").getPrecision();

Assegna il valore di precisione del campo Limite di credito alla variabile creditLimitPrecision.

Modificare se i dati sono necessari in un campo per salvare un record

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_setRequiredLevel

Xrm.Page.getAttribute("creditlimit").setRequiredLevel("required");

Rende il campo Limite di credito obbligatorio.

Controllare se i dati in un attributo verranno salvati quando viene salvato il record

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_setSubmitMode

Xrm.Page.getAttribute("name").setSubmitMode("always");

L'esempio forzerà il valore del campo Nome account per essere sempre salvato anche quando non è stato modificato.

Evitare che un record venga salvato.

function My_PreventSaveFunction(eContext) {
 eContext.getEventArgs().preventDefault();
}

Utilizzare il parametro eContext per acquisire il contesto di esecuzione e utilizzare il metodo preventDefault incluso negli argomenti dell'evento.

Visualizzare un messaggio accanto al controllo per indicare che i dati non sono validi.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setnotification

Xrm.Page.getAttribute("name").controls.forEach(
function (control, i) {
control.setNotification("'Test' is not a valid name.");
})

Imposta un messaggio di errore di convalida su ogni controllo nel modulo dell'attributo Nome account.

Quando viene visualizzato questo messaggio il record non può essere salvato.

Questo metodo è disponibile solo per 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties.

Visualizzare notifiche relative a livello di modulo.

0375b206-d2bf-4034-a41d-fb476ecb4438#BKMK_setFormNotification

Xrm.Page.ui.setFormNotification(
"Hello",
"INFO",
"helloMsg"
);

Visualizza il messaggio "Ciao" nella parte superiore del modulo con un'icona di informazioni di sistema.

Questo metodo è disponibile solo per 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties.

Visualizzare un dialogo di avviso non bloccante con una funzione di richiamata.

72a66f93-92df-42b9-a8fd-b6125c7fe83b#BKMK_alertDialog

var alertDisplayed = false;
Xrm.Utility.alertDialog(
"Showing Alert",
function () { alertDisplayed = true; }
)

Visualizzare un avviso e impostare il valore della variabile alertDisplayed alla chiusura.

Questo metodo è disponibile solo per 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties.

Accedere a tutti i controlli per un attributo specifico

var nameControls = Xrm.Page.getAttribute("name").controls.get();

Assegna una matrice di tutti i controlli per l'attributo name alla variabile nameControls.

Accedere a un controllo per indice

var firstControl = Xrm.Page.getControl(0);

Assegna il primo controllo nella raccolta Xrm.Page.ui.controls alla variabile firstControl.

Accedere a tutti i controlli che soddisfano un criterio specifico

var optionsetControls = Xrm.Page.getControl(function (control, index) {
return control.getControlType() == "optionset";
});

Assegna una matrice di tutti gli attributi nella raccolta Xrm.Page.ui.controls che soddisfano i criteri della funzione anonima, che restituisce true quando il tipo di controllo è "set di opzioni" alla variabile optionsetControls.

Determinare se un controllo è visibile

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getVisible

var isNameVisible = Xrm.Page.getControl("name").getVisible();

Assegna un valore Boolean alla variabile isNameVisible che indica se il campo Nome account è visibile.

Ottenere un riferimento all'attributo per il controllo

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute

var nameAttribute = Xrm.Page.getControl("name").getAttribute();

Assegna l'attributo per il controllo per il campo Nome account alla variabile nameAttribute.

Determinare se un controllo è abilitato

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getDisabled

var disabledControls = Xrm.Page.getControl(function(control, index) { return control.getDisabled(); });

Assegna una matrice di controlli disabilitati alla variabile disabledControls.

Ottenere l'etichetta per un controllo

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getLabel

var nameControlLabel = Xrm.Page.getControl("name").getLabel();

Assegna il valore del controllo per il campo Nome account alla variabile nameControlLabel.

Ottenere il nome di un controllo

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getName

var firstControlName = Xrm.Page.getControl(0).getName();

Assegna il nome del primo controllo nella raccolta Xrm.Page.ui.controls alla variabile firstControlName.

Impostare lo stato attivo su un controllo

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setFocus

Xrm.Page.getControl("name").setFocus();

Imposta lo stato attivo sul campo Nome account.

Aggiungere un'opzione a un controllo di set di opzioni

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addOption

var addressTypeCodeControl = Xrm.Page.getControl("address1_addresstypecode");
var billToAddressOption = addressTypeCodeControl.getAttribute().getOption(1);
addressTypeCodeControl.clearOptions();
addressTypeCodeControl.addOption(billToAddressOption);

Utilizzando un riferimento al controllo per il campo Tipo di indirizzo, accedere all'attributo per il controllo e utilizzare il metodo di 6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getOption per impostare la variabile billToAddressOption sull'opzione che indica l'opzione Fatturazione.

Utilizzare 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_clearOptions per rimuovere tutte le opzioni esistenti e utilizzare addOption per impostare billToAddressOption come l'unica opzione disponibile per il controllo.

Rimuovere una singola opzione da un controllo di set di opzioni.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_removeOption

Xrm.Page.getControl("address1_addresstypecode").removeOption(1);

Rimuovere l'opzione Fatturazione dal controllo per il campo Tipo di indirizzo.

Ottenere il valore del parametro stringa di query dei dati passato a una risorsa Web Silverlight.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getData

var dataValue = Xrm.Page.getControl("WebResource_SilverLightControl").getData();

Assegna il valore passato attraverso il parametro stringa di query dei dati alla variabile dataValue.

Impostare l'URL per il contenuto da visualizzare in IFRAME.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setSrc

Xrm.Page.getControl("IFRAME_targetPage").setSrc("http://www.bing.com");

Impostare un URL per essere IFRAME.src per il controllo.

Ottiene l'oggetto nel modulo che indica la risorsa Web o IFRAME.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getObject

var obj = Xrm.Page.getControl("IFRAME_bing").getObject();

Assegna un riferimento di oggetto alla variabile obj. Per IFRAME questo sarà IFRAME l'elemento di Document Object Model (DOM). Per una risorsa Web Silverlight sarà l'elemento Oggetto che indica il plug-in Silverlight incorporato.

Aggiungere una visualizzazione personalizzata per una ricerca.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addCustomView

var viewId = "{C7034F4F-6F92-4DD7-BD9D-9B9C1E996380}";
var viewDisplayName = "SDK Sample View";
var fetchXml = "<fetch version='1.0' " +
"output-format='xml-platform' " +
"mapping='logical'>" +
"<entity name='account'>" +
"<attribute name='name' />" +
"<attribute name='address1_city' />" +
"<order attribute='name' " +
"descending='false' />" +
"<filter type='and'>" +
"<condition attribute='ownerid' " +
"operator='eq-userid' />" +
"<condition attribute='statecode' " +
"operator='eq' " +
"value='0' />" +
"</filter>" +
"<attribute name='primarycontactid' />" +
"<attribute name='telephone1' />" +
"<attribute name='accountid' />" +
"<link-entity "+
"alias='accountprimarycontactidcontactcontactid' " +
"name='contact' " +
"from='contactid' " +
"to='primarycontactid' " +
"link-type='outer' " +
"visible='false'>" +
"<attribute name='emailaddress1' />" +
"</link-entity>" +
"</entity>" +
"</fetch>";
var layoutXml = "<grid name='resultset' " +
"object='1' " +
"jump='name' " +
"select='1' " +
"icon='1' " +
"preview='1'>" +
"<row name='result' " +
"id='accountid'>" +
"<cell name='name' " +
"width='300' />" +
"<cell name='telephone1' " +
"width='100' />" +
"<cell name='address1_city' " +
"width='100' />" +
"<cell name='primarycontactid' " +
"width='150' />" +
"<cell name='accountprimarycontactidcontactcontactid.emailaddress1' " +
"width='150' " +
"disableSorting='1' />" +
"</row>" +
"</grid>";
Xrm.Page.getControl("parentaccountid").addCustomView(viewId, "account", viewDisplayName, fetchXml, layoutXml, true);

Imposta le variabili viewId, viewDisplayName, fetchXml e layoutXml da passare come argomenti in modo da aggiungere una visualizzazione personalizzata come visualizzazione predefinita al controllo per il campo di ricerca Account padre.

Impostare la visualizzazione predefinita per una ricerca.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setDefaultView

var viewId = "{C7034F4F-6F92-4DD7-BD9D-9B9C1E996380}";
Xrm.Page.getControl("parentaccountid").setDefaultView(viewId);

Imposta la visualizzazione predefinita per il controllo per il campo Account padre sul valore id alla variabile viewId.

Aggiornare i dati visualizzati nella griglia secondaria

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_refresh

Xrm.Page.getControl("accountcontactsgrid").refresh();

Aggiornare i Contattisubgrid.

Specificare se il controllo della data deve visualizzare la porzione di tempo della data.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setShowTime

Xrm.Page.getControl("createdon").setShowTime(false);

Impostare il campo Data creazione in modo che il tempo non venga visualizzato.

Questo metodo è disponibile solo per 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties.

Ottenere il nome di un elemento di navigazione

bcf7210d-df71-43a5-8052-a76de0d4763d#BKMK_getId

var navItemIds = [];
Xrm.Page.ui.navigation.items.forEach(
function (item, index)
{ navItemIds.push(item.getId()) }
);

Creare una matrice navItemIds contenente i valori id di ogni elemento di navigazione nella raccolta Xrm.Page.ui.navigation.items.

Impostare l'etichetta di un elemento di navigazione

bcf7210d-df71-43a5-8052-a76de0d4763d#BKMK_setLabel

Xrm.Page.ui.navigation.items.get("navAddresses").setLabel("Other Addresses");

Modificare l'etichetta dell'elemento di navigazione Altri indirizzi in Altri indirizzi.

Determinare se un elemento di navigazione è visibile

bcf7210d-df71-43a5-8052-a76de0d4763d#BKMK_getVisible

var moreAddressesVisible = Xrm.Page.ui.navigation.items.get("navAddresses").getVisible()

Assegnare un valore Boolean alla variabile moreAddressesVisible per rappresentare se l'elemento di navigazione Altri indirizzi è visibile.

Determinare se una scheda è espansa o compressa

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_getDisplayState

var isGeneralTabExpanded = (Xrm.Page.ui.tabs.get("general").getDisplayState() == "expanded")

Assegnare un valore Boolean alla variabile isGeneralTabExpanded che indica se la scheda Generale è espansa.

Determinare se una scheda è visibile

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_tabgetVisible

var isGeneralTabVisible = Xrm.Page.ui.tabs.get("general").getVisible();

Assegnare un valore Boolean alla variabile isGeneralTabVisible che indica se la scheda Generale è visibile.

Ottenere l'etichetta per una scheda

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_tabgetLabel

var generalTabLabel = Xrm.Page.ui.tabs.get("general").getLabel();

Assegnare l'etichetta della scheda Generale alla variabile generalTabLabel.

Impostare lo stato attivo su una scheda

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_tabsetFocus

Xrm.Page.ui.tabs.get("general").setFocus();

Impostare lo stato attivo sulla scheda Generale.

Ottenere la scheda padre di una sezione

a90df20b-42a6-444e-9912-e0ffab11daec#BKMK_sectionGetParent

Xrm.Page.getControl("industrycode").getParent().getParent().setFocus();

Impostare lo stato attivo sulla scheda che contiene il campo Settore.

Mostrare o nascondere una sezione

a90df20b-42a6-444e-9912-e0ffab11daec#BKMK_sectionSetVisible

Xrm.Page.getControl("industrycode").getParent().setVisible(false);

Nascondere la sezione che contiene il campo Settore.

Modificare l'etichetta per una sezione

a90df20b-42a6-444e-9912-e0ffab11daec#BKMK_sectionSetLabel

Xrm.Page.getControl("industrycode").getParent().setLabel("Detailed Information");

Modificare l'etichetta della sezione che contiene il campo Settore in Informazioni dettagliate.

Aggiungere una funzione all'evento OnSave

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_addOnSave

Xrm.Page.data.entity.addOnSave(myFunction);

Aggiungere la funzione myFunction all'evento OnSave.

Aggiungere una funzione all'evento OnChange di un attributo.

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_addOnChange

Xrm.Page.getAttribute("name").addOnChange(myFunction);

Aggiungere la funzione myFunction all'evento OnChange del campo Nome account.

Aggiungere una funzione all'evento PreSearch di un controllo di ricerca.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addPreSearch

Il seguente esempio di codice riguarda la ricerca Account del modulo Opportunità (parentaccountid). Quando la funzione Sdk.setParentAccountIdFilter è impostata nel gestore eventi Onload del modulo, la funzione Sdk.filterCustomAccounts viene aggiunta all'evento PreSearch per tale ricerca. Ne risulta che solo gli account con il valore Categoria (accountcategorycode) di Cliente preferito (1) verranno restituiti.

  var Sdk = window.Sdk || {};

  Sdk.filterCustomerAccounts = function () {
      //Only show accounts with the type 'Preferred Customer'
      var customerAccountFilter = "<filter type='and'><condition attribute='accountcategorycode' operator='eq' value='1'/></filter>";
      Xrm.Page.getControl("parentaccountid").addCustomFilter(customerAccountFilter, "account");
  }
  //set 'Sdk.setParentAccountIdFilter' in the Opportunity form Onload event handler
  Sdk.setParentAccountIdFilter = function () {
      Xrm.Page.getControl("parentaccountid").addPreSearch(Sdk.filterCustomerAccounts);
  }

Ottenere l'URL per connettersi all'organizzazione.

getClientUrl

var serverUrl = Xrm.Page.context.getClientUrl();

Assegnare una stringa che indica l'URL alla variabile serverUrl.

Ottenere il nome dell'utente corrente.

getUserName

var userName = Xrm.Page.context.getUserName();

Assegnare una stringa che indica il nome dell'utente alla variabile userName.

Questo metodo è disponibile solo per 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties.

Ottenere una matrice di stringhe che indica i valori GUID per ogni ruolo di sicurezza assegnato all'utente corrente e a tutti i team cui l'utente è associato.

getUserRoles

var userRoles = Xrm.Page.context.getUserRoles();

Assegna una matrice di stringhe che indicano i ruoli di sicurezza dell'utente alla variabile userRoles.

Determinare se l'utente sta lavorando offline con il client Microsoft Dynamics 365 per Microsoft Office Outlook con accesso offline.

client.getClientState

var IsOffline = (Xrm.Page.context.client.getClientState() == "Offline");

Assegnare un valore Boolean che indica se l'utente sta lavorando attualmente offline alla variabile IsOffline.

Ottenere il nome logico dell'entità corrente

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_getEntityName

var entityName = Xrm.Page.data.entity.getEntityName();

Assegnare il nome di entità logico alla variabile entityName.

Ottenere l'Id del record corrente

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_getId

var recordId = Xrm.Page.data.entity.getId();

Assegnare l'id del record alla variabile recordId.

Salvare il record corrente

Xrm.Page.data.entity.fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_save

Xrm.Page.data.entity.save();

Salva il record. Esistono argomenti facoltativi. Utilizzare saveandclose o saveandnew per eseguire azioni equivalenti.

Determinare se i dati del record corrente sono stati modificati.

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_getIsDirty

var isDirty = Xrm.Page.data.entity.getIsDirty();

Assegnare un valore Boolean che indica che i dati nel record sono stati modificati alla variabile isDirty.