Typen von HAT Automatisierungsaktivitäten in Unified Service Desk

Es gibt verschiedene Arten von Hosted Application Toolkit (HAT) Automatisierungsaktivitäten, mit denen Sie Ihre gehosteten Anwendungen automatisieren können. Um die HAT-Automatisierungsaktivitäten anzuzeigen und zu verwenden, siehe Verwenden Sie HAT-Automatisierungsaktivitäten.

Application Integration Framework (AIF)-Aktionsaktivitäten

Aktionsaktivitäten bieten Funktionen für Zugriff und Verwaltung von UII Aktionen Hier sind die verschiedenen verfügbaren Aktionsaktivitäten.

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 werden soll. Obligatorisch.

• ActionData: Für die Durchführung der Aktion erforderliche Daten. (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, bei der die UII-Aktion registriert ist. Obligatorisch.

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

• ApplicationName: Name der Anwendung, die das Ereignis auslöst. Obligatorisch.

• ControlName: Name des Steuerelements, das das Ereignis auslöst. (Optional).

• EventName: Name des Ereignisses, das von der Anwendung/dem Steuerelement ausgelöst 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, bei der die UII-Aktion registriert ist.

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

• ApplicationName: Name der Anwendung, die das Ereignis auslöst.

• ControlName: Name des Steuerelements, das das Ereignis auslöst.

• EventName: Name des Ereignisses, das durch die Anwendung oder das Steuerelement ausgelöst wird.

  CloseDynamicApp
  Schließt eine dynamische gehostete Anwendung aus der Automatisierung heraus. Sie können diese Aktion verwenden, um eine dynamische gehostete Anwendung in Unified Service Desk programmatisch zu schließen.

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

  Weitere Informationen zur gehosteten Anwendungen finden Sie unter Dynamic UII gehostete Anwendung

  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. Hier sind die verschiedenen Kontextaktivitäen verfügbar.

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 Kontexts, der festgelegt werden soll.

• ContextData: Geben Sie optional die Daten ein, die auf den in ContextKey angegebenen Kontext festgelegt werden sollen.

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

• ApplicationName: Name der Anwendung.

• UserName: Name des Benutzers.

• Password: Kennwort.

Notiz

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

HostApplication
Hostet die Benutzeroberfläche der Anwendung. Es verwendet die Application Hosting Konfigurationsdaten, die bei der Konfiguration des gehosteten Steuerelements in Unified Service Desk auf Server Microsoft Dataverse angegeben wurden, um den Hosting-Modus zu bestimmen. Weitere Informationen zum Festlegen des Hosting-Modus für eine Anwendung in Unified Service Desk finden Sie unter Erstellen und Verwalten von gehosteten UII-Anwendungen.

DDA-Aktivitäten

Datengesteuerte Adapter (DDA)-Aktivitäten ermöglichen den Zugriff auf Steuerlemente, welche in den Bindungen angegeben wurden. Hier sind die verschiedenen DDA Aktivitäten.

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

• Audit Flag: Name des Audit-Flags.

• Log data: Wert des Audit-Flag-Werts.

  Informationen zu den verschiedenen Audit-Flags in Unified Service Desk finden Sie unter Konfigurieren Sie Auditing und Diagnose in Unified Service Desk.

  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 gehostet hat. 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.

Notiz

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 gehostet hat.

• ControlName: Name des Steuerelements in der Anwendung.

  GetControlValue
  Ruft einen Wert von einem Steuerelement in der Anwendung ab. Der Wert wird in der ControlValue-Eigenschaft zurückgegeben. Diese Aktion hat folgende Eigenschaften:

• ApplicationName: Name der Anwendung, die das Steuerelement gehostet hat.

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

Notiz

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 gehostet hat.

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

• ControlValue: Geben Sie den Wert ein, der festgelegt werden soll.

Notiz

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 gehostet hat.

• URL: Geben Sie die URL zusammen mit dem Abfrage-String an.

Notiz

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

  AutomationAdapter (app=Contact,action=__SetControlValue__): Posted implicit action exception:  Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.   
  
  WF/Automation <GUID> exception: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.  
  

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

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

  Weitere Informationen zur Konfiguration von gehosteten Steuerelementen in Unified Service Desk finden Sie unter Erstellen und Verwalten von gehosteten UII-Anwendungen.

ConfigReader
Liest einen Konfigurationswert aus der Automatisierung. Diese Aktivität liest entweder die Konfiguration aus den Option-Einstellungen in Unified Service Desk oder aus der Konfigurationsdatei der Anwendung. Diese Aktion hat folgende Eigenschaften:

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

• XPath als String: Wird verwendet, um die Konfigurationsdatei der Anwendung zu lesen.

• QueryResult als String: Ergebnis der Suche.

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

• XPath als String: Wird verwendet, um die Konfigurationsdatei der Anwendung zu lesen.

• QueryResult als String: Ergebnis der Suche.

Siehe auch

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