Del via

Klientsidekontekst (klientsidereference)

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Koden skal fungere i en kontekst, hvor et antal variabler ikke er kendt på designtidspunktet. Kontekstobjektet indeholder metoder til at hente oplysninger, der er specifikke for en organisation, en bruger eller parametre, der blev overført til en side.

Du kan få adgang til kontekstobjektet i formularer ved at referere til Xrm.Page.context.

For webressourcer, der køres uden for en formular, skal du bruge GetGlobalContext-funktion til at hente et kontekstobjekt.

Kontekstegenskaber og metoder

  • klient
    Giver adgang til metoderne getClient, getClientState og getFormFactor, som du kan bruge til at bestemme, hvilken klient der bruges, om klienten har forbindelse til serveren, og hvilken type enhed der bruges.

  • getClientUrl
    Returnerer den grundlæggende URL, der blev brugt til at få adgang til programmet.

  • getCurrentTheme
    Returnerer en streng, der repræsenterer det aktuelle Microsoft Office Outlook-tema, som er valgt af brugeren.

  • getIsAutoSaveEnabled
    Returnerer, om automatisk lagring er aktiveret for organisationen.

  • getOrgLcid
    Returnerer den LCID-værdi (language code identifier), der repræsenterer udgangssproget for organisationen.

  • getOrgUniqueName
    Returnerer den entydige tekstværdi for organisationens navn.

  • getQueryStringParameters
    Returnerer et ordbogsobjekt med nøgle-værdipar, som repræsenterer de forespørgselsstrengargumenter, der blev overført til siden.

  • getTimeZoneOffsetMinutes
    Returnerer forskellen mellem den lokale tid og UTC-tid.

    Denne metode blev introduceret i Opdatering 1 til Microsoft Dynamics CRM Online 2015.

  • getUserId
    Returnerer GUID'ET for SystemUser.Id-værdien for den aktuelle bruger.

  • getUserLcid
    Returnerer den LCID-værdi, der repræsenterer det klargjorte sprog, som brugeren har valgt som det foretrukne sprog.

  • getUserName
    Returnerer navnet på den aktuelle bruger.

  • getUserRoles
    Returnerer en matrix af strenge, der repræsenterer GUID-værdier for hver af de sikkerhedsroller, som brugeren er tilknyttet til, eller eventuelle teams, som brugeren er tilknyttet til.

  • getVersion
    Returnerer versionsnummeret på Dynamics 365-serveren.

  • prependOrgName
    Tilføjer organisationsnavnet foran den angivne sti.

  • Fjernede metoder
    Fjernede metoder er enten forældede eller erstattes med andre metoder. Du skal sørge for, at disse metoder ikke anvendes i dine scripts.

    Metoderne getAuthenticationHeader og getServerUrl blev frabedt med Microsoft Dynamics CRM 2011 og findes ikke længere i Microsoft Dynamics 365 (online og i det lokale miljø).

    Metoderne isOutlookClient og isOutlookOnline blev frabedt med Microsoft Dynamics CRM 2013 og findes ikke længere i Microsoft Dynamics 365 (online og i det lokale miljø).

klient

Microsoft Dynamics CRM 2013 og Microsoft Dynamics CRM Online tilføjede det klientobjekt, der indeholder metoderne getClient og getClientState til at få oplysninger om klienten.

Opdatering 1 til Microsoft Dynamics CRM Online 2015 har tilføjet getFormFactor-metoden.

getClient

Returnerer en værdi for at angive, hvilken klient scriptet kører på.

context.client.getClient()

Brug denne metode i stedet for den fjernede metode isOutlookClient.

  • Returværdi
    Type: streng

    De returnerede værdier er:

    Værdi

    Klient

    Internet

    Browser

    Outlook

    Outlook

    Mobil

    Mobil

    Mobil

    Interaktiv servicehub

getClientState

Brug denne metode i stedet for den fjernede metode isOutlookOnline.

Returnerer en værdi, der angiver tilstanden for klienten.

context.client.getClientState()

  • Returværdi
    Type: streng

    De mulige returnerede værdier er:

    Værdi

    Klient

    Online

    Web, Outlook, mobil, interaktiv tjenestehb

    Offline

    Outlook, Mobile

getFormFactor

Brug denne metode til at få oplysninger om, hvilken type enhed brugeren anvender.

context.client.getFormFactor()

  • Returværdi
    Type: Tal

    De mulige returnerede værdier er:

    Værdi

    Formfaktor

    0

    Ukendt

    1

    Skrivebord

    2

    Tablet

    3

    Telefon

  • Bemærkninger
    Denne metode blev introduceret i Opdatering 1 til Microsoft Dynamics CRM Online 2015

getClientUrl

Returnerer den grundlæggende URL, der blev brugt til at få adgang til programmet.

context.getClientUrl()

Brug denne metode i stedet for den fjernede metode getServerUrl.

De returnerede værdier ligner dem, der er angivet i følgende tabel.

Værdi

Klient

http(s)://server/org

Dynamics 365 (i det lokale miljø)

https://org.crm.dynamics.com

Microsoft Dynamics 365 (online)

https://localhost:2525

Microsoft Dynamics 365 til Outlook med offlineadgang når du arbejder offline
  • Returværdi
    Type: streng

getCurrentTheme

Returnerer en streng, der repræsenterer det aktuelle Microsoft Office Outlook-tema, som er valgt af brugeren.

Bemærk

Denne funktion understøttes ikke Dynamics 365-mobilklienter (telefoner og tablets) og den interaktive tjenestehub.

context.getCurrentTheme()
  • Returværdi
    Type: streng

Brug disse oplysninger til at vælge et passende tema til dine HTML- og Silverlight-webressourcer, når de vises i Microsoft Dynamics 365 til Outlook. I følgende tabel vises de værdier, der kan returneres fra denne metode.

Bemærk

Formularer tilpasser sig ikke til ændringer i Microsoft Office-temaet, så det eneste tilfælde, hvor det kan være en god ide at tilpasse sig til Microsoft Office-temaerne, er, når du får vist en side i navigationen ved hjælp af en HTML-webressource. Selv i dette scenarie kan det være svært af få øje på visuelle forskelle.

Værdi

Tema

standard

Microsoft Dynamics 365-webprogram

Office12Blue

Microsoft Dynamics 365 til Outlook 2007 eller 2010 blåt tema

Office14Silver

Microsoft Dynamics 365 til Outlook 2007 eller 2010 sølv eller sort tema

getIsAutoSaveEnabled

Denne metode blev introduceret i Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015

Returnerer, om automatisk lagring er aktiveret for organisationen.

context.getIsAutoSaveEnabled()

  • Returværdi
    Type: Boolesk

    Bemærk

    Denne funktion returnerer den værdi, der er angivet på det tidspunkt, hvor siden åbnes. Når du tester kode ved hjælp af denne værdi, skal du opdatere siden, når du har ændret værdien, for at få den nye værdi.

    Flere oplysninger:TechNet: Administration af automatisk lagring.

getOrgLcid

Returnerer den LCID-værdi, der repræsenterer udgangssproget for organisationen.

context.getOrgLcid()

getOrgUniqueName

Returnerer den entydige tekstværdi for organisationens navn.

context.getOrgUniqueName()

  • Returværdi
    Type: streng

    Eksempel: Svarer til værdien for organisationens navn

    "adventureworkscycle"

getQueryStringParameters

Returnerer et ordbogsobjekt med nøgle-værdipar, som repræsenterer de forespørgselsstrengargumenter, der blev overført til siden.

context.getQueryStringParameters()
  • Returværdi
    Type: objekt

getTimeZoneOffsetMinutes

Returnerer forskellen mellem den lokale tid og UTC-tid.

Bemærk

Denne metode blev introduceret i Opdatering 1 til Microsoft Dynamics CRM Online 2015.

context.getTimeZoneOffsetMinutes()
  • Returværdi
    Type: Tal

getUserId

Returnerer GUID'ET for SystemUser.Id-værdien for den aktuelle bruger.

context.getUserId()

  • Returværdi
    Type: streng

    Eksempel:

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

getUserLcid

Returnerer den LCID-værdi, der repræsenterer det Microsoft Dynamics 365Sprogpakke, som brugeren har valgt som det foretrukne sprog.

context.getUserLcid()

getUserName

Returnerer navnet på den aktuelle bruger.

context.getUserName()
  • Returværdi
    Type: streng

getUserRoles

Returnerer en matrix af strenge, der repræsenterer GUID-værdier for hver af de sikkerhedsroller, som brugeren er tilknyttet til, eller eventuelle teams, som brugeren er tilknyttet til.

Du kan finde flere oplysninger om sikkerhedsroller i Hvordan rollebaseret sikkerhed kan bruges til at styre adgangen til objekter i Microsoft Dynamics 365.

context.getUserRoles()

  • Returværdi
    Type: Matrix

    Eksempel: Denne bruger har kun én sikkerhedsrolle, der er knyttet til vedkommendes brugerkonto.JSON-repræsentationen i denne matrix med en enkelt værdi er:

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

getVersion

Returnerer versionsnummeret på Dynamics 365-serveren.

context.getVersion()
  • Returværdi
    Type: streng

prependOrgName

Tilføjer organisationsnavnet foran den angivne sti.

context.prependOrgName(sPath)

  • Argumenter
    Type: streng

    En lokal sti til en ressource.

  • Returværdi
    Type: streng

    Den returnerede værdi følger dette mønster:

    "/"+ OrgName + sPath

Fjernede metoder

Fjernede metoder er enten forældede eller erstattes med andre metoder. Du skal sørge for, at disse metoder ikke anvendes i dine scripts.

Følgende metoder blev frabedt med tidligere versioner af Microsoft Dynamics 365 og findes ikke længere i den aktuelle version:

  • getAuthenticationHeader
    Denne metode understøttede brug af Microsoft Dynamics CRM 4.0-webtjenesterne, som ikke længere findes.

  • getServerUrl
    Denne metode blev erstattet af getClientUrl.

  • isOutlookClient
    Denne metode er blevet erstattet af klient.getClient.

  • isOutlookOnline
    Denne metode er blevet erstattet af klient.getClientState.

Se også

GetGlobalContext-funktion og ClientGlobalContext.js.aspx (klientsidreference)
Formularscripter - hurtig henvisning
Skriv kode til Microsoft Dynamics 365-formularer
Bruge Xrm.Page-objektmodel
Programmeringsreference på klientsiden

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret