Åbne formularer, visninger, dialogbokse og rapporter med en URL-adresse
Udgivet: november 2016
Gælder for: Dynamics CRM 2015
Elementer, der kan angives en URL for, giver dig mulighed for at medtage hyperlinks til Microsoft Dynamics 365 formularer, visninger, dialogbokse og rapporter i andre programmer. På denne måde kan du nemt udvide andre programmer, rapporter eller websteder, så brugere kan få vist oplysninger og udføre handlinger uden at skifte programmer.
Bemærk
Formularer, visninger, dialogbokse og rapporter, der kan angives en URL-adresse for, kan ikke tilsidesætte Microsoft Dynamics 365-sikkerheden. Kun licenserede Microsoft Dynamics 365-brugere kan på baggrund af deres sikkerhedsroller få adgang til dataene og de poster, de kan se.
Brug Xrm.Utility.openEntityForm, når du åbner objektformularer ved hjælp af programmering i programmet ved hjælp af webressourcer. Du skal ikke bruge window.open.
I webprogrammet, hvor sider ikke har adgang til funktionen Xrm.Utility.openEntityForm, skal du bruge window.open eller et hyperlink til at åbne en bestemt post eller en formular til et objekt. Hele programmet åbnes for en hvilken som helst af Opdaterede objekter.
Dette emne indeholder
Formularer og visninger, der kan angives en URL-adresse for
Parametre for forespørgselsstrengen for siden Main.aspx
Kopiér URL-adressen for en visning
Få vist en visning i navigationsprogrammet ved hjælp af oversigten
Åbne en dialogboksproces ved hjælp af en URL-adresse
Åbne en rapport ved hjælp af en URL-adresse
Formularer og visninger, der kan angives en URL-adresse for
Alle objektformularer og visninger vises på siden main.aspx. Parametre for forespørgselsstrenge overført til dette kontrolelement til siden for, hvad der skal vises. Eksempel:
Sådan åbner du en ny firmaobjektpostformular for Microsoft Dynamics 365 i et lokalt miljø:
http://mycrm/myOrg/main.aspx?etn=account&pagetype=entityrecordSådan åbner du en firmapostobjektformular for Microsoft Dynamics CRM Online, hvor id'et er {91330924-802A-4B0D-A900-34FD9D790829}:
http://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7DSådan åbner du visningen Afsluttede salgsmuligheder for Microsoft Dynamics CRM Online:
http://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039Sådan åbner du visningen Aktive kontakter for Microsoft Dynamics CRM Online uden navigationslinje eller kommandoværktøjslinjen
http://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false
Bemærk
Åbning af objektformularer i et dialogvindue ved hjælp af showModalDialog eller showModelessDialog understøttes ikke.
Vise en objektformular inden for en IFrame integreret i et andet objektformular understøttes ikke.
Du bruger normalt metoden d7d0b052-abca-4f81-9b86-0b9dc5e62a66#BKMK_getClientUrl til at hente organisationsrodens URL-adresse for både lokale Microsoft Dynamics 365 og Microsoft Dynamics CRM Online.
Parametre for forespørgselsstrengen for siden Main.aspx
Tip
For at få id-værdien for en post kan du bruge knappen Send et Link på kommandoværktøjslinjen. Følgende er et eksempel på, hvad vil blive åbnet i dit e-mail-program:
<http://mycrm/myOrg/main.aspx?etc=4&id=%7b899D4FCF-F4D3-E011-9D26-00155DBA3819%7d&pagetype=entityrecord>.
Parameter-id'et, der er sendt til URL-adressen, er den kodede id-værdi for posten. I dette eksempel er id-værdien {899D4FCF-F4D3-E011-9D26-00155DBA3819}. Den kodede version af GUID erstatter indledende og afsluttende parenteser "{" og "}" med henholdsvis "%7B" og "%7D".
Følgende er de parametre for forespørgselsstrengen, der bruges sammen med siden main.aspx for at åbne objektformularerne eller visningerne:
Parameter |
Beskrivelse |
|---|---|
etn |
Det logiske navn på objektet. > [!IMPORTANT] >Brug ikke den parameter etc (objekttypekode), der indeholder en heltalkode for objektet. Denne heltalkode varierer for brugerdefinerede objekter i forskellige organisationer. |
extraqs |
Valgfri for formularer. Denne parameter indeholder parametre, der er kodet i denne parameter. Brug denne parameter til at sende værdier til en formular. Du kan finde flere oplysninger under Angiv feltværdier vha. parametre, der overføres til en formular. Når et objekt har mere end én formular, der er defineret, kan du bruge denne parameter til at angive, hvilken formular der skal åbnes ved at overføre den kodede parameter formid med den værdi, der er lig med id-værdien i formularen. For at åbne f.eks. en formular med id'et «6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf» skal du medtage denne værdi i extraqs-parameteren: formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A. |
pagetype |
Sidetype. Der er to mulige værdier:
|
id |
Valgfri for formularer. Brug denne indstilling, når du åbner en bestemt objektpost. Overfør det kodede GUID-id for objektet. Den kodede version af GUID erstatter indledende og afsluttende parenteser “{“ og “}” med henholdsvis “%7B” og “%7D”, f.eks. {91330924-802A-4B0D-A900-34FD9D790829} er %7B91330924-802A-4B0D-A900-34FD9D790829%7D. |
viewid |
Kræves til visninger. Dette er id'et for den savedquery- eller userquery-objektpost, der definerer visningen. Den nemmeste måde at hente URL-adressen til en visning på er at kopiere den. Du kan finde flere oplysninger under Kopiér URL-adressen for en visning. |
viewtype |
Definerer visningens type. Mulige værdier er som følger:
|
navbar |
Kontrollerer, om navigationslinjen skal vises, og om programnavigation er tilgængelig ved hjælp af områder og underområder, der er defineret i sitemap.
|
cmdbar |
Kontrollerer, om kommandolinjen skal vises. > [!NOTE] >Denne funktion understøtter kravene til programmet Unified Service Desk til Microsoft Dynamics 365.
|
Kopiér URL-adressen for en visning
Mange visninger i Microsoft Dynamics 365 lader en bruger kopiere URL-adressen for en bestemt visning eller sende en e-mail med URL-adressen for en bestemt visning, der er integreret i meddelelsen. Denne funktion gør kommunikationen mellem brugere lettere og viser en måde at få adgang til en URL-adresse til en visning på, som brugerne kan medtage i et andet program, f.eks et SharePoint-sted.
Bemærk
Brug ikke denne URL-adresse til at inkludere visningen i programnavigation ved hjælp af oversigten. Du kan finde flere oplysninger under Få vist en visning i navigationsprogrammet ved hjælp af oversigten.
Siden, der vises i URL-adressen, indeholder fuld visning. Dette omfatter båndet, men omfatter ikke programnavigation.
Hent URL-adressen for en visning
Åbn den visning, du vil bruge.
Vælg Send et link på kommandolinjen, og vælg derefter Af aktuel visning.
Indsæt link til Notesblok, og rediger den for kun at udpakke den URL-del af teksten, du ønsker.
Bemærk
Visninger, der bruger brugerkonteksten som en parameter, som Mine firmaer, kan ikke kopieres.
Det GUID, der repræsenterer systemet for systemobjekter, vil være det samme for hver lokale Microsoft Dynamics 365-installation. GUID for brugerdefinerede objekter og brugerdefinerede visninger er unikke for hver Microsoft Dynamics 365-installation.
Få vist en visning i navigationsprogrammet ved hjælp af oversigten
Når du tilpasser programnavigationen ved hjælp af oversigten, skal du ikke bruge den visnings-URL-adresse, du har kopieret fra programmet ved hjælp af trinnene i Kopiér URL-adressen for en visning til at angive som URL-adressen. Den pågældende URL-adresse viser en side, der indeholder båndet og giver uønskede resultater, hvis den bruges i en <SubArea> (SiteMap)-URL-attribut.
For at få vist en liste over objektposter i programmet for et underområde skal du angive objektattributtens værdi. Dette viser standardvisningen for det pågældende objekt, og det giver den korrekte titel og det korrekte ikon.
Hvis du vil have et element af typen SubArea, der bruger en bestemt første standardvisning, skal du dog bruge følgende URL-mønster.
Url=“/_root/homepage.aspx?etn=<entity logical name >&viewid=%7b<GUID value of view id>%7d”
Når du bruger denne URL-adresse, skal du også angive relevante værdier for <Titles> (SiteMap) og <Descriptions> (SiteMap) og angive et ikon for objektet.
Bemærk
Hvis du angiver visningen ved hjælp af siden /_root/homepage.aspx, kan visningsvælgeren stadig ses. Hvis brugeren ændrer visningen, husker Microsoft Dynamics 365 brugerens seneste valg, og den oprindelige standardvisning vises, efter de lukker og genåbner deres browser.
Åbne en dialogboksproces ved hjælp af en URL-adresse
En fælles tilpasning er at give en bruger mulighed for at åbne en bestemt dialogboksproces i forbindelse med en bestemt post. Du kan f.eks. tilføje en brugerdefineret knap på båndet for et bestemt objekt, der bruger id-værdien for den aktuelle post som en inputparameter for dialogprocessen.
Hvis du vil åbne en dialogboks, skal du bruge følgende:
Entydigt id for dialogboksen.
Det logiske navn for det objekt, som dialogboksen oprettes for.
Entydigt id for den post, du vil have dialogboksen til at køre op imod.
Tip
For at få det unikke id for dialogboksen skal du gå til Indstillinger og i standardløsningen vælge Processer. Vælg en proces og derefter skal du i indstillingen Handlinger på kommandolinjen vælge Kopiér et Link. Dette vil kopiere et hyperlink for at redigere dialogboksen til din Udklipsholder, for eksempel [organisationens URL-adresse]/sfa/workflow/edit.aspx?id=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d.
Følgende eksempel viser URL-adressen og forespørgselsstrengens parametre, der skal bruges til at åbne en dialogboks:
[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[entity logical name]&ObjectId=[unique identifier for the record]
For at åbne dialogboksen med id = {6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} med firmapost-id = {40C9ADFD-90A8-DF11-840E-00155DBA380F} skal du bruge URL-adressen i følgende eksempel.
[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d
Tip
For andre browsere end Internet Explorer, hvis en dialogboksproces åbnes fra et link fungerer knappen Udfør muligvis ikke. Dataene gemmes, men brugeren skal vælge knappen Luk i vinduet for at lukke den. Dette skyldes, at andre browsere ikke har en window.close-metode, hvis vinduet ikke åbnes ved hjælp af JavaScript fra et andet vindue. Når det er muligt, kan du bruge metoden JavaScript og window.open til at åbne dialogboksprocesser i stedet for at fremskaffe links.
Du kan oprette en JavaScript-funktion til at åbne dialogboksen som vist i følgende eksempel:
function openDialogProcess(dialogId, entityName, objectId)
{
var url = Xrm.Page.context.getClientUrl() +
"/cs/dialog/rundialog.aspx?DialogId=" +
dialogId + "&EntityName=" +
entityName + "&ObjectId=" +
objectId;
window.open(url);
}
Åbne en rapport ved hjælp af en URL-adresse
Du kan åbne en rapport ved at overføre relevante parameterværdier til følgende URL-adresse: [organization url]/crmreports/viewer/viewer.aspx.
Denne URL-adresse accepterer følgende parametre:
action
To mulige værdier for denne parameter er run eller filter. Når run bruges, vises rapporten med standardfiltrene. Når filter er brugt, viser rapporten et filter, som brugeren kan redigere, før du vælger knappen Kør rapport for at få vist rapporten.helpID
Denne parameter er valgfri. For rapporter, der er inkluderet i Microsoft Dynamics 365, giver værdien i denne parameter det muligt for knappen Hjælp at få vist relevant indhold om denne rapport, når Hjælp på denne side er valgt. Værdien skal svare til rapportens FileName-attributværdi.id
Denne parameter er rapportens ReportId-attributværdi.
Følgende eksempler viser URL-adresser, der kan bruges til at åbne rapporter i Microsoft Dynamics 365.
Åbn rapporten Forsømte sager ved hjælp af standardfilteret:
[organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7dÅbn rapporten Mest læste vidensbaseartikler, og bed brugeren om at angive filterværdier:
[organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d
Følgende funktion viser, hvordan du korrekt koder værdier i URL-adressen:
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;
}
Se også
Skrive klientprogramudvidelser
Angiv feltværdier vha. parametre, der overføres til en formular
Konfigurere en formular for at acceptere brugerdefinerede forespørgselsstrengparametre
Ændre programnavigation vha. SiteMap
Tilpasse kommandoer og båndet
Skrive kode til Microsoft Dynamics CRM 2015-formularer
Webressourcer til Microsoft Dynamics CRM 2015
Starte en dialog ved hjælp af en URL-adresse
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret