Formulieren, weergaven, dialogen en rapporten met een URL openen

Artikel
03/04/2017

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Met URL adresseerbare elementen kunt u koppelingen naar Microsoft Dynamics 365 formulieren, weergaven dialogen en rapporten in andere toepassingen inschakelen. Op deze manier kunt u eenvoudig andere toepassingen, rapporten of websites uitbreiden zodat gebruikers informatie kunnen bekijken en acties kunnen uitvoeren zonder van applicatie te wisselen.

Notitie

URL-adresseerbare formulieren, weergaven, dialogen, en rapporten kunnen de beveiliging van Microsoft Dynamics 365 niet omzeilen. Alleen gelicentieerde gebruikers van Microsoft Dynamics 365 kunnen, op basis van hun beveiligingsrollen, toegang krijgen tot de gegevens en de records die ze zien.
Gebruik Xrm.Utility.openEntityForm als u entiteitformulieren programmatisch opent in de toepassing door webbronnen te gebruiken. Gebruik window.open niet.
Buiten de toepassing, waar pagina's geen toegang hebben tot de functie Xrm.Utility.openEntityForm , gebruik window.open of een koppeling om een specifiek record of formulier voor een entiteit te openen. De volledige toepassing wordt voor elk van de Bijgewerkte entiteiten geopend.

In dit onderwerp

URL-adresseerbare formulieren en weergaven

Querytekenreeksparameters voor de Main.aspx-pagina
Kopieer de URL voor een weergave
Een weergave in de navigatie van de toepassing weergeven met behulp van het siteoverzicht

Een dialoogvensterproces openen door een URL te gebruiken

Een rapport openen door een URL te gebruiken

URL-adresseerbare formulieren en weergaven

Alle entiteitformulieren en weergaven worden weergegeven in de main.aspx-pagina. Querytekenreeksparameter die naar deze pagina worden gestuurd. bepalen wat wordt weergegeven. Bijvoorbeeld:

Als u een nieuw formulier voor het accountentiteitsrecord voor lokale Microsoft Dynamics 365 wilt openen:
```
http://mycrm/myOrg/main.aspx?etn=account&pagetype=entityrecord
```
Om een accountentiteitrecordformulier te openen voor Microsoft Dynamics 365 (online) waar de ID 91330924-802A-4B0D-A900-34FD9D790829 is:
```
http://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D
```

Als u de weergave Gesloten verkoopkansen voor Microsoft Dynamics 365 (online) wilt openen:

http://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039

Als u de weergave Actieve contactpersonen voor Microsoft Dynamics 365 (online) wilt openen zonder navigatiebalk of opdrachtbalk

http://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false

Notitie

Het openen van entiteitformulieren in een dialoogvenster door gebruik te maken van showModalDialog of showModelessDialog wordt niet ondersteund.

Het weergeven van een entiteitsformulier in een ingesloten IFrame in een ander entiteitsformulier wordt niet ondersteund.

Normaal gesproken gebruikt u de methode getClientUrl om de bron-URL van de organisatie op te halen voor zowel on-premises Microsoft Dynamics 365 en Microsoft Dynamics 365 (online).

Querytekenreeksparameters voor de Main.aspx-pagina

Tip

Om de ID-waarde voor elk record te verkrijgen, gebruikt u de knop Koppeling verzenden op de opdrachtbalk. Hier volgt een voorbeeld van de inhoud die in uw e-mailtoepassing wordt geopend:

<http://mycrm/myOrg/main.aspx?etc=4&id=%7b899D4FCF-F4D3-E011-9D26-00155DBA3819%7d&pagetype=entityrecord>.

De ID-parameter die aan URL wordt doorgegeven is de gecodeerde ID-waarde voor de record. In dit voorbeeld is de ID-waarde {899D4FCF-F4D3-E011-9D26-00155DBA3819}. De gecodeerde versie van GUID vervangt openende en sluitende haakjes '{' en '}' met '%7B' en '%7D', respectievelijk.

Het volgende zijn querytekenreeksparameters die worden gebruikt met de main.aspx-pagina om entiteitformulieren of weergaven te openen:

Parameter	Beschrijving
etn	De logische naam van de entiteit. Belangrijk Gebruik niet de parameter etc (entiteittypecode) die een integercode voor de entiteit bevat. Deze integercode varieert voor aangepaste entiteiten in verschillende organisaties.
extraqs	Optioneel voor formulieren. Deze parameter bevat gecodeerde parameters in deze parameter. Gebruik deze parameter als u waarden naar een formulier wilt overzetten. Zie Veldwaarden instellen via parameters die worden doorgegeven aan een formulier voor meer informatie. Wanneer een entiteit meer dan één formulier heeft gedefinieerd, kunt u deze parameter gebruiken om een formulier op te geven om te openen met de gecodeerde parameter formid met de waarde gelijk aan de ID-waarde van het formulier. Bijvoorbeeld, om het formulier met ID ‘6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf’ te openen, moet u deze waarde toevoegen aan de parameter extraqs: formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A.
pagetype	Het type pagina. Er zijn twee mogelijke waarden: entityrecord Geeft een entiteitsrecordformulier weer. entitylist Geeft een entiteitsweergave weer.
id	Optioneel voor formulieren. Gebruik dit wanneer u een specifiek entiteitrecord opent. Pas de gecodeerde GUID-ID in voor de entiteit. De gecodeerde versie van GUID vervangt openende en sluitende haakjes '{' en '}' met '%7B' en '%7D', respectievelijk. Bijvoorbeeld {91330924-802A-4B0D-A900-34FD9D790829} is %7B91330924-802A-4B0D-A900-34FD9D790829%7D.
viewid	Vereist voor weergaven. Dit is de ID van de entiteitsrecords savedquery of userquery die de weergave bepalen. De eenvoudigste manier om de URL voor een weergave te verkrijgen is door deze te kopiëren. Zie Kopieer de URL voor een weergave voor meer informatie.
viewtype	Bepaalt het type weergave. Mogelijke waarden zijn als volgt: 1039 Gebruik voor een systeemweergave. De viewid vertegenwoordigt de ID van een savedquery record. 4230 Gebruik voor een persoonlijke weergave. De viewid vertegenwoordigt de ID van een userquery record.
navbar	Bepaalt of de navigatiebalk wordt weergegeven en of de navigatie in toepassing beschikbaar is met gebruik van de gebieden en subgebieden die zijn opgegeven in de sitemap. on De navigatiebalk wordt weergegeven. Dit is het standaardgedrag als de parameter navbar niet wordt gebruikt. off De navigatiebalk wordt niet weergegeven. Mensen kunnen navigeren met behulp van andere besturingselementen of de knoppen Vorige en Volgende. entity Op een entiteitformulier zijn alleen de navigatieopties beschikbaar voor gerelateerde entiteiten. Na het navigeren naar een gerelateerde entiteit, wordt de knop Vorige weergegeven in de navigatiebalk zodat u kunt terugkeren naar het oorspronkelijke record.
cmdbar	Bepaalt of de opdrachtbalk wordt weergegeven. Notitie Deze mogelijkheid ondersteunt vereisten voor de Unified Service Desk for Microsoft Dynamics 365-toepassing. Het gebruik van deze weergave om een entiteitsformulier weer te geven in een IFrame die is ingesloten in een ander entiteitformulier, wordt niet ondersteund. true De opdrachtbalk wordt weergegeven. Dit is de standaardinstelling. false De opdrachtbalk wordt verborgen.

Kopieer de URL voor een weergave

Vele weergaven in Microsoft Dynamics 365 stellen een gebruiker in staat om de URL voor een bepaalde weergave te kopiëren of een e-mail te verzenden met de URL voor de betreffende weergave in het bericht. Deze functie maakt communicatie tussen gebruikers eenvoudiger en biedt een mogelijkheid om toegang te krijgen tot een URL voor een weergave die gebruikers kunnen toevoegen aan een andere toepassing, zoals een SharePoint site.

Notitie

Gebruik deze URL niet om een weergave toe te voegen aan de toepassingsnavigatie met het siteoverzicht. Zie Een weergave in de navigatie van de toepassing weergeven met behulp van het siteoverzicht voor meer informatie.

De pagina die wordt weergegeven door de URL bevat de volledige weergave. Dit omvat onder andere het lint, maar bevat niet de navigatie in de toepassing.

Krijg de URL voor een weergave

Open de weergave die u wilt gebruiken.
Op de opdrachtbalk, klikt u op Een koppeling verzenden en vervolgens op Van huidige weergave.
Plak de koppeling in Kladblok en bewerk deze om alleen het URL-deel van de gewenste tekst te verkrijgen.

Notitie

Weergaven die de gebruikerscontext als parameter gebruiken, zoals Mijn accounts, kunnen niet worden gekopieerd.
De GUID van systeemweergaven voor systeementiteiten is hetzelfde voor iedere on-premises Microsoft Dynamics 365 installatie. De GUID voor aangepaste entiteiten en aangepaste weergaven is uniek voor elke Microsoft Dynamics 365 installatie.

Een weergave in de navigatie van de toepassing weergeven met behulp van het siteoverzicht

Als u de navigatie in de toepassing aanpast met het siteoverzicht, moet u niet de weergave-URL gebruiken die u hebt gekopieerd van de toepassing met de stappen in Kopieer de URL voor een weergave om als de URL in te stellen. Die URL geeft een pagina weer die een lint bevat en produceert ongewenste resultaten indien gebruikt in een <SubArea> (SiteMap) URL-kenmerk.

Stel de entiteitkenmerkwaarde in om een lijst van entiteitsrecords voor een subgebied weer te geven in een toepassing. Dit geeft de standaardweergave voor die entiteit weer en verschaft de juiste titel en het pictogram.

Als u echter een subgebiedelement wilt gebruiken dat een specifieke standaardweergave gebruikt, moet u het volgende URL-patroon gebruiken.

Url=“/_root/homepage.aspx?etn=<entity logical name >&amp;viewid=%7b<GUID value of view id>%7d”

Wanneer u deze URL gebruikt, moet u ook de juiste waarden voor <Titles> (SiteMap) en <Descriptions> (SiteMap) opgeven en een pictogram opgeven voor de entiteit.

Notitie

Als u de weergave instelt met behulp van de pagina /_root/homepage.aspx, wordt de weergaveselector nog steeds weergegeven. Als de gebruiker de weergave wijzigt, onthoudt Microsoft Dynamics 365 de meest recente selectie van de gebruiker en de standaardweergaven nadat de browser wordt gesloten en opnieuw geopend.

Een dialoogvensterproces openen door een URL te gebruiken

Een gebruikelijke aanpassing is een gebruiker in staat stellen om een specifiek dialoogproces te openen in de context van een specifiek record. U kunt bijvoorbeeld een aangepaste knop aan het lint toevoegen voor een specifieke entiteit door gebruik te maken van de ID-waarde van het huidige record als een invoerparameter voor het dialoogvensterproces.

Om het dialoogvenster te openen moet u het volgende doen:

De unieke ID voor het dialoogvenster.
De logische naam voor de entiteit waarvoor het dialoogvenster is gemaakt.
De unieke ID van het record waartegen u het dialoogvenster wilt uitvoeren.

Tip

Voor de unieke ID van het dialoogvenster, gaat u naar Instellingen, en selecteert u Processen in de standaardoplossing. Selecteer een proces en klik vervolgens in de groep Acties op de opdrachtbalk op de optie Een koppeling kopiëren. Hierdoor wordt een koppeling gekopieerd om het dialoogvenster op uw klembord te bewerken, bijvoorbeeld [organisatie-url]/sfa/workflow/edit.aspx?id=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d.

Het volgende voorbeeld toont de URL en querytekenreeksparameters om een dialoogvenster te openen:

[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[entity logical name]&ObjectId=[unique identifier for the record]

Bijvoorbeeld, om het dialoogvenster te openen met ID ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} met accountrecord-ID = {40C9ADFD-90A8-DF11-840E-00155DBA380F}, gebruikt u de URL in het volgende voorbeeld.

[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d

Tip

Voor andere browsers dan Internet Explorer, als een dialoogvensterproces via een koppeling wordt geopend, werkt de knop Voltooien wellicht niet. De gegevens worden opgeslagen, maar de gebruiker moet op de knop Sluiten klikken om het venster te sluiten. Dit komt doordat andere browsers geen window.close methode opgeven als het venster niet is geopend met JavaScript vanuit een ander venster. Indien mogelijk, moet u JavaScript en de window.open methode gebruiken om dialoogvensterprocessen in plaats van alleen koppelingen te geven.

U kunt een JavaScript functie maken om een dialoogvenster te openen zoals weergegeven in het volgende voorbeeld:

function openDialogProcess(dialogId, entityName, objectId)
{
 var url = Xrm.Page.context.getClientUrl() +
  "/cs/dialog/rundialog.aspx?DialogId=" +
  dialogId + "&EntityName=" +
  entityName + "&ObjectId=" +
  objectId;
 window.open(url);
}

Een rapport openen door een URL te gebruiken

U kunt een rapport openen door de juiste parameterwaarden aan de volgende URL toe te voegen [organization url]/crmreports/viewer/viewer.aspx.

Deze URL accepteert de volgende parameters:

actie
Twee mogelijke waarden voor deze parameter zijn run of filter. Als run wordt gebruikt, wordt het rapport weergegeven met de standaardfilters. Als filter wordt gebruikt, geeft het rapport een filter weer dat de gebruiker kan bewerken alvorens de knop Rapport uitvoeren te kiezen om het rapport weer te geven.
helpID
Deze parameter is optioneel. Voor rapporten die wordt meegeleverd met Microsoft Dynamics 365 stelt de waarde in deze parameter de knop Help in staat om de juiste inhoud over dit rapport weer te geven als Help op deze pagina is gekozen. Deze waarde moet overeenkomen met de rapport FileName kenmerkwaarde.
id
Deze parameter is de rapport ReportId kenmerkwaarde.

De volgende voorbeelden tonen URL's die kunnen worden gebruikt om rapporten te openen in Microsoft Dynamics 365.

Open het rapport Verwaarloosde aanvragen met de standaardfilter:

[organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d

Open het rapport Bovenste Knowledge Base-artikelen en vraag de gebruiker om filterwaarden in te stellen:

[organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d

De volgende functies toont hoe u waarden in de URL correct kunt coderen:

function getReportURL(action,fileName,id) {
 var orgUrl = GetGlobalContext().getClientUrl();
 var reportUrl = orgUrl + 
  "/crmreports/viewer/viewer.aspx?action=" +
  encodeURIComponent(action) +
  "&helpID=" +
  encodeURIComponent(fileName) +
  "&id=%7b" +
  encodeURIComponent(id) +
  "%7d";
 return reportUrl;
}

Zie ook

Microsoft Dynamics 365 uitbreiden op de client
Veldwaarden instellen via parameters die worden doorgegeven aan een formulier
Een formulier configureren om aangepaste querytekenreeksparameters te accepteren
Toepassingsnavigatie wijzigen met de SiteMap
Opdrachten en het lint aanpassen
Code schrijven voor Microsoft Dynamics 365-formulieren
Webresources voor Microsoft Dynamics 365
Start een dialoogvenster met behulp van een URL

Microsoft Dynamics 365

Delen via

Formulieren, weergaven, dialogen en rapporten met een URL openen

In dit onderwerp

URL-adresseerbare formulieren en weergaven

Querytekenreeksparameters voor de Main.aspx-pagina

Kopieer de URL voor een weergave

Krijg de URL voor een weergave

Een weergave in de navigatie van de toepassing weergeven met behulp van het siteoverzicht

Een dialoogvensterproces openen door een URL te gebruiken

Een rapport openen door een URL te gebruiken

Zie ook

Aanvullende resources