Typen HAT-automatiseringsactiviteiten

 

Gepubliceerd: november 2016

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

Er zijn verschillende typen Hosted Application Toolkit (HAT)-automatiseringsactiviteiten die u kunt gebruiken om uw gehoste toepassingen te automatiseren. Als u de HAT-automatiseringsactiviteiten wilt weergeven en gebruiken, raadpleegt u HAT-automatiseringsactiviteiten gebruiken.

In dit onderwerp

AIF-actieactiviteiten (Application Integration Framework)

AIF-contextactiviteiten

DDA-activiteiten

AIF-actieactiviteiten (Application Integration Framework)

Actieactiviteiten bieden functionaliteit voor toegang tot en beheer van UII-acties. In de volgende tabel worden de verschillende beschikbare actieactiviteiten beschreven.

Activiteit

Beschrijving

DoAction

Voert een actie uit in dezelfde toepassing of in een andere, gehoste toepassing. Deze actie heeft de volgende eigenschappen:

  • ApplicationName: de toepassing waarop de DoAction moet worden uitgevoerd. Verplicht.

  • ActionData: gegevens die vereist zijn voor het uitvoeren van de actie. Optioneel.

  • ActionName Naam van de actie die is geregistreerd bij de gehoste toepassing die wordt opgegeven met de eigenschap ApplicationName. Verplicht.

GetActionData

Haalt de gegevens op van de actie die de workflow of de automatisering heeft aangeroepen. De waarde wordt geretourneerd in de eigenschap ActionData.

SetActionData

Voegt gegevens toe aan de huidige actie.

Geef de gegevens op die vereist zijn voor de actie in de parameter ActionData.

RegisterActionForEvent

Registreert een actie die moet worden gestart wanneer een gebeurtenis optreedt. Deze actie heeft de volgende eigenschappen:

  • ActionApplication: naam van de toepassing waarbij de UII-actie is geregistreerd. Verplicht.

  • ActionName: naam van de actie voor de toepassing die wordt uitgevoerd wanneer de gebeurtenis wordt uitgevoerd. Verplicht.

  • ApplicationName: naam van de toepassing die de gebeurtenis start. Verplicht.

  • ControlName: naam van het besturingselement dat de gebeurtenis start. Optioneel.

  • EventName: naam van de gebeurtenis die wordt gestart door de toepassing of het besturingselement.

UnRegisterActionForEvent

Maakt de registratie ongedaan die eerder is geregistreerd met de activiteit RegisterActionForEvent. De niet meer geregistreerde gebeurtenis wordt niet meer uitgevoerd. Deze actie heeft de volgende eigenschappen:

  • ActionApplicationName: naam van de toepassing waarbij de UII-actie is geregistreerd.

  • ActionName: naam van de actie voor de toepassing die zou zijn uitgevoerd toen de gebeurtenis werd gestart.

  • ApplicationName: naam van de toepassing die de gebeurtenis start.

  • ControlName: naam van het besturingselement dat de gebeurtenis start.

  • EventName: naam van de gebeurtenis die wordt gestart door de toepassing of het besturingselement.

CloseDynamicApp

Sluit een dynamische gehoste toepassing vanuit de automatisering. U kunt deze actie gebruiken om vanuit programmering een dynamische gehoste toepassing in Unified Service Desk te sluiten.

Geef in de parameter ApplicationName de naam op van de dynamische gehoste toepassing die u wilt sluiten.

Zie voor meer informatie over dynamische gehoste toepassingen Dynamische UII-gehoste toepassingen.

StartDynamicApp

Start een dynamische gehoste toepassing vanuit de automatisering.

Geef in de parameter ApplicationName de naam op van de dynamische gehoste toepassing die u wilt starten.

FocusApp

Stelt de focus in op een toepassing vanuit de automatisering.

Geef in de parameter ApplicationName de naam op van de gehoste toepassing waarop u de focus wilt instellen.

AIF-contextactiviteiten

Contextactiviteiten maken toegang mogelijk tot de AIF-context vanuit de automatisering. De volgende tabel beschrijft de verschillende beschikbare contextactiviteiten.

Activiteit

Beschrijving

GetContext

Haalt een waarde voor de opgegeven code op uit de context. De waarde wordt geretourneerd in de eigenschap ContextValue.

Geef de code op van de context die moet worden opgehaald in de eigenschap ContextKey.

SetContext

Stelt de waarde voor de opgegeven code in de context in. Deze actie heeft de volgende eigenschappen:

  • ContextKey: code van de context die moet worden ingesteld.

  • ContextData: voer desgewenst de gegevens in die moeten worden ingesteld op de context die is opgegeven in ContextKey.

GetCredential

Haalt gebruikersreferenties uit de context op voor de opgegeven toepassing. Deze actie heeft de volgende eigenschappen:

  • ApplicationName: naam van de toepassing.

  • UserName: gebruikersnaam.

  • Password: wachtwoord.

Notitie

Om de referenties van een aangepast archief op te halen, moet de ontwikkelaar een klasse aanbieden die de ISsoLookupService-interface implementeert.

HostApplication

Hosts de gebruikersinterface van de toepassing. Het gebruikt de Toepassingen hosten-configuratiegegevens die zijn opgegeven tijdens het configureren van het gehoste besturingselement in Unified Service Desk op de Microsoft Dynamics 365-server, om de hostingmodus te bepalen. Voor meer informatie over het opgeven van de hostingmodus voor een toepassing in Unified Service Desk raadpleegt u Gehoste UII-toepassingen maken en beheren.

DDA-activiteiten

DDA-activiteiten (Data Driven Adapter) verlenen toegang tot besturingselementen die zijn opgegeven in de bindingen. In de volgende tabel worden verschillende DDA-activiteiten beschreven.

Activiteit

Beschrijving

ControlFinder

Zoekt een besturingselement in de gehoste toepassing. De actie retourneert True als het besturingselement in de eigenschap ControlFound wordt gevonden; anders wordt False geretourneerd. U kunt de eigenschap ExceptionsMask instellen als u de uitzonderingshandler wilt gebruiken om afhankelijke activiteiten uit te voeren. Deze actie heeft de volgende eigenschappen:

  • ApplicationName: naam van de toepassing die het besturingselement host. Verplicht.

  • ControlName: naam van het besturingselement in de toepassing.

  • ExceptionsMask: geeft aan of u een uitzondering wilt weergeven als het besturingselement niet wordt gevonden. De standaardinstelling is False.

Notitie

Als een werkstroom die u hebt geconfigureerd, de UI-thread blokkeert en u de parameters SleepInterval en Timeout hebt opgegeven voor de ControlFinder-activiteit, moet de actie worden geconfigureerd om asynchroon te worden uitgevoerd.

ExecuteControlAction

Voert de standaardactie van een besturingselement uit. Als het besturingselement bijvoorbeeld een knop is, is de standaardactie klikken. Deze actie heeft de volgende eigenschappen:

  • ApplicationName: naam van de toepassing die het besturingselement host.

  • ControlName: naam van het besturingselement in de toepassing.

GetControlValue

Haalt een waarde op van een besturingselement in de toepassing. De waarde wordt geretourneerd in de eigenschap ControlValue. Deze actie heeft de volgende eigenschappen:

  • ApplicationName: naam van de toepassing die het besturingselement host.

  • ControlName: naam van het besturingselement in de toepassing waarvan de waarde moet worden opgehaald.

Notitie

Als u de activiteit GetControlValue gebruikt met een tekstbesturingselement met meerdere regels, worden alle nieuwe regeltekens genegeerd en wordt één tekenreeks geretourneerd.

SetControlValue

Stelt de waarde van een besturingselement in de toepassing in. Deze actie heeft de volgende eigenschappen:

  • ApplicationName: naam van de toepassing die het besturingselement host.

  • ControlName: naam van het besturingselement in de toepassing waarvan de waarde moet worden ingesteld.

  • ControlValue: voer de waarde in die moet worden ingesteld.

Notitie

Als u de activiteit SetControlValue gebruikt met een tekstbesturingselement met meerdere regels, worden alle nieuwe regeltekens genegeerd en wordt één tekenreeks geretourneerd.

Navigate

Geeft een URL op waarnaar een webtoepassing navigeert. U kunt bijvoorbeeld de activiteit Navigate gebruiken om een webtoepassing te dwingen naar een specifieke URL te navigeren als een gebruiker een taak uitvoert. Deze actie heeft de volgende eigenschappen:

  • ApplicationName: naam van de toepassing die het besturingselement host.

  • URL: geef de URL op met de querytekenreeks.

Notitie

  • De activiteit Navigate moet niet tegelijkertijd worden aangeroepen in de webbrowser. Als dit wel gebeurt, krijgt u de volgende fouten:

    AutomationAdapter (app=Contact, action=__SetControlValue__): Geeft impliciete actieuitzondering: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: De webbrowser is bezet en kan niet worden gestopt. WF/Automation <GUID>-uitzondering: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: De webbrowser is bezet en kan niet worden gestopt.

  • Als u wilt dat de activiteit Navigate werkt met de doeltoepassing, moet u de gehoste toepassing in Unified Service Desk configureren om Automation Adapter (HAT) te gebruiken en voor de volgende binding zorgen in het veld Automatisering XML:

    <DataDrivenAdapterBindingsCollection>    <DataDrivenAdapterBindings>       <Type>Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.WebDataDrivenAdapter, Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter</Type>       <Controls/>    </DataDrivenAdapterBindings> </DataDrivenAdapterBindingsCollection>

    Zie voor meer informatie over het configureren van gehoste besturingselementen in Unified Service DeskGehoste UII-toepassingen maken en beheren.

Audit

Maakt controlevermeldingen vanuit de automatisering. Deze actie heeft de volgende eigenschappen:

  • Audit Flag: naam van de controlevlag.

  • Log data: waarde van de controlevlag.

Voor informatie over verschillende controlevlaggen in Unified Service Desk raadpleegt u Controle configureren in Unified Service Desk in de Unified Service Desk Beheerhandleiding.

ConfigReader

Leest een configuratiewaarde vanuit de automatisering. Deze activiteit leest het configuratiebestand van de Optie-instellingen in Unified Service Desk of het toepassingsconfiguratiebestand. Deze actie heeft de volgende eigenschappen:

  • OptionKey als tekenreeks: gebruikt om de Option-instelling te lezen uit Unified Service Desk. Voor meer informatie over verschillende opties, raadpleegt TechNet: Opties voor Unified Service Desk beheren u.

  • XPath als tekenreeks: gebruikt om het toepassingsconfiguratiebestand te lezen.

  • QueryResult als tekenreeks: resultaat van de zoekactie.

InitstringReader

Hiermee kunt u de InitString-inhoud lezen vanuit de automatisering. Deze actie heeft de volgende eigenschappen:

  • XPath als tekenreeks: gebruikt om het toepassingsconfiguratiebestand te lezen.

  • QueryResult als tekenreeks: resultaat van de zoekactie.

Zie ook

HAT-automatisering maken
UII Application Integration Framework
Data-Driven Adapters (DDA's) gebruiken

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht

  • Last updated on