API Taskに関するよくある質問

API Tasksの詳細については、よくある質問を参照してください。

1. フォームで API Tasks を作成し使用する際の異なるステップは何ですか (リアルタイム)?

フォーム内の API Task

2. プロセス（オンデマンド）で API Tasks を作成し使用する際に関与するさまざまなステップは何ですか？

APIタスク 進行中

3. API Task はタスク Bot と比較してどのように実行されますか?

API Tasks は Automation 360 Cloud で実行され、Task Bot とは異なり、顧客のインフラストラクチャ上の Bot 実行者デバイスを使用しません。API Tasks は Task Bot のようなデスクトップ操作を行わず、迅速に開始でき、Task Bot よりも速く実行される可能性があります。

また、一般データ保護規則 (GDPR) およびカリフォルニア州消費者プライバシー法 (CCPA) に準拠しています。API Task も SOC 2 に準拠したプラットフォームの一部です。 すべての API Task データは暗号化されており、移動データと静的データの暗号化も提供しています。

4. API Tasksでファイルの読み取りや書き込みは可能ですか?
はい、API Tasks内ではファイル ストリームの読み取りや書き込みが可能です。 REST Web Services package は、変数を介した FileStream の読み取りをサポートするようになり、OneDrive などのオンライン ストレージに保存されているファイルとシームレスにやり取りできるようになりました。 現在は OneDrive のみをサポートしていますが、ロードマップには他の一般的なクラウド ストレージ サービスとの統合も計画されています。
5. パッケージ SDK を使用して作成されたカスタム パッケージは API Taskでサポートされますか?
いいえ、API Taskは現在、パッケージ SDK を使用してビルドされたパッケージをサポートしていません。
6. API デバイス プールでデバイスのいずれかがダウンした場合、別のデバイスが自動的にスピンアップされますか?
はい。すべてはお客様のために管理されています。
7. ユーザーはAPIタスクのためにデバイスプールを自分で作成し、それにAPIタスクを割り当てることができますか？
いいえ、API Tasks のために自分のデバイスポールを作成することはできません。 Automation Anywhere Cloud プラットフォームは、API Task コンテナを自動的にプロビジョニングおよび管理し、変動するワークロードに対応するために動的にスケーリングします。
8. セッション制限を超えて API Taskを実行すると、どうなりますか? すぐに失敗しますか、それともキューに入れられますか?
  • リアルタイム モード: リアルタイム モード (Attended - フォーム経由の呼び出し) の API Taskがセッション制限を超えると、すぐに失敗します。 これは、リアルタイム モードのタスクは事前にデプロイされてすぐに実行できる状態になっており、同時実行の制約により実行できないタスクのキュー登録のメカニズムが存在しないためです。
  • オンデマンド モード: オンデマンド モード (Unattended - プロセス経由の呼び出し) の API Taskがセッション制限を超えると、キューに登録されて、セッションが利用可能になったときに処理されます。 つまり、タスクがすぐに失敗することはありませんが、実行可能になるまでセッションが空くのを待機します。
9. スピンアップするデバイスの寿命はどのくらいですか?
API デバイス プールのリソースは、設定期間中は利用可能です。
10. デプロイ マシンで何か設定する必要がありますか?
API Tasksは、Automation 360 Cloud デバイス上で実行されるため、お客様のインフラ上のデバイスを設定する必要はありません。
11. デバイスのインストールは必要ですか?
クラウド デバイスは、Automation Anywhere が管理するクラスターで動作します。 お客様によるデバイスの設置は必要ありません。
12. API Taskの実行にタイムアウトはありますか?
リアルタイム API Tasksの場合、タイムアウトは 1 分です。 オンデマンド API Tasksの場合、タイムアウトは 15 分です。
13. クラウド デバイスにはどのようなデータが保存されて、どれくらいの期間情報は残されますか?
一時データが保存されることはなく、API Taskのメタデータのみが保存されます。
14. API Task エディターではなぜ実行オプションが使えないのですか?
API Tasksはローカル PC にデプロイできません。 したがって、API Task エディターには実行オプションがありません。 ただし、フォーム、プロセス、エンドポイントを介して、または [すぐに実行] オプションを使用することで API Tasksを呼び出すことができます。
15. API Taskのエラーを見つけるには?
お使いの API Task ロジックが正しいかどうかを検証するために、デバッガー ツールを使用して出力変数を確認できます。 また、エラー ハンドラー パッケージのアクションを使用して、API Task内のエラーをチェックすることもできます。
16. プリウォームとは何ですか?
プリウォームとは、Cloud デバイスにAPI Task ロジックとコマンドを事前にインストールし、受信リクエストを処理できるようにするプロセスです。 ウォームアップ中に、ライブラリを含むすべての API Taskの依存関係が事前にインストールされます。 これにより、API Taskをデプロイする前に依存関係を確認する必要がなくなるというメリットがもたらされます。 したがって、API Tasks は非常に低遅延で実行されます。フォームで呼び出された API Tasks フォームは、正常に実行されるために Cloud デバイス上でプリウォームされている必要があります。 フォーム (API Taskが添付) を含むプロセスを実行する前に、監査ログで API Taskがプリウォームされているかどうかを確認することができます。 詳細については、「API Task ランタイム監査ログの表示」を参照してください。
17. API Tasks のためにデバイスポールを作成し、それに API Tasks を割り当てることはできますか？

いいえ、API Tasks のために自分のデバイスポールを作成することはできません。 Automation Anywhere クラウドプラットフォームは、API Task コンテナを自動的にプロビジョニングおよび管理し、変動するワークロードに対応するために動的にスケーリングします。

18. セッション制限を超えて API Taskを実行すると、どうなりますか? すぐに失敗しますか、それともキューに入れられますか?
セッション制限を超える API タスク の動作は、使用している API Task モード により、以下のように異なります。
  • リアルタイム モード: リアルタイム モード (Attended - フォーム経由の呼び出し) の API Taskがセッション制限を超えると、すぐに失敗します。 これは、リアルタイム モードのタスクは事前にデプロイされてすぐに実行できる状態になっており、同時実行の制約により実行できないタスクのキュー登録のメカニズムが存在しないためです。
  • オンデマンド モード: オンデマンド モード (Unattended - プロセス経由の呼び出し) の API Taskがセッション制限を超えると、キューに登録されて、セッションが利用可能になったときに処理されます。 つまり、タスクがすぐに失敗することはありませんが、実行可能になるまでセッションが空くのを待機します。
19. API Tasksでサポートされている変数型は何ですか?
次の変数型が API Tasksでサポートされています。
  • 文字列
  • 数字
  • 日時
  • Boolean
  • 資格情報
  • リスト
  • ディクショナリ
  • レコード
  • テーブル
  • セッション
  • ファイル
    注: API Tasks でファイル変数をサポートするパッケージの詳細については、File streaming using file variable を参照してください。
変数の詳細については、[変数の概要]を参照してください。
20. API Tasks にはどのようなライセンス モデルがありますか。
すべてのクラウドのお客様は、1 つの API Task あたり 100 回の Control Roomの実行を無料の基本権限として受け取ります。 この基本権限には 2 回の同時実行も含まれており、2 つの API タスク を同時に実行できます。 実行制限を高めて同時実行を追加するには、Enterprise Platform ライセンスまたは API Task Overage SKU のいずれかを購入できます。 詳細については、カスタマーサービス マネージャーまでお問い合わせください。
21. API Tasks の消費状況はどのようにご覧になりますか？
Automation Anywhere Cloud Service セクションに移動し、管理 > ライセンス で API Task の消費状況を確認します。 ベース実行（API タスク実行の数） または オーバーエイジ実行（API タスク実行の数） をクリックして実行の詳細を表示します。
  • ベース実行 は、無料のベース権利の消費詳細をリストします。
  • オーバーエイジ実行 は、Enterprise Platform ライセンスまたは API Task オーバーエイジ SKU の一部である消費の詳細をリストします。
22. システムはどのようにして API Task の実行を計算しますか？
システムは、API Task の実行を分単位で計算します。 実行時間が1分（60秒）を超えると、実行回数が1回増加します。
例:
  • 30秒間実行される API タスクは1回の実行としてカウントされます。
  • 1分1秒（61秒）実行される API タスクは2回の実行としてカウントされます。
  • 3分40秒（220秒）実行される API タスクは4回の実行としてカウントされます。
23. 1 つの API Taskの中に 10 個の API コールが含まれている場合、それは 1 つの実行として、または複数の実行としてカウントされますか?
これは 1 回の実行としてカウントされます。 1 つの API Task 内に任意の数の API 呼び出しを含めることができます。
24. システムは、API Task 実行がスタックしているときに API Task 消費をどのように計算しますか？
もし API Task の実行が無限ループ、サードパーティシステムの応答なし、または応答タイムアウトなどの論理またはコードの問題によりスタックした場合、システムはリアルタイムの API Tasks については1分後、オンデマンドの API Tasks については15分後に自動的に実行を終了します。 これらの場合、システムはこれを実行としてカウントします（リアルタイム API Tasks に対して1回の実行、オンデマンド API Tasks に対して15回の実行）および ライセンス ページの消費詳細を更新します。
実行リクエストがデバイスの利用不可のためにキューに残っている場合、システムはデバイスが利用可能になり、実行が完了するまで実行をカウントしません。
注: あなたは アクティビティを管理する 権限があれば、スタックした API Tasks を中止できます。 詳細については、彼らのカスタマーサービス マネージャーにお問い合わせいただけます。
25. プロセス内に API Taskをオンデマンドでデプロイすると、[不明: Bot エージェントの自動登録トークンが見つかりません] というエラーが表示されます。 これはどうすれば解決できますか?
上記のエラーは、API Taskのオンデマンド デプロイで登録キーが利用できないことを示しています。 これを解決するには、次の手順を実行します。
  1. [管理] > [設定] > [Bot エージェントの一括インストール] に移動します。
  2. [編集] をクリックすると、デフォルトで [新しい API キーを生成] オプションが選択されます。
  3. [変更を保存] をクリックして登録キーを生成します。