Klientsidekontekst (klientsidereference)

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

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.

• 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 CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015.

  Metoderne isOutlookClient og isOutlookOnline blev frabedt med Microsoft Dynamics CRM 2013 og findes ikke længere i Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015.

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:

  Klient	Værdi
  Browser	Web
  Outlook	Outlook
  Mobil	Mobil

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:

  Klient	Værdier, der returneres
  Web, Outlook, Mobile	Online
  Outlook, Mobile	Offline

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.

• Returværdi
  Type: streng

getCurrentTheme

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

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 CRM til Outlook. I følgende tabel vises de værdier, der kan returneres fra denne metode.

getIsAutoSaveEnabled

Denne metode er ny for 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: Administrering af automatisk lagring.

getOrgLcid

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

context.getOrgLcid()

• Returværdi
  Type: Tal

  Eksempel: 1033 angiver det engelske sprog.Du kan finde gyldige landestandard-id'er på Oversigt over landestandard-id'er.

  1033
  

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.

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 CRMSprogpakke, som brugeren har valgt som det foretrukne sprog.

context.getUserLcid()

• Returværdi
  Type: Tal

  Eksempel: 1041 angiver det japanske sprog.Du kan finde gyldige landestandard-id'er på Oversigt over landestandard-id'er.

  1041
  

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 CRM 2015.

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"]
  

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
Skrive kode til Microsoft Dynamics CRM 2015-formularer
Bruge Xrm.Page-objektmodel
Programmeringsreference på klientsiden

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret