Delen via

Clientcontext (clientreferentie)

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Uw code moet werken in een context waarin een aantal variabelen tijdens het ontwerpen niet bekend zijn. Het contextobject verschaft methoden om informatie op te halen specifiek voor een organisatie, een gebruiker, of parameters die aan een pagina worden doorgegeven.

Het contextobject is beschikbaar in formulieren door te verwijzen naar Xrm.Page.context.

Voor webresources die buiten een formulier worden uitgevoerd, gebruikt u de Functie GetGlobalContext om een contextobject op te halen.

Contexteigenschappen en -methoden

  • client
    Biedt toegang tot de methoden getClient, getClientState en getFormFactor die u kunt gebruiken om te bepalen welke client wordt gebruikt, of de client verbinding heeft met de server en welk type apparaat wordt gebruikt.

  • getClientUrl
    Retourneert de basis-URL die is gebruikt voor toegang tot de toepassing.

  • getCurrentTheme
    Retourneert een tekenreeks die het huidige Microsoft Office Outlook-thema weergeeft dat de gebruiker heeft gekozen.

  • getIsAutoSaveEnabled
    Retourneert of Autosave voor de organisatie is ingeschakeld.

  • getOrgLcid
    Retourneert de taalcode-id (LCID) die de standaardtaal voor de organisatie vertegenwoordigt.

  • getOrgUniqueName
    Retourneert de unieke tekstwaarde van de naam van de organisatie.

  • getQueryStringParameters
    Retourneert een woordenlijstobject van belangrijke waardeparen die de querytekenreeksargumenten vertegenwoordigen die aan de pagina zijn doorgegeven.

  • getTimeZoneOffsetMinutes
    Retourneert het verschil tussen de lokale tijd en UTC (Coordinated Universal Time).

    Deze methode werd geïntroduceerd met Update 1 voor Microsoft Dynamics CRM Online 2015.

  • getUserId
    Retourneert de GUID van de SystemUser.Id-waarde voor de huidige gebruiker.

  • getUserLcid
    Retourneert de LCID-waarde die de ingerichte taal vertegenwoordigt die de gebruiker heeft geselecteerd als de voorkeurstaal.

  • getUserName
    Geeft de naam de gebruiker die eigenaar is van de record.

  • getUserRoles
    Retourneert een matrix van tekenreeksen die de GUID-waarden vertegenwoordigen van elke beveiligingsrol die de gebruiker heeft of van teams waaraan de gebruiker is gekoppeld.

  • getVersion
    Geeft het versienummer van de Dynamics 365-server als resultaat.

  • prependOrgName
    Plaatst de naam van de organisatie vóór het opgegeven pad.

  • Verwijderde methoden
    Verwijderde methoden zijn verouderd of vervangen door andere methoden. Zorg ervoor dat deze methoden niet in uw scripts wordt gebruikt.

    De methoden getAuthenticationHeader en getServerUrl zijn afgeschaft in Microsoft Dynamics CRM 2011 en zijn niet meer aanwezig in Microsoft Dynamics 365 (online en on-premises).

    De methoden isOutlookClient en isOutlookOnline zijn afgeschaft in Microsoft Dynamics CRM 2013 en zijn niet meer aanwezig in Microsoft Dynamics 365 (online en on-premises).

client

In Microsoft Dynamics CRM 2013 en Microsoft Dynamics CRM Online is het clientobject toegevoegd dat de methoden getClient en getClientState bevat om informatie over de client te krijgen.

Update 1 voor Microsoft Dynamics CRM Online 2015 heeft de methode getFormFactor toegevoegd.

getClient

Geeft een waarde om aan te geven in welke client het script wordt uitgevoerd.

context.client.getClient()

Gebruik dit in plaats van de verwijderde methode isOutlookClient.

  • Retourwaarde
    Type: Tekenreeks

    De geretourneerde waarden zijn:

    Waarde

    Klant

    Web

    Browser

    Outlook

    Outlook

    Mobiel

    Mobiel

    Mobiel

    Interactieve servicehub

getClientState

Gebruik dit in plaats van de verwijderde methode isOutlookOnline.

Geeft een waarde om de status van een client aan te geven.

context.client.getClientState()

  • Retourwaarde
    Type: Tekenreeks

    De mogelijk geretourneerde waarden zijn:

    Waarde

    Klant

    Online

    Web, Outlook, Mobiel, Interactieve servicehub

    Offline

    Outlook, Mobile

getFormFactor

Gebruik deze methode om gegevens op te halen over het type apparaat waarmee de gebruiker werkt.

context.client.getFormFactor()

  • Retourwaarde
    Type: getal

    De mogelijk geretourneerde waarden zijn:

    Waarde

    Formulierfactor

    0

    Onbekend

    1

    Desktop

    2

    Tablet

    3

    Telefoon

  • Opmerkingen
    Deze methode werd geïntroduceerd met Update 1 voor Microsoft Dynamics CRM Online 2015

getClientUrl

Retourneert de basis-URL die is gebruikt voor toegang tot de toepassing.

context.getClientUrl()

Gebruik dit in plaats van de verwijderde methode getServerUrl.

De geretourneerde waarden lijken op de waarden in de volgende tabel.

Waarde

Klant

http(s)://server/org

Dynamics 365 (on-premises)

https://org.crm.dynamics.com

Microsoft Dynamics 365 (online)

https://localhost:2525

Microsoft Dynamics 365 voor Outlook met offlinetoegang wanneer offline
  • Retourwaarde
    Type: Tekenreeks

getCurrentTheme

Retourneert een tekenreeks die het huidige Microsoft Office Outlook-thema weergeeft dat de gebruiker heeft gekozen.

Notitie

Deze functie wordt niet ondersteund voor de mobiele Dynamics 365-clients (telefoons en tablets) en de interactieve servicehub.

context.getCurrentTheme()
  • Retourwaarde
    Type: Tekenreeks

Gebruik deze informatie om een juist thema te selecteren voor uw webresources HTML en Silverlight wanneer ze worden weergegeven in Microsoft Dynamics 365 voor Outlook. De volgende tabel bevat de waarden die door deze methode kunnen worden geretourneerd.

Notitie

De formulieren worden niet aangepast aan wijzigingen in het Microsoft Office-thema, dus het enige geval wanneer u mogelijk wilt aanpassen aan Microsoft Office-thema's is wanneer u een pagina in de navigatie weergeeft met behulp van een HTML-webresource. Zelfs in dit scenario kunnen visuele verschillen moeilijk te detecteren zijn.

Waarde

Thema

standaard

Microsoft Dynamics 365-webtoepassing

Office12Blue

Het thema Blauw van Microsoft Dynamics 365 voor Outlook 2007 of 2010

Office14Silver

Het thema Zilver of Zwart van Microsoft Dynamics 365 voor Outlook 2007 of 2010

getIsAutoSaveEnabled

Deze methode werd geïntroduceerd met Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update

Retourneert of Autosave voor de organisatie is ingeschakeld.

context.getIsAutoSaveEnabled()

  • Retourwaarde
    Type: Boole-waarde.

    Notitie

    Deze functie retourneert de waarde die is ingesteld op het moment dat de pagina wordt geopend. Wanneer u code test die deze waarde gebruikt, moet u de pagina vernieuwen nadat de waarde is gewijzigd om de nieuwe waarde te krijgen.

    Meer informatie:TechNet: Automatisch opslaan beheren.

getOrgLcid

Retourneert de LCID-waarde die de standaardtaal voor de organisatie vertegenwoordigt.

context.getOrgLcid()

getOrgUniqueName

Retourneert de unieke tekstwaarde van de naam van de organisatie.

context.getOrgUniqueName()

  • Retourwaarde
    Type: Tekenreeks

    Voorbeeld: dit komt overeen met de waarde van de organisatienaam

    "adventureworkscycle"

getQueryStringParameters

Retourneert een woordenlijstobject van belangrijke waardeparen die de querytekenreeksargumenten vertegenwoordigen die aan de pagina zijn doorgegeven.

context.getQueryStringParameters()
  • Retourwaarde
    Type: Object

getTimeZoneOffsetMinutes

Retourneert het verschil tussen de lokale tijd en UTC (Coordinated Universal Time).

Notitie

Deze methode werd geïntroduceerd met Update 1 voor Microsoft Dynamics CRM Online 2015.

context.getTimeZoneOffsetMinutes()
  • Retourwaarde
    Type: getal

getUserId

Retourneert de GUID van de SystemUser.Id-waarde voor de huidige gebruiker.

context.getUserId()

  • Retourwaarde
    Type: Tekenreeks

    Voorbeeld:

    "{B05EC7CE-5D51-DF11-97E0-00155DB232D0}"

getUserLcid

Retourneert de LCID-waarde die het Microsoft Dynamics 365 Talenpakket vertegenwoordigt dat de gebruiker heeft geselecteerd als de voorkeurstaal.

context.getUserLcid()

getUserName

Geeft de naam de gebruiker die eigenaar is van de record.

context.getUserName()
  • Retourwaarde
    Type: Tekenreeks

getUserRoles

Retourneert een matrix van tekenreeksen die de GUID-waarden vertegenwoordigen van elke beveiligingsrol die de gebruiker heeft of van teams waaraan de gebruiker is gekoppeld.

Raadpleeg Hoe op rollen gebaseerde beveiliging kan worden gebruikt om toegang tot entiteiten te beheren in Microsoft Dynamics 365 voor meer informatie over beveiligingsrollen.

context.getUserRoles()

  • Retourwaarde
    Type: matrix

    Voorbeeld: deze gebruiker heeft slechts één beveiligingsrol die aan zijn of haar gebruikersaccount is gekoppeld. De JSON-weergave van deze matrix met één waarde is:

    ["cf4cc7ce-5d51-df11-97e0-00155db232d0"]

getVersion

Geeft het versienummer van de Dynamics 365-server als resultaat.

context.getVersion()
  • Retourwaarde
    Type: Tekenreeks

prependOrgName

Plaatst de naam van de organisatie vóór het opgegeven pad.

context.prependOrgName(sPath)

  • Argumenten
    Type: Tekenreeks

    Een lokaal pad naar een resource.

  • Retourwaarde
    Type: Tekenreeks

    De geretourneerde waarde volgt dit patroon:

    "/"+ OrgName + sPath

Verwijderde methoden

Verwijderde methoden zijn verouderd of vervangen door andere methoden. Zorg ervoor dat deze methoden niet in uw scripts wordt gebruikt.

De volgende methoden zijn afgeschaft met eerdere versies van Microsoft Dynamics 365 en zijn niet langer aanwezig in de huidige versie:

Zie ook

Functie GetGlobalContext en ClientGlobalContext.js.aspx (clientreferentie)
Beknopte naslag voor het opstellen van formulierscripts
Code schrijven voor Microsoft Dynamics 365-formulieren
Het objectmodel Xrm.Page gebruiken
Programmeerreferentie op de client

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht