- リリース ノート
- 概要
- 基本情報
- Marketplace ベンダー
- Marketplace のお客様
- パブリッシング ガイドライン
- すぐに使えるオートメーションのパブリッシング ガイドライン
- ソリューション アクセラレータの公開ガイドライン
- Publishing Guidelines for Integration Service Connectors
- セキュリティと IP 保護
- その他の UiPath コンポーネント
- Node-RED
- セットアップ
- Teams
- Microsoft Teams Scope
- Create Team
- チームをグループから作成する
- Get Team
- Get Teams
- Channels
- チャンネルを作成
- Delete Channel
- Get Channel
- Get Channels
- Update Channel
- Chats
- Get Chat
- Get Chats
- Get Chat Members
- Messages
- Get Message
- メッセージを取得
- Get Message Replies
- Reply To Message
- メッセージを送信
- イベント
- イベント/予定を作成
- イベント/予定を削除
- Get Event
- Get Events
- ユーザー
- Get User Presence
- 動作のしくみ
- テクニカル リファレンス
- はじめに
- 概要
- セットアップ
- テクニカル リファレンス
- Azure Form Recognizer Scope
- アクティビティ
- Analyze Form
- Analyze Form Async
- Get Analyze Form Result
- Analyze Receipt
- Analyze Receipt Async
- Get Analyze Receipt Result
- Analyze Layout
- Analyze Layout Async
- Get Analyze Layout Result
- Train Model
- Get Models
- モデル のキーを取得
- Get Model Info
- Delete Model
- コネクタ
- How to Create Activities
- 連携の独自開発
![](https://docs.uipath.com/_next/static/media/grid.05ebd128.png?w=3840&%3Bq=100)
内容
ソリューション アクセラレータは、すべてのソリューション アクセラレータで一貫したエクスペリエンスを維持するために、次のフォルダー構造に準拠する必要があります。 次の 4 つのフォルダーを含めることができます。
-
デプロイ ( テスト データ管理などのユーザー エクスペリエンスが Attended の場合、これが含まれていない可能性があります)
-
ドキュメント
-
ライブラリ (プロセスにライブラリが含まれていない場合、このライブラリが含まれていない可能性があります)
-
プロセス
特定の要素 (フォルダー構造など) は各ソリューション アクセラレータで一貫していますが、ソリューション アクセラレータは、ソリューション アクセラレータ内で使用される特定のユース ケースや UiPath 製品の影響を受ける可能性があります。 以下の表に、各ソリューション アクセラレータ内の一貫性のある項目を示します。
デプロイ | ドキュメント | ライブラリ | プロセス |
|
| 各ライブラリの個別のサブフォルダ |
|
アセットは、ソリューション アクセラレータ全体の異なるオートメーション プロジェクトで使用できる共有の変数または資格情報を表します。 [アセットの詳細] は、Orchestrator の API を利用してエンティティを操作するツールである Orchestrator Manager に対応した Microsoft Excel ブック ファイル (.xlsx) です。 このブックを使用すると、ソリューション アクセラレータ全体で使用される資産を簡単に確認および追加できます。
以下の例に示すように、このブックには 2 つのシートが含まれることが想定されます: Text、Bool、Integer のアセットを作成する「 作成 」と、資格情報アセットを作成する場合の 「資格情報を作成」 です。 各シートに必要なヘッダー、ヘッダーの順序、および各行内の情報を、下の表で定義しています。
フォルダー名1 | アセット名1 | 説明1 | スコープ1 | ロボット名またはユーザーのユーザー名1 | タイプ1 | 値1 | アセット ID2 | 結果2 |
発注書の処理 | Dispatcher_PurchaseOrdersEmailsSourceAccount | 処理する必要のある PurchaseOrders ドキュメント メールが格納されているメールボックスです。 | グローバル | テキスト | 特定の値に置き換えるには |
2) Orchestrator Manager が Orchestrator から取得したデータ (作成したアセットの ID など) を書き込むために使用する列です。 ここにある値は、次回の 資格情報の作成/作成 操作時に上書きされます。
作成
フォルダー名1 | アセット名1 | 説明1 | スコープ1 | ロボット名1 またはユーザーのユーザー名1 | タイプ1 | 値1 | アセット ID2 | 結果2 |
モダン フォルダーのサブフォルダーの名前を指定する場合、親フォルダーとその祖先フォルダーの完全な名前をスラッシュ (/) で区切って入力する必要があります。 例:「WorkGroup1」というモダン フォルダーが「部門 A」というモダン フォルダーのサブフォルダーである場合、「ワークグループ 1」の完全な名前は「部門 A/ワークグループ 1」になります。 |
アセットの名前。 名前は最大 256 文字にする必要があります。 |
アセットの説明。 説明は最大 250 文字にする必要があります。 |
[スコープ] フィールドには、Orchestrator で利用可能なアセット スコープに応じて、設定可能な数の固定数の値があります。
|
|
[型] フィールドには、Orchestrator で利用可能なアセットの種類に応じて、指定可能な数の値が固定されています。
|
アセットの値。 ユーザーがアセット値を定義する必要がある場合は、「特定の値で置き換える」と記述する必要があります。 このフィールドには、次のものが必要です。
| アセットが正常に作成された場合は、作成されたアセットの ID です。 | アセットの作成結果 (成功または失敗)。 |
1) 列は、作成するアセットの名前、タイプ、値などの入力を操作から受け取ります。
2) Orchestrator Manager が Orchestrator から取得したデータ (作成したアセットの ID など) を書き込むために使用する列です。 ここにある値は、次回の 資格情報の作成/作成 操作時に上書きされます。
資格情報を作成
フォルダー名1 | アセット名1 | 説明1 | スコープ1 | ロボット名またはユーザーのユーザー名1 | ユーザー名1 | パスワード1 | アセット ID2 | 結果2 |
モダン フォルダーのサブフォルダーの名前を指定する場合、親フォルダーとその祖先フォルダーの完全な名前をスラッシュ (/) で区切って入力する必要があります。 例:「WorkGroup1」というモダン フォルダーが「DepartmentA」というモダン フォルダーのサブフォルダーである場合、「WorkGroup1」の完全な名前は「DepartmentA/WorkGroup1」となります。 |
アセットの名前。 名前は最大 256 文字にする必要があります。 |
アセットの説明。 説明は最大 250 文字にする必要があります。 |
[スコープ] フィールドには、Orchestrator で利用可能なアセット スコープに応じて、設定可能な数の固定数の値があります。
|
|
ユーザー名フィールド。 これはエンド ユーザーによって提供されるため、このフィールドの各行には常に "TO REPLACE WITH SPECIFIC VALUE" を含める必要があります。 |
パスワード フィールド。 これはエンド ユーザーによって提供されるため、このフィールドの各行には常に "TO REPLACE WITH SPECIFIC VALUE" を含める必要があります。 | アセットが正常に作成された場合は、作成されたアセットの ID です。 | アセットの作成結果 (成功または失敗)。 |
2) Orchestrator Manager が Orchestrator から取得したデータ (作成したアセットの ID など) を書き込むために使用する列です。 ここにある値は、次回の 資格情報の作成/作成 操作時に上書きされます。
キューは、無制限の数のアイテムを保持できるコンテナーです。キュー アイテムには、請求書情報や顧客詳細など、複数の種類のデータを格納できます。 キューを使用すると、ソリューション アクセラレータのように、複雑なロジックに基づいた大規模なオートメーション プロジェクトを作成できます。
[キューの詳細] は、Orchestrator の API を利用してエンティティを操作するツールである Orchestrator Manager と互換性のある Microsoft Excel ブック ファイル (.xlsx) です。 このブックを使用すると、ソリューション アクセラレータ全体で使用されるキューを簡単に確認および追加できます
次の例のように、このブックには [Create ] - すべてのキューを作成するシートが 1 つ含まれます。 シートに必要なヘッダー、ヘッダーの順序、および各行内の情報を次の表に定義します。 オレンジ色のヘッダー列は、操作からの入力 (名前、説明、作成するキューの最大再試行回数など) を受け取ります。 灰色のヘッダー列は、Orchestrator Manager が Orchestrator から取得したデータ (作成されたキューの ID など) を書き込むために使用されます。 ここの値は、次回の作成操作で上書きされます。
フォルダー名 | キュー名 | 説明 | 一意の参照 | 自動リトライ | 最大リトライ回数 | アセット ID | 結果 |
モダン フォルダーのサブフォルダーの名前を指定する場合、親フォルダーとその祖先フォルダーの完全な名前をスラッシュ (/) で区切って入力する必要があります。 例:「WorkGroup1」というモダン フォルダーが「部門 A」というモダン フォルダーのサブフォルダーである場合、「ワークグループ 1」の完全な名前は「部門 A/ワークグループ 1」になります。 |
キューの名前です。 名前に空白を含めることはできません。 名前は最大 50 文字にする必要があります。 |
キューの説明。 説明は最大 250 文字にする必要があります。 |
一意の参照を持つようにトランザクションを強制します。 [はい] または [いいえ] のいずれかを指定する必要があります。 |
システム例外で失敗したキュー内のトランザクション アイテムを自動的にリトライできるようにします。 [はい] または [いいえ] のいずれかを指定する必要があります。 |
キュー内のトランザクション アイテムの最大リトライ回数です。 [自動リトライ] が [はい] の場合は 1 以上である必要があります。 1 から 50 までの整数を指定できます。 | キューが正常に作成された場合に、作成されたキューの ID です。 | キューの作成結果 (成功か失敗か)。 |
ソリューション アクセラレータは、UiPath Platform 上で開発された複数のコンポーネント (プロセス、アセット、キューなど) のバンドルであり、これらが連携してビジネス ユース ケースを自動化します。 UiPath Solutions Management は、一度構築したソリューション アクセラレータ コンポーネントのライフサイクルを管理するための、すぐに使える手段を提供します。 この一連の機能は、ソリューション アクセラレータの開発が完了し、そのコンポーネントを新しい環境に簡単に昇格させたいときに有効になります。
ソリューション管理を使用すると、ソリューション アクセラレータが開発された Orchestrator 環境内の 1 つのファイルにこれらのコンポーネントを簡単にパッケージ化できます。 ソリューション管理パッケージの作成方法のガイドについては、「 ソリューション プロジェクトの作成」を参照してください。
ソリューション アクセラレータのソリューション管理パッケージを作成する際のいくつかの要件と考慮事項:
-
資格情報であるアセットには、エンドユーザーによって提供される「特定の値で置き換える」の値を持つユーザー名とパスワードのフィールドが含まれている必要があります。
-
宛先メールアドレスや環境 URL など、エンドユーザー固有のアセットにも「特定の値で置き換える」の値が必要です。
-
ソリューション管理 Zip の名前付け規則は、"ソリューション アクセラレータ名 1.0.0" である必要があります。 ここで、ソリューション アクセラレータ名はソリューション アクセラレータの名前で、1.0.0 はソリューション管理 zip のソリューション プロジェクトのバージョンです。
-
すべてのストレージ バケットとトリガーは、ソリューション管理の zip ファイルに含まれます。 ストレージ バケットとトリガーは手動デプロイに含めることはできません。デプロイ ガイドのドキュメント内に手動で作成できるように明記しておく必要があります。
-
プロセスは、ソリューション管理の zip ファイル 内に含めないでください 。 プロセスは、ソリューションアクセラレータに対する環境および手順固有の機能強化を変更しない限り、すぐには機能しないことが期待されます。
-
カスタム ライブラリが何らかの理由で変更されることが予想される場合は、変更しないとすぐには機能しないため、ソリューション管理パッケージに含めないでください。
ライブラリとは、他のプロジェクトでアクティビティとして再利用できる 1 つ以上のワークフローを含むプロジェクトです。 これにより、ソリューション アクセラレータは個々のプロセスで共通のコードを使用できます。 ライブラリの作成については、ライブラリ ドキュメントの「 ライブラリの作成」セクションを参照してください 。 ソリューション アクセラレータのライブラリの作成に関する開発標準については、「 ライブラリ開発」セクションを参照してください。 ライブラリはパブリッシュ時に nupkg ファイルとして保存され、 パッケージ マネージャーから依存関係としてインストールできます。 ライブラリをローカル フォルダーにパブリッシュするか、NuGet パッケージ フィードからパブリッシュおよびダウンロードして、関連する NUPKG ファイルを取得できます。
再利用可能なライブラリが、変更を必要とせずにすぐに動作するように設計されている場合は、それを Deployment フォルダー内に含めてください。
ライブラリがプロジェクト内で正しく動作するように変更されることが予想される場合は、配置フォルダーに含まれないことが予想され、配置ガイドでは、そのライブラリを使用するすべてのプロジェクトでライブラリを変更、発行、および依存関係を更新する必要があることを明確にする必要があります。
UiPath Solution Accelerators の汎用再利用可能なファイルのように、再利用可能なライブラリがフィード上で個別にパブリッシュされている場合は、NUPKG ファイルを含める必要はありません。
UiPath Studio プロジェクトで使用できる 独自のカスタム アクティビティを作成できます 。 作成した カスタム アクティビティを使用するには 、UiPath Studio からパッケージ マネージャーにアクセスし、NUPKG をインストールして、ソリューション アクセラレータ プロジェクト内にそのアクティビティを含む NuGet パッケージをインストールする必要があります。 その NuGet パッケージは、カスタム アクティビティ の完了時に作成 する必要があります。 NUPKG は、ソリューション アクセラレータの Deployment フォルダーに含めることができます。
ドキュメントの構成は、以下のガイドラインに従う必要があります。
-
ソリューション アクセラレータ – アクセラレータの概要
-
ソリューション アクセラレータ – 導入ガイド
-
ソリューション アクセラレータ – テクニカル ドキュメント
-
高レベルのソリューション設計(.pdfおよび.vsdxなどの元の編集ファイル)
-
詳細なソリューション設計(.pdfおよび.vsdxなどのオリジナル編集ファイル)
UiPath ライブラリとは、他のプロジェクトでアクティビティとして再利用できる 1 つ以上のワークフローを含むプロジェクトです。 ライブラリはパブリッシュ時に nupkg ファイルとして保存され、 パッケージ マネージャーから依存関係としてインストールできます。 ライブラリは、ライブラリタイプのプロジェクトを使用してのみ開発できます。 再利用可能な UI コンポーネントは、 オブジェクト リポジトリを使用してライブラリ内に実装する必要があります。 Data Service のエンティティ は、ライブラリ内にインポートする必要があります 。これは、ライブラリをインポートすることによってソリューション アクセラレータ全体で同じ参照/名前空間を使用できるようにするためです。 ライブラリ内にインポートすることにより、名前空間が異なるプロセス間で競合することはありません。
ライブラリには次の要件があります。
projectType |
|
Process Size & Workflow Naming Convention |
|
注釈 |
|
変数の命名規則 |
|
引数の命名規則 |
|
引数の結果 |
|
コメント |
|
Data Service エンティティ |
|
例外処理 |
|
プロセスとは、プロセス設計オプションを使用して開発された UiPath のプロジェクトで、UiPath のロボットで実行できます。 新しいプロセス プロジェクトは、 クロスプラットフォーム プロジェクト または Windows プロジェクトである必要があります。 Windows – レガシでは古いバージョンの .NET Framework が使用されており、近い将来、新しいプロジェクトのオプションではなくなります。 Data Service のエンティティはプロセス内にインポートしないでください。 個々のプロセス内にインポートすると、ソリューション アクセラレータ全体で名前空間が競合する可能性があります。
プロセスには次の要件があります。
projectType |
|
プロセスサイズ |
|
注釈 |
|
変数の命名規則 |
|
引数の命名規則 |
|
コメント |
|
Data Service エンティティ |
|
層 |
|