Clientcontext (clientreferentie)

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

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.

  • 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 CRM 2015 en Microsoft Dynamics CRM Online 2015 Update.

    De methoden isOutlookClient en isOutlookOnline zijn afgeschaft in Microsoft Dynamics CRM 2013 en zijn niet meer aanwezig in Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update.

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:

    Klant

    Waarde

    Browser

    Web

    Outlook

    Outlook

    Mobiel

    Mobiel

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:

    Klant

    Geretourneerde waarden

    Web, Outlook, Mobile

    OnLine

    Outlook, Mobile

    Offline

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.

Klant

Waarde

Microsoft Dynamics CRM (on-premises)

http(s)://server/org

Microsoft Dynamics CRM Online

https://org.crm.dynamics.com

Microsoft Dynamics CRM voor Outlook met offlinetoegang wanneer offline

https://localhost:2525
  • Retourwaarde
    Type: Tekenreeks

getCurrentTheme

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

Notitie

Deze functie werkt niet met Microsoft Dynamics CRM voor tablets.

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 CRM 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 CRM voor Outlook 2007 of 2010

Office14Silver

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

getIsAutoSaveEnabled

Deze methode is nieuw voor 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 CRMTalenpakket 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 CRM 2015 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"]

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 CRM 2015-formulieren
Het objectmodel Xrm.Page gebruiken
Programmeerreferentie op de client

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht