Delen via

Parameters aan een URL doorgeven met het lint

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Lintacties worden gedefinieerd in het <Actions> (RibbonDiffXml)-element van een <CommandDefinition> (RibbonDiffXml)-element. Er zijn diverse manieren om contextuele Microsoft Dynamics 365-informatie als queryparameters aan een URL door te geven met behulp van het lint.

Gebruik het PassParams-kenmerk om dynamische waarden in te stellen.

Parameters aan de doel-URL doorgeven met behulp van het kenmerk PassParams levert informatie aan de doeltoepassing over de context van de record of de gebruiker. Alle parameters worden doorgegeven als het lintbesturingselement wordt geconfigureerd met het kenmerk . De volgende tabel bevat de parameters die worden doorgegeven.

Parameter

Naam

Beschrijving

typename

Naam van de entiteit

Naam van de entiteit. Voor aangepaste entiteiten bevat dit het aanpassingsprefix, bijvoorbeeld, new_entityname.

type

Entiteittypecode

Geheel getal dat uniek de entiteit in de huidige organisatie identificeert.

Notitie

Entity Type Code-waarden worden vastgesteld op basis van de volgorde waarin een entiteit is gemaakt in een organisatie.Entity Type Codes voor aangepaste entiteiten wijken gewoonlijk af in verschillende organisaties.

id

Object-GUID

Globally unique identifier (GUID) die een record vertegenwoordigt.

orgname

Organisatienaam

Unieke naam van de organisatie.

userlcid

Gebruikerstaalcode

Taalcode-id die de huidige gebruiker gebruikt.

orglcid

Taalcode van organisatie

De taalcode-id die de standaardtaal voor de organisatie weergeeft.

Taalcodes bestaan uit vier- of vijfcijferige landinstellingen-id's. U vindt de geldige LCID-waarden in het Diagram van landinstellingen-id's (LCID's).

Notitie

We raden aan dat u de entiteitnaam in plaats van de entiteitstypecode gebruikt omdat de entiteitstypecode tussen Microsoft Dynamics 365-installaties kan verschillen.

Voorbeeld

Het volgende voorbeeld toont de URL zonder parameters:

http://myserver/mypage.aspx

In het volgende voorbeeld ziet u de opgenomen parameters wanneer het lintbesturingselement wordt gepresenteerd voor de accountentiteit, voor een organisatie genaamd "AdventureWorksCycle", als de taal van de gebruiker en de standaardtaal van de organisatie Engels is, en de GUID voor de accountrecord DBD5DBFB-0666-DC11-A5D9-0003FF9CE217 is:

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

Een querytekenreeksparameter gebruiken in de URL

U kunt een querystring-parameter opnemen in het URL-kenmerk. Dit kan heel nuttig zijn als u een specifieke Microsoft Dynamics 365-record wilt openen of weergeven met behulp van Open formulieren, weergaven, dialogen en rapporten met een URL.

Notitie

U kunt het lint niet importeren als de URL de ampersand (&) bevat die wordt gebruikt om meerdere querystring-parameters te scheiden in de URL. Dit teken maakt de XML ongeldig. U moet een escape voor het ampersandteken in de URL-kenmerkwaarde plaatsen met "&amp;".

Doorgegeven parameters lezen

Doorgegeven parameters worden gewoonlijk in de doel-.aspx-pagina gelezen met behulp van de eigenschap HttpRequest.QueryString.Meer informatie:Eigenschap HttpRequest.QueryString

Notitie

Als het doel van de URL een webresource is, kan deze alleen de parameters accepteren die in het onderwerp Geef parameters door aan HTML webresources worden geïdentificeerd. De enige manier om aangepaste waarden door te geven is door ze op te nemen in de parameter data. Bepaalde speciale behandeling is vereist als u meerdere waarden in één parameter wilt opnemen.Meer informatie:Voorbeeld: Meerdere waarden aan een webresource doorgeven met de gegevensparameter

Zie ook

Opdrachten en het lint aanpassen
Open formulieren, weergaven, dialogen en rapporten met een URL
<Url> (RibbonDiffXml)
Weergaveregels voor het linttabblad definiëren
Voorbeeld: exporteren van lintdefinities

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht