Über die Integration Service-Aktivitäten

Die Integration Service-Aktivitäten sind so konzipiert, dass die vom Integration Service bereitgestellten Connectors verwendet werden, um Verbindungen mit Anwendungen von Drittanbietern herzustellen und diese einfach zu automatisieren. Dies ermöglicht eine schnellere Integration in SaaS-Plattformen (Software-as-a-Service).

Wir unterstützen eine Vielzahl von Anwendungen von Drittanbietern und die Liste wächst ständig. Dieser Leitfaden enthält alle Aktivitäten, die von UiPath® ausschließlich zur Verwendung mit dem Integration Service erstellt wurden. Aktivitäten, die sowohl Integration Service als auch Scope-basierte Verbindungen verwenden, werden im Handbuch zu Produktivitätsaktivitäten (z. B. Microsoft OneDrive, Outlook oder Google-Aktivitäten) und im Handbuch zu IT-Automatisierungsaktivitäten (z. B. Amazon WebServices, Azure oder VMWare) separat dokumentiert.

Arbeiten mit Integration Service-Aktivitäten

Studio Web

In Studio Web sind die neuesten Aktivitäten standardmäßig im Aktivitätsbrowser verfügbar. Weitere Informationen finden Sie unter Hinzufügen von Aktivitäten zu einem Projekt im Studio Web-Benutzerhandbuch.

Sie können auch verfügbare Trigger verwenden, um Ihre Automatisierung zu starten. Weitere Informationen finden Sie unter So starten Sie eine Automatisierung.

Studio 2025.0.161

Ab Studio 2025.0.161 Integration Service-Connectors werden direkt im Fenster Pakete verwalten aufgeführt. Dies erleichtert das Hinzufügen eines Connectors und seiner Aktivitäten zu einem Projekt. Weitere Informationen finden Sie unter Verwalten von Connectors im Studio-Benutzerhandbuch.

Studio Desktop-Version 2023.10 oder höher

Ab Studio Desktop-Version 2023.10 Integration Service-Aktivitäten werden über das einheitliche UiPath.IntegrationService.Activities-Paket bereitgestellt.

Alle Integration Service-Aktivitäten und -Trigger werden in Studio im Bereich Aktivitäten im Abschnitt Verfügbar aufgelistet.

Hinweis: Stellen Sie sicher, dass Sie den Filter Verfügbar im Aktivitätenbereich aktivieren.

Wenn Sie eine Aktivität aus der Liste Verfügbar zu Ihrem Workflow hinzufügen, wird das UiPath.IntegrationService.Activities-Paket automatisch als Projektabhängigkeit installiert. Dadurch erhalten Sie Zugriff auf jeden Connector aus dem Integration Service, einschließlich Ihrer benutzerdefinierten Connectors.

UiPath.IntegrationService.Activities ist ein dynamisches Aktivitätspaket, das bedeutet, dass Sie es nicht manuell aktualisieren müssen. Das Aktivitätspaket wird automatisch aktualisiert. Sie haben immer Zugriff auf die neuesten Connectors, Trigger und Aktivitäten sowie auf die neueste Version der Aktivitäten, die Sie bereits verwenden.

Weitere Informationen finden Sie unter Häufig gestellte Fragen.

Tipp:

Um auf Vorschauaktivitäten zuzugreifen, stellen Sie sicher, dass Vorschaupakete und -aktivitäten aktiviert sind. Wenn Sie Studio Web verwenden, sehen Sie sich den Abschnitt Vorschau von Aktivitäten und Paketen im Studio Web-Benutzerhandbuch an. Wenn Sie Studio Desktop verwenden, sehen Sie sich den Abschnitt Verwalten von Paketen im Studio-Benutzerhandbuch an.

Studio-Version 2023.4 oder niedriger

Wenn Sie Studio 2023.4 oder niedriger verwenden, verwenden Sie den Paketmanager, um einzelne Aktivitätspakete für bestimmte Connector herunterzuladen. Weitere Informationen finden Sie unter Verwalten von Aktivitätspaketen im Studio Desktop-Benutzerhandbuch.

Jeder Integration Service-Connector verfügt über ein entsprechendes Paket, das als UiPath.[ConnectorName].IntegrationService.Activities verfügbar ist. Beispiel: UiPath.Jira.IntegrationService.Activities.

Wichtig: Um von den neuesten Aktualisierungen für Integration Service-Connector und -Aktivitäten zu profitieren, empfehlen wir Ihnen, auf Studio 2023.10 oder höher zu aktualisieren.

Projektkompatibilität

Alle Aktivitäten, die über das einheitliche UiPath.IntegrationService.Activities-Paket bereitgestellt werden, sind mit Windows und plattformübergreifend kompatibel.

	Windows – Legacy	Windows	Plattformübergreifend
UiPath.IntegrationService.Activities

Eigenständige Versionen von Integration Service-Aktivitätspaketen können auch mit Windows – Legacy kompatibel sein. Überprüfen Sie die einzelne Paketdokumentation, um die spezifische Projektkompatibilität anzuzeigen.

Einschränkungen

In diesem Abschnitt werden Grenzwerte auf Plattformebene und andere Einschränkungen beschrieben, die sich auf alle Integration Service-Connectors und/oder -Aktivitäten auswirken.

Grenzen der Datenverarbeitung

Integration Service hat ein Plattformlimit für das Abrufen von Antworten. Die maximale Grenze für die Datenverarbeitung beträgt 8 MB. Das bedeutet, dass bei einigen API-Aufrufen die Anzahl der abgerufenen Antworten die Grenze von 8 MB überschreiten kann und die folgende Fehlermeldung ausgegeben wird: „Antwortinhalt zu groß“.

Hinweis: Die 8-MB-Grenze gilt für Daten im JSON-Format. Dies umfasst Fälle, in denen Dateien im Base64-Format als Teil der JSON-Daten gesendet oder empfangen werden. Für Dateien, die außerhalb von JSON verarbeitet werden, beträgt die Grenze 1 GB.

Problemumgehung

Mit den folgenden Schritten können Sie sicherstellen, dass das Datenverarbeitungslimit nicht überschritten wird:

• Passen Sie das Feld Max. Datensätze auf Aktivitätsebene auf eine niedrigere Zahl an.
• Fügen Sie Filter zu Ihren Abfragen hinzu. Die Angabe von Filterparametern kann die Anzahl der Antworten begrenzen.

Aktivitäts-Timeouts

Es gibt ein plattformweites Timeout von 90 Sekunden für alle Aktivitäten, die auf Integration Service-Connectors basieren. Das bedeutet, dass wenn innerhalb von 90 Sekunden keine Antwort von der API empfangen wird, die Aktivität mit einem Timeout-Fehler fehlschlägt.

Fehlercodes

Dieser Abschnitt enthält eine Übersicht über die Fehlercodes, die bei der Verwendung von Aktivitäten aus dem einheitlichen Integration Service-Aktivitätspaket auftreten können.

Fehlercodes liegen im Bereich [1000, 3999], aufgeteilt in drei Kategorien:

• Laufzeit (RT) – [1000, 1999]
• Entwurfszeit (DT) – [2000, 2999]
• Allgemein (kann sowohl zur Laufzeit als auch zur Entwurfszeit auftreten) – [3000, 3999]

In Fehlermeldungen werden die Codes mit dem enthaltenen Kategoriepräfix angezeigt, z. B. Das Feld „KontoID“ ist erforderlich. DAP-RT-1003.

In der folgenden Tabelle finden Sie Beschreibungen häufiger Fehlercodes.

Fehlercode	Kategorie	Meldung	Beschreibung
1001	Laufzeit	ServiceProvider ist NULL.	Die Aktivität konnte nicht gestartet werden, da ein erforderlicher Dienst nicht geladen wurde. Starten Sie Studio neu oder wenden Sie sich an den Support, wenn das Problem weiterhin besteht.
1002	Laufzeit	Verbindungs-ID ist leer.	Verbindungs-ID in der Aktivität nicht gefunden.
1003	Laufzeit	Das Feld „{fieldName}“ ist erforderlich.	Ein erforderliches Aktivitätsargument hat keinen festgelegten Wert.
1005	Laufzeit	Dienst hat mit einem Objekt geantwortet, das nicht dem Ausgabetyp der Aktivität entspricht.	Die Antwort eines API-Aufrufs entspricht nicht dem Ausgabeschema, das zur Entwurfszeit definiert wurde.
1051	Laufzeit	Ausführung des Triggers fehlgeschlagen.	Ein Trigger-API-Aufruf hat einen Fehlercode zurückgegeben oder die Antwort ist leer.
1052	Laufzeit	Triggeraktivität konnte keine Übereinstimmungen finden.	Der Trigger hat keine übereinstimmenden Ereignisse erkannt. Überprüfen Sie Ihre Filtereinstellungen oder versuchen Sie es mit der Ausführung in einer Live-Umgebung anstelle des Debugmodus.
1101	Laufzeit	Anforderung ist mit Fehler fehlgeschlagen: {0}. Statuscode: {1}.	Ein API-Aufruf ist auf der Integration Service- oder Anbieterseite fehlgeschlagen.
1103	Laufzeit	Keine benutzerdefinierte Meldung, die zugrunde liegende Ausnahmemeldung wird angezeigt.	Eine API-Anforderung ist während der Ausführung fehlgeschlagen. Überprüfen Sie die detaillierte Fehlermeldung und überprüfen Sie Ihre Netzwerk- oder API-Anmeldeinformationen.
2.000	Entwurfszeit	Die Metadaten-API-Anforderung ist mit dem Fehler „{0}“ fehlgeschlagen. Statuscode: {1}.	Die Aktivität konnte das Schema oder die Konfiguration nicht aus dem Dienst abrufen. Überprüfen Sie Ihre Netzwerkverbindung und Berechtigungen, und versuchen Sie es dann erneut.
2002	Entwurfszeit	Auf das Objekt „{0}“ kann für die aktuelle Verbindung nicht mehr zugegriffen werden. Überprüfen Sie Ihre Berechtigungen, oder wählen Sie ein gültiges Objekt in dieser Verbindung aus, oder wählen Sie eine Verbindung aus, die dieses Objekt enthält.	Das referenzierte Objekt wurde entfernt oder ist mit aktuellen Anmeldeinformationen nicht zugänglich. Möglicherweise wurde sie gelöscht oder Ihre Berechtigungen wurden geändert. Aktualisieren Sie ein gültiges Objekt, oder wählen/konfigurieren Sie ein gültiges Objekt.
2050	Entwurfszeit	Die Abfrage-API-Anforderung ist mit dem Fehler „{0}“ fehlgeschlagen. Statuscode: {1}.	Ein API-Aufruf konnte keine Daten für eine Dropdownliste oder ein anderes ähnliches Steuerelement abrufen. Mögliche Ursachen: Der beim Aufrufen des Elementdiensts erstellte Pfad ist falsch. Der Endpunkt des Anbieters ist ausgefallen (in der Regel wird ein 502-Code zurückgegeben). Fehlender Scope, um die API ordnungsgemäß aufzurufen. Die Anforderung sucht nach einem nicht vorhandenen Schlüssel (und ein 404-Code wurde zurückgegeben). Fehlender Header (zurückgegeben wird ein 400-Code).
2151	Entwurfszeit	Doppelte Feldnamen „{0}“	Es gibt zwei Objekte mit einem ähnlichen Namen, z. B ID und Id.
3000	Allgemein	Fehler beim Abrufen der Verbindung. Erwägen Sie die Verwendung einer anderen Verbindung.	Ein Aufruf der ConnectionClient-Komponente ist fehlgeschlagen. Kann mehrere Ursachen haben, z. B. eine Verbindung, die ungültig wurde.
3004	Allgemein	Fehler beim Abrufen des Zugriffstokens für die Ressource {0}.	Zeigt in der Regel an, dass das System kein gültiges Sicherheitstoken abrufen kann. Meist liegt das daran, dass ein vorhandenes Token abgelaufen ist.
3005	Allgemein	Verbindung ist deaktiviert. Aktivieren Sie die Verbindung, um fortzufahren.	Die Verbindung ist deaktiviert und muss aktiviert sein.