Lomakkeiden, näkymien, valintaikkunoiden ja raporttien avaaminen URL-osoitteen avulla

2025-05-22

URL-osoitteellisten elementtien avulla voit sisällyttää linkkejä Dynamics 365 Customer Engagement (on-premises) -lomakkeisiin, näkymiin, valintaikkunoihin ja raportteihin muissa sovelluksissa. Tällä tavalla voit helposti laajentaa muita sovelluksia, raportteja tai verkkosivustoja, jotta käyttäjät voivat tarkastella tietoja ja suorittaa toimintoja sovellusta vaihtamatta.

Huomautus

URL-osoitteelliset lomakkeet, näkymät, valintaikkunat ja raportit eivät voi ohittaa Dynamics 365 Customer Engagement (on-premises) -suojausta. Vain käyttöoikeuden saaneet Dynamics 365 Customer Engagement (on-premises) -käyttäjät voivat käyttää näkemiään tietoja ja tietueita käyttöoikeusrooliensa perusteella.
- Käytä Xrm.Navigation.openFormia , kun avaat entiteettilomakkeita ohjelmallisesti sovelluksessa verkkoresurssien avulla. Älä käytä window.open.
- Sovelluksen ulkopuolella, jos sivuilla ei ole openForm-funktionXrm.Navigation. käyttöoikeutta, voit avata entiteetin tietyn tietueen tai lomakkeen käyttämällä window.open linkkiä.

URL-osoitteelliset lomakkeet ja näkymät

Kaikki entiteettilomakkeet ja -näkymät näkyvät main.aspx sivulla. Tälle sivulle välitetyt kyselymerkkijonoparametrit määrittävät, mitä näytetään. Esimerkkejä:

Uuden asiakasentiteettitietueen lomakkeen avaaminen paikallisessa Dynamics 365 Customer Engagement (on-premises):ssä:

https://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord

Voit avata asiakasentiteettitietuelomakkeen Dynamics 365 for Customer Engagement:ssä, jonka tunnus on {91330924-802A-4B0D-A900-34FD9D790829}:

https://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D

Dynamics 365 for Customer Engagement:n Suljetut mahdollisuudet -näkymän avaaminen:

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

Dynamics 365 for Customer Engagement:n Aktiiviset yhteyshenkilöt -näkymän avaaminen ilman siirtymispalkkia tai komentopalkkia

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

Huomautus

Entiteettilomakkeiden avaamista valintaikkunassa showModalDialog- tai showModelessDialog-komennuksella ei tueta.

Entiteettilomakkeen näyttämistä toiseen entiteettilomakkeeseen upotetussa IFramessa ei tueta.

Käytät yleensä getClientUrl-menetelmää organisaation pää-URL-osoitteen noutamiseen sekä paikalliselle Dynamics 365 Customer Engagement (on-premises):lle että Dynamics 365 for Customer Engagement:lle.

Main.aspx sivun kyselymerkkijonoparametrit

Vihje

Jos haluat saada minkä tahansa tietueen id-arvon, käytä komentopalkin Lähetä linkki -painiketta. Seuraavassa on esimerkki siitä, mitä sähköpostisovelluksessasi avataan:

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

URL-osoitteeseen välitetty id-parametri on tietueen koodattu id-arvo. Tässä esimerkissä id-arvo on {899D4FCF-F4D3-E011-9D26-00155DBA3819}. GUID-tunnuksen koodattu versio korvaa alku- ja loppusulkeet "{" ja "}" "%7B" ja "%7D", vastaavasti,

Seuraavat kyselymerkkijonoparametrit, joita käytetään main.aspx-sivulla entiteettilomakkeiden tai -näkymien avaamiseen:

Parametri	Kuvaus
Etn	Entiteetin looginen nimi. Tärkeä: Älä käytä etc (entiteettityypin koodi) -parametria, joka sisältää entiteetin kokonaislukukoodin. Tämä kokonaislukukoodi vaihtelee eri organisaatioiden mukautetuissa entiteeteissä.
Lisäkysymyksiä	Valinnainen lomakkeille. Tämä parametri sisältää koodattuja parametreja tämän parametrin sisällä. Tämän parametrin avulla voit välittää arvoja lomakkeeseen. Lisätietoja on kohdassa Kenttäarvojen määrittäminen lomakkeeseen välitettyjen parametrien avulla. Kun entiteetille on määritetty useita lomakkeita, voit määrittää tämän parametrin avulla avattavan lomakkeen välittämällä koodatun parametrin `formid` , jonka arvo on yhtä suuri kuin lomakkeen tunnusarvo. Jos esimerkiksi haluat avata lomakkeen, jonka tunnus on "6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf", sisällytä tämä arvo parametriin `extraqs` : `formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A`.
Sivun tyyppi	Sivun tyyppi. Mahdollisia arvoja on kaksi: - entityrecord Näyttää entiteettitietueen lomakkeen. - Entiteettiluettelo Näyttää entiteettinäkymän.
henkilöllisyystodistus	Valinnainen lomakkeille. Käytä tätä, kun avaat tietyn entiteettitietueen. Anna entiteetin koodattu GUID-tunnus. GUID-tunnuksen koodattu versio korvaa alku- ja loppusulkeet "{" ja "}" "%7B" ja "%7D", esimerkiksi `{91330924-802A-4B0D-A900-34FD9D790829}` .`%7B91330924-802A-4B0D-A900-34FD9D790829%7D`
viewid	Pakollinen näkymiä varten. Tämä on näkymän määrittävän entiteettitietueen `userquery` tunnus`savedquery`. Helpoin tapa saada näkymän URL-osoite on kopioida se. Lisätietoja on kohdassa Näkymän URL-osoitteen kopioiminen.
näkymän tyyppi	Määrittää näkymätyypin. Mahdolliset arvot ovat seuraavat: - 1039 Käytä järjestelmänäkymään. `viewid` edustaa `savedquery`-tietueen tunnusta. - 4230 Käytä henkilökohtaiseen näkemykseen. `viewid` edustaa `userquery` tietueen tunnusta.
`navbar`	Määrittää, näytetäänkö siirtymispalkki ja onko sovelluksessa siirtyminen käytettävissä sivustokartassa määritettyjen alueiden ja alialueiden avulla. - `on` Navigointipalkki tulee näkyviin. Tämä on oletustoiminta, jos parametria `navbar` ei käytetä. - `off` Siirtymispalkki ei näy. Käyttäjät voivat navigoida käyttämällä muita käyttöliittymän elementtejä tai Edellinen- ja Eteenpäin-painikkeita. - `entity` Entiteettilomakkeessa käytettävissä ovat vain liittyvien entiteettien siirtymisasetukset. Kun olet siirtynyt liittyvään entiteettiin, siirtymispalkissa näkyy Takaisin-painike, jonka avulla voit palata alkuperäiseen tietueeseen.
`cmdbar`	Määrittää, näytetäänkö komentopalkki. Muistiinpano: Tämä ominaisuus tukee Unified Service Desk for Dynamics 365 -sovelluksen vaatimuksia. Tätä entiteettilomakkeen näyttämistä toiseen entiteettilomakkeeseen upotetussa IFramessa ei tueta. - `true` Komentopalkki tulee näkyviin. Tämä on oletusarvo. - `false` Komentopalkki on piilotettu.

Näkymän URL-osoitteen kopioiminen

Monissa Dynamics 365 Customer Engagement (on-premises) -näkymissä käyttäjä voi kopioida tietyn näkymän URL-osoitteen tai lähettää sähköpostiviestin, jossa viestiin on upotettu tietyn näkymän URL-osoite. Tämä ominaisuus helpottaa käyttäjien välistä viestintää ja paljastaa tavan, jolla voit käyttää sellaisen näkymän URL-osoitetta, jonka käyttäjät voivat sisällyttää toiseen sovellukseen, kuten SharePoint-sivustoon.

Huomautus

Älä käytä tätä URL-osoitetta näkymän sisällyttämiseen sovelluksen siirtymiseen sivustokartan avulla. Lisätietoja on kohdassa Näkymän näyttäminen sovelluksen siirtymisessä sivustokartan avulla.

URL-osoitteen näyttämä sivu sisältää koko näkymän. Tämä sisältää valintanauhan, mutta ei sovelluksen siirtymistä.

Näkymän URL-osoitteen hakeminen

Avaa näkymä, jota haluat käyttää.
Valitse komentopalkissa Lähetä linkki ja valitse sitten Nykyisestä näkymästä.
Liitä linkki Muistioon ja muokkaa sitä poimiaksesi vain haluamasi URL-osan tekstistä.

Huomautus

Näkymiä, jotka käyttävät käyttäjäkontekstia parametrina, kuten Omat tilit, ei voi kopioida.
- Järjestelmäentiteettien järjestelmänäkymiä edustava GUID-tunnus on sama jokaisessa paikallisessa Dynamics 365 Customer Engagement (on-premises) -asennuksessa. Mukautettujen entiteettien ja mukautettujen näkymien GUID-tunnus on yksilöllinen kussakin Dynamics 365 Customer Engagement (on-premises) -asennuksessa.

Kun mukautat sovelluksen siirtymistä sivustokartan avulla, älä käytä näkymän URL-osoitetta, jonka kopioit sovelluksesta URL-osoitteeksi määritettävän näkymän URL-osoitteen kopioiminen ohjeiden mukaisesti. URL-osoite näyttää sivun, joka sisältää valintanauhan ja tuottaa ei-toivottuja tuloksia, jos sitä käytetään <SubArea> URL-määritteessä.

Jos haluat näyttää alialueen sovelluksen entiteettitietueiden luettelon, määritä Entiteettimäärite-arvo. Tämä näyttää entiteetin oletusnäkymän ja antaa oikean otsikon ja kuvakkeen.

Jos kuitenkin haluat Alialue-elementin, joka käyttää tiettyä alkuperäistä oletusnäkymää, käytä seuraavaa URL-mallia, kun käytät Unified Interfacea.

[Organization Url]/main.aspx?pagetype=entitylist&etn=<entity logical name >&viewid=%7b00000000-0000-0000-0000-000000000000%7d&viewType=1039

Käytä vanhassa WWW-asiakasohjelmassa seuraavaa URL-osoitetta.

[Organization Url]/homepage.aspx?etn=<entity logical name >&viewid=%7b00000000-0000-0000-0000-000000000000%7d

Kun käytät tätä URL-osoitetta, sinun on myös määritettävä asianmukaiset arvot <Titles> ja ja <Descriptions>määritettävä entiteetille kuvake.

Huomautus

Jos määrität näkymän sivun avulla .../homepage.aspx , näkymän valitsin näkyy edelleen. Jos käyttäjä muuttaa näkymää, Dynamics 365 Customer Engagement (on-premises) muistaa käyttäjän viimeisimmän valinnan ja alkuperäinen oletusnäkymä tulee näkyviin, kun hän sulkee selaimen ja avaa sen uudelleen.

Valintaikkunaprosessin avaaminen URL-osoitteen avulla

Yleinen mukautus on, että käyttäjä voi avata tietyn valintaikkunaprosessin tietyn tietueen kontekstissa. Voit esimerkiksi lisätä mukautetun painikkeen tietyn entiteetin valintanauhaan käyttämällä nykyisen tietueen id-arvoa valintaikkunaprosessin syöttöparametrina.

Valintaikkunan avaamiseen tarvitaan seuraavat asiat:

Dialogin yksilöllinen tunniste.
Sen entiteetin looginen nimi, jolle valintaikkuna luodaan.
Sen tietueen yksilöllinen tunnus, jonka perusteella dialogi suoritetaan.

Vihje

Jos haluat saada valintaikkunan yksilöllisen tunnuksen, siirry kohtaan Asetukset ja valitse oletusratkaisussa Prosessit. Valitse prosessi ja valitse sitten komentopalkin Toiminnot-asetuksistaKopioi linkki. Tämä kopioi leikepöydälle linkin, jolla voit muokata valintaikkunaa, esimerkiksi [organisaation URL]/sfa/workflow/edit.aspx?id=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d.

Seuraavassa esimerkissä näytetään URL- ja kyselymerkkijonoparametrit valintaikkunan avaamiseksi:

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

Jos esimerkiksi haluat avata valintaikkunan, jonka tunnus on ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} ja tilitietueen tunnus = {40C9ADFD-90A8-DF11-840E-00155DBA380F}, käytä seuraavassa esimerkissä olevaa URL-osoitetta.

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

Vihje

Jos valintaikkuna avataan linkistä muissa selaimissa kuin Internet Explorerissa, Valmis-painike ei ehkä toimi. Tiedot tallennetaan, mutta käyttäjän on napsautettava ikkunan Sulje-painiketta sulkeakseen sen. Tämä johtuu siitä, että muut selaimet eivät tarjoa menetelmää window.close , jos ikkunaa ei avata JavaScriptillä toisesta ikkunasta. Käytä mahdollisuuksien mukaan JavaScriptiä ja menetelmää window.open dialogiprosessien avaamiseen pelkkien linkkien tarjoamisen sijaan.

Voit luoda JavaScript-funktion avataksesi valintaikkunan seuraavan esimerkin mukaisesti:

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

Raportin avaaminen URL-osoitteen avulla

Voit avata raportin välittämällä asianmukaiset parametriarvot seuraavaan URL-osoitteeseen: [organization url]/crmreports/viewer/viewer.aspx.

Tämä URL-osoite hyväksyy seuraavat parametrit:

toiminta
Tämän parametrin kaksi mahdollista arvoa ovat run tai filter. Kun run sitä käytetään, raportti näytetään oletussuodattimilla. Kun filter sitä käytetään, raportti näyttää suodattimen, jota käyttäjä voi muokata ennen kuin valitsee Suorita raportti -painikkeen raportin tarkastelemiseksi.

helpID
Tämä parametri on valinnainen. Dynamics 365 Customer Engagement (on-premises) -ohjelmaan sisältyvissä raporteissa tämän parametrin arvo sallii Ohje-painikkeen näyttää tätä raporttia koskevaa asianmukaista sisältöä, kun Ohje tällä sivulla on valittuna. Arvon tulee vastata raportin FileName määritteen arvoa.

henkilöllisyystodistus
Tämä parametri on raportin ReportId määritteen arvo.

Seuraavissa esimerkeissä on esitetty URL-osoitteet, joita voidaan käyttää raporttien avaamiseen Dynamics 365 Customer Engagement (on-premises):ssä.

Avaa Laiminlyödyt palvelupyynnöt -raportti oletussuodattimella:

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

Avaa Suosituimmat tietämyskannan artikkelit -raportti ja pyydä käyttäjää määrittämään suodatusarvot:

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

Seuraava funktio näyttää, kuinka URL-osoitteen arvot koodataan oikein:

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;  
}

Katso myös

Dynamics 365 Customer Engagement (on-premises):n laajentaminen asiakasohjelmassa
Kenttäarvojen määrittäminen lomakkeeseen välitettyjen parametrien avulla
Lomakkeen määrittäminen hyväksymään mukautettuja kyselymerkkijonoparametreja
Muuta sovelluksen siirtymistä sivustokartan avulla
Valintanauhan mukauttaminen Dynamics 365 Customer Engagement (on-premises)Client -sovelluksen komentosarjat Customer Engagement:ssä JavaScriptin avulla Dynamics 365 Customer Engagement (on-premises) -verkkoresurssit
Aloita valintaikkuna URL-osoitteen avulla

Jaa

Lomakkeiden, näkymien, valintaikkunoiden ja raporttien avaaminen URL-osoitteen avulla

URL-osoitteelliset lomakkeet ja näkymät

Main.aspx sivun kyselymerkkijonoparametrit

Näkymän URL-osoitteen kopioiminen

Näkymän URL-osoitteen hakeminen

Näkymän näyttäminen sovelluksen siirtymisessä sivustokartan avulla

Valintaikkunaprosessin avaaminen URL-osoitteen avulla

Raportin avaaminen URL-osoitteen avulla

Katso myös

Palaute

Lisäresursseja