Delen via


Xrm.Utility (clientreferentie)

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Het Xrm.Utility-object biedt een container voor nuttige functies die niet onmiddellijk verband houden met de huidige pagina.

Deze functies zijn beschikbaar op elke toepassingspagina die scriptgebruik ondersteunt. U kunt ze gebruiken in formulierscripts of in lintopdrachten. Voor HTML-webresources zijn zij beschikbaar wanneer u de pagina ClientGlobalContext.js.aspx opneemt. Zie Functie GetGlobalContext en ClientGlobalContext.js.aspx (clientreferentie) voor meer informatie.

Functies

  • Dialoogvensters
    Gebruik alertDialog- en confirmDialog-weergaveberichten voor gebruikers en stel code in die wordt uitgevoerd op basis van hun reactie. Deze functies moeten worden gebruikt met Microsoft Dynamics CRM voor tablets in plaats van met de methoden window.alert en window.confirm.

  • isActivityType
    Bepaal of een entiteit een activiteitsentiteit is.

  • openEntityForm
    Opent een entiteitsformulier.

  • openQuickCreate
    Gebruik voor Update 1 voor Microsoft Dynamics CRM Online 2015 of later deze functie om een formulier voor snelle invoer te maken te openen. U kunt deze functie gebruiken voor het instellen van standaardwaarden met kenmerktoewijzingen of voor specifieke kenmerken. Als de gebruiker de record opslaat, kunt u een verwijzing naar de gemaakte record vastleggen.

  • openWebResource
    Opent een HTML-webresource.

Dialoogvensters

Er zijn twee typen dialoogvensters: alertDialog en confirmDialog. Deze zijn toegevoegd voor gebruik met scripts die werken met Microsoft Dynamics CRM voor tablets.CRM voor tablets staat niet het gebruik van JavaScript-toe die de stroom van code blokkeren, zoals window.alert en window.confirm. Gebruik deze methoden in plaats van die methoden wanneer u een bericht moet weergeven aan de gebruiker. Het belangrijkste verschil is dat deze methoden geen code blokkeren totdat een gebruiker ze sluit. Zij bevatten een parameter voor een callbackfunctie om aan te geven welke code moet worden uitgevoerd afhankelijk van de respons van de gebruiker.

Notitie

In Microsoft Dynamics CRM voor tablets wordt elk gebruik van de methode window.alert genegeerd om Xrm.Utility.alertDialog te gebruiken zonder callback. Hiermee wordt het bericht weergegeven maar wordt de uitvoering van code niet geblokkeerd zoals bij window.alert. Deze toewijzing van window.alert aan Xrm.Utility.alertDialog in CRM voor tablets is afgeschaft en wordt verwijderd in de volgende hoofdversie. U moet eventuele bestaande code migreren om Xrm.Utility.alertDialog te gebruiken in plaats van window.alert.

alertDialog

Hiermee wordt een dialoogvenster weergegeven dat een door de toepassing gedefinieerd bericht bevat.

Xrm.Utility.alertDialog(message,onCloseCallback)
  • Parameters

    Naam

    Type

    Vereist

    Beschrijving

    bericht

    Tekenreeks

    Ja

    De tekst van het bericht dat moet worden weergegeven in het dialoogvenster.

    onCloseCallback

    Functie

    Nee

    Een functie die moet worden uitgevoerd als op de knop OK wordt geklikt.

  • Opmerkingen
    Deze methode is alleen beschikbaar voor Bijgewerkte entiteiten.

confirmDialog

Hiermee wordt een bevestigingsvenster weergegeven dat een optioneel bericht alsmede de knoppen OK en Annuleren bevat.

Xrm.Utility.confirmDialog(message,yesCloseCallback,noCloseCallback)
  • Parameters

    Naam

    Type

    Vereist

    Beschrijving

    bericht

    Tekenreeks

    Ja

    De tekst van het bericht dat moet worden weergegeven in het dialoogvenster

    yesCloseCallback

    Functie

    Nee

    Een functie die moet worden uitgevoerd als op de knop OK wordt geklikt.

    noCloseCallback

    Functie

    Nee

    Een functie die moet worden uitgevoerd als op de knop Annuleren wordt geklikt.

  • Opmerkingen
    Deze methode is alleen beschikbaar voor Bijgewerkte entiteiten.

isActivityType

Bepaal of een entiteit een activiteitsentiteit is.

Xrm.Utility.isActivityType(entityName)
  • Parameter

    Naam

    Type

    Vereist

    Beschrijving

    entityName

    Tekenreeks

    Ja

    De logische naam van een entiteit.

  • Retourwaarde

    Type

    Beschrijving

    Boolean

    Waar als de entiteit een activiteitsentiteit is, anders onwaar.

openEntityForm

Opent een entiteitsformulier voor een nieuwe of bestaande entiteitsrecord met de optie die u instelt als parameters.

Xrm.Utility.openEntityForm(name,id,parameters,windowOptions)
  • Parameters

    Naam

    Type

    Vereist

    Beschrijving

    naam

    Tekenreeks

    Ja

    De logische naam van de entiteit.

    id

    Tekenreeks

    Nee

    De tekenreeksweergave van een unieke id of de te openen record in het formulier. Als deze niet ingesteld, wordt een formulier voor het maken van een nieuwe record geopend.

    parameters

    Object

    Nee

    Een woordenlijstobject dat extra parameters doorgeeft aan het formulier. Ongeldige parameters veroorzaken een fout.

    Geldige extra querytekenreeksparameters zijn:

    windowOptions

    Object

    Nee

    Gebruik voor Update 1 voor Microsoft Dynamics CRM Online 2015 of later deze optionele parameter in de webtoepassing om te bepalen hoe het formulier wordt geopend. U kunt kiezen een formulier te openen in een nieuw venster door een woordenlijstobject door te geven waarvoor een booleaanse eigenschap openInNewWindow is ingesteld op true.

    Deze parameter wordt genegeerd in CRM voor tablets en CRM voor telefoons.

  • Opmerkingen
    Het gebruik van deze functie helpt ervoor te zorgen dat gebruikers niet worden gevraagd zich opnieuw aan te melden onder bepaalde omstandigheden.

  • Voorbeelden
    Een nieuwe accountrecord openen met het standaardformulier

    Xrm.Utility.openEntityForm("account");
    

    Een bestaande accountrecord openen met het standaardformulier

    Xrm.Utility.openEntityForm("account","A85C0252-DF8B-E111-997C-00155D8A8410");
    

    Een nieuwe accountrecord openen met een bepaald formulier en met instelling van standaardwaarden

    var parameters = {};
    parameters["formid"] = "b053a39a-041a-4356-acef-ddf00182762b";
    parameters["name"] = "Test";
    parameters["telephone1"] = "(425) 555-1234";
    Xrm.Utility.openEntityForm("account", null, parameters);
    

    Een nieuwe accountrecord openen met het standaardformulier in een nieuw venster

    var windowOptions = {
     openInNewWindow: true
    };
    Xrm.Utility.openEntityForm("account",null,null,windowOptions);
    

openQuickCreate

Gebruik voor Update 1 voor Microsoft Dynamics CRM Online 2015 of later deze functie om een formulier voor snelle invoer te maken te openen. U kunt deze functie gebruiken voor het instellen van standaardwaarden met kenmerktoewijzingen of voor specifieke kenmerken. Als de gebruiker de record opslaat, kunt u een verwijzing naar de gemaakte record vastleggen.

Xrm.Utility.openQuickCreate(entityLogicalName,createFromEntity,parameters).then(successCallback, errorCallback);
  • Parameters

    Naam

    Type

    Vereist

    Beschrijving

    entityLogicalName

    Tekenreeks

    Ja

    De logische naam van de te maken entiteit.

    createFromEntity

    Opzoeken

    Nee

    Geeft een record aan die standaardwaarden verstrekt op basis van toegewezen kenmerkwaarden.

    Een opzoekobject heeft de volgende String-eigenschappen:

    • entityType: de logische naam van de entiteit.

    • id: een tekenreeksweergave van een GUID-waarde voor de record.

    • name: de primaire kenmerkwaarde van de record.

    parameters

    Object

    Nee

    Een woordenlijstobject dat extra querytekenreeksparameters doorgeeft aan het formulier. Ongeldige querytekenreeksparameters veroorzaken een fout.

    Geldige extra querytekenreeksparameters zijn:

    successCallback

    Functie

    Nee

    De functie die wordt aangeroepen als een record wordt gemaakt. Aan deze functie wordt een object doorgegeven als een parameter. Dit object bevat een eigenschap savedEntityReference met de volgende eigenschappen om de gemaakte record te identificeren:

    • entityType: de logische naam van de entiteit.

    • id: een tekenreeksweergave van een GUID-waarde voor de record.

    • name: de primaire kenmerkwaarde van de gemaakte record.

    errorCallback

    Functie

    Nee

    Een functie die moet worden aangeroepen als de bewerking is mislukt.

    Een object met de volgende eigenschappen wordt doorgegeven:

    • errorCode: Number. De foutcode.

    • bericht: String. Een gelokaliseerd foutbericht.

  • Opmerkingen
    Deze functie is alleen beschikbaar voor Update 1 voor Microsoft Dynamics CRM Online 2015 of later.

    Er geldt een limiet van 10 geneste formulieren voor snelle invoer in de webtoepassing. Als deze limiet wordt overschreden, wordt met deze functie het complete entiteitsformulier geopend in plaats van het formulier voor snelle invoer.

  • Voorbeeld
    Als deze code wordt uitgevoerd in een entiteitsformulier voor accounts, wordt een formulier voor snelle invoer gemaakt om een nieuwe onderliggende account te maken waarvoor een standaardnaam is ingesteld die de naam van de bovenliggende account bevat.

    var thisAccount = {
        entityType: "account",
        id: Xrm.Page.data.entity.getId()
    };
    var callback = function (obj) {
        console.log("Created new " + obj.savedEntityReference.entityType + " named '" + obj.savedEntityReference.name + "' with id:" + obj.savedEntityReference.id);
    }
    var setName = { name: "Child account of " + Xrm.Page.getAttribute("name").getValue() };
    Xrm.Utility.openQuickCreate("account", thisAccount, setName).then(callback, function (error) {
        console.log(error.message);
    });
    

    Als deze code wordt uitgevoerd met ontwikkelingshulpmiddelen voor de browser (F12-hulpmiddelen) geeft het volgende de uitvoer naar de console aan als de code wordt uitgevoerd in de context van een account met met naam 'A. Datum Corporation (sample)' en de gebruiker de standaardnaam die is ingesteld voor de nieuwe onderliggende account niet heeft gewijzigd.

    Created new account named 'Child account of A. Datum Corporation (sample)' with id:{1D4BFF87-E8C5-E411-80CF-00155DB58496}
    

openWebResource

Opent een HTML-webresource.

Notitie

Deze functie werkt niet met Microsoft Dynamics CRM voor tablets.

Xrm.Utility.openWebResource(webResourceName,webResourceData,width, height)
  • Parameters

    Naam

    Type

    Vereist

    Beschrijving

    webResourceName

    Tekenreeks

    Ja

    De naam van de HTML-webresource die moet worden geopend.

    webResourceData

    Tekenreeks

    Nee

    Gegevens die in de gegevensparameter moeten worden doorgegeven.

    width

    Nummer

    Nee

    De breedte van het te openen venster in pixels.

    height

    Nummer

    Nee

    De hoogte van het te openen venster in pixels.

  • Retourwaarde
    Vensterobject.

  • Opmerkingen
    Een HTML-webresource kan de parameterwaarden accepteren die zijn beschreven in Geef parameters door aan HTML webresources. Deze functie zorgt alleen voor het doorgeven van de optionele gegevensparameter. Als u waarden wilt doorgeven voor andere geldige parameters, moet u deze toevoegen aan de aan de parameter webResourceName.

  • Voorbeelden
    Open een HTML-webresource genaamd "new_webResource.htm"

    Xrm.Utility.openWebResource("new_webResource.htm");
    

    Open een HTML-webresource met een enkel gegevensitem voor de gegevensparameter

    Xrm.Utility.openWebResource("new_webResource.htm","dataItemValue");
    

    Open een HTML-webresource die meerdere waarde doorgeeft via de gegevensparameter

    var customParameters = encodeURIComponent("first=First Value&second=Second Value&third=Third Value");
    Xrm.Utility.openWebResource("new_webResource.htm",customParameters);
    

    Notitie

    Deze waarden moeten wordt opgehaald uit de waarde van de gegevensparameter in de HTML-webresource. Zie Voorbeeld: Meerdere waarden aan een webresource doorgeven met de gegevensparameter voor meer informatie

    Open een HTML-webresource met de parameters die worden verwacht door HTML-webresources

    Xrm.Utility.openWebResource("new_webResource.htm?typename=account&userlcid=1033");
    

    Zie Geef parameters door aan HTML webresources voor meer informatie.

    Open een HTML-webresource, waarbij de hoogte en breedte worden ingesteld

    Xrm.Utility.openWebResource("new_webResource.htm", null, 300,300);
    

Zie ook

Programmeerreferentie op de client
Open formulieren, weergaven, dialogen en rapporten met een URL
Veldwaarden instellen via parameters die worden doorgegeven aan een formulier
Een formulier configureren om aangepaste querytekenreeksparameters te accepteren
Beknopte naslag voor het opstellen van formulierscripts
Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
Het objectmodel Xrm.Page gebruiken

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht