Integration Service のアクティビティについて

Integration Service のアクティビティは、Integration Service が提供するコネクタを使用してサードパーティ アプリケーションとのコネクションを作成し、それらを簡単に自動化できるように設計されています。このため、サービスとしてのソフトウェア (SaaS) プラットフォームとの連携を高速化できます。

幅広いサードパーティ アプリケーションをサポートしており、サポートの範囲は拡大し続けています。このガイドには、UiPath® が Integration Service と併用する目的のみのために作成されたすべてのアクティビティが含まれています。Integration Service とスコープベースのコネクションの両方を使用するアクティビティについては、『生産性を高めるアクティビティ ガイド』(Microsoft OneDrive、Outlook、Google アクティビティなど) と『IT オートメーション アクティビティ ガイド』(アマゾン ウェブ サービス、Azure、VMWare など) に別途記載されています。

Integration Service のアクティビティを使用する

Studio Web

Studio Web では、最新のアクティビティを既定でアクティビティ ブラウザーから利用できます。詳細については、『Studio Web ガイド』の「Adding activities to a project」をご覧ください。

また、用意されている任意のトリガーを使用してオートメーションを開始することもできます。詳しくは「How to start an automation」をご覧ください。

Studio 2025.0.161

Studio v2025.0.161 以降では、Integration Service のコネクタは、[パッケージを管理] ウィンドウに直接表示されます。これにより、コネクタとそのアクティビティをプロジェクトに追加しやすくなります。詳細については、『Studio ガイド』の「コネクタを管理する」をご覧ください。

デスクトップ版の Studio v2023.10 以降

デスクトップ版の Studio v2023.10 以降では、統合 UiPath.IntegrationService.Activities パッケージを通じて Integration Service アクティビティが提供されます。

Integration Service のすべてのアクティビティとトリガーは、Studio の [アクティビティ] パネルの [利用可能] セクションに一覧表示されます。

注: [アクティビティ] パネルで [利用可能] フィルターを必ず有効にします。

[利用可能] リストからアクティビティをワークフローに追加すると、UiPath.IntegrationService.Activities パッケージがプロジェクトの依存関係として自動的にインストールされます。これにより、Integration Service の任意のコネクタ (カスタム コネクタを含む) にアクセスできるようになります。

UiPath.IntegrationService.Activities は動的なアクティビティ パッケージであるため、手動で更新する必要はありません。このアクティビティ パッケージは自動的に更新されます。最新のコネクタ、トリガー、アクティビティのほか、すでに使用しているアクティビティの最新バージョンにも、いつでもアクセスできます。

詳細については「Frequently asked questions」を参照してください。

ヒント:

プレビューのアクティビティにアクセスするには、プレビューのパッケージとアクティビティが有効化されていることを確認してください。Studio Web を使用している場合は、『Studio Web ユーザー ガイド』の「プレビュー中のアクティビティとパッケージ」をご覧ください。デスクトップ版の Studio を使用している場合は、『Studio ユーザー ガイド』の「パッケージを管理する」をご覧ください。

Studio バージョン 2023.4 以前

v2023.4 以前の Studio を使用している場合は、パッケージ マネージャーを使用して、特定のコネクタ用のアクティビティ パッケージを個別にダウンロードします。詳細については、デスクトップ版の Studio のユーザー ガイドで「Managing activity packages」をご覧ください。

Integration Service の各コネクタに対応するパッケージが UiPath.[ConnectorName].IntegrationService.Activities として用意されています。例: UiPath.Jira.IntegrationService.Activities

重要: Integration Service のコネクタとアクティビティの最新の更新内容を活用するために、v2023.10 以降の Studio へのアップグレードをお勧めします。

プロジェクトの対応 OS

統合 UiPath.IntegrationService.Activities パッケージで提供されるすべてのアクティビティは、Windows およびクロスプラットフォームに対応しています。

	Windows - レガシ	Windows	クロスプラットフォーム
UiPath.IntegrationService.Activities

Integration Service アクティビティ パッケージのスタンドアロン バージョンは、Windows - レガシにも対応している場合があります。各プロジェクトの対応 OS については、個々のパッケージのドキュメントをご覧ください。

制限事項

このセクションでは、Integration Service のすべてのコネクタおよび/またはアクティビティに影響する、プラットフォーム レベルの制限値とその他の制限事項について説明します。

データ処理の制限

Integration Service には、応答を取得するためのプラットフォームの制限があります。データ処理の上限は 8 MB です。つまり、一部の API 呼び出しでは、取得される応答の数が 8 MB の制限を超え、「応答の内容が大きすぎます」というエラー メッセージが表示される場合があります。

注: 8 MB の制限は JSON 形式のデータに適用されます。これには、ファイルが JSON データの一部として Base64 形式で送受信されるケースが含まれます。JSON の外部で処理されるファイルの制限は 1 GB です。

回避策

次の手順に従って、データ処理の制限を超えないようにすることができます。

• アクティビティ レベルの [レコードの最大数] フィールドを少ない数値に調整します。
• クエリにフィルター処理を追加します。フィルター パラメーターを指定すると、応答の数を制限できます。

Activity timeouts

There is a platform-wide timeout of 90 seconds for all activities based on Integration Service connectors. This means that if a response is not received from the API within 90 seconds, the activity fails with a timeout error.

Error codes

This section presents an overview of the error codes you might encounter using activities from the unified Integration Service activities package.

Error codes are in the range [1000, 3999], split in three categories:

• Run time (RT) - [1000, 1999]
• Design time (DT) - [2000, 2999]
• General (can occur both at run time and design time) - [3000, 3999]

In error messages, the codes are displayed with the category prefix included, for example The “AccountId” field is required. DAP-RT-1003.

See the following table for descriptions of common error codes.

エラー コード	カテゴリ (Category)	メッセージ	説明
1001	実行時時間	ServiceProvider is null.	A dependant service could not be loaded from the host activity.
1002	実行時時間	Connection ID is empty.	Connection ID not found in the activity.
1003	実行時時間	The "{fieldName}" field is required.	A required activity argument does not have a set value.
1005	実行時時間	Service responded with an object that does not match the activity's output type.	The response of an API call does not fit the output schema that was defined at design time.
1051	実行時時間	Trigger execution failed.	A trigger API call returned a failure code or the response is empty.
1052	実行時時間	Trigger activity could not find any matches.	A trigger ran in debug mode but no matches were found.
1101	実行時時間	Request failed with error: {0}. Status code: {1}.	An API call failed on the Integration Service or vendor side.
1103	実行時時間	No custom message, the underlying exception message is displayed.	An API call failed on the activity package side.
2000	設計時	Metadata API request failed with error '{0}'. Status code: {1}.	A metadata call failed. This is a call made by activities to Integration Service to get information about how they should look and behave.
2002	設計時	The object '{0}' is no longer accessible on the current connection. Please verify your permissions, or choose a valid object from this connection, or select a connection that includes this object.	The credentials used to create the connection don't contain the object or the object was deleted.
2050	設計時	Query API request failed with error '{0}'. Status code: {1}.	An API call failed to fetch data for a dropdown or another similar control. Possible causes: The path constructed when invoking the element service is incorrect. The vendor endpoint is down (typically returning a 502 code). Missing scope to call the API properly. The request looked for non existing key (returning a 404 code). Missing header (returning a 400 code).
2151	設計時	Duplicate field names "{0}"	There are two objects with a similar name, e.g. ID and Id.
3000	全般	Failed to retrieve connection. Consider using a different connection.	A call to the ConnectionClient component failed. Can have multiple causes, for example a connection that became invalid.
3004	全般	Failed to get access token for the resource {0}.	Typically indicates the system cannot retrieve a valid security token, most often because an existing token has expired.
3005	全般	Connection is disabled. Please enable the connection to continue.	The connection is disabled and must be enabled.