Parameters aan een URL doorgeven met het lint
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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.
Een <Url> (RibbonDiffXml)-element gebruiken. Gebruik binnen het Url-element het kenmerk PassParams.
Gebruik een <Url> (RibbonDiffXml)-element met een <CrmParameter> (RibbonDiffXml)-element. Indien gebruikt vanuit een Url-element moet het naamkenmerk worden ingesteld.
Gebruik een <JavaScriptFunction> (RibbonDiffXml)-element met een <CrmParameter> (RibbonDiffXml)-element.
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 Formulieren, weergaven, dialogen en rapporten met een URL openen.
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 "&".
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
Formulieren, weergaven, dialogen en rapporten met een URL openen
<Url> (RibbonDiffXml)
Weergaveregels voor het linttabblad definiëren
Voorbeeld: exporteren van lintdefinities
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht