Freigeben über

Typen von HAT-Automatisierungsaktivitäten

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Es stehen verschiedene Typen von Hosted Application Toolkit (HAT)-Automatisierungsaktivitäten zu Verfügung, die Sie verwenden können, um Ihre gehosteten Anwendungen zu automatisieren. Um die HAT-Automatisierungsaktivitäten anzuzeigen und zu verwenden, siehe Use HAT-Automatisierungsaktivitäten

In diesem Thema

Application Integration Framework (AIF)-Aktionsaktivitäten

AIF-Kontextaktivitäten

DDA-Aktivitäten

Application Integration Framework (AIF)-Aktionsaktivitäten

Aktionsaktivitäten bieten Funktionen für Zugriff und Verwaltung von UII-Aktionen. Die folgende Tabelle beschreibt die verschiedenen verfügbaren Aktionsaktivitäten.

Aktivität

Beschreibung

DoAction

Führt eine Aktion entweder in der gleichen oder in einer anderen gehosteten Anwendung aus. Diese Aktion hat folgende Eigenschaften:

  • ApplicationName: Die Anwendung, auf der die DoAction ausgeführt wird. Obligatorisch.

  • ActionData: Daten, die zum Ausführen der Aktion erforderlich sind. (Optional).

  • ActionName: der Name der Aktion, der mit der gehosteten Anwendung registriert ist, die in der Eigenschaft ApplicationName angegeben ist. Obligatorisch.

GetActionData

Ruft die Daten aus der Aktion ab, die den Workflow oder den Automatisierungsvorgang aufriefen. Der Wert wird in der ActionData-Eigenschaft zurückgegeben.

SetActionData

Fügt der aktuellen Aktion Daten hinzu.

Geben Sie die Daten ab, die für die Aktion im Parameter ActionData erforderlich sind.

RegisterActionForEvent

Registriert, dass eine Aktion initiiert wird, wenn ein Ereignis auftritt. Diese Aktion hat folgende Eigenschaften:

  • ActionApplication: Name der Anwendung, mit dem die UII-Aktion registriert wird. Obligatorisch.

  • ActionName: Name der Aktion für die Anwendung, die ausgeführt wird, wenn das Ereignis initiiert wird. Obligatorisch.

  • ApplicationName: Name der Anwendung, mit der das Ereignis initiiert wird. Obligatorisch.

  • ControlName: Name des Steuerelements, mit dem das Ereignis initiiert wird. (Optional).

  • EventName: Name des Ereignisses, das von der Anwendung/dem Steuerelement initiiert wird.

UnRegisterActionForEvent

Hebt die Registrierung einer Aktion auf, die zuvor mithilfe der RegisterActionForEvent-Aktivität registriert wurde. Der Ereignis, dessen Registrierung aufgehoben wurde, wird nicht mehr ausgeführt. Diese Aktion hat folgende Eigenschaften:

  • ActionApplicationName: Name der Anwendung, mit dem die UII-Aktion registriert wird.

  • ActionName: Name der Aktion für die Anwendung, die ausgeführt worden wäre, wenn das Ereignis initiiert würde.

  • ApplicationName: Name der Anwendung, mit der das Ereignis initiiert wird.

  • ControlName: Name des Steuerelements, mit dem das Ereignis initiiert wird.

  • EventName: Name des Ereignisses, das von der Anwendung oder dem Steuerelement initiiert wird.

CloseDynamicApp

Schließt eine dynamische gehostete Anwendung aus der Automatisierung heraus. Mit dieser Aktion kann eine dynamische gehostete Anwendung in Unified Service Desk programmgesteuert geschlossen werden.

Geben Sie den Namen der dynamischen gehosteten Anwendung im Parameter ApplicationName an, die Sie schließen möchten.

Weitere Informationen zu dynamischen gehosteten Anwendungen finden Sie unter Von einer dynamischen UI gehostete Anwendungen.

StartDynamicApp

Startet eine dynamische gehostete Anwendung aus der Automatisierung heraus.

Geben Sie den Namen der dynamischen gehosteten Anwendung im Parameter ApplicationName an, die Sie starten möchten.

FocusApp

Fokus auf eine Anwendung aus der Automatisierung heraus setzen.

Geben Sie den Namen der dynamischen gehosteten Anwendung im Parameter ApplicationName an, auf die Sie den Fokus setzen möchten.

AIF-Kontextaktivitäten

Kontextaktivitäten ermöglichen den Zugriff auf den AIF-Kontext aus der Automatisierung. Die folgende Tabelle beschreibt die verschiedenen verfügbaren Kontextaktivitäten.

Aktivität

Beschreibung

GetContext

Ruft einen Schlüssel für den angegebenen Wert aus dem Kontext ab. Der Wert wird in der ContextValue-Eigenschaft zurückgegeben.

Geben Sie den Schlüssel des abzurufenden Kontexts in der Eigenschaft ContextKey an.

SetContext

Legt den Wert für den angegebenen Schlüssel im Kontext an. Diese Aktion hat folgende Eigenschaften:

  • ContextKey: Schlüssel des Kontext, der festgelegt werden soll.

  • ContextData: Optional, geben Sie die festzulegenden Daten für den Kontext an, der in ContextKey angegeben wurde.

GetCredential

Ruft Benutzeranmledenformationen aus dem Kontext für die angegebene Anwendung ab. Diese Aktion hat folgende Eigenschaften:

  • ApplicationName: Name der Anwendung.

  • UserName: Benutzername.

  • Password: Passwort.

Hinweis

Wenn Sie die Anmeldeinformationen aus einer angepassten Speicher hinzufügen, muss der Entwickler eineKlasse bereitstellen, die die ISsoLookupService-Schnittstelle implementiert.

HostApplication

Hostet die Benutzeroberfläche der Anwendung. Sie verwendet die Anwendungshosting-Konfigurationsdaten, die beim Konfigurieren des gehosteten Steuerelements in Unified Service Desk auf dem Microsoft Dynamics 365-Server, um den Hostingmodus festzulegen. Weitere Informationen zur Angabe des Hostingmodus für eine Anwendung in Unified Service Desk, siehe Erstellen und Verwalten von UII-gehosteten Steuerelementen.

DDA-Aktivitäten

Datengesteuerte Adapter (DDA)-Aktivitäten ermöglichen den Zugriff auf Steuerlemente, welche in den Bindungen angegeben wurden. Die folgende Tabelle enthält verschiedene DDA-Aktivitäten.

Aktivität

Beschreibung

ControlFinder

Lokalisiert ein gehostetes Steuerelement in der Anwendung. Die Aktion gibt True zurück, wenn das Steuerlement in der ControlFound-Eigenschft gefunden wird; andernfalls gibt es False zurück. Sie können die ExceptionsMask-Eigenschaft festlegen, wenn Sie den Ausnahmehandler verwenden, um abhängige Aktivitäten auszuführen. Diese Aktion hat folgende Eigenschaften:

  • ApplicationName: Name der Anwendung, die das Steuerelement hostet. Obligatorisch.

  • ControlName: Name des Steuerelements in der Anwendung.

  • ExceptionsMask: Gibt an, ob Sie eine Ausnahme anzeigen möchten, wenn das Steuerelement nicht gefunden wird. Die Standardeinstellung ist False.

Hinweis

Wenn ein Workflow, den Sie konfigurierten, den UI-Thread blockiert, den Sie angegeben haben und Sie SleepInterval-Parameter für die Aktivität ControlFinder angegeben haben, sollte die Aktion so konfiguriert werden, dass sie asynchron ausgeführt wird.

ExecuteControlAction

Führt die Standardaktion eines Steuerelements aus. Beispielsweise, wenn das Steuerelement eine Schaltfläche ist, ist die Standardaktion "Klicken". Diese Aktion hat folgende Eigenschaften:

  • ApplicationName: Name der Anwendung, die das Steuerelement hostet.

  • ControlName: Name des Steuerelements in der Anwendung.

GetControlValue

Ruft einen Wert von einem Steuerelement in der Anwendung ab. Der Wert wird in der Eigenschaft ControlValue abgerufen. Diese Aktion hat folgende Eigenschaften:

  • ApplicationName: Name der Anwendung, die das Steuerelement hostet.

  • ControlName: Name des Steuerelements in der Anwendung, dessen Wert abgerufen werden muss.

Hinweis

Wenn Sie die GetControlValue-Akltivität mit einem Mehrzeilentext-Steuerelement verwenden, werdfen alle Zeichen neuer Zeilen ignoriert und ein einzelner Wert wird zurückgegeben.

SetControlValue

Legt den Wert eines Steuerelements in der Anwendung fest. Diese Aktion hat folgende Eigenschaften:

  • ApplicationName: Name der Anwendung, die das Steuerelement hostet.

  • ControlName: Name des Steuerelements in der Anwendung, dessen Wert festgelegt werden soll.

  • ControlValue: Geben Sie den festzulegenden Wert ein.

Hinweis

Wenn Sie die SetControlValue-Akltivität mit einem Mehrzeilentext-Steuerelement verwenden, werdfen alle Zeichen neuer Zeilen ignoriert und ein einzelner Wert wird zurückgegeben.

Navigate

Gibt eine URL an, zu der eine Webanwendung navigiert. Beispielsweise können Sie die Navigate-Aktivität verwenden, um eine Webanwendung zu zwingen, zu einer bestimmten URL zu wechseln, wenn ein Benutzer eine Aufgabe ausführt. Diese Aktion hat folgende Eigenschaften:

  • ApplicationName: Name der Anwendung, die das Steuerelement hostet.

  • URL: Geben Sie die URL zusammen mit einer Abfragezeichenfolge an.

Hinweis

  • Die Aktivität Navigate sollte im Webbrowser nicht gleichzeitig aufgerufen werden. Wenn doch, wird die folgende Fehlermeldung angezeigt:

    AutomationAdapter (app=Contact, action=__SetControlValue): Gebuchte implizite Aktionsausnahme: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Webbrowser ist beschäftigt und kann nicht gestoppt werden. WF/Automatisierung <GUID>-Ausnahme: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Webbrowser ist beschäftigt und kann nicht gestoppt werden.

  • Damit die Navigate-Aktitvität in der Zielanwendung funktioniert. müssen Sie die gehostete Anwendung in Unified Service Desk so konfigurieren, dass sie den Automation Adapter (HAT) verwendet, und folgende Bindung im Automation XML-Feld angeben:

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

    Weitere Informationen zum Konfigurieren von gehosteten Steuerelementen in Unified Service Desk, siehe Erstellen und Verwalten von UII-gehosteten Steuerelementen.

Audit

Erstellt der Überwachungseinträge aus der Automatisierung heraus. Diese Aktion hat folgende Eigenschaften:

  • Audit Flag: Name des Überwachungsflags.

  • Log data: Wert des Überwachungsflagwerts.

Informationen zu verschiedenen Überwachungsflags in Unified Service Desk, siehe Konfigurieren von Überwachung in Unified Service Desk im Unified Service Desk Administrationshandbuch.

ConfigReader

Liest einen Konfigurationswert aus der Automatisierung. Diese Aktivitäten lesen entweder Konfiguration aus den Einstellungen Option in Unified Service Desk oder der Anwendungskonfigurationsdatei. Diese Aktion hat folgende Eigenschaften:

  • OptionKey als Zeichenfolge: wird verwendet, um die Option-Einstellung aus Unified Service Desk zu lesen. Weitere Informationen über verschiedene Optionen erhalten Sie unter TechNet: Verwalten von Optionen für Unified Service Desk.

  • XPath als Zeichenfolge: Wird verwendet, um die Anwendungskonfigurationsdatei zu lesen.

  • QueryResult als Zeichenfolge: Ergebnis der Suche.

InitstringReader

Ermöglicht Ihnen, den InitString-Inhalt aus der Automatisierung heraus zu lesen. Diese Aktion hat folgende Eigenschaften:

  • XPath als Zeichenfolge: Wird verwendet, um die Anwendungskonfigurationsdatei zu lesen.

  • QueryResult als Zeichenfolge: Ergebnis der Suche.

Siehe auch

Erstellen von HAT-Automatisierung
UII-Anwendungsintegrationsframework
Verwenden von datengesteuerten Adaptern (DDAs)

Unified Service Desk 2.0

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright