CRM-pagina (gehost besturingselement)

 

Gepubliceerd: november 2016

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

Gebruik het gehoste besturingselement van het type CRM-pagina om een URL of pagina te laden vanuit Dynamics 365. Wanneer een Dynamics 365-pagina in een gehost besturingselement van dit type wordt geladen, wordt automatisch de pagina gescand op gegevens van de entiteit, en worden automatisch de vervangingsparameters gevuld.

Dit type gehost besturingselement bevat een aantal vooraf gedefinieerde UII-acties en -evenementen die uniek zijn voor afhandeling van Dynamics 365-vensters, inclusief lijstbewerkingen en een zoekactie voor het weergeven van een snelle of een geavanceerde zoekpagina.

In dit onderwerp

Een gehost besturingselement van het type CRM-pagina maken.

Vooraf gedefinieerde UII-acties

Vooraf gedefinieerde gebeurtenissen

Een gehost besturingselement van het type CRM-pagina maken.

Bij het maken van een nieuw, gehost besturingselement variëren de velden in het scherm Nieuw gehost beheer afhankelijk van het type gehost besturingselement dat u wilt maken. Deze sectie bevat informatie over de specifieke velden die uniek zijn voor het gehost besturingselement van het type CRM-pagina. Voor gedetailleerde informatie over het maken van gehost besturingselement raadpleegt u Een gehost besturingselement maken of bewerken.

Gehost besturingselement Dynamics 365-pagina

In het scherm Nieuw gehost beheer:

  • Selecteer onder Unified Service DeskCRM-pagina in de vervolgkeuzelijst Onderdeeltype van Unified Service Desk.

  • Van de vervolgkeuzelijst Sta Meerdere Pagina's toe, selecteert u Nee (standaard) om de Dynamics 365 te vervangen pagina momenteel weer te geven, en de browsergeschiedenis bij te werken als Unified Service Deskactieoproep ontvangt of een pagina naar het tabblad wordt gerouteerd. Selecteer Ja om automatisch een vervolgkeuzelijst te maken wanneer een tweede URL wordt aangeroepen of een vensternavigatieregel een pagina naar het tabblad doorstuurt. Hierdoor kan de gebruiker snel zoeken tussen de Dynamics 365 pagina's die aan dit besturingselement zijn gekoppeld. Bovendien, als u Ja selecteert, wordt een extra veld, Maximumbrowsers, beschikbaar waar u het maximumaantal pagina´s kunt opgeven die in de vervolgkeuzelijst worden weergegeven.

  • De vervolgkeuzelijst Hosttype geeft op hoe u wilt dat dit besturingselement wordt gehost. U kunt kiezen tussen IE-proces (standaard) of Interne WPF.. Zie Een hostingmethode selecteren voor uw besturingselementen voor meer informatie.

  • Schakel in het gebied Gemeenschappelijke eigenschappen het selectievakje Toepassing is algemeen in om het gehoste besturingselement in te stellen als algemeen. Algemene gehoste besturingselementen kunnen buiten een klantsessie worden weergegeven. Besturingselementen zoals het dashboard, het prikbord of de zoekactie van agents zijn veelvoorkomende voorbeelden van algemene gehoste besturingselementen. Algemene gehoste besturingselementen hebben geen sessiespecifieke status, dus als u van sessie verandert, blijven dezelfde algemene gehoste besturingselementen behouden. Als het selectievakje niet is ingeschakeld, wordt het gehoste besturingselement sessiegebaseerd. Sessiegebaseerde besturingselementen bestaan in de context van de klantsessie. Als de gebruiker de sessie wijzigt, worden alle sessiepagina's uit de vorige sessie verborgen.

  • Het veld Weergavegroep bevat het paneel waar dit gehoste besturingselement wordt weergegeven.MainPanel wordt het meest gebruikt voor dit type gehost besturingselement. Voor informatie over verschillende panelen beschikbaar in Unified Service Desk, zie Panelen, paneeltypen en paneelindelingen in Unified Service Desk.

Voor meer informatie over algemene velden raadpleegt u Een gehost besturingselement maken of bewerken.

Vooraf gedefinieerde UII-acties

Dit zijn de vooraf gedefinieerde acties voor dit type gehost besturingselement.

AssociatedView

Deze actie laadt een bepaalde gekoppelde weergave van Dynamics 365. Deze weergaven zijn normaal gesproken toegankelijk door klikken op de pijl-omlaag naast een entiteitsrecordnaam op de navigatiebalk en selecteren van de gekoppelde entiteiten.

Parameter

Beschrijving

navItemName

De gekoppelde entiteit die u wilt weergeven. Voorbeeld: aanvragen

Id

De id van de primaire entiteitsrecord waarvoor u de gekoppelde entiteitsrecords wilt weergeven.

tabset

Het gebied in Dynamics 365. Voorbeelden: areaSales of areaService.

Zie voor meer informatie over het gebruik van deze actie stap 5 in Analyse 7: Agentscripts configureren in uw agenttoepassing.

Sluiten

Deze actie wordt gebruikt om het gehoste besturingselement te sluiten. Als op dit tabblad (gehost besturingselement) meer dan één pagina wordt weergegeven, worden, anders dan bij de actie CloseActive, alle pagina's gesloten die op het tabblad in uw agenttoepassing worden weergegeven.

CloseActive

Deze actie wordt gebruikt om het actieve venster in dit gehoste besturingselement te sluiten. Als het actieve venster het enige weergegeven venster in het gehoste besturingselement is, wordt het besturingselement zelf gesloten. Voor gehoste besturingselementen van het type CRM-pagina die geen meerdere pagina's toestaan (Meerdere pagina's toestaan = Nee) is deze actie vergelijkbaar met de actie Sluiten.

CloseAndPrompt

Met deze actie wordt het gehoste besturingselement gesloten maar wordt de gebruiker gevraagd de wijzigingen eerst op te slaan of te negeren.

DisableToolbarButton

Met deze actie wordt de opgegeven werkbalkknop op de werkbalk in uw agenttoepassing uitgeschakeld.

Parameter

Beschrijving

Naam van de werkbalkknop die moet worden uitgeschakeld.

EnableToolbarButton

Met deze actie wordt de opgegeven werkbalkknop op de werkbalk in uw agenttoepassing ingeschakeld.

Parameter

Beschrijving

Naam van de werkbalkknop die moet worden ingeschakeld.

Zoeken

Navigeer naar de snelzoeklijst van de specifieke entiteit.

Parameter

Beschrijving

De gegevensparameter moet de logische naam van de entiteit van de weer te geven snelzoeklijst aangeven. Er zijn enkele waarden voor speciale gevallen:

  • Gebruik aanvraag of incident om de lijstweergave Snel zoeken weer te geven voor aanvragen.

  • Gebruik advfind om het geavanceerde zoekvenster weer te geven.

  • Gebruik activiteiten of activiteit om de lijstweergave Snel zoeken weer te geven voor activiteiten.

FireEvent

Activeert een door de gebruiker gedefinieerde gebeurtenis vanuit dit gehoste besturingselement.

Parameter

Beschrijving

naam

Naam van de door de gebruiker gedefinieerde gebeurtenis.

Alle volgende name=value-paren worden de parameters van de gebeurtenis. Voor meer informatie over het maken van een door de gebruiker gedefinieerde gebeurtenis raadpleegt u Een door de gebruiker gedefinieerde gebeurtenis maken.

GetSelectedIds

Deze actie wordt gebruikt om de geselecteerde id's op te halen uit de lijsten.

Parameter

Beschrijving

De gegevensparameter moet de lijstnaam opgeven om de geselecteerde id's vast te leggen.

De retourwaarde bevat een door puntkomma's gescheiden lijst met id's die de geselecteerde items bevatten.

GetSelectedCount

Deze actie haalt het aantal items op dat is geselecteerd. Gebruik de actie GetSelectedIds om de lijst met id's voor de entiteit op te halen.

Parameter

Beschrijving

De gegevensparameter moet de lijstnaam opgeven om de geselecteerde id's op te halen.

De retourwaarde bevat het aantal geselecteerde items.

GoHome

Deze actie gaat naar de eerste URL die voor dit browserexemplaar is opgegeven.

GoBack

Deze actie is vergelijkbaar met klikken op de knop Vorige in het browserexemplaar.

GoForward

Deze actie is vergelijkbaar met klikken op de knop Volgende in het browserexemplaar.

LoadArea

Met deze actie wordt een specifiek gebied uit Dynamics 365 geladen. Dit is vergelijkbaar met het selecteren van een gebied in het navigatiedeelvenster (zoals Verkoop, Service en Marketing). De enige parameter is de naam is van het gebied waarop wordt geklikt. Bijvoorbeeld: areaService.

Parameter

Beschrijving

frame

De naam van het betrokken frame. Als geen naam is opgegeven, wordt automatisch het eerste frame gebruikt dat op de pagina wordt gevonden.

LookupInfo

Geeft een Dynamics 365-opzoekdialoogvenster weer met opzoekinformatie waarmee u een entiteit in een lijst kunt selecteren.

Parameter

Beschrijving

AllowFilterOff

"0" of "1" om de gebruiker toe te staan filtering uit te schakelen

DefaultType

De logische naam van de standaardweergave. Dit moet een van de numerieke waarden die zijn in de parameter objecttypes is opgegeven.

DefaultViewId

"0" of "1" om de standaardweergave te tonen

DisableQuickFind

"0" of "1" om het snelzoekveld weer te geven

DisableViewPicker

"0" of "1" om de weergaveselectie te tonen

LookupStyle

Een of meer

ShowNewButton

"0" of "1" om de knop Nieuw weer te geven

ShowPropButton

"0" of "1" om de knop Eigenschappen weer te geven

Bladeren

"0" of "1" om aan te geven of de bladermodus wordt gebruikt Bij het volgende is dit ingesteld op "1".

Currentid

De Guid voor de huidige waarde

objecttypes

Lijst met weer te geven objecttypen. Dit zijn de etc-typen uit Dynamics 365. Voorbeeld: "1,2" om accounts en contactpersonen weer te geven.

MoveToPanel

Deze actie verplaatst een gehost besturingselement CRM-Pagina naar een ander deelvenster tijdens runtime.

Parameter

Beschrijving

De gegevensparameter moet de naam van het doelpaneel opgeven waarnaar het gehoste besturingselement wordt verplaatst. Voorbeeld: FloatingPanel.

Deze actie wordt gebruikt om naar een Dynamics 365-URL te gaan.

Parameter

Beschrijving

URL

De URL waarnaar moet worden genavigeerd. Dit is een verplichte parameter.

Noscan

Als deze parameter wordt opgegeven en Waar is, worden de gegevensparameters niet geregistreerd van de pagina.

HideCommandBar

Als deze parameter wordt opgegeven en Waar is, wordt het binnenframe weergegeven, zonder de Dynamics 365 opdrachtbalk te laden.

Navigatiebalk verbergen

Als deze parameter wordt opgegeven en Waar is, wordt het formulier weergegeven, zonder de Dynamics 365 navigatiebalk te laden.

Kader

Als de pagina frames bevat, kan deze parameter de naam bevatten van het te navigeren frame, in plaats van dat het hoofdvenster wordt genavigeerd.

postdata

Gegevens die naar de server worden verzonden als onderdeel van een HTTPPOST-transactie. Een POST-transactie wordt meestal gebruikt om gegevens te verzenden die zijn verzameld door een HTML-pagina. In Unified Service Desk, kunnen deze gegevens zijn ontvangen van elke gebeurtenis die is geactiveerd met "http://event/?". Voorbeeld: [[postdata]+]

Anders kunnen de gegevens als een gecodeerde tekenreeks met het kopteksttype in de beoogde indeling worden doorgegeven.

header

Een tekenreekswaarde die aanvullende HTTP-kopteksten bevat die naar de server moeten worden gestuurd. Als de parameter in postdata wordt gebruikt in de actie Navigate, moet u ook een juiste waarde voor de parameter header opgeven. Voorbeeld: Content-Type:application/x-www-form-urlencoded

Als een Unified Service DeskPOST-gebeurtenis de actie Navigate activeert, moet de standaardwaarde van deze parameter header=[[header]+] zijn

New_CRM_Page

Maakt een pagina voor het maken van een nieuwe Dynamics 365-record van de opgegeven entiteit en behandelt de pagina als een pop-up vanuit het opgegeven gehoste besturingselement. De vensternavigatieregels worden geëvalueerd om de locatie te bepalen waar de pagina voor het maken van de entiteitrecord wordt weergegeven.

Parameter

Beschrijving

LogicalName

De logische naam van de entiteit voor het maken van een nieuw exemplaar.

Notitie

De rest van de parameters moet uit name=value-paren bestaan. Dit zijn de extra vooraf gevulde waarden in het formulier voor het maken van een nieuwe record voor de opgegeven entiteit. Zie voor meer informatie over het gebruik van deze actie stap 4 in Analyse 7: Agentscripts configureren in uw agenttoepassing.

Open_CRM_Page

Opent een bestaande entiteit van het opgegeven type en geïdentificeerd door de id, en behandelt de pagina als een pop-up vanuit het opgegeven gehoste besturingselement. De vensternavigatieregels worden geëvalueerd om de locatie te bepalen waar de pop-up moet worden weergegeven.

Parameter

Beschrijving

LogicalName

De logische naam van de te openen entiteit.

id

De id van de te openen entiteitrecord.

Geeft een URL weer vanuit het gehoste besturingselement en voert er de vensternavigatieregels op uit om de pop-up naar de juiste locatie te routeren.

Parameter

Beschrijving

url

Routeert een pop-up vanuit dit besturingselement met deze URL alsof het een pop-up is die vanuit het weergegeven besturingselement is aangevraagd.

frame

Het frame waaruit deze pop-up voortkomt.

RealignWindow

Geeft het gehoste besturingselement weer op de opgegeven locatie op een monitor. U kunt het gehoste besturingselement op maximaal twee monitoren weergeven. Deze actie is toepasbaar op exemplaren van gehoste besturingselementen die zijn geconfigureerd om te worden geplaatst op een paneel van het type USDFloatingPanel of USDFloatingToolPanel.

Parameter

Beschrijving

screen

Geeft het scherm op waarop het gehoste besturingselement moet worden weergegeven. Geldige waarden zijn 1 en 2. Als u deze parameter niet opgeeft, wordt standaard 1 doorgegeven.

left

Geeft in een percentage vanaf de linkerzijde van het scherm de positie op de doelmonitor op waar het gehoste besturingselement moet worden weergegeven. Geldige waarden lopen van 0 tot 100. Als u deze parameter niet opgeeft, wordt standaard 0 doorgegeven.

top

Geeft in een percentage vanaf de bovenzijde van het scherm de positie op de doelmonitor op waar het gehoste besturingselement moet worden weergegeven. Geldige waarden lopen van 0 tot 100. Als u deze parameter niet opgeeft, wordt standaard 0 doorgegeven.

width

Geeft in een percentage de breedte van het venster van het gehoste besturingselement op de doelmonitor op. Geldige waarden lopen van 1 tot 100. Als u deze parameter niet opgeeft, wordt standaard 100 doorgegeven.

height

Geeft in een percentage de hoogte van het venster van het gehoste besturingselement op de doelmonitor op. Geldige waarden lopen van 1 tot 100. Als u deze parameter niet opgeeft, wordt standaard 100 doorgegeven.

Vernieuwen

Deze actie vernieuwt de huidige pagina.

ReRoute

Deze actie gebruikt de momenteel weergegeven URL en stuurt deze door de vensternavigatieregels als een pop-up vanuit het huidige gehoste besturingselement.

RunScript

Deze actie voegt JavaScript in het hoofdframe van de toepassing in. Gebruik geen Dynamics 365-client SDK-aanroepen met deze actie; gebruik in plaats daarvan de actie RunXrmCommand.

Parameter

Beschrijving

De gegevensparameter in de JavaScript die in het formulier wordt ingevoegd.

Notitie

De vervangingsparameters kunnen in het script worden gebruikt en ze worden vervangen voordat het script wordt uitgevoerd.

RunXrmCommand

Deze actie wordt gebruikt om Dynamics 365 SDK JavaScript te plaatsen in het Dynamics 365-formulier.

Parameter

Beschrijving

De gegevensparameter in de JavaScript die in het formulier wordt ingevoegd.

Notitie

De vervangingsparameters kunnen in het script worden gebruikt en ze worden vervangen voordat het script wordt uitgevoerd.

SetSize

Met deze actie worden de breedte en de hoogte van het gehoste besturingselement expliciet ingesteld. Dit is vooral handig bij het gebruik van "auto" in uw paneelindelingen.

Parameter

Beschrijving

width

De breedte van het gehoste besturingselement.

height

De hoogte van het gehoste besturingselement.

SaveAndClose

Met deze actie worden de vuile gegevens in het Dynamics 365-formulier opgeslagen en wordt het gehoste besturingselement gesloten.

SaveAll

Met deze actie worden alle formulieren in een gehost besturingselement dat toestaat dat meerdere pagina's worden weergegeven (Meerdere pagina's toestaan = Ja), opgeslagen. Als het gehoste besturingselement slechts toestaat dat één pagina wordt weergegeven (Meerdere pagina's toestaan = Nee), is dit vergelijkbaar met de actie Opslaan.

Opslaan

Met deze actie wordt de huidige CRM-pagina opgeslagen.

ToggleRibbon

Deze actie vouwt het lint samen of uit. Als u het lint verbergt in de Navigate-actie, wordt het niet weergegeven en werkt deze actie niet. Deze actie werkt alleen wanneer het lint in eerste instantie is geladen.

ToggleNavigation

Met deze actie wordt het navigatiedeelvenster in het linkerdeelvenster van het venster Dynamics 365 samengevouwen of uitgevouwen. De navigatie moet een navigatiedeelvenster bevatten, anders werkt deze actie niet.

Vooraf gedefinieerde gebeurtenissen

De volgende vooraf gedefinieerde gebeurtenissen zijn gekoppeld aan dit type gehost besturingselement.

ActiveClosed

Treedt op wanneer het actieve gehoste besturingselement wordt gesloten met de actie CloseActive.

Parameter

Beschrijving

url

De URL die in het gehoste besturingselement werd weergegeven toen het werd gesloten.

BrowserDocumentComplete

Treedt op wanneer het laden van de pagina is voltooid. In een gehost besturingselement van het type CRM-pagina treedt deze gebeurtenis op nadat de gegevens zijn opgeslagen in de lijst met vervangingsparameters. Deze gebeurtenis treedt slechts één keer op, hoewel voor meerdere frames afzonderlijk de BrowserDocumentComplete-gebeurtenissen worden geactiveerd.

Parameter

Beschrijving

url

De URL van de pagina die klaar is met laden.

PageLoadComplete

Treedt op wanneer het laden van een frame is voltooid. Deze gebeurtenis kan meerdere keren per pagina optreden wanneer een iFrame of een frame op de pagina wordt gebruikt. Deze gebeurtenis correspondeert met de afzonderlijke BrowserDocumentComplete-gebeurtenissen in code.

Parameter

Beschrijving

frame

De naam van het frame dat klaar is met laden, indien beschikbaar.

url

De URL van het frame dat klaar is met laden.

PopupRouted

Treedt op nadat een pop-up door het systeem is gerouteerd.

Parameter

Beschrijving

url

De URL van de pop-up die is gerouteerd.

RefreshRequested

Treedt op als om vernieuwing wordt gevraagd op de huidige pagina. Om vernieuwen kan worden gevraagd door drukken op F5 of door het aanroepen van de actie Refresh door de toepassing.

Parameter

Beschrijving

url

De URL die werd weergegeven toen om vernieuwing werd gevraagd.

Saved

Treedt op nadat een record op de Dynamics 365-pagina is opgeslagen.

Parameter

Beschrijving

newId

De id van de nieuw gemaakte record.

Zie ook

CRM-dialoogvenster (gehost besturingselement)
UII-acties
Gebeurtenissen
Analyse 3: Microsoft Dynamics 365-records weergeven in een sessie in uw agenttoepassing
Typen gehoste besturingselementen en actie/gebeurtenisnaslag
Beheerhandleiding voor Unified Service Desk for Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht

  • Last updated on