Open formulieren, weergaven, dialogen en rapporten met een URL
Gepubliceerd: november 2016
Is van toepassing op: Dynamics CRM 2015
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=entityrecordOm een accountentiteitrecordformulier te openen voor Microsoft Dynamics CRM 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%7DAls u de weergave Gesloten verkoopkansen voor Microsoft Dynamics CRM Online wilt openen:
http://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039Als u de weergave Actieve contactpersonen voor Microsoft Dynamics CRM 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 d7d0b052-abca-4f81-9b86-0b9dc5e62a66#BKMK_getClientUrl om de bron-URL van de organisatie op te halen voor zowel on-premises Microsoft Dynamics 365 en Microsoft Dynamics CRM 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. > [!IMPORTANT] >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:
|
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:
|
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.
|
cmdbar |
Bepaalt of de opdrachtbalk wordt weergegeven. Notitie Deze mogelijkheid ondersteunt vereisten voor de Unified Service Desk for Microsoft Dynamics 365-toepassing.
|
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.
Kies op de opdrachtbalk Een koppeling verzenden en vervolgens 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 >&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 vervolgens in de groep Acties op de opdrachtbalk 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 de knop Sluiten kiezen 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%7dOpen 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
Uitbreidingen van clienttoepassingen schrijven
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 CRM 2015-formulieren
Webresources voor Microsoft Dynamics CRM 2015
Start een dialoogvenster met behulp van een URL
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht