API タスクに関するよくある質問

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

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

フォーム内の API タスク

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

APIタスク 進行中

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

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

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

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

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

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