Del via


Overfør parametre til en URL-adresse ved hjælp af båndet

 

Udgivet: januar 2017

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

Handlinger på båndet defineres i elementet <Actions> (RibbonDiffXml) i et <CommandDefinition> (RibbonDiffXml)-element. Der er flere måder at overføre kontekstafhængige Microsoft Dynamics 365-oplysninger som parametre for forespørgselsstrengen til en URL-adresse ved hjælp af båndet.

Brug attributten PassParams til at angive dynamiske værdier

Ved at overføre parametre til destinations-URL-adressen ved hjælp af attributten PassParams sendes der oplysninger til destinationsprogrammet om konteksten for posten eller brugeren. Alle parametrene overføres, hvis kontrolelementet på båndet konfigureres ved hjælp af attributten PassParams. I nedenstående tabel vises de parametre, der overføres.

Parameter

Navn

Beskrivelse

typename

Objektnavn

Navnet på objektet. Dette omfatter tilpasningspræfikset, for eksempel new_entityname, for brugerdefinerede objekter.

type

Objekttypekode

Heltal, der entydigt identificerer objektet i den aktuelle organisation.

Bemærk

Entity Type Code-værdierne bestemmes af den rækkefølge, hvori et objekt er oprettet i en organisation.Entity Type Codes for brugerdefinerede objekter er typisk forskellige i forskellige organisationer.

id

Objekt-GUID

Globalt entydigt id (GUID), der repræsenterer en post.

orgname

Organisationsnavn

Entydigt navn på organisationen.

userlcid

Brugersprogkode

Sprogkode-id, der bruges af den aktuelle bruger.

orglcid

Organisationssprogkode

Sprogkode-id, der repræsenterer udgangssproget for organisationen.

Sprogkoder er fire- eller femcifrede landestandard-id'er. Du kan finde gyldige landestandard-id'er på Locale ID (LCID) Chart.

Bemærk

Vi anbefaler, at du bruger objektets navn i stedet for objekttypekoden, fordi objekttypekoden for brugerdefinerede objekter kan være forskellig i forskellige Microsoft Dynamics 365-installationer.

Eksempel

Følgende eksempel viser URL-adressen uden parametre:

http://myserver/mypage.aspx

I følgende eksempel vises de parametre, der er inkluderet, når kontrolelementet på båndet præsenteres for firmaobjektet for en organisation, der hedder "AdventureWorksCycle", når brugerens sprog og udgangssproget for organisationen er engelsk, og GUID for firmaposten er DBD5DBFB-0666-DC11-A5D9-0003FF9CE217:

http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D

Brug en Querystring-parameter i URL-adressen

Du kan medtage en querystring-parameter i URL-adresse-attributten. Dette kan være meget nyttigt, hvis du vil åbne en bestemt Microsoft Dynamics 365-post eller se ved hjælp af Åbne formularer, visninger, dialoger og rapporter med en URL-adresse.

Bemærk

Du kan ikke importere båndet, hvis URL-adressen indeholder ampersandtegnet (&), der bruges til at adskille flere querystring-parametre i URL-adressen. Dette tegn gør XML-filen ugyldig. Du skal erstatte &-tegnet i URL-attributværdien med "&amp;".

Læsning af overførte parametre

Overførte parametre læses normalt på .aspx-destinationssiden ved hjælp af egenskaben HttpRequest.QueryString.Flere oplysninger:HttpRequest.QueryString-egenskab

Bemærk

Hvis målet for URL-adressen er en webressource, kan det acceptere de parametre, der er beskrevet i emnet Videreføre parametre til HTML-webressourcer. Den eneste mulighed for at overføre brugerdefinerede værdier, der er ved at medtage dem i parameteren data. Det er nødvendigt med en vis særbehandling for at medtage flere værdier i en enkelt parameter.Flere oplysninger:Eksempel: Send flere værdier til en webressource via dataparameteren

Se også

Tilpasse kommandoer og båndet
Åbne formularer, visninger, dialoger og rapporter med en URL-adresse
<Url> (RibbonDiffXml)
Definere visningsregler for fane
Eksempel: Eksportere definitionerne for båndene

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret