IA-Connect Session
IA-Connect はロボティック プロセス オートメーション (RPA) プラットフォームで、クラウドからオンプレミスの仮想マシン、Citrix や Microsoft リモート デスクトップ (RDS) の接続により、RPA 機能を追加します。 このモジュールは、環境、セッション、ファイル管理を自動化し、IA-Connect を構成します。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Ultima Labs |
| [URL] | https://www.ultima.com/ultima-labs |
| メール | IAConnect@ultima.com |
| Connector Metadata | |
|---|---|
| 発行者 | Ultima Labs |
| Web サイト | https://www.ultima.com/ultima-labs |
| プライバシー ポリシー | https://www.ultima.com/privacy-policy |
| カテゴリー | IT Operations;生産性 |
IA-Connect はロボティック プロセス オートメーション (RPA) プラットフォームで、Power Automate クラウド フローからオンプレミスの仮想マシン、Citrix や Microsoft リモート デスクトップ (RDS) の接続により、RPA 機能を追加します。 IA-Connect コネクタは 800 を超えるアクションを提供しており、Power Automate クラウド フローから直接さまざまなタイプのオンプレミス アプリケーションを自動化できるようにします。 すべての IA-Connect アクションは、Power Automate クラウド フローから直接利用でき、クラウドベース アプリケーションとオンプレミス アプリケーション間の簡単な統合ができます。また、既存の Power Automate 条件、ループ、動的コンテンツ、式、および例外処理を RPA プロセスで活用できます。 また、IA-Connect コネクタを利用することで、フローの実行履歴から完全な実行履歴と監査性が提供されると同時に、RPA プロセスを開発するための個別のアプリケーション/コンソール/スタジオが不要になります。
前提条件
任意の IA-Connect コネクタを使用するには、IA-Connect ソフトウェアをインストールする必要があります。 30 日間は無料でお試しいただけますが、その後は IA-Connect ライセンスが必要になります。
IA-Connect ソフトウェアは、次の 2 つの主要コンポーネントで構成されています。
IA-Connect オーケストレーターは、独自の Azure テナントでホストする Azure WebApp です。 これは、1 つ以上のオンプレミスまたはクラウドベースの仮想マシンへの RPA フローのルーティングとセキュリティを処理します。
自動化したいソフトウェアにアクセスできる仮想マシンにインストールされる IA-Connect Agent および Director。 さらに、IA-Connect Agent は Citrix または Microsoft リモート デスクトップ サービス (RDS) セッション内で実行でき、RPA コマンドは仮想チャネルを介してリモート セッションに渡されて実行されます。 IA-Connect Agent はネットワーク共有から実行でき、インストールする必要はありません。
使用可能な IA-Connect コネクタ
次の IA-Connect コネクタを使用できます。
- IA-Connect Dynamic Code
- IA-Connect Java
- IA-Connect JML
- IA-Connect Mainframe
- IA-Connect Microsoft Office
- IA-Connect SAP GUI
- IA-Connect Session
- IA-Connect UI
- IA-Connect Web Browser
資格情報の入手方法
ライセンスを受け取り、30 日間の無料トライアルを開始するには、当社の Web サイト (https://www.ultima.com/IA-Connect/Power-Automate) を通じてリクエストを送信してください。
試用版のお申し込みをいただきましたら、IA-Connect ソフトウェアのセットアップのお手伝いと試用版ライセンスを提供するために、ご登録いただいたメール アドレスにご連絡いたします。 この試用版はすべての機能を備えており、試用期間中に、ご自身の環境で 9 つの IA-Connect コネクタすべてにおいて 800 のアクションのいずれかをテストできます。
コネクタの使用を開始する
IA-Connect の試用版を申し込むと、IA-Connect ソフトウェアおよびインストールとセットアップに関するドキュメントを含む ZIP ファイルをダウンロードできるようになります。 また、必要に応じてお客様にご連絡し、インストール プロセスのサポートやご案内をさせていただきます。
サポート
試用期間中は、Ultima Labs (IAConnect@ultima.com) に問い合わせてサポートと支援を受けることができます。
IA-Connect ライセンスを購入すると、Ultima の英国拠点の技術サービス センター (TSC) からの特注トレーニングまたはサポートと引き換えることができるサポート トークンが発行されます。
既知の問題と一般的なエラーに関する FAQ
サポート情報には、既知の問題、IA-Connect コネクタの使用時に発生する可能性のある一般的なエラー、よく寄せられる質問など多数の記事が含まれています。 https://support.ultima.com/ultimalabs からアクセス可能で、これらのリソースにアクセスするためのアカウントは、IA-Connect の試用期間中および IA-Connect ライセンスの購入時に提供されます。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| API Key | securestring | この API の API キー | True |
| IA-Connect オーケストレーターのアドレス | string | HTTP(S) コンポーネントなしで IA-Connect オーケストレーターのアドレスを指定してください | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| 画面の解像度を取得する |
IA-Connect Agent ユーザー セッションの画面解像度を返します。 物理デスクトップまたはラップトップ上で実行されている IA-Connect ローカル Agent の場合、これにより、すべてのディスプレイ デバイスとそのスケーリングに関する情報が提供されます。 仮想マシンでは、複数のディスプレイを表示するように仮想マシンが構成されていない限り (一般的ではありません)、通常は 1 つのディスプレイのみが報告されます。 リモート セッションでは通常、1 つの仮想ディスプレイが作成されるため、そのディスプレイが複数のローカル ディスプレイにまたがる場合でも、通常は 1 つのディスプレイのみが報告されます。 |
| Agent スレッドが正常に完了するまで待機する |
Agent スレッドの完了を待機して、オプションでスレッド出力データを取得します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 Agent スレッドが完了しても失敗すると、例外が発生します。 |
| Agent スレッドの状態を取得する |
Agent スレッドのステータスを取得し、オプションでスレッド出力データを取得します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 |
| Agent スレッドをキルする |
Agent スレッドをキル (終了、中止) します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 Agent スレッドを削除せずに (スレッドを削除するには、「Agent スレッドの削除」アクションを使用します)、Agent スレッドを監視しているプロセスまたはフローが「IA-Connect Agent スレッドが中止されました」エラーを受信できるます。 |
| Agent スレッドを削除する |
Agent スレッドまたはすべての Agent スレッドを削除し、スレッドがまだ実行中の場合は最初にスレッドをキル (終了、中止) します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 Agent スレッドを監視しているプロセスまたはフローは、「Agent スレッド ID が存在しません」エラーを受け取ります。 |
| Agent スレッドを取得する |
Agent スレッドのリストを返します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 通常、Agent スレッドが完了し、そのデータが取得されると、Agent スレッドは削除され、スレッドのリストに表示されなくなります。 |
| Agent メモリ内のパスワードを削除する |
Agent メモリに保存されている 1 つのパスワードを削除するか、Agent に保存されているすべてのパスワードを削除します。 |
| CSV テキストをコレクションとして取得する |
IA-Connect Agent がコレクション (テーブル) として実行されているコンピューター上の CSV ファイルを返します。 CSV ファイルへの読み取り専用アクセスのみが必要です。 |
| CSV ファイルへの書き込み |
IA-Connect Agent を実行しているコンピューター上の CSV ファイルを作成します。 CSV ファイルは、コレクション (テーブル) または JSON 形式のテーブルから作成されます。 |
| Director から送信された代替 IA-Connect Agent を実行する |
IA-Connect Director から代替 Agent をアップロードし、代替 Agent の実行可能ファイルを読み込むことで、代替 IA-Connect Agent (新しいバージョンなど) を実行します。 |
| HTTP ファイルをダウンロードする |
HTTP(S) を使用して IA-Connect Agent を実行しているコンピューターにファイルをダウンロードします。 |
| IA-Connect Agent GUI の不透明度を設定する |
IA-Connect Agent の不透明度を 1 (可視) から 0 (透明) に設定します。 |
| IA-Connect Agent GUI の位置を設定する |
IA-Connect Agent GUI の画面上の位置を指定された場所に設定します。 |
| IA-Connect Agent GUI を前面に移動 |
IA-Connect Agent GUI を前面に表示し、画面に表示されるようにします。 |
| IA-Connect Agent GUI を最前面に設定する |
IA-Connect Agent を最前面に設定します。 これによって、IA-Connect Agent は常に画面に表示され、他のアプリケーション ウィンドウによって隠されることがなくなります。 |
| IA-Connect Agent のグローバル座標構成を取得する |
IA-Connect Agent のグローバル座標系構成を取得します。この構成は、要素の位置の表示 (例: マウス検査中) とマウス位置の計算 (例: グローバル マウス アクションの実行時) に使用されます。 |
| IA-Connect Agent のグローバル座標構成を設定する |
IA-Connect Agent のグローバル座標系を構成します。この構成は、要素の位置の表示 (例: マウス検査中) とマウス位置の計算 (例: グローバル マウス アクションの実行時) に使用されます。 デフォルトでは最新の機能が提供されますが、このアクションを使用して、以前のバージョンの Agent の動作に戻したり、API が別の座標系を使用するように指定したりすることができます。 |
| IA-Connect Agent のコマンド タイムアウトを設定する |
実行される各コマンドに対して IA-Connect Agent が使用するコマンド タイムアウトを設定します。 |
| IA-Connect Agent の汎用コマンドを実行する |
引数を JSON として渡し、出力データを JSON として返す一般的な IA-Connect Agent コマンドを実行します。 Director と Inspector が Agent より古いバージョンであるため、コマンドを理解できない場合に Agent コマンドを実行するために使用されます。 |
| IA-Connect Agent の現在のライセンス状態を取得する |
IA-Connect Agent のライセンスが現在付与されているかどうかを返します。ライセンスが付与されている場合は、ライセンスのプロパティを返します。 |
| IA-Connect Agent を閉じる |
IA-Connect Agent を閉じます。 これは、IA-Connect Agent が実行されていたユーザー セッションに影響しません。 |
| IA-Connect Agent セッション情報の取得 |
IA-Connect Agent ユーザー セッションに関する情報を返します。 |
| IA-Connect Agent プロセス数を取得する |
ユーザー セッションで現在実行されている IA-Connect Agent のインスタンス数を返します。 これは、実行中の IA-Connect Agent のインスタンスが複数存在するかどうかを検出する場合に便利です。 |
| IA-Connect Agent ログ レベルを取得 |
現在の IA-Connect Agent のログ レベルを返します。 ログ レベルは 1 から 4 の範囲で設定され、1 が最も低いレベル、4 が最も高いレベルになります。 |
| IA-Connect Agent ログ レベルを設定する |
IA-Connect Agent のログ レベルを指定された値に設定します (1 は最も低いレベル、4 は最も高いレベル)。 |
| IA-Connect Agent ログを取得 |
現在の IA-Connect Agent ログをファイルとして返すか、内容を読み取って出力変数に戻すことで返します。 |
| IA-Connect Agent 情報の取得 |
バージョン番号や Agent 実行可能ファイルへのパスを含む、IA-Connect Agent のプロパティを返します。 |
| IA-Connect Director ログ レベルを設定する |
IA-Connect Director のログ レベルを指定された値に設定します (1 は最も低いレベル、4 は最も高いレベル)。 |
| IA-Connect Directorの稼働時間を取得 |
この IA-Connect Director の稼働時間を秒単位で返します (Director の実行時間)。 |
| IA-Connect の次のホップ セッションの接続を待機する |
次のホップ セッションが接続され、IA-Connect Agent が次のホップ セッションで実行されるのを待機します。 |
| IA-Connect の次のホップが有効 |
次のホップ セッションで実行されている IA-Connect Agent に受信した今後のすべてのコマンドを転送する次のホップを有効にします。 |
| IA-Connect の次のホップを無効にする |
次のホップを無効にして、今後のすべてのコマンドが (次のホップのエージェントに転送されるのではなく) それらを受信したエージェントで処理されるようにします。 |
| IA-Connect の次のホップ状態を取得する |
このコマンドを受け取る Agent の次のホップ Director の状態を報告します。 次のホップが有効になっている場合、その Agent は次のホップにコマンドを転送しています (次のホップ Director を経由)。 次のホップが無効になっている場合、その Agent はコマンド自体を処理しています (既定)。 |
| IA-Connect コマンド統計をリセットする |
現在のセッションで IA-Connect Agent が実行したコマンドに対して現在格納されている統計をリセットします。 |
| IA-Connect セッションが名前によって終了するまで待機する |
指定した IA-Connect Director セッションが終了するまで待機します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 名前は前の 'アタッチ' アクションから取得されます。 |
| IA-Connect セッションにインデックスで添付する |
指定した IA-Connect Director セッションにインデックスを使って添付します (例: 最初の Citrix ICA セッションに添付する)。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 |
| IA-Connect セッションに名前で添付する |
指定した IA-Connect Director セッションに名前で添付します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 |
| IA-Connect ライセンス キーを設定する |
ライセンス キーを使用して IA-Connect Agent のライセンスを取得します。 IA-Connect オーケストレーターに保持されたライセンスのライセンス文字列またはフレンドリ名を、これに指定できます。 |
| IA-Connect ライセンス コードを設定する |
IA-Connect Agent に古いスタイル (7.0 と 7.1) のエージェント ドメイン ライセンスをアップロードします。 |
| INI ファイル内の変数データを置き換える |
INI ファイル内の 1 つの変数を更新します。 |
| mouse_event を調整する |
指定したピクセル数だけマウスを移動し、新しいマウスの位置を読み取ることで、mouse_event メソッドを調整します。 |
| TCP ポートは応答している |
ネットワーク TCP ポートが IA-Connect Agent による接続試行に応答しているかどうかを報告します。 これは、IA-Connect Agent が実行されているコンピューター (リモート ホストの場合は 'localhost' と入力) または任意のリモート コンピューターの TCP ポートである可能性があります。 IA-Connect Agent が TCP ポートに正常に接続すると、すぐに TCP 接続を閉じます。 |
| ZIP にフォルダーを追加する |
フォルダー内のファイルを ZIP ファイルに圧縮します (ファイルを圧縮アーカイブに格納します)。 |
| すべての IA-Connect コマンド統計を取得する |
現在のセッションで IA-Connect Agent が実行したコマンドに対して現在格納されている統計をすべて返します。 |
| アクセス許可をファイルに追加する |
IA-Connect Agent を実行しているコンピューター上のファイルにアクセス許可を追加します。 |
| アクセス許可をフォルダーに追加する |
IA-Connect Agent を実行しているコンピューター上のフォルダーにアクセス許可を追加します。 |
| オーケストレーター フローを取得する |
IA-Connect オーケストレーターからフロー統計のリストを返します。 レポート目的で使用されます。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。 |
| オーケストレーター フロー統計から最後に失敗したアクションを取得する |
IA-Connect オーケストレーションを通じて Worker に渡した最後のアクションが失敗した場合、その詳細を取得します。 このアクションは、エラー処理中に最も一般的に使用されます。 |
| オーケストレーター フロー統計結果を更新する |
IA-Connect オーケストレーターの現在のワーカーフローの結果統計を更新します。 これは、IA-Connect オーケストレータのフロー統計の最終結果を変更するために使用されます。これは通常、レポートの目的で使用されます。 これは現在のフローに対してのみ機能します (オーケストレーターはフロー実行 ID を検出します)。 他のフローの統計を変更することはできません。 |
| オーケストレーターからログイン履歴を取得する |
レポート目的で IA-Connect オーケストレーターのログイン履歴を返します。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。 |
| オーケストレーターからワーカー フローの使用ヒートマップを取得する |
IA-Connect オーケストレーターからワーカー フロー使用の日時ヒートマップを返します。 レポート目的で使用されます。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。 |
| オーケストレーターからワーカーの可用性統計を取得する |
IA-Connect オーケストレーターからワーカーの可用性を返します。 レポート目的で使用されます。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。 |
| オーケストレーターから汎用資格情報を取得する |
IA-Connect オーケストレーターに保存されている汎用資格情報を取得します。 資格情報には、ユーザー名、パスワード、ホスト名、URL、その他の一般的なデータを保持できます。 |
| オーケストレーター自動化タスクの状態を変更する |
選択したオーケストレーター自動化タスクの状態を、完了、失敗、新規のいずれかに変更します。 |
| オーケストレーター自動化タスクをすべて取得する |
フィルターと一致するオーケストレーター自動化タスクをすべて取得します。 |
| オーケストレーター自動化タスクを削除する |
延期したオーケストレーター自動化タスクを削除します。 |
| オーケストレーター自動化タスクを取得する |
特定のオーケストレーション自動化タスクを取得します。 |
| キー イベントを送信する |
グローバル キー押下イベントを IA-Connect Agent ユーザー セッションに送信します。 |
| キーを送信する |
グローバル キー押下を IA-Connect Agent ユーザー セッションに送信します。 |
| クライアントからサーバーにファイルをコピーする |
(IA-Connect Director を実行している) ローカル コンピューター から (IA-Connect Agent を実行している) リモート コンピューターにファイルをコピーします。 |
| クライアントのホスト名を取得する |
IA-Connect Director が実行しているクライアントのホスト名を返します。 |
| クリップボードをクリア |
IA-Connect Agent のユーザー セッションで、クリップボードのコンテンツをクリアします。 |
| クリップボードを取得する |
IA-Connect Agent ユーザー セッションでクリップボードの現在コンテンツを取得します。 |
| クリップボードを設定する |
IA-Connect Agent ユーザー セッションでクリップボードのコンテンツを設定します。 |
| コンピューター ドメインを取得する |
IA-Connect Agent ユーザー セッションを実行しているコンピューターのドメインを返します。 |
| コンピューター名を取得する |
IA-Connect Agent ユーザー セッションを実行しているコンピューターの名前を返します。 |
| スクリーン リーダーが有効 |
IA-Connect Agent ユーザー セッションでスクリーン リーダーが有効になっているかどうかを返します。 |
| スクリーン リーダーを設定する |
IA-Connect Agent ユーザー セッションでスクリーン リーダーを有効または無効にします。 |
| スクリーンショットを取得する |
IA-Connect Agent ユーザー セッションのスクリーンショットを取得し、Base64 でエンコードされた文字列として返します。 |
| セッションのアクティブ状態を停止する |
IA-Connect Agent ユーザー セッションのアクティブ状態を停止します。 |
| セッションはロックされたか |
IA-Connect Agent が実行されているセッションがロックされているかどうかを報告します。 |
| セッションをアクティブ状態に維持する |
指定した間隔でマウスを移動して、セッションがアイドル状態になるのを防ぐことで、IA-Connect Agent ユーザー セッションをアクティブに維持します。 |
| セッションをロックする |
IA-Connect Agent が実行しているセッションをロックします。 |
| セッションをロック解除する |
IA-Connect Agent が実行しているセッションをロック解除します。 Credential Provider のみがコンピューターのロック解除できるため、セッションをホストしているコンピューターに IA-Connect Unlocker Credential Provider をインストールする必要があります。 |
| テキスト ファイルを書き込む |
IA-Connect Agent を実行しているコンピューター上にテキスト ファイルを作成し、テキストをファイルに書き込みます。 |
| ディスクの空き領域を取得する |
IA-Connect Agent を実行しているコンピューター上の、指定したディスクの空き領域の容量を返します。 |
| ディレクター クライアント タイプとセッション情報を取得する |
ティア 1 ディレクターによって処理されているローカルまたはリモート セッションの詳細を返します。 |
| ディレクトリが存在しない |
IA-Connect Agent を実行しているコンピューター上にディレクトリ (フォルダー) が存在するかどうかを true または false で報告します。 |
| ディレクトリはアクセス可能 |
ディレクトリ (フォルダー) にアクセスできるかどうかと、IA-Connect Agent を実行しているコンピューター上でアクセス許可によってアクセスが制限されているかどうかを返します。 |
| ディレクトリを作成する |
IA-Connect Agent を実行しているコンピューター上にディレクトリ (フォルダー) を作成します。 |
| ディレクトリを削除する |
IA-Connect Agent を実行しているコンピューター上にディレクトリ (フォルダー) を削除します。 |
| ディレクトリを削除する |
IA-Connect Agent を実行しているコンピューターのディレクトリ (フォルダー) を削除して、ディレクトリ内のすべてのファイルを削除します。 |
| ドライブの一覧を取得する |
IA-Connect Agent を実行しているコンピューター上のドライブの一覧を返します。 |
| パスワード キーを送信する |
グローバル キー押下を、特にパスワード入力時に IA-Connect Agent ユーザー セッションに送信します。 |
| パスワードのキー イベントを送信する |
グローバル キー押下イベントを、特にパスワード入力時に IA-Connect Agent ユーザー セッションに送信します。 |
| パスワードを Agent メモリに保存する |
パスワードを Agent メモリに保存し (暗号化)、保存されたパスワードをサポートするアクションからそのパスワードを使用できるようにします。 パスワードはメモリにのみ保存され、Agent を終了すると失われます。 |
| パスワードを生成する |
テンプレート形式で定義された辞書の単語、数字、記号、文字を含むパスワードを生成します。 |
| パスワード文字列を展開する |
IA-Connect の保存済みのパスワードへの参照を含む入力文字列を受け入れ、その参照を保存済みのパスワードに置き換えた文字列を返します。 |
| ファイル コンテンツを Base64 として取得する |
指定したファイルのコンテンツを Base64 形式で取得します。Base64 形式は API 経由での送信に適した形式で、元のテキストまたはバイナリ形式に簡単に変換できます。 |
| ファイル サイズを取得する |
IA-Connect Agent を実行しているコンピューター上のファイルのサイズ (バイト数) を返します。 |
| ファイルからすべてのテキストを読み取る |
IA-Connect Agent を実行しているコンピューター上のファイルのテキスト コンテンツを読み取ります。 |
| ファイルに所有者を設定する |
IA-Connect Agent を実行しているコンピューター上のファイルに所有者を設定します。 |
| ファイルのセキュリティ アクセス許可を取得する |
IA-Connect Agent を実行しているコンピューター上のファイルに現在設定されているアクセス許可の一覧を返します。 |
| ファイルのセキュリティから ID を削除する |
IA-Connect Agent を実行しているコンピューター上のファイルのセキュリティ アクセス許可から ID (ユーザー、グループ、コンピューターなど) を削除します。 |
| ファイルは存在しない |
IA-Connect Agent を実行しているコンピューター上にファイルが存在するかどうかを true または false で報告します。 |
| ファイルを ZIP に追加する |
ファイルを圧縮します (ファイルを圧縮アーカイブに格納します)。 |
| ファイルをクリップボードにコピーする |
指定したローカル ファイルを IA-Connect Agent ユーザー セッションのクリップボードにコピーします。 |
| ファイルをコピーする |
IA-Connect Agent を実行しているコンピューター上のファイルをコピーします。 |
| ファイルを削除する |
IA-Connect Agent を実行しているコンピューター上のファイルを削除します。 |
| ファイルを削除する |
IA-Connect Agent を実行しているコンピューター上の指定されたフォルダーに含まれている、パターンに一致するファイルを削除します。 |
| ファイルを取得する |
IA-Connect Agent を実行しているコンピューター上のフォルダー内のファイル一覧 (パターンの CSV 一覧に一致) を返します。 |
| ファイルを移動する |
IA-Connect Agent を実行しているコンピューター上のファイルを移動します。 |
| ファイルを解凍する |
ZIP 圧縮を使用して圧縮されたファイルを解凍します。 |
| フォルダーに所有者を設定する |
IA-Connect Agent を実行しているコンピューター上のフォルダーに所有者を設定します。 |
| フォルダーのセキュリティ アクセス許可を取得する |
IA-Connect Agent を実行しているコンピューター上のフォルダーに現在設定されているアクセス許可の一覧を返します。 |
| フォルダーのセキュリティから ID を削除する |
IA-Connect Agent を実行しているコンピューター上のフォルダーのセキュリティ アクセス許可から ID (ユーザー、グループ、コンピューターなど) を削除します。 |
| フォルダーのセキュリティ継承を有効にする |
IA-Connect Agent を実行しているコンピューター上のフォルダーのセキュリティ継承を有効にします。 |
| フォルダーのセキュリティ継承を解消する |
IA-Connect Agent を実行しているコンピューター上のフォルダーのセキュリティ継承を解消します。 |
| フォルダーを取得する |
IA-Connect Agent を実行しているコンピューター上の指定されたフォルダー内のすべてのサブフォルダーを返します。 |
| フローを完了としてマークする |
フローを完了としてマークします。それによって、割り当てられているワーカー コンピューターが他のフローを処理できるようになったことが IA-Connect オーケストレーターに通知されます。 |
| フロー結果 JSON から失敗したアクションのエラー メッセージを取得する |
1 つ以上のフロー result() 式の JSON 出力を逆シリアル化し、失敗したアクションの最初に見つかったエラー メッセージを取得します。 エラー メッセージは、さまざまな形式で JSON に保存できます。 このアクションは既知の形式を処理し、最初に見つかったエラー メッセージを返します。 |
| プリンターの一覧を取得する |
IA-Connect Agent セッションで使用可能なすべてのプリンターの一覧を返します。 |
| プロセス ID でプロセスを取得する |
指定したプロセス ID のプロセスが IA-Connect Agent ユーザー セッションで実行されているかどうかを返します。 プロセス ID は一意であるため、ID に一致できるプロセスは 1 つのみです。プロセス ID は動的であり、アプリケーションを起動するごとに異なります。 |
| プロセス ID のコマンド ライン プロパティを取得する |
指定したプロセス ID を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスのコマンド ライン プロパティを返します。 |
| プロセス ID を強制終了する |
指定したプロセス ID を持つ IA-Connect Agent ユーザー セッションで実行されているプロセスを強制終了します。プロセス ID は一意であるため、ID に一致できるプロセスは 1 つのみです。プロセス ID は動的であり、アプリケーションを起動するごとに異なります。 |
| プロセスを取得する |
IA-Connect Agent ユーザー セッションで実行中のプロセスの一覧を返します。 オプションにより、プロセス名を指定してフィルター処理を行うことができます。 |
| プロセスを実行する |
プロセス、コマンド、またはアプリケーションを起動します。 |
| プロセスを強制終了する |
指定されたプロセス名を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスをすべて強制終了します。 |
| マウス ホイールを回転する |
IA-Connect Agent ユーザー セッションでマウス ホイール (プラスまたはマイナスのノッチ) を回転します。 |
| マウスのウィグル |
指定した座標数だけマウスを前後に移動します。 |
| マウスのカーソルの位置を設定する |
IA-Connect Agent ユーザー セッションで、マウスのカーソルを指定した位置に設定します。 |
| マウスの中央ボタンをクリックする |
IA-Connect Agent ユーザー セッションでマウスの中央ボタンをクリックします。 |
| マウスの中央ボタンを上に移動する |
IA-Connect Agent ユーザー セッションでマウスの中央ボタンを離します。 |
| マウスの中央ボタンを下に移動する |
IA-Connect Agent ユーザー セッションでマウスの中央ボタンを押します (離しません)。 マウスを離すには、マウスの中央ボタンを上に移動します。 |
| マウスの中央ボタンを長押しする |
指定した秒数間、IA-Connect Agent ユーザー セッションでマウスの中央ボタンを長押しします。 |
| マウスの乗数を設定する |
IA-Connect Agent ユーザー セッションでグローバル マウス乗数を設定します。 これは、開発中にリモート デスクトップのスケーリングで問題が発生した場合に役立ちます。 |
| マウスの右ボタンを上に移動する |
IA-Connect Agent ユーザー セッションでマウスの右ボタンを離します。 |
| マウスの右ボタンを下に移動する |
IA-Connect Agent ユーザー セッションでマウスの右ボタンを押します (離しません)。 マウスを離すには、マウスの右ボタンを上に移動します。 |
| マウスの右ボタンを長押しする |
指定した秒数間、IA-Connect Agent ユーザー セッションでマウスの右ボタンを長押しします。 |
| マウスの左ボタンをダブルクリックする |
IA-Connect Agent ユーザー セッションでマウスの左ボタンをダブル クリックします。 |
| マウスの左ボタンを上に移動する |
IA-Connect Agent ユーザー セッションでマウスの左ボタンを解放します。 |
| マウスの左ボタンを下に移動する |
IA-Connect Agent ユーザー セッションでマウスの左ボタンを押します (離しません)。 マウスを離すには、マウスの左ボタンを上に移動します。 |
| マウスの左ボタンを長押しする |
指定した秒数間、IA-Connect Agent ユーザー セッションでマウスの左ボタンを長押しします。 |
| マウスの移動方法を取得する |
現在のマウスの移動方法を取得します。 |
| マウスの移動方法を設定する |
現在のマウスの移動方法を mouse_event または setcursorpos に設定します。 |
| マウスを右クリックする |
IA-Connect Agent ユーザー セッションでマウスの右ボタンをクリックします。 |
| マウスを左クリックする |
IA-Connect Agent ユーザー セッションでマウスの左ボタンをクリックします。 |
| マウスを座標に移動する |
IA-Connect Agent ユーザー セッションで、指定したピクセル座標にマウスを移動します。 |
| マウスを相対的に移動する |
IA-Connect Agent ユーザー セッションで、指定したピクセル数だけ現在の位置に相対させてマウスを移動します。 |
| マウス乗数を取得する |
IA-Connect Agent ユーザー セッションでグローバル マウス乗数を取得します。 これはデフォルトで (1, 1) ですが、「マウスの乗数を設定する」アクションによって変更された可能性があります。 |
| ユーザーの資格情報から読み取る |
IA-Connect Agent セッションでユーザーのプロファイルの資格情報からユーザー名とパスワードを読み取ります。 資格情報は、Windows のコントロール パネルから表示できます。 ユーザー名とパスワードの両方を汎用資格情報から取得できますが、Windows 資格情報から取得できるのはユーザー名のみです。 |
| ユーザーの資格情報を削除する |
IA-Connect Agent セッションでユーザーのプロファイルの資格情報を削除します。 資格情報は、Windows のコントロール パネルから表示できます。 |
| ユーザー資格情報に書き込む |
IA-Connect Agent セッションでユーザーのプロファイルにあるユーザー名とパスワードを資格情報に書き込み、存在しない場合はその資格情報を作成します。 資格情報は、Windows のコントロール パネルから表示できます。 |
| リモート セッションをログオフする |
IA-Connect Agent が実行されているリモート セッションをログオフします。 |
| リモート セッションを接続解除 |
IA-Connect Agent がリモート セッションで実行されている場合、このアクションによりリモート セッションが接続解除されます。 これはログオフとは異なり、リモート セッションが切断された状態で実行されます。 このアクションは、新しいセッションを開始するのではなく、後でリモート セッションに接続して同じ状態から継続したい場合に使用できます。 IA-Connect Agent がローカルで実行されている場合、このアクションによりセッションがロックされます。 |
| リモート デスクトップ セッション (RDS) の起動ファイルを作成する |
リモート デスクトップ セッション (RDS) の起動ファイルを作成します。このファイルを使用して、リモート デスクトップ クライアント UI の自動化を必要とせずに、指定したパラメーターを使用してリモート デスクトップ セッションを自動的に起動できます。 RDS 起動ファイルの拡張子は '.rdp' であるため、多くの場合に RDS ファイルと呼ばれます。 |
| リモート デスクトップ セッション (RDS) を起動する |
RDS 起動ファイルを使用して、リモート デスクトップ セッション (RDS) を起動します。 |
| 他のすべての IA-Connect Agent を強制終了する |
ユーザー セッションで現在実行中の IA-Connect Agent のその他のインスタンスを強制終了します。 これにより、IA-Connect Agent のインスタンスが 1 つのみ実行されます。 |
| 代替 IA-Connect Agentを実行する |
ファイルの場所から Agent 実行可能ファイルを読み込むことで、代替 IA-Connect Agent (新しいバージョンなど) を実行します。 |
| 例外を発生する |
入力例外が空白でない場合は、指定されたメッセージで例外を発生します。 これは、以前のアクションにエラーがあった場合に、フロー (HTTP 400) で例外メッセージをトリガーし、エラー処理ステージでキャッチするのに役立ちます。 この例外は、IA-Connect オーケストレーター フロー実行統計には記録されません。 |
| 保存済みのパスワードを取得する |
以前に生成または保存されたパスワードを取得します。 |
| 利用可能な IA-Connect セッションを取得する |
IA-Connect Director セッション (ローカル、Microsoft RDP または Citrix ICA など、IA-Connect Agent が実行されているセッションへの利用可能な接続) の一覧を取得します。 |
| 名前ごとに IA-Connect セッションが存在しますか |
指定した IA-Connect Director セッションが存在する場合は返します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 名前は前の 'アタッチ' アクションから取得されます。 |
| 名前でプロセス数を取得する |
指定されたプロセス名を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスの数を返します。 |
| 名前による IA-Connect セッションの強制終了 |
指定した IA-Connect Director セッションが存在する場合は、セッションを強制終了します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 名前は前の 'アタッチ' アクションから取得されます。 |
| 座標でマウスの中央ボタンをクリックする |
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの中央ボタンをクリックします。 |
| 座標でマウスの中央ボタンを長押しする |
IA-Connect Agent ユーザー セッションにおいて、指定した秒数間、指定した座標でマウスの中央ボタンを長押しします。 |
| 座標でマウスの右ボタンを長押しする |
IA-Connect Agent ユーザー セッションにおいて、指定した秒数間、指定した座標でマウスの右ボタンを長押しします。 |
| 座標でマウスの左ボタンをダブルクリックする |
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの左ボタンをダブル クリックします。 |
| 座標でマウスの左ボタンを長押しする |
IA-Connect Agent ユーザー セッションにおいて、指定した秒数間、指定した座標でマウスの左ボタンを長押しします。 |
| 座標でマウスを右クリックする |
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの右ボタンをクリックします。 |
| 座標でマウスを左クリックする |
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの左ボタンをクリックします。 |
| 座標のピクセルカラーを取得する |
指定された座標のピクセルの RGB カラーを返します。 |
| 座標間をマウスの中央ボタンでドラッグする |
IA-Connect Agent ユーザー セッションで、指定した 2 つの座標間でマウスの中央ボタンをドラッグします。 |
| 座標間をマウスの右ボタンでドラッグする |
IA-Connect Agent ユーザー セッションで、指定した 2 つの座標間でマウスの右ボタンをドラッグします。 |
| 座標間をマウスの左ボタンでドラッグする |
IA-Connect Agent ユーザー セッションで、指定した 2 つの座標間でマウスの左ボタンをドラッグします。 |
| 新しいオーケストレーター延期タスクを追加する |
フローから監視できるキューに新しいオーケストレーター延期タスクを追加します。 タスクは、将来の指定された時間に延期されます。 このアクションを使用して、指定した時間だけタスクを一時的に中断します (たとえば、何かを待っている場合など)。 |
| 新しいオーケストレーター自動化タスクを追加する |
フローから監視できるキューに新しいオーケストレーター自動化タスクを追加します。 タスクは、すぐに実行できるようにすることも、後で実行するために延期することもできます。 |
| 既存のオーケストレーター自動化タスクを延期する |
すでにキューにある既存のオーケストレーター タスクを延期します。 タスクは、将来の指定された時間に延期されます。 これは通常、既存のタスクを再延期するために使用されます (つまり、タスクは以前に延期されていたため、再度延期する必要があります)。 このアクションを使用して、指定した時間だけタスクを一時的に中断します (たとえば、何かを待っている場合など)。 |
| 既定のプリンターを取得する |
IA-Connect Agent セッションでユーザーの既定のプリンター名を取得します。 |
| 既定のプリンターを設定する |
IA-Connect Agent セッションでユーザーの既定のプリンターを設定します。 |
| 最後の入力情報を取得する |
IA-Connect Agent ユーザー セッションで最後のユーザー入力を受信してから経過した時間を取得します。 |
| 最新の IA-Connect セッションに添付する |
最後に接続した IA-Connect Director セッション添付します (オプションで指定されたタイプ)。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 |
| 次のオーケストレーター自動化タスクを取得する |
指定した検索条件と一致する、次のオーケストレーター自動化タスクを取得します。 |
| 次のホップ IA-Connect Director を構成する |
ダブルホップ シナリオで次のホップ Director を構成します。 これは、規定の IA-Connect の次のホップ Director 設定が適切でない場合にのみ必要です。 |
| 次のホップの IA-Connect Director 設定をリセットする |
設定されている IA-Connect Director のカスタム設定をリセットして既定の設定を復元します。 |
| 現在のマウスの座標を取得する |
IA-Connect Agent ユーザー セッションで現在のマウス カーソル位置を取得します。 |
| 環境変数を展開する |
IA-Connect Agent ユーザー セッションで環境変数 (%USERPROFILE% や %TEMP% など) を含む文字列を展開します。 |
| 環境情報を取得する |
IA-Connect Agent ユーザー セッションが実行されている環境に関する情報を返します。 |
| 画面に長方形を描画する |
画面座標、または画面座標を報告するアクションの出力を識別しやすくするために、画面上に長方形を描画します。 長方形は 5 秒後に自動的に削除されます。 |
| 親プロセス ID を取得する |
指定したプロセス ID を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスの親プロセスのプロセス ID を返します。 |
| 長方形座標を変換する |
長方形のピクセル座標を仮想から物理、または物理から仮想に変換します。 ポイントを変換する場合は、Right=Left、Bottom=Top と設定するだけです。 物理座標はモニター上のピクセルに直接マッピングされます。 仮想座標は DPI スケールされます。 すべての表示デバイスの基本的な表示スケーリングが 100% の場合、物理座標と仮想座標は両方とも同じになります。 |
| 階層 1 の IA-Connect セッションに添付する |
SOAP / REST メッセージのどちらかまたは両方を受信する Director の IA-Connect Director セッションに添付します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 |
画面の解像度を取得する
IA-Connect Agent ユーザー セッションの画面解像度を返します。 物理デスクトップまたはラップトップ上で実行されている IA-Connect ローカル Agent の場合、これにより、すべてのディスプレイ デバイスとそのスケーリングに関する情報が提供されます。 仮想マシンでは、複数のディスプレイを表示するように仮想マシンが構成されていない限り (一般的ではありません)、通常は 1 つのディスプレイのみが報告されます。 リモート セッションでは通常、1 つの仮想ディスプレイが作成されるため、そのディスプレイが複数のローカル ディスプレイにまたがる場合でも、通常は 1 つのディスプレイのみが報告されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
水平解像度
|
HorizontalResolution | integer |
プライマリ画面の水平物理解像度。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
垂直解像度
|
VerticalResolution | integer |
プライマリ画面の垂直物理解像度。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
画面の数
|
NumberOfScreens | integer |
検出された画面の数。 |
|
2 番目のディスプレイの水平解像度
|
SecondDisplayHorizontalResolution | integer |
2 番目の画面の水平物理解像度 (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
2 番目のディスプレイの垂直解像度
|
SecondDisplayVerticalResolution | integer |
2 番目の画面の垂直物理解像度 (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
3 番目のディスプレイの水平解像度
|
ThirdDisplayHorizontalResolution | integer |
3 番目の画面の水平物理解像度 (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
3 番目のディスプレイの垂直解像度
|
ThirdDisplayVerticalResolution | integer |
3 番目の画面の垂直物理解像度 (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
4 番目のディスプレイの水平解像度
|
FourthDisplayHorizontalResolution | integer |
4 番目の画面の水平物理解像度 (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
4 番目のディスプレイの垂直解像度
|
FourthDisplayVerticalResolution | integer |
4 番目の画面の垂直物理解像度 (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
仮想画面の左端のピクセル数
|
VirtualScreenLeftEdgePixels | integer |
仮想ディスプレイ全体の左端 (検出されたすべてのディスプレイ)。 仮想座標は DPI スケールされます。 |
|
仮想画面の上端のピクセル数
|
VirtualScreenTopEdgePixels | integer |
仮想ディスプレイ全体の上端 (検出されたすべてのディスプレイ)。 仮想座標は DPI スケールされます。 |
|
仮想画面の幅のピクセル数
|
VirtualScreenWidthPixels | integer |
仮想ディスプレイ全体の幅 (検出されたすべてのディスプレイ)。 仮想座標は DPI スケールされます。 |
|
仮想画面の高さのピクセル数
|
VirtualScreenHeightPixels | integer |
仮想ディスプレイ全体の高さ (検出されたすべてのディスプレイ)。 仮想座標は DPI スケールされます。 |
|
プライマリ ディスプレイ スケール
|
PrimaryDisplayScaling | double |
プライマリ ディスプレイの DPI スケール乗数 (10 進数)。 たとえば、100% は 1.0 として返され、125% は 1.25 として返されます。 |
|
2 番目のディスプレイ スケール
|
SecondDisplayScaling | double |
2 番目のディスプレイの DPI スケール乗数 (10 進数)。 たとえば、100% は 1.0 として返され、125% は 1.25 として返されます。 |
|
3 番目のディスプレイ スケール
|
ThirdDisplayScaling | double |
3 番目のディスプレイの DPI スケール乗数 (10 進数)。 たとえば、100% は 1.0 として返され、125% は 1.25 として返されます。 |
|
4 番目のディスプレイ スケール
|
FourthDisplayScaling | double |
4 番目のディスプレイの DPI スケール乗数 (10 進数)。 たとえば、100% は 1.0 として返され、125% は 1.25 として返されます。 |
|
物理画面の左端のピクセル数
|
PhysicalScreenLeftEdgePixels | integer |
物理ディスプレイ全体の左端 (検出されたすべてのディスプレイ)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
物理画面の上端のピクセル数
|
PhysicalScreenTopEdgePixels | integer |
物理ディスプレイ全体の上端 (検出されたすべてのディスプレイ)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
物理画面の幅のピクセル数
|
PhysicalScreenWidthPixels | integer |
物理ディスプレイ全体の幅 (検出されたすべてのディスプレイ)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
物理画面の高さのピクセル数
|
PhysicalScreenHeightPixels | integer |
物理ディスプレイ全体の高さ (検出されたすべてのディスプレイ)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
プライマリ ディスプレイの左端のピクセル数
|
PrimaryDisplayLeftEdgePixels | integer |
プライマリ ディスプレイの左端の物理です。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
プライマリ ディスプレイの上端のピクセル数
|
PrimaryDisplayTopEdgePixels | integer |
プライマリ ディスプレイの上端の物理です。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
2 番目のディスプレイの左端のピクセル数
|
SecondDisplayLeftEdgePixels | integer |
2 番目のディスプレイの左端の物理です (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
2 番目のディスプレイの上端のピクセル数
|
SecondDisplayTopEdgePixels | integer |
2 番目のディスプレイの上端の物理です (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
3 番目のディスプレイの左端のピクセル数
|
ThirdDisplayLeftEdgePixels | integer |
3 番目のディスプレイの左端の物理です (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
3 番目のディスプレイの上端のピクセル数
|
ThirdDisplayTopEdgePixels | integer |
3 番目のディスプレイの上端の物理です (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
4 番目のディスプレイの左端のピクセル数
|
FourthDisplayLeftEdgePixels | integer |
4 番目のディスプレイの左端の物理です (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
|
4 番目のディスプレイの上端のピクセル数
|
FourthDisplayTopEdgePixels | integer |
4 番目のディスプレイの上端の物理です (検出された場合)。 物理座標はモニター上のピクセルに直接マッピングされます。 |
Agent スレッドが正常に完了するまで待機する
Agent スレッドの完了を待機して、オプションでスレッド出力データを取得します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 Agent スレッドが完了しても失敗すると、例外が発生します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
スレッド ID
|
ThreadId | True | integer |
以前に Agent アクションをスレッドとして実行した場合は、スレッド ID を指定してスレッドの状態を取得します。 このスレッド ID は、スレッドとして以前に実行されたアクションの出力として提供されます。 |
|
スレッドを待機する秒数
|
SecondsToWaitForThread | True | integer |
スレッドが完了するまで待機する秒数です。 この時間内にスレッドが完了していない場合は、例外が発生します (「スレッドが完了していない場合は例外を発生させる」が false に設定されている場合を除く)。 |
|
スレッド出力データを取得する
|
RetrieveThreadOutputData | boolean |
JSON 形式のスレッド出力データを取得するには true に設定します。 スレッドの作成に使用したのと同じアクションを呼び出し、入力「スレッド ID の出力データを取得する」をスレッド ID に設定して、スレッド出力データを取得することをお勧めします。ただし、このオプションを使用すると、スレッド出力データを直接取得できましが、オプションでデータを削除できません。 |
|
|
出力データを取得した後、スレッドを削除する
|
ClearOutputDataFromMemoryOnceRead | boolean |
スレッドが正常に完了し、出力データが取得された場合に (入力「スレッド出力データを取得する」を参照)、結果が返された後にスレッドを削除するには、この入力を true に設定します。 これにより、スレッド出力データとスレッド自体が削除されるため、スレッドを再度クエリできなくなります。 |
|
|
スレッドが完了していない場合は例外を発生する
|
RaiseExceptionIfThreadNotCompleted | boolean |
true に設定して、指定した時間にスレッドが完了していない場合、例外が発生します。 false に設定すると、このアクションは要求された時間まで (スレッドが完了するまで) 待機し、スレッドのス状態を報告します (出力「スレッドが実行中」などを参照)。 スレッドが完了しても失敗すると、常に例外が発生します。 |
|
|
スレッド エラーの場合は例外を発生する
|
RaiseExceptionIfThreadError | boolean |
true (デフォルトの動作) に設定すると、スレッドにエラー状態 (スレッドは完了したが成功しなかった) がある場合、例外が発生し、スレッドは削除されます。 false に設定すると、エラーは出力「スレッド エラー メッセージ」に保存され、スレッドは削除されません (必要に応じて、「Agent スレッドを削除する」アクションを使用してスレッドを削除する必要があります)。 |
|
|
電話ごとの待機秒数
|
SecondsToWaitPerCall | integer |
「スレッドを待機する秒数」は、タイムアウトを避けるために、より小さなタイム スライスに分割されます。 このオプションの入力を使用すると、より小さいタイム スライスのサイズを指定できます。 RPA タイムアウトの 80% を超える値に設定しないでください。値を設定すると、タイムアウト エラーが発生する可能性があります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
スレッドが開始された
|
ThreadStarted | boolean |
スレッドが開始された場合は true。 スレッドがまだ開始されていない場合は false。スレッドは即座に開始されるため、問題が発生したことを示します。 「スレッドが完了していない場合は例外を発生させる」が false に設定されている場合のみ便利です。そうでない場合、指定した待機時間にスレッドが完了していない場合に、例外が発生するためです。 |
|
スレッドが実行中
|
ThreadRunning | boolean |
スレッドが現在実行中の場合は True。 スレッドが開始されていない場合 (可能性は非常に低い)、またはスレッドが完了した場合は false。 「スレッドが完了していない場合は例外を発生させる」が false に設定されている場合のみ便利です。そうでない場合、指定した待機時間にスレッドが完了していない場合に、例外が発生するためです。 |
|
スレッドが完了した
|
ThreadCompleted | boolean |
スレッドが完了した場合は true。 スレッドが開始されていない場合 (可能性は非常に低い)、またはスレッドが実行中の場合は false。 「スレッドが完了していない場合は例外を発生させる」が false に設定されている場合のみ便利です。そうでない場合、指定した待機時間にスレッドが完了していない場合に、例外が発生するためです。 |
|
スレッドが成功した
|
ThreadSuccess | boolean |
スレッドが正常に完了した場合は true。 スレッドが開始されていない (可能性は非常に低い)、スレッドが実行中、スレッドが失敗のいずれかの場合は false。 「スレッドが完了していない場合は例外を発生させる」が false に設定されている場合のみ便利です。そうでない場合、指定した待機時間にスレッドが完了していない場合に、例外が発生するためです。 |
|
スレッドの実行時間 (秒)
|
ThreadRuntimeInSeconds | integer |
スレッドが実行されている秒数の合計。 |
|
IA-Connect アクション名
|
IAConnectActionName | string |
スレッドとして実行されている IA-Connect Agent アクションの内部名。 |
|
スレッドの状態メッセージ
|
ThreadStatusMessage | string |
スレッドの状態を説明するテキスト文字列。 このメッセージは、ThreadStarted、ThreadRunning、ThreadCompleted、ThreadSuccess プロパティから計算されます。 このテキスト文字列は言語に依存しません (ロケールに合わせて変更されることはありません)。 |
|
スレッドのエラー メッセージ
|
ThreadErrorMessage | string |
スレッドが失敗した場合、この出力にはエラー メッセージが含まれます。 「スレッド エラーの場合は例外を発生する」が false に設定されている場合のみ便利です。それ以外の場合は、スレッドがエラーの場合に例外が発生するためです。 |
|
スレッド出力データ JSON
|
ThreadOutputJSON | string |
「スレッド出力データを取得する」が true に設定されている場合、この出力には生のスレッド出力データが JSON 形式で保持されます。 |
Agent スレッドの状態を取得する
Agent スレッドのステータスを取得し、オプションでスレッド出力データを取得します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
スレッド ID
|
ThreadId | True | integer |
以前に Agent アクションをスレッドとして実行した場合は、スレッド ID を指定してスレッドの状態を取得します。 このスレッド ID は、スレッドとして以前に実行されたアクションの出力として提供されます。 |
|
スレッド出力データを取得する
|
RetrieveThreadOutputData | boolean |
JSON 形式のスレッド出力データを取得するには true に設定します。 スレッドの作成に使用したのと同じアクションを呼び出し、入力「スレッド ID の出力データを取得する」をスレッド ID に設定して、スレッド出力データを取得することをお勧めします。ただし、このオプションを使用すると、スレッド出力データを直接取得できましが、オプションでデータを削除できません。 |
|
|
出力データを取得した後、スレッドを削除する
|
ClearOutputDataFromMemoryOnceRead | boolean |
スレッドが正常に完了し、出力データが取得された場合に (入力「スレッド出力データを取得する」を参照)、結果が返された後にスレッドを削除するには、この入力を true に設定します。 これにより、スレッド出力データとスレッド自体が削除されるため、スレッドを再度クエリできなくなります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
スレッドが開始された
|
ThreadStarted | boolean |
スレッドが開始された場合は true。 スレッドがまだ開始されていない場合は false。スレッドは即座に開始されるため、問題が発生したことを示します。 |
|
スレッドが実行中
|
ThreadRunning | boolean |
スレッドが現在実行中の場合は True。 スレッドが開始されていない場合 (可能性は非常に低い)、またはスレッドが完了した場合は false。 |
|
スレッドが完了した
|
ThreadCompleted | boolean |
スレッドが完了した場合は true。 スレッドが開始されていない場合 (可能性は非常に低い)、またはスレッドが実行中の場合は false。 |
|
スレッドが成功した
|
ThreadSuccess | boolean |
スレッドが正常に完了した場合は true。 スレッドが開始されていない (可能性は非常に低い)、スレッドが実行中、スレッドが失敗のいずれかの場合は false。 |
|
スレッドの実行時間 (秒)
|
ThreadRuntimeInSeconds | integer |
スレッドが実行されている秒数の合計。 |
|
IA-Connect アクション名
|
IAConnectActionName | string |
スレッドとして実行されている IA-Connect Agent アクションの内部名。 |
|
スレッドの状態メッセージ
|
ThreadStatusMessage | string |
スレッドの状態を説明するテキスト文字列。 このメッセージは、ThreadStarted、ThreadRunning、ThreadCompleted、ThreadSuccess プロパティから計算されます。 このテキスト文字列は言語に依存しません (ロケールに合わせて変更されることはありません)。 |
|
スレッドのエラー メッセージ
|
ThreadErrorMessage | string |
スレッドが失敗した場合、この出力にはエラー メッセージが含まれます。 |
|
スレッド出力データ JSON
|
ThreadOutputJSON | string |
「スレッド出力データを取得する」が true に設定されている場合、この出力には生のスレッド出力データが JSON 形式で保持されます。 |
Agent スレッドをキルする
Agent スレッドをキル (終了、中止) します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 Agent スレッドを削除せずに (スレッドを削除するには、「Agent スレッドの削除」アクションを使用します)、Agent スレッドを監視しているプロセスまたはフローが「IA-Connect Agent スレッドが中止されました」エラーを受信できるます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
スレッド ID
|
ThreadId | True | integer |
以前に Agent アクションをスレッドとして実行した場合は、スレッド ID を指定してスレッドを終了します (スレッドの実行を完全に停止します)。 このスレッド ID は、スレッドとして以前に実行されたアクションの出力として提供されます。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
KillAgentThreadResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
Agent スレッドを削除する
Agent スレッドまたはすべての Agent スレッドを削除し、スレッドがまだ実行中の場合は最初にスレッドをキル (終了、中止) します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 Agent スレッドを監視しているプロセスまたはフローは、「Agent スレッド ID が存在しません」エラーを受け取ります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
スレッド ID
|
ThreadId | integer |
以前に Agent アクションをスレッドとして実行した場合は、スレッド ID を指定してスレッドを終了し、削除します。 このスレッド ID は、スレッドとして以前に実行されたアクションの出力として提供されます。 指定された Agent スレッド ID が存在しない場合、例外が発生します。 |
|
|
すべての Agent スレッドを削除する
|
DeleteAllAgentThreads | boolean |
すべての Agent スレッドを削除するには、true に設定します。 false (デフォルト) に設定すると、「スレッド ID」入力で指定された単一の Agent スレッドが削除されます。 |
|
|
Agent スレッドの削除に失敗した場合に例外を発生する
|
RaiseExceptionIfAgentThreadFailsToDelete | boolean |
Agent スレッドの削除に失敗した場合に例外を発生するには、true に設定します。 このアクションの発行中に Agent スレッドが完了すると、例外が発生する可能性があることに注意してください (削除時点では存在しなくなるため)。 Agent スレッドの削除中のエラーを無視するには、false (デフォルト) に設定します。 「削除された Agent スレッドの数」の出力には、削除された Agent スレッドの数が報告されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
削除された Agent スレッドの数
|
NumberOfAgentThreadsDeleted | integer |
「すべての Agent スレッドを削除する」が true の場合、この出力には削除された Agent スレッドの数 (0 以上) が保持されます。 「すべての Agent スレッドを削除する」が false で、Agent スレッド ID が指定された場合、この出力は 0 または 1 に設定されます。 |
Agent スレッドを取得する
Agent スレッドのリストを返します。 Agent スレッドを使用すると、スレッド内で特定のアクションを実行でき、アクションを長時間 (RPA タイムアウトより長く) 実行したり、他のアクションと並行して実行したりできます。 通常、Agent スレッドが完了し、そのデータが取得されると、Agent スレッドは削除され、スレッドのリストに表示されなくなります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
並べ替え順序
|
SortOrder | string |
Agent スレッドの出力リストの並べ替え順序。 サポートされている並べ替え順序は、「None」、「ThreadStartTime」、「ThreadStartTime_Desc」、「ThreadEndTime」、「ThreadEndTime_Desc」、「ThreadId」、「ThreadId_Desc」、「ThreadActionName」、「ThreadActionName_Desc」、「ThreadRuntime」、「ThreadRuntime_Desc」です。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Agent スレッドの数
|
NumberOfAgentThreads | integer |
まだ実行中または取得可能な Agent スレッドの数。 通常、Agent スレッドが完了し、そのデータが取得されると、Agent スレッドは削除され、スレッドのリストに表示されなくなります。 |
|
Agent スレッド
|
AgentThreads | array of object |
Agent スレッドのリストと利用可能なすべてのスレッド情報 (内部スレッド データを除く)。 |
|
ThreadId
|
AgentThreads.ThreadId | integer | |
|
IAConnectActionName
|
AgentThreads.IAConnectActionName | string | |
|
ThreadStartDateTimeUTC
|
AgentThreads.ThreadStartDateTimeUTC | date-time | |
|
ThreadCompletedDateTimeUTC
|
AgentThreads.ThreadCompletedDateTimeUTC | date-time | |
|
ThreadRuntimeInSeconds
|
AgentThreads.ThreadRuntimeInSeconds | integer | |
|
ThreadStarted
|
AgentThreads.ThreadStarted | boolean | |
|
ThreadRunning
|
AgentThreads.ThreadRunning | boolean | |
|
ThreadCompleted
|
AgentThreads.ThreadCompleted | boolean | |
|
ThreadSuccess
|
AgentThreads.ThreadSuccess | boolean | |
|
ThreadStatusMessage
|
AgentThreads.ThreadStatusMessage | string | |
|
ThreadErrorMessage
|
AgentThreads.ThreadErrorMessage | string |
Agent メモリ内のパスワードを削除する
Agent メモリに保存されている 1 つのパスワードを削除するか、Agent に保存されているすべてのパスワードを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
すべてのパスワードを削除する
|
DeleteAllPasswords | boolean |
Agent メモリに保存されているすべてのパスワードを削除するには、true に設定します。 指定された識別子に一致する単一のパスワードを削除するには、false (デフォルト) に設定します。 |
|
|
識別子
|
Identifier | string |
削除するパスワードを表す一意識別子です。 例: SAPGUILogon。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
DeletePasswordInAgentMemoryResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
CSV テキストをコレクションとして取得する
IA-Connect Agent がコレクション (テーブル) として実行されているコンピューター上の CSV ファイルを返します。 CSV ファイルへの読み取り専用アクセスのみが必要です。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
CSV ファイル パス
|
CSVFilePath | True | string |
CSV ファイルへの完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
先頭行はヘッダー
|
FirstLineIsHeader | boolean |
CSV ファイルの先頭行はヘッダー行ですか? |
|
|
ヘッダーのトリミング
|
TrimHeaders | boolean |
ヘッダーをトリミングして先頭または末尾の空白を削除しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
CSV データ JSON
|
CSVDataJSON | string |
JSON 形式の CSV ファイルのコンテンツ。 |
CSV ファイルへの書き込み
IA-Connect Agent を実行しているコンピューター上の CSV ファイルを作成します。 CSV ファイルは、コレクション (テーブル) または JSON 形式のテーブルから作成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロパティ
|
Properties | object | ||
|
入力テーブル JSON
|
InputTableJSON | string |
JSON 形式で CSV ファイルに書き込むデータのテーブルです。 |
|
|
出力 CSV ファイルのパス
|
CSVFilePath | True | string |
CSV ファイルへの完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
出力エンコード
|
OutputEncoding | string |
CSV ファイルに書き込む際に使用するテキスト エンコード形式。 サポートされているエンコードは、UTF8、UTF7、Unicode、および ASCII です。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
WriteCollectionToCSVFileResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
Director から送信された代替 IA-Connect Agent を実行する
IA-Connect Director から代替 Agent をアップロードし、代替 Agent の実行可能ファイルを読み込むことで、代替 IA-Connect Agent (新しいバージョンなど) を実行します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ローカル ファイル名
|
LocalFilename | True | string |
IA-Connect Director からアクセスできる代替の IA-Connect Agent.exe への完全なパス。 |
|
リモート ファイル名
|
RemoteFilename | string |
代替の IA-Connect Agent.exe (リモート システム上) をコピーする場所への完全なパス。 指定しない場合は、一時ファイル名が選択されます。 代替の IA-Connect Agent がメモリに読み込まれる場合は、'メモリから実行する場合もディスクに保存する' を true に設定しない限り、このファイルは作成されません (不要であるため)。 (IA-Connect の内部メソッドにアクセスするためなどに) '参照実行アセンブリ' を必要とする IA-Connect の動的コード アクションを使用する場合にのみ、これを true に設定します。 |
|
|
圧縮
|
Compress | boolean |
アップロード中に代替の IA-Connect Agent 実行可能ファイルを圧縮しますか? |
|
|
引数
|
Arguments | string |
IA-Connect Agent.exe の実行時に渡されるすべての引数です (オプション)。 |
|
|
許可のダウングレード
|
PermitDowngrade | boolean |
IA-Connect Agent の以前のバージョンを許可しますか? |
|
|
バージョン チェックをスキップ
|
SkipVersionCheck | boolean |
IA-Connect Agent のバージョン (既存か新しいか) をチェックしない場合に指定します。指定すると、すべてのシナリオで新しいバージョンが (同じものが存在する場合でも) 使用されます。 |
|
|
メモリに読み込む
|
LoadIntoMemory | boolean |
代替 IA-Connect Agent をメモリ内で実行しますか? true に設定した場合、新しい Agent がメモリに読み込まれ、既存の Agent のアセンブリ内で実行されます。 false に設定した場合、新しい Agent は通常のプロセスとして実行され、既存の Agent EXE は終了します。 |
|
|
メモリから実行している場合でもディスクに保存する
|
SaveToDiskEvenIfRunningFromMemory | boolean |
代替の IA-Connect Agent がメモリ内で実行されている場合でもそれをディスクに保存しますか? (IA-Connect の内部メソッドにアクセスするためなどに) '参照実行アセンブリ' を必要とする IA-Connect の動的コード アクションを使用する場合にのみ、これを true に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
代替ファイルがコピーされました
|
AlternativeFileCopied | boolean |
代替の IA-Connect Agent が使用された場合に報告します。 |
HTTP ファイルをダウンロードする
HTTP(S) を使用して IA-Connect Agent を実行しているコンピューターにファイルをダウンロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Download URL
|
DownloadURL | True | string |
HTTP または HTTPS のダウンロード URL。 |
|
保存ファイル パス
|
SaveFilename | string |
保存ファイル名への完全なパス。 このフィールドが空で、'コンテンツを文字列として返す' を True として指定した場合、ファイルはコンピューターに保存されません。 |
|
|
既存のファイルを上書きする
|
OverwriteExistingFile | boolean |
'保存ファイル パス' 入力に指定されている名前のファイルが既に存在する場合、上書きしますか? |
|
|
パススルー認証
|
PassthroughAuthentication | boolean |
ユーザーの資格情報を Web サーバーに渡しますか? これは通常、内部のイントラネット サイトのみに使用されます。 |
|
|
ユーザー エージェント
|
UserAgent | string |
これにより、Web ページに報告されるユーザー エージェントを設定できます。 通常、これは必須ではなく、Web ページに特定のエージェント文字列が必要な場合にのみ変更します。 |
|
|
Accept
|
Accept | string |
このパラメーターは、サポートされているコンテンツ タイプを指定します。 これは、ダウンロードするコンテンツに別のコンテンツ タイプが必要な場合にのみ変更してください。 |
|
|
TLS10 のサポート
|
SupportTLS10 | boolean |
TLS 1.0 暗号化プロトコルをサポートするには True に設定します。 |
|
|
TLS11 のサポート
|
SupportTLS11 | boolean |
TLS 1.1 暗号化プロトコルをサポートするには True に設定します。 |
|
|
TLS12 のサポート
|
SupportTLS12 | boolean |
TLS 1.2 暗号化プロトコルをサポートするには True に設定します。 |
|
|
deflate を自動解除
|
AutoDecompressDeflate | boolean |
一部の Web コンテンツは、'deflate' 圧縮を使用して圧縮して返されます。 この値を True に設定すると、'deflate' がサポートされていることが Web サーバーに通知され、この圧縮を使用してコンテンツが送信された場合は、自動的に圧縮解除されます。 |
|
|
GZip を自動解除
|
AutoDecompressGZIP | boolean |
一部の Web コンテンツは、'GZIP' 圧縮を使用して圧縮して返されます。 この値を True に設定すると、'GZIP' がサポートされていることが Web サーバーに通知され、この圧縮を使用してコンテンツが送信された場合は、自動的に圧縮解除されます。 |
|
|
コンテンツを文字列として返す
|
ReturnContentsAsString | boolean |
ファイルのコンテンツを文字列として返しますか? |
|
|
コンテンツのエンコードを返す
|
ReturnContentEncoding | string |
ダウンロードされたコンテンツのエンコード。 これは、'コンテンツを文字列として返す' が True の場合にのみ使用され、ダウンロードされたコンテンツのエンコードを定義して、正しく解釈できるようにします。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ダウンロード ファイルのコンテンツ
|
DownloadFileContents | string |
ダウンロードしたファイルのコンテンツ。 |
IA-Connect Agent GUI の不透明度を設定する
IA-Connect Agent の不透明度を 1 (可視) から 0 (透明) に設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
不透明度
|
Opacity | True | double |
設定する不透明度の値は 1 (可視) から 0 (透明) 範囲になります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Agent GUI の位置を設定する
IA-Connect Agent GUI の画面上の位置を指定された場所に設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X
|
X | True | integer |
Agent に設定するピクセル単位の X 座標。 |
|
年
|
Y | True | integer |
Agent に設定するピクセル単位の Y 座標。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Agent GUI を前面に移動
IA-Connect Agent GUI を前面に表示し、画面に表示されるようにします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォーカス
|
Focus | boolean |
IA-Connect Agent GUI にフォーカスしますか? |
|
|
グローバルのマウスの左ボタンをクリックする
|
GlobalLeftMouseClick | boolean |
エージェントを前面に表示するには、グローバルのマウスの左ボタンをクリックする必要がありますか? これにより、オペレーティング システムによってフォーカス方法が制限され、アプリケーションが前面に表示されないシナリオで、前面に表示されるイベントが保証されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Agent GUI を最前面に設定する
IA-Connect Agent を最前面に設定します。 これによって、IA-Connect Agent は常に画面に表示され、他のアプリケーション ウィンドウによって隠されることがなくなります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
最前面
|
TopMost | boolean |
IA-Connect Agent を最前面 (true) に設定しますか、それとも最前面を無効 (false) にしますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Agent のグローバル座標構成を取得する
IA-Connect Agent のグローバル座標系構成を取得します。この構成は、要素の位置の表示 (例: マウス検査中) とマウス位置の計算 (例: グローバル マウス アクションの実行時) に使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
マルチ モニター機能
|
MultiMonitorFunctionality | string |
IA-Connect Agent が現在、プライマリ ディスプレイ デバイスでの要素の強調表示とグローバル マウス アクションの実行のみをサポートするように構成されている場合は、「PrimaryMonitor」を返します。 IA-Connect Agent がすべてのモニター上の要素を強調表示する場合は、「MultiMonitor」を返します (IA-Connect 9.4 以降のデフォルト)。 |
|
マウス検査乗数の自動設定
|
AutoSetMouseInspectionMultiplier | boolean |
IA-Connect Agent が、Agent の起動時およびマウス検査が実行されるたびに、プライマリ ディスプレイ デバイス上でマウス検査乗数を自動的に計算する場合は true を返します (IA-Connect 9.4 以降のデフォルト)。 IA-ConnectAgent でマウス検査乗数を手動で設定する必要がある場合は false を返します (IA-Connect 9.3 以前でのみ使用可能なオプション)。 このオプションは、マルチ モニター モードが無効になっている場合にのみ効果があります。 |
|
グローバル マウス検査乗数の自動設定
|
AutoSetGlobalMouseMultiplier | boolean |
IA-Connect Agent が、Agent の起動時およびマウス検査が実行されるたびに、プライマリ ディスプレイ デバイス上でグローバル マウス移動乗数を自動的に計算する場合は true を返します (IA-Connect 9.4 以降のデフォルト)。 IA-ConnectAgent でグローバル マウス移動乗数を手動で設定する必要がある場合は false を返します (IA-Connect 9.3 以前でのみ使用可能なオプション)。 このオプションは、マルチ モニター モードが無効になっている場合にのみ効果があります。 |
|
マウス検査 X 乗数
|
MouseInspectionXMultiplier | double |
現在の水平方向 (X) マウス検査乗数 (Agent がマウスの下にあるものを強調表示する場合)。 例: IA-Connect が実際のマウス X 位置の半分に検査長方形を表示している場合、この値は 0.5 になります。 乗数は「マルチ モニター機能」が無効になっている場合にのみ影響します。これは、IA-Connect Agent がマルチ モニターに対応するように構成されている場合、乗数が動的に計算されるためです。 |
|
マウス検査 Y 乗数
|
MouseInspectionYMultiplier | double |
現在の垂直方向 (Y) マウス検査乗数 (Agent がマウスの下にあるものを強調表示する場合)。 例: IA-Connect が実際のマウス Y 位置の半分に検査長方形を表示している場合、この値は 0.5 になります。 乗数は「マルチ モニター機能」が無効になっている場合にのみ影響します。これは、IA-Connect Agent がマルチ モニターに対応するように構成されている場合、乗数が動的に計算されるためです。 |
|
グローバル マウス X 乗数
|
GlobalMouseXMultiplier | double |
現在の水平方向 (X) グローバル マウス移動乗数 (Agent がマウスを移動する場合)。 乗数は「マルチ モニター機能」が無効になっている場合にのみ影響します。これは、IA-Connect Agent がマルチ モニターに対応するように構成されている場合、乗数が動的に計算されるためです。 |
|
グローバル マウス Y 乗数
|
GlobalMouseYMultiplier | double |
現在の垂直方向 (X) グローバル マウス移動乗数 (Agent がマウスを移動する場合)。 乗数は「マルチ モニター機能」が無効になっている場合にのみ影響します。これは、IA-Connect Agent がマルチ モニターに対応するように構成されている場合、乗数が動的に計算されるためです。 |
|
グローバル マウス移動メソッド
|
GlobalMouseMoveMethod | string |
現在のグローバル マウス移動メソッド (mouse_event または setcursorpos) を返します。 |
|
Java 座標系
|
JavaCoordinateSystem | string |
現在の Java 座標系を返します。これは、「仮想」(デフォルト) または「物理」(新機能) になります (IA-Connect 9.4 の新機能)。 仮想座標は DPI スケールされますが、物理座標はピクセルに直接マッピングされます。 この値は、Java Access Bridge で表示されている座標系に設定する必要があります。 |
|
SAP GUI 座標系
|
SAPGUICoordinateSystem | string |
現在の SAP GUI スクリプト API 座標系を返します。これは、「仮想」(デフォルト) または「物理」(新機能) になります (IA-Connect 9.4 の新機能)。 仮想座標は DPI スケールされますが、物理座標はピクセルに直接マッピングされます。 この値は、SAP GUI スクリプト API で表示されている座標系に設定する必要があります。 |
IA-Connect Agent のグローバル座標構成を設定する
IA-Connect Agent のグローバル座標系を構成します。この構成は、要素の位置の表示 (例: マウス検査中) とマウス位置の計算 (例: グローバル マウス アクションの実行時) に使用されます。 デフォルトでは最新の機能が提供されますが、このアクションを使用して、以前のバージョンの Agent の動作に戻したり、API が別の座標系を使用するように指定したりすることができます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
マルチ モニター機能
|
MultiMonitorFunctionality | string |
「プライマリ ディスプレイのみ」(PrimaryMonitor) に設定すると、プライマリ ディスプレイ デバイスでの要素の強調表示とグローバル マウス アクションの実行のみがサポートされる古い動作に戻ります (IA-Connect 9.3 以前でのみ使用可能なモード)。 「すべてのディスプレイ」(マルチモニター) に設定すると、すべてのモニターで要素の強調表示とグローバル マウス アクションの実行が有効になり、各モニターで DPI スケールが自動的に検出されます (IA-Connect 9.4 以降のデフォルト)。 何も変更しない場合は、「設定しない」(NotSet) に設定します。 |
|
|
マウス検査乗数の自動設定
|
AutoSetMouseInspectionMultiplier | string |
「自動」(1) Agent (IA-Connect 9.4 以降のデフォルト) に設定すると、Agent の起動時およびマウス検査が実行されるたびに、プライマリ ディスプレイ デバイス上でマウス検査乗数を自動的に計算します。 検査乗数を手動で設定する必要がある場合は、「手動」(0) に設定します (IA-Connect 9.3 以前でのみ使用可能なオプション)。 このオプションを変更しない場合は、空白または「NotSet」に設定します。 このオプションは、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
グローバル マウス検査乗数の自動設定
|
AutoSetGlobalMouseMultiplier | string |
「自動」(1) Agent (IA-Connect 9.4 以降のデフォルト) に設定すると、Agent の起動時およびマウス検査が実行されるたびに、グローバル マウス動作乗数を自動的に計算します。 グローバル マウス動作乗数を手動で設定する必要がある場合は、「手動」(0) に設定します (IA-Connect 9.3 以前でのみ使用可能なオプション)。 このオプションを変更しない場合は、空白または「NotSet」に設定します。 このオプションは、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
マウス検査 X 乗数
|
MouseInspectionXMultiplier | double |
水平方向 (X) マウス検査乗数を設定します (Agent がマウスの下にあるものを強調表示する場合)。 例: IA-Connect が実際のマウス X 位置の半分に検査長方形を表示している場合、値 を 0.5 に設定します。 現在の値を変更しない場合は、0 に設定します。 このオプションは、「マルチ モニター機能」が無効で、「マウス検査乗数の自動設定」が無効になっている場合にのみ効果があります。 |
|
|
マウス検査 Y 乗数
|
MouseInspectionYMultiplier | double |
垂直方向 (Y) マウス検査乗数を設定します (Agent がマウスの下にあるものを強調表示する場合)。 例: IA-Connect が実際のマウス Y 位置の半分に検査長方形を表示している場合、値 を 0.5 に設定します。 現在の値を変更しない場合は、0 に設定します。 このオプションは、「マルチ モニター機能」が無効で、「マウス検査乗数の自動設定」が無効になっている場合にのみ効果があります。 |
|
|
グローバル マウス X 乗数
|
GlobalMouseXMultiplier | double |
水平方向 (X) グローバル マウス移動乗数を設定します (Agent がマウスを移動する場合)。 現在の値を変更しない場合は、0 に設定します。 このオプションは、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
グローバル マウス Y 乗数
|
GlobalMouseYMultiplier | double |
垂直方向 (X) グローバル マウス移動乗数を設定します (Agent がマウスを移動する場合)。 現在の値を変更しない場合は、0 に設定します。 このオプションは、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
mouse_event に適用
|
GlobalMouseMultiplierApplyToMouseEvent | boolean |
これは、グローバル マウス乗数の値を mouse_event メソッドに適用するかどうかを指定します。 このオプションは、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
SetCursorPos に適用
|
GlobalMouseMultiplierApplyToSetCursorPos | boolean |
この引数は、グローバル マウス乗数の値を SetCursorPos メソッドに適用するかどうかを指定します。 このオプションは、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
Apply to current mouse move method
|
GlobalMouseMultiplierApplyToCurrentMouseMoveMethod | boolean |
この引数は、グローバル マウス乗数値を現在のマウス移動メソッドに適用するかどうかを指定します (例: SetCursorPos が現在のマウス移動メソッドである場合、乗数は SetCursorPos に適用されます)。 これが true に設定されている場合、入力 'Apply to mouse_event' と 'Apply to SetCursorPos' は無視されます。 このオプションは、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
Java 座標系
|
JavaCoordinateSystem | string |
「仮想」(IA-Connect 9.3 以前でのみ使用可能なオプション、デフォルト) に設定すると、Java Access Bridge が仮想 (DPI スケールされた) 座標を提供していることが Agent に通知されます。 「物理」に設定すると、Java Access Bridge が物理座標 (ピクセルに直接マッピング) を提供していることを Agent に通知します。 何も変更しない場合は、「設定しない」(NotSet) に設定します。 |
|
|
SAP GUI 座標系
|
SAPGUICoordinateSystem | string |
「仮想」(IA-Connect 9.3 以前でのみ使用可能なオプション、デフォルト) に設定すると、SAP GUI スクリプト API が仮想 (DPI スケールされた) 座標を提供していることが Agent に通知されます。 「物理」に設定すると、SAP GUI スクリプト API が物理座標 (ピクセルに直接マッピング) を提供していることを Agent に通知します。 何も変更しない場合は、「設定しない」(NotSet) に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
SetAgentGlobalCoordinateConfigurationResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
IA-Connect Agent のコマンド タイムアウトを設定する
実行される各コマンドに対して IA-Connect Agent が使用するコマンド タイムアウトを設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コマンド タイムアウト (秒)
|
CommandTimeoutInSeconds | True | integer |
IA-Connect Agent が使用するコマンド タイムアウト。 大量のデータの読み取りまたは書き込みを行う場合は、タイムアウト期間を長くすることができます。 |
|
タイムアウトした RPA コマンド スレッドを終了する
|
TerminateTimedoutRPACommandThreads | boolean |
タイムアウトした場合にコマンド スレッドを終了しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Agent の汎用コマンドを実行する
引数を JSON として渡し、出力データを JSON として返す一般的な IA-Connect Agent コマンドを実行します。 Director と Inspector が Agent より古いバージョンであるため、コマンドを理解できない場合に Agent コマンドを実行するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
IA-Connect Agent コマンド名
|
CommandName | True | string |
IA-Connect Agent コマンドの内部名。 コマンド名のリストは、アクション 'GetAgentActionsInClass' によって提供できます。 |
|
入力 JSON
|
InputJSON | string |
IA-Connect Agent コマンドへの入力 (JSON 形式)。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力 JSON
|
OutputJSON | string |
IA-Connect Agent コマンドからの出力 (JSON 形式)。 |
IA-Connect Agent の現在のライセンス状態を取得する
IA-Connect Agent のライセンスが現在付与されているかどうかを返します。ライセンスが付与されている場合は、ライセンスのプロパティを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ライセンス取得済み
|
IsLicensed | boolean |
IA-Connect Agent のライセンスが現在付与されている場合は true、付与されていない場合は false を返します。 |
|
ライセンスの種類
|
LicenseType | string |
使用されている IA-Connect ライセンスの種類。 |
|
Agent のドメイン名
|
CustomerNETBIOSDomainName | string |
IA-Connect Agent を実行しているコンピューターの NetBIOS ドメイン名 (ドメイン名でライセンスが付与されている場合) (IA-Connect 7.0 または 7.1)。 |
|
Director のホスト名
|
DirectorHostnameCSV | string |
IA-Connect Director をインストールできるコンピューターのホスト名 (ホスト名によってライセンスが付与されている場合) (IA-Connect 7.2 以降)。 |
|
顧客の表示名
|
CustomerDisplayName | string |
IA-Connect Agent のタイトル バーに表示される顧客名。 |
|
ベンダー名
|
VendorName | string |
IA-Connect ベンダーの名前。 |
|
ライセンス有効期限
|
LicenseExpiryDate | string |
IA-Connect ライセンスの有効期限。 |
|
ライセンス期限切れまでの日数
|
DaysUntilLicenseExpires | integer |
IA-Connect ライセンスの有効期限までの残り日数。 |
|
ライセンス機能
|
LicenseFeatures | string |
追加のライセンス機能。通常は追加機能へのアクセスを提供します。 |
|
JML ライセンスである
|
IsJMLLicense | boolean |
このライセンスは JML 機能へのアクセスを提供しますか。 |
IA-Connect Agent を閉じる
IA-Connect Agent を閉じます。 これは、IA-Connect Agent が実行されていたユーザー セッションに影響しません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
待機する秒数
|
SecondsToWait | integer |
IA-Connect Agent がコマンドの完了を報告するために、閉じるコマンドを発行するまでの時間。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Agent セッション情報の取得
IA-Connect Agent ユーザー セッションに関する情報を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
セッション ID
|
SessionId | integer |
現在のリモート ユーザー セッション ID。 |
|
セッションの種類
|
SessionType | integer |
リモート セッションの種類で、1 (Citrix)、2 (RDP)、0 (コンソール) のいずれかです。 |
|
セッションの種類の名前
|
SessionTypeName | string |
リモート セッションの種類で、ICA (Citrix)、RDP、コンソールのいずれかです。 |
IA-Connect Agent プロセス数を取得する
ユーザー セッションで現在実行されている IA-Connect Agent のインスタンス数を返します。 これは、実行中の IA-Connect Agent のインスタンスが複数存在するかどうかを検出する場合に便利です。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プロセスの数
|
NumberOfProcesses | integer |
ユーザー セッションで現在実行されている IA-Connect Agent プロセスの数。 |
IA-Connect Agent ログ レベルを取得
現在の IA-Connect Agent のログ レベルを返します。 ログ レベルは 1 から 4 の範囲で設定され、1 が最も低いレベル、4 が最も高いレベルになります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ログ レベル
|
LoggingLevel | integer |
現在の IA-Connect Agent のログ レベル。 |
IA-Connect Agent ログ レベルを設定する
IA-Connect Agent のログ レベルを指定された値に設定します (1 は最も低いレベル、4 は最も高いレベル)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ログ レベル
|
LoggingLevel | True | integer |
IA-Connect Agent に設定するログ レベル。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Agent ログを取得
現在の IA-Connect Agent ログをファイルとして返すか、内容を読み取って出力変数に戻すことで返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
圧縮
|
Compress | boolean |
アップロード中に代替の IA-Connect Agent 実行可能ファイルを圧縮しますか? |
|
|
最後のコマンド ログのみを返す
|
ReturnLastCommandOnly | boolean |
IA-Connect Agent ログをログ全体ではなく最後のコマンドの結果に制限しますか? |
|
|
ログをファイルに保存
|
SaveLogToFile | boolean |
IA-Connect Agent ログをファイルとして保存しますか? |
|
|
ログ コンテンツをデータ アイテムに配置する
|
PlaceLogContentInDataItem | boolean |
ログのコンテンツを出力変数に返しますか? |
|
|
ローカル保存フォルダー
|
LocalSaveFolder | string |
IA-Connect Agent ログの保存先となるフォルダーへのファイルパス。 |
|
|
Agent ログ ファイル名を使用する
|
UseAgentLogFilename | boolean |
ログ ファイルに Agent のログ ファイル名と同じ名前を付けますか? false に設定した場合は、'ローカル保存ファイル名' を設定してファイル名を指定できます。 |
|
|
ローカル保存ファイル名
|
LocalSaveFilename | string |
IA-Connect Agent ログのローカル保存ファイルのファイル名のみ。 これは 'Agent ログ ファイル名を使用する' が false に設定されている場合にのみ使用されます。 |
|
|
読み取る最大バイト数
|
MaxBytesToRead | integer |
Agent ログから読み取る (末尾から逆方向に) 最大バイト数。 ログ全体を取得する場合は、0 または -1 に設定できます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Agent ログのコンテンツ
|
IAConnectAgentLogContentsBase64 | string |
IA-Connect Agent ログのコンテンツ |
|
ローカルに保存されたログ ファイル名
|
IAConnectAgentLogFilenameOnly | string |
保存されたログ ファイル名のパス。 |
IA-Connect Agent 情報の取得
バージョン番号や Agent 実行可能ファイルへのパスを含む、IA-Connect Agent のプロパティを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
IA-Connect Agent バージョン
|
IAConnectAgentVersion | string |
IA-Connect Agent の完全なバージョン番号。 |
|
DotNet CLR バージョン
|
DotNetCLRVersion | string |
DotNet 共通言語ランタイム (CLR) のバージョン。 |
|
ユーザー名として実行される IA-Connect エージェント
|
IAConnectAgentRunAsUsername | string |
IA-Connect Agent が実行されているユーザー セッションのユーザー名。 |
|
ユーザードメインとして実行される IA-Connect Agent
|
IAConnectAgentRunAsUserdomain | string |
IA-Connect Agent が実行されているユーザー セッションのユーザー ドメイン。 |
|
IA-Connect Agent パス
|
IAConnectAgentPath | string |
IA-Connect Agent 実行可能ファイルへの完全なパス。 |
|
IA-Connect Agent は 64 ビット プロセス
|
IAConnectAgentIs64bitProcess | boolean |
IA-Connect Agent が 64 ビットのプロセスである場合は true、そうでない場合は false を返します。 |
|
IA-Connect Agent リリース バージョン
|
IAConnectAgentReleaseVersion | string |
IA-Connect Agent のリリース バージョン (例: 8.0)。 |
IA-Connect Director ログ レベルを設定する
IA-Connect Director のログ レベルを指定された値に設定します (1 は最も低いレベル、4 は最も高いレベル)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ログ レベル
|
LoggingLevel | True | integer |
IA-Connect Director に設定するログ レベル。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect Directorの稼働時間を取得
この IA-Connect Director の稼働時間を秒単位で返します (Director の実行時間)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Director のアップタイム (秒)
|
UpTimeInSeconds | integer |
IA-Connect Director が実行されている秒数。 |
IA-Connect の次のホップ セッションの接続を待機する
次のホップ セッションが接続され、IA-Connect Agent が次のホップ セッションで実行されるのを待機します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
次のホップ ディレクターのアドレス
|
NextHopDirectorAddress | string |
'次のホップ Director のアドレスは localhost です'、'次のホップ Director のアドレスはホスト名です'、'次のホップ Director のアドレスは FQDN です'、または '次のホップ Director のアドレスは名前付きパイプです' のいずれのパラメーターも true に設定されていない場合に、次のホップ IA-Connect Director がコマンドを転送するためのオプションのアドレス。 |
|
|
次のホップ ディレクターの TCP ポート
|
NextHopDirectorTCPPort | integer |
次のホップ Director (Agent を実行しているコンピューター上の Director) がリッスンしている TCP ポート。 |
|
|
次のホップ ディレクターは HTTPS を使用する
|
NextHopDirectorUsesHTTPS | boolean |
次のホップ ダイレクターが HTTPS を使用する場合は True、そうでない場合は false に設定します。 |
|
|
次のホップ ディレクターのアドレスは localhost です
|
NextHopDirectorAddressIsLocalhostname | boolean |
次のホップ Director のアドレス (Agent に相対) は 'localhost' です。 |
|
|
次のホップ ディレクターのアドレスはホスト名です
|
NextHopDirectorAddressIsHostname | boolean |
次のホップ Director のアドレスは、Agent を実行しているコンピューター (つまり Agent と Director を実行しているコンピューター) のホスト名です。 |
|
|
次のホップ ディレクターのアドレスは FQDN です
|
NextHopDirectorAddressIsFQDN | boolean |
次のホップ Director のアドレスは、Agent を実行しているコンピューター (つまり Agent と Director を実行しているコンピューター) の完全修飾ドメイン名 (FQDN) です。 |
|
|
次のホップ ディレクター TCP ポートをセッション ID ごとに増加する
|
IncrementNextHopDirectorTCPPortBySessionId | boolean |
次のホップ Director の TCP ポートを一意にするために (同じホストからの次のホップを使用している並列セッションが複数存在する場合)、セッション ID を次のホップ Director の TCP ポートに追加できます。 |
|
|
待機する時間 (秒)
|
SecondsToWait | double |
次のホップ セッションの接続を待機する最大秒数。 |
|
|
次のホップ ディレクターのアドレスは名前パイプです
|
NextHopDirectorAddressIsNamedPipe | boolean |
次のホップ Director のアドレス (Agent に相対) は、TCP/IP Web サービスの代わりに名前付きパイプを使用しています。 これは、最初のホップで TCP/IP ポートが使用されることを避けるための既定の設定です。 |
|
|
既存の次のホップを無効にする
|
DisableExistingNextHop | boolean |
(現在アクティブな) ダブルホップを再度有効化する前に無効にしますか? true (既定) に設定した場合は、新しいダブルホップ有効化の指示によって前の指示が置換されます。 false に設定した場合は、ダブルホップ IA-Connect Agent エージェントが指示を受け取るため、トリプルホップが有効になります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
次のホップ セッション接続済み
|
NextHopSessionConnected | boolean |
最大待機時間を超える前に次のホップ セッションが接続された場合に true を返します。 |
IA-Connect の次のホップが有効
次のホップ セッションで実行されている IA-Connect Agent に受信した今後のすべてのコマンドを転送する次のホップを有効にします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
次のホップ ディレクターのアドレス
|
NextHopDirectorAddress | string |
'次のホップ Director のアドレスは localhost です'、'次のホップ Director のアドレスはホスト名です'、'次のホップ Director のアドレスは FQDN です'、または '次のホップ Director のアドレスは名前付きパイプです' のいずれのパラメーターも true に設定されていない場合に、次のホップ IA-Connect Director がコマンドを転送するためのオプションのアドレス。 |
|
|
次のホップ ディレクターの TCP ポート
|
NextHopDirectorTCPPort | integer |
次のホップ Director (Agent を実行しているコンピューター上の Director) がリッスンしている TCP ポート。 |
|
|
次のホップ ディレクターは HTTPS を使用する
|
NextHopDirectorUsesHTTPS | boolean |
次のホップ ダイレクターが HTTPS を使用する場合は True、そうでない場合は false に設定します。 |
|
|
次のホップ ディレクターのアドレスは localhost です
|
NextHopDirectorAddressIsLocalhostname | boolean |
次のホップ Director のアドレス (Agent に相対) は 'localhost' です。 |
|
|
次のホップ ディレクターのアドレスはホスト名です
|
NextHopDirectorAddressIsHostname | boolean |
次のホップ Director のアドレスは、Agent を実行しているコンピューター (つまり Agent と Director を実行しているコンピューター) のホスト名です。 |
|
|
次のホップ ディレクターのアドレスは FQDN です
|
NextHopDirectorAddressIsFQDN | boolean |
次のホップ Director のアドレスは、Agent を実行しているコンピューター (つまり Agent と Director を実行しているコンピューター) の完全修飾ドメイン名 (FQDN) です。 |
|
|
次のホップ ディレクター TCP ポートをセッション ID ごとに増加する
|
IncrementNextHopDirectorTCPPortBySessionId | boolean |
次のホップ Director の TCP ポートを一意にするために (同じホストからの次のホップを使用している並列セッションが複数存在する場合)、セッション ID を次のホップ Director の TCP ポートに追加できます。 |
|
|
有効化する前に無効にする
|
DisableBeforeEnable | boolean |
(現在アクティブな) ダブルホップを再度有効化する前に無効にしますか? true (既定) に設定した場合は、新しいダブルホップ有効化の指示によって前の指示が置換されます。 false に設定した場合は、ダブルホップ IA-Connect Agent エージェントが指示を受け取るため、トリプルホップが有効になります。 |
|
|
次のホップ ディレクターが実行中であることを確認する
|
CheckNextHopDirectorIsRunning | boolean |
次のホップは、Agent と同じコンピューター上で実行中の IA-Connect Director を必要とします。 この設定が true の場合、Agent は記述されているとおりに次のホップ Director が実行されていることを確認し、次のホップ Director が実行中でない場合は次のホップの有効化に失敗します。 この設定が false の場合、Agent はチェックを一切実行せず、次のホップの状態のみを確認します。 |
|
|
次のホップ エージェントが実行中であることを確認する
|
CheckNextHopAgentIsRunning | boolean |
次のホップでは、Agent と同じコンピューター上で実行中の IA-Connect Drector と、次のホップ セッションで実行中の IA-Connect Agent が必要です。 この設定が true の場合、Agent は記述されているとおりに次のホップ Agent が実行されていることを確認し、次のホップ Agent が実行中でない場合は次のホップの有効化に失敗します。 この設定が false の場合、Agent はチェックを一切実行せず、次のホップの状態のみを確認します。 |
|
|
次のホップ ディレクターのアドレスは名前パイプです
|
NextHopDirectorAddressIsNamedPipe | boolean |
次のホップ Director のアドレス (Agent に相対) は、TCP/IP Web サービスの代わりに名前付きパイプを使用しています。 これは、最初のホップで TCP/IP ポートが使用されることを避けるための既定の設定です。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アクティブな次のホップ ディレクター アドレス
|
ActiveNextHopDirectorAddress | string |
アクティブな次のホップ Director のアドレス (使用されている場合)。 |
|
アクティブな次のホップ ディレクター TCP ポート
|
ActiveNextHopDirectorTCPPort | integer |
アクティブな次のホップ Director の TCP ポート (使用されている場合)。 |
|
HTTPS を使用するアクティブな次のホップ ディレクター
|
ActiveNextHopDirectorUsesHTTPS | boolean |
アクティブな次のホップ ダイレクターが HTTPS を使用する場合は true を返します。 |
|
アクティブな次のホップ ディレクター URL
|
ActiveNextHopDirectorURL | string |
アクティブな次のホップ Director の URL。 |
IA-Connect の次のホップを無効にする
次のホップを無効にして、今後のすべてのコマンドが (次のホップのエージェントに転送されるのではなく) それらを受信したエージェントで処理されるようにします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect の次のホップ状態を取得する
このコマンドを受け取る Agent の次のホップ Director の状態を報告します。 次のホップが有効になっている場合、その Agent は次のホップにコマンドを転送しています (次のホップ Director を経由)。 次のホップが無効になっている場合、その Agent はコマンド自体を処理しています (既定)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
次のホップ ディレクターが実行中であることを確認する
|
CheckNextHopDirectorIsRunning | boolean |
次のホップは、Agent と同じコンピューター上で実行中の IA-Connect Director を必要とします。 この設定が true の場合、Agent は記述されているとおりに次のホップ Director が実行されていることを確認します。 この設定が false の場合、Agent はチェックを一切実行せず、次のホップの状態のみを確認します。 |
|
|
次のホップ エージェントが実行中であることを確認する
|
CheckNextHopAgentIsRunning | boolean |
次のホップでは、Agent と同じコンピューター上で実行中の IA-Connect Drector と、次のホップ セッションで実行中の IA-Connect Agent が必要です。 この設定が true の場合、Agent は記述されているとおりに次のホップ Agent が実行されていることを確認します。 この設定が false の場合、Agent はチェックを一切実行せず、次のホップの状態のみを確認します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
次のホップが有効
|
NextHopEnabled | boolean |
次のホップが現在有効になっている場合は true を返します。 |
|
アクティブな次のホップ ディレクター アドレス
|
ActiveNextHopDirectorAddress | string |
アクティブな次のホップ Director のアドレス (使用されている場合)。 |
|
アクティブな次のホップ ディレクター TCP ポート
|
ActiveNextHopDirectorTCPPort | integer |
アクティブな次のホップ Director の TCP ポート (使用されている場合)。 |
|
HTTPS を使用するアクティブな次のホップ ディレクター
|
ActiveNextHopDirectorUsesHTTPS | boolean |
アクティブな次のホップ ダイレクターが HTTPS を使用する場合は true を返します。 |
|
アクティブな次のホップ Director が実行中
|
ActiveNextHopDirectorIsRunning | boolean |
アクティブな次のホップ Director が実行中の場合は true、実行中でない場合は false を返します。 |
|
アクティブな次のホップ ディレクター URL
|
ActiveNextHopDirectorURL | string |
アクティブな次のホップ Director の URL。 |
|
アクティブな次のホップ Agent が実行中
|
ActiveNextHopAgentIsRunning | boolean |
アクティブな次のホップ Agent が実行中の場合は true、実行中でない場合は false を返します。 |
IA-Connect コマンド統計をリセットする
現在のセッションで IA-Connect Agent が実行したコマンドに対して現在格納されている統計をリセットします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect セッションが名前によって終了するまで待機する
指定した IA-Connect Director セッションが終了するまで待機します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 名前は前の 'アタッチ' アクションから取得されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
IA-Connect セッション名
|
IAConnectSessionName | True | string |
チェックする IA-Connect セッションの名前。 |
|
待機する時間 (秒)
|
TimeToWaitInSeconds | integer |
指定したタイプのセッションが存在しない場合 (特定のタイプを指定した場合)、IA-Connect が待機すべき時間はどのくらいですか? |
|
|
タイムアウトしたら例外を発生する
|
RaiseExceptionIfTimedout | boolean |
タイムアウト期間の経過前に新しいセッションが接続されていない場合、IA-Connect で例外を発生させますか? |
|
|
成功時に、階層 1 の IA-Connect セッションに添付する
|
AttachToTier1IAConnectSessionOnSuccess | boolean |
セッションが正常に終了した場合に、IA-Connect を階層 1 の IA-Connect セッション (SOAP / REST メッセージのどちらかまたは両方を受信する Director の IA-Connect Director セッション) に接続しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
IA-Connect セッションを終了した
|
IAConnectSessionClosed | boolean |
指定された名前のセッションが終了している場合は true、終了していない場合は false を返します。 |
|
階層 1 の IA-Connect セッション名に添付する
|
AttachedTier1IAConnectSessionName | string |
接続した階層 1 の IA-Connect セッションの名前。 |
IA-Connect セッションにインデックスで添付する
指定した IA-Connect Director セッションにインデックスを使って添付します (例: 最初の Citrix ICA セッションに添付する)。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
IA-Connect のセッション タイプを検索する
|
SearchIAConnectSessionType | string |
検索するセッションの種類 (例: リモート セッションの場合は 'ローカル エージェント'、'Microsoft RDP'、'Citrix ICA'、'リモート' など)。 セッションの種類を検索するには空白のままにします。 |
|
|
IA-Connect セッション インデックスを検索する
|
SearchIAConnectSessionIndex | integer |
接続するセッションのインデックス (例: 一致する最初のセッションの種類は 1、一致する 2 番目のセッションの種類は 2)。 |
|
|
待機する時間 (秒)
|
TimeToWaitInSeconds | integer |
指定されたインデックスを持つセッションが存在しない場合、IA-Connect はどれくらいの期間待機しますか? |
|
|
タイムアウトしたら例外を発生する
|
RaiseExceptionIfTimedout | boolean |
タイムアウト期間の経過前に新しいセッションが接続されていない場合、IA-Connect で例外を発生させますか? |
|
|
仮想チャネルの接続が必要
|
VirtualChannelMustBeConnected | boolean |
IA-Connect Director は、セッションへの接続時に仮想チャネルが接続されていることを検証しますか? これにより、IA-Connect Agent は指定したセッションで確実に実行されます。 |
|
|
まだ閲覧していないセッションのみの件数
|
OnlyCountSessionsNotSeenBefore | boolean |
true に設定すると、以前に実行した '利用できる IA-Connect セッションを取得する' アクション (または IA-Connect Inspector の表示セッション) で見つかったセッションを、インデックスにカウントしません。 これにより '新しい' セッションのみをカウントできます (例: 最初の新しい Citrix セッションに添付する)。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
添付した IA-Connect セッション名
|
AttachedIAConnectSessionName | string |
接続した IA-Connect セッションの名前。 |
|
セッションに添付する
|
AttachedToSession | boolean |
IA-Connect がセッションに添付されている場合は true、そうでない場合は false を返します。 |
IA-Connect セッションに名前で添付する
指定した IA-Connect Director セッションに名前で添付します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
IA-Connect セッション名
|
IAConnectSessionName | True | string |
接続する IA-Connect セッションの名前。 |
|
仮想チャネルの接続が必要
|
VirtualChannelMustBeConnected | boolean |
IA-Connect Director は、セッションへの接続時に仮想チャネルが接続されていることを検証しますか? これにより、IA-Connect Agent は指定したセッションで確実に実行されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
IA-Connect ライセンス キーを設定する
ライセンス キーを使用して IA-Connect Agent のライセンスを取得します。 IA-Connect オーケストレーターに保持されたライセンスのライセンス文字列またはフレンドリ名を、これに指定できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ライセンス キー
|
LicenseString | True | string |
IA-Connect のライセンス キー文字列、または IA-Connect オーケストレーターが保持するライセンスの分かりやすい名前 (IA-Connect オーケストレーターで IA-Connect を制御する場合)。 |
|
レジストリに格納
|
StoreInRegistry | boolean |
IA-Connect ライセンスをレジストリに一時的に保管しますか? これにより、Agent が終了して再起動した場合でも、ユーザー セッションの期間中は IA-Connect Agent のライセンスが維持されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ライセンス期限切れまでの日数
|
DaysUntilLicenseExpires | integer |
IA-Connect ライセンスの有効期限までの残り日数。 |
IA-Connect ライセンス コードを設定する
IA-Connect Agent に古いスタイル (7.0 と 7.1) のエージェント ドメイン ライセンスをアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
顧客の NetBIOS ドメイン名
|
CustomerNETBIOSDomainName | True | string |
IA-Connect Agent を実行しているコンピューターの NetBIOS ドメイン名。 |
|
顧客の表示名
|
CustomerDisplayName | True | string |
IA-Connect Agent のタイトル バーに表示される顧客名。 |
|
ベンダー名
|
VendorName | True | string |
IA-Connect ベンダーの名前。 |
|
ライセンス有効期限
|
LicenseExpiryDate | True | string |
IA-Connect ライセンスの有効期限。 |
|
アクティブ化コード
|
ActivationCode | True | string |
IA-Connect ライセンスのアクティブ化コード。 |
|
レジストリに格納
|
StoreInRegistry | boolean |
IA-Connect ライセンスをレジストリに一時的に保管しますか? これにより、Agent が終了して再起動した場合でも、ユーザー セッションの期間中は IA-Connect Agent のライセンスが維持されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
INI ファイル内の変数データを置き換える
INI ファイル内の 1 つの変数を更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
INI ファイル パス
|
InputFilename | True | string |
INI ファイルへの完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
出力 INI ファイルのパス
|
OutputFilename | string |
更新された INI ファイルを代替ファイルに書き込む場合は、ここに出力ファイルへの完全なパスを入力します。 入力 INI ファイルは変更されません - 出力 INI ファイルに変更内容が格納されます。 |
|
|
INI 検索セクション
|
SearchSection | string |
変更する変数を保持するセクションのオプション名。 |
|
|
INI 検索変数名
|
SearchVariable | string |
更新する変数の名前。 |
|
|
置換データ
|
ReplaceData | string |
変数を更新する置換データ。 |
|
|
INI ファイルのエンコード
|
InputFilenameEncoding | string |
INI ファイルのエンコード (Unicode、UTF8、UTF7、または ASCII) を指定するか、エンコードの値 (例: 西ヨーロッパは 1252) を指定します。 |
|
|
入力ファイルが存在しない場合に新しいファイルを作成する
|
CreateNewFileIfNotExists | boolean |
入力ファイルが存在しない場合に新しいファイルを作成しますか? |
|
|
等号の前にスペースを書き込む
|
WriteSpaceBeforeEquals | boolean |
等号 ( = ) 記号の前にスペースを書き込みますか? |
|
|
等号の後にスペースを書き込む
|
WriteSpaceAfterEquals | boolean |
等号 ( = ) 記号の後にスペースを書き込みますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
mouse_event を調整する
指定したピクセル数だけマウスを移動し、新しいマウスの位置を読み取ることで、mouse_event メソッドを調整します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
調整サイズ (ピクセル単位)
|
CalibrationSizeInPixels | integer |
調整のためにマウスを移動するピクセル数。 値が小さいほど調整の精度が低くなります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
マウス X の乗数
|
MouseXMultiplier | double |
マウス X の乗数値。 1.0 の値は乗数が存在しないことを示します。 |
|
マウス Y の乗数
|
MouseYMultiplier | double |
マウス Y の乗数値。 1.0 の値は乗数が存在しないことを示します。 |
TCP ポートは応答している
ネットワーク TCP ポートが IA-Connect Agent による接続試行に応答しているかどうかを報告します。 これは、IA-Connect Agent が実行されているコンピューター (リモート ホストの場合は 'localhost' と入力) または任意のリモート コンピューターの TCP ポートである可能性があります。 IA-Connect Agent が TCP ポートに正常に接続すると、すぐに TCP 接続を閉じます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リモート ホスト
|
RemoteHost | True | string |
接続するコンピューターの IPv4 アドレス、DNS アドレス、またはホスト名。 'localhost' を入力して、IA-Connect Agent を実行しているコンピューター上の TCP ポートをチェックします。 例: 192.168.1.10 または www.test.com または vm-server19。 |
|
TCP ポート
|
TCPPort | True | integer |
指定されたリモート (またはローカル) ホストで接続する TCP ポート番号。 TCP ポートは、1 以上および 65535 以下である必要があります。 一般的な既知のポートの例は、80 (HTTP)、443 (HTTPS)、445 (SMB/ファイル共有)。 |
|
タイムアウト (秒)
|
TimeoutInSeconds | integer |
TCP 接続を待機する最大秒数。 この既定値は 10 秒ですが、ほとんどの機能している接続は数秒以内 (インターネット経由) または 1 秒未満 (ローカル ネットワーク) で接続するはずです。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
TCP ポートに接続済み
|
TCPPortConnected | boolean |
TCP ポートに接続した場合は true に設定し、TCP ポートの接続に失敗した場合は false に設定します。 |
|
接続エラーのメッセージ
|
ConnectionErrorMessage | string |
TCP ポートが接続に失敗した場合のエラー メッセージ。 これは通常、DNS/名前検索エラーまたはタイムアウトになります。 |
ZIP にフォルダーを追加する
フォルダー内のファイルを ZIP ファイルに圧縮します (ファイルを圧縮アーカイブに格納します)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ZIP に追加するソース フォルダー
|
SourceFolderToAddToZIP | True | string |
ZIP に追加するフォルダーへのファイル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
出力 ZIP ファイルのパス
|
OutputZIPFilename | True | string |
ZIP の出力先のファイル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ZIP 内のフォルダーにファイルを追加
|
AddFilesToFolderInZIP | string |
ZIP ファイル内のフォルダーにソース ファイルを追加する場合は、ここにフォルダー名を入力します。 |
|
|
圧縮
|
Compress | boolean |
ZIP ファイル作成時にフォルダーを圧縮しますか? |
|
|
既存の ZIP ファイルに追加する
|
AddToExistingZIPFile | boolean |
既存の ZIP ファイルに追加する場合は True に設定します。 |
|
|
サブフォルダーを含める
|
IncludeSubfolders | boolean |
ソース フォルダー内のサブフォルダーも ZIP に追加しますか? |
|
|
ファイルの正規表現を含める
|
IncludeFilesRegEx | string |
抽出するファイルを指定するためのオプションの正規表現です。 ファイル名のみ一致。 |
|
|
ファイルの正規表現を除外する
|
ExcludeFilesRegEx | string |
抽出から除外するファイルを指定するためのオプションの正規表現です。 ファイル名のみ一致。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
正常に追加されたファイルの数
|
FilesAddedSuccessfully | integer |
ZIP に正常に追加されたファイルの数。 |
|
除外するファイルの数
|
FilesExcluded | integer |
除外されたファイルの数 ('ファイルの正規表現を除外する' 入力を使用している場合)。 |
すべての IA-Connect コマンド統計を取得する
現在のセッションで IA-Connect Agent が実行したコマンドに対して現在格納されている統計をすべて返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド統計 JSON
|
CommandStatsJSON | string |
JSON 形式での、現在のセッションで IA-Connect Agent が実行したコマンドの一覧。 この一覧には、各アクションの名前と実行された回数が含まれます。 |
アクセス許可をファイルに追加する
IA-Connect Agent を実行しているコンピューター上のファイルにアクセス許可を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
FilePath | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ID
|
Identity | True | string |
アクセス許可を割り当てるユーザーまたはグループの ID。 これは 'ユーザー名'、'DOMAIN\username'、または 'username@domainfqdn' の形式で指定できます。 |
|
Permission
|
Permission | True | string |
割り当てるアクセス許可 (読み取り、読み取りと実行、変更、全権限) を指定するか、または空白のままにして既定 (読み取り) に設定します。 |
|
拒否
|
Deny | boolean |
アクセス許可が拒否されていますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
アクセス許可をフォルダーに追加する
IA-Connect Agent を実行しているコンピューター上のフォルダーにアクセス許可を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Folder path
|
FolderPath | True | string |
フォルダーへのフル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ID
|
Identity | True | string |
アクセス許可を割り当てる ID (例: ユーザー、グループまたはコンピューターなど)。 これは 'ユーザー名'、'DOMAIN\username'、または 'username@domainfqdn' の形式で指定できます。 |
|
Permission
|
Permission | True | string |
割り当てるアクセス許可 (読み取り、読み取りと実行、変更、全権限) を指定するか、または空白のままにして既定 (読み取り) に設定します。 |
|
フォルダーに適用
|
ApplyToFolder | boolean |
アクセス許可をフォルダー自体に適用しますか? |
|
|
サブフォルダーに適用
|
ApplyToSubFolders | boolean |
アクセス許可をサブフォルダーに伝播しますか? |
|
|
ファイルに適用
|
ApplyToFiles | boolean |
フォルダー内のファイルにアクセス許可を適用しますか? |
|
|
拒否
|
Deny | boolean |
アクセス許可が拒否されていますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
オーケストレーター フローを取得する
IA-Connect オーケストレーターからフロー統計のリストを返します。 レポート目的で使用されます。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
過去数日以内
|
WithinLastNumberOfDays | integer |
結果をフィルターして、最後に指定した日数以内に開始した結果のみを取得します。 フィルターしない場合は 0 に設定します。 |
|
|
フロー名
|
SearchFlowName | string |
結果をフィルターして、指定されたフロー名を持つ結果のみを取得します。 フロー名でフィルターしない場合は、空白に設定します。 |
|
|
フローの最後のアクションの結果
|
SearchFlowLastActionResult | boolean |
結果をフィルターして、指定された前回のアクション結果のみを取得します。 成功したフローのみを取得するには、true に設定します。 失敗したフローのみを取得するには、false に設定します。 フローの最後のアクションの結果でフィルターしないように、値を設定しない/空白に設定します。 |
|
|
フロー開始時間の開始ウィンドウ
|
SearchFlowStartTimeStartWindow | date-time |
結果をフィルターして、指定した開始時刻以降に開始した結果のみを取得します。 フィルターしない場合は空白に設定します。 例: '2022-01-24T07:00:00' は、2022 年 1 月 24 日の 07.00 時間以降に開始されたフローのすべてのオーケストレーター フロー統計を返します。 日時はすべて UTC (GMT+0) で表すため、Convert DateTime アクションによってローカル時間を UTC に変換することをお勧めします。 |
|
|
フロー開始時間の終了ウィンドウ
|
SearchFlowStartTimeEndWindow | date-time |
結果をフィルターして、指定した開始時刻前に開始した結果のみを取得します。 フィルターしない場合は空白に設定します。 例: '2022-01-25T07:00:00' は、2022 年 1 月 25 日の 07.00 時間前に開始されたフローのすべてのオーケストレーター フロー統計を返します。 日時はすべて UTC (GMT+0) で表すため、Convert DateTime アクションによってローカル時間を UTC に変換することをお勧めします。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
オーケストレーター フロー統計の JSON
|
OrchestratorFlowStatsJSON | string |
すべてのオーケストレーター フロー統計のリスト (JSON 形式)。 |
|
フロー統計の件数
|
NumberOfOrchestratorFlowStats | integer |
返されたフロー統計の件数。 |
オーケストレーター フロー統計から最後に失敗したアクションを取得する
IA-Connect オーケストレーションを通じて Worker に渡した最後のアクションが失敗した場合、その詳細を取得します。 このアクションは、エラー処理中に最も一般的に使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Worker がフロー実行に割り当てられている
|
WorkerAllocatedToFlowRun | boolean |
このフロー実行に Worker が割り当てられている場合は true を返します。そのため、最後のアクション エラーに関する情報を提供できます。 このフロー実行に Worker が割り当てらていない (Worker が 1 つも割り当てられていないか、Worker が別のフロー実行で使用できるようになている場合) ため、最後のエラーに関する情報を提供できない場合は false を返します。 |
|
最後のアクションが失敗
|
LastActionFailed | boolean |
このフロー実行の最後のアクション (このフロー実行に割り当てられたワーカー上で実行されるアクション) が失敗した場合は true を返します。このアクションからの他の出力に詳細が保持されます。 このフロー実行の最後のアクションが失敗しなかった場合は false を返します。他の出力は空白になります。 |
|
最後に失敗したアクション要求のパス
|
LastFailedActionRequestPath | string |
このフロー実行の最後のアクション (このフロー実行に割り当てられた Worker 上で実行されるアクション) が失敗した場合、この出力にアクション要求のパスが含まれます。 これを使用して、どのアクションが失敗したかを判断できます。 このフロー実行の最後のアクションが失敗しなかった場合、この値は空白になります。 |
|
最後に失敗したアクションのエラー メッセージ
|
LastFailedActionErrorMessage | string |
このフロー実行の最後のアクション (このフロー実行に割り当てられた Worker 上で実行されるアクション) が失敗した場合、この出力にエラー メッセージが含まれます。 このフロー実行の最後のアクションが失敗しなかった場合、この値は空白になります。 |
オーケストレーター フロー統計結果を更新する
IA-Connect オーケストレーターの現在のワーカーフローの結果統計を更新します。 これは、IA-Connect オーケストレータのフロー統計の最終結果を変更するために使用されます。これは通常、レポートの目的で使用されます。 これは現在のフローに対してのみ機能します (オーケストレーターはフロー実行 ID を検出します)。 他のフローの統計を変更することはできません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フローの最後のアクションの成功
|
FlowLastActionSuccess | boolean |
true に設定すると、オーケストレーター フロー統計の最後のアクションが成功することを指定します。 false に設定すると、オーケストレーター フロー統計の最後のアクションが失敗することを指定します。 フローの最後のアクションのステータスを更新しない場合は、このフィールドを空白のままにします (例: 最後のアクション コードのみを更新する場合)。 |
|
|
フローの最後のアクションのエラー メッセージ
|
FlowLastActionErrorMessage | string |
フローの最後のアクションが失敗したと指定する場合は、ここにエラー メッセージを入力します。 |
|
|
フローの最後のアクション コード
|
FlowLastActionCode | integer |
フロー統計に割り当てるオプションのコード。これは通常、エラー コード (例: システムとビジネスの例外を区別する) として使用しますが、成功コードとしても使用できます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
UpdateOrchestratorFlowStatsResultResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
オーケストレーターからログイン履歴を取得する
レポート目的で IA-Connect オーケストレーターのログイン履歴を返します。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
過去数日以内
|
WithinLastNumberOfDays | integer |
結果をフィルターして、指定した日数内のオーケストレーターのログインのみを取得します。 フィルターしない場合は 0 に設定します。 |
|
|
電子メールアドレス
|
SearchByEmail | string |
結果をフィルターして、指定したメール アドレスでのオーケストレーターのログインのみを取得します。 メール アドレスでフィルターしない場合は、空白に設定します。 |
|
|
開始時間枠のログイン履歴
|
SearchLoginHistoryTimeStartWindow | date-time |
結果をフィルターして、指定した開始時刻以降のオーケストレーターのログインのみ取得します。 フィルターしない場合は空白に設定します。 例: 「2022-01-24T07:00:00」の場合、2022 年 1 月 24 日の 07.00 後のすべてのオーケストレーターのログインを返します。 日時はすべて UTC (GMT+0) で表すため、Convert DateTime アクションによってローカル時間を UTC に変換することをお勧めします。 |
|
|
終了時間枠のログイン履歴
|
SearchLoginHistoryTimeEndWindow | date-time |
結果をフィルターして、指定した開始時刻前のオーケストレーターのログインのみを取得します。 フィルターしない場合は空白に設定します。 例: 「2022-01-25T07:00:00」の場合、2022 年 1 月 25 日の 07.00 前のすべてのオーケストレーターのログインを返します。 日時はすべて UTC (GMT+0) で表すため、Convert DateTime アクションによってローカル時間を UTC に変換することをお勧めします。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
オーケストレーターのログイン履歴 JSON
|
OrchestratorLoginHistoryJSON | string |
指定されたフィルターを満たす、JSON形式のすべてのオーケストレーターのログインのリスト。 |
|
オーケストレーターのログイン数
|
NumberOfOrchestratorLogins | integer |
オーケストレーターのログイン数が返されます。 |
オーケストレーターからワーカー フローの使用ヒートマップを取得する
IA-Connect オーケストレーターからワーカー フロー使用の日時ヒートマップを返します。 レポート目的で使用されます。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フロー開始時間の開始ウィンドウ
|
SearchStartDateStartWindow | True | date-time |
結果をフィルタリングして、指定された開始日以降のワーカー フローの使用ヒートマップのみを取得します (時間コンポーネントは無視されます)。 フィルターしない場合は空白に設定します。 例: '2022-01-24T00:00:00' は、2022 年 1 月 24 日以降に開始されたフローのワーカー ヒートマップを返します。 日時はすべて UTC (GMT+0) で表すため、Convert DateTime アクションによってローカル時間を UTC に変換することをお勧めします。 |
|
フロー開始時間の終了ウィンドウ
|
SearchStartDateEndWindow | True | date-time |
結果をフィルタリングして、指定された開始日以前のワーカー フローの使用ヒートマップのみを取得します (時間コンポーネントは無視されます)。 フィルターしない場合は空白に設定します。 例: '2022-01-25T00:00:00' は、2022 年 1 月 25 日以降に開始されたフローのワーカー ヒートマップを返します。 日時はすべて UTC (GMT+0) で表すため、Convert DateTime アクションによってローカル時間を UTC に変換することをお勧めします。 |
|
Time zone minutes offset from UTC
|
TimeZoneMinutesOffsetFromUTC | integer |
毎日のヒートマップを調整するための UTC からのタイム ゾーン オフセット (分単位)。 例: 60 分を指定すると、毎日のヒートマップは 01:00 UTC から 01:00 UTC まで実行されます。 |
|
|
IA-Connect 作業者名
|
WorkerNames | string |
ヒートマップを返す IA-Connect ワーカーの名前のリスト (JSON または CSV 形式)。 空白のままにすると、オーケストレーターが現在認識しているすべてのワーカーのヒートマップが生成されます。 例: [{"WorkerName": "Worker1"}、{"WorkerName": "Worker2"}] (JSON 形式) または Worker1,Worker2 (CSV 形式)。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Worker flow usage heatmap JSON
|
WorkerFlowUsageHeatmapJSON | string |
JSON 形式のワーカー フロー使用ヒートマップ。 |
|
Number of worker flow usage heatmap items
|
NumberOfWorkerFlowUsageHeatmapItems | integer |
返されたワーカー フロー使用ヒートマップアイテムの数。 労働者 1 人につき 1 日 1 アイテム。 |
オーケストレーターからワーカーの可用性統計を取得する
IA-Connect オーケストレーターからワーカーの可用性を返します。 レポート目的で使用されます。 オプションで、1 つ以上のフィルターを使用して、返される結果を制限できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
過去数日以内
|
WithinLastNumberOfDays | integer |
結果をフィルターして、最後に指定した日数以内に開始した結果のみを取得します。 フィルターしない場合は 0 に設定します。 |
|
|
フロー名
|
SearchFlowName | string |
結果をフィルターして、指定されたフロー名を持つ結果のみを取得します。 フロー名でフィルターしない場合は、空白に設定します。 |
|
|
フロー開始時間の開始ウィンドウ
|
SearchFlowStartTimeStartWindow | date-time |
結果をフィルターして、指定した開始時刻以降に開始した結果のみを取得します。 フィルターしない場合は空白に設定します。 例: '2022-01-24T07:00:00' は、2022 年 1 月 24 日の 07.00 時間以降に開始されたフローのすべてのオーケストレーター フロー統計を返します。 日時はすべて UTC (GMT+0) で表すため、Convert DateTime アクションによってローカル時間を UTC に変換することをお勧めします。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Worker availability stats JSON
|
WorkerAvailabilityStatsJSON | string |
ワーカーの可用性統計のリスト (JSON 形式)。 |
|
Number of worker availability stats
|
NumberOfWorkerAvailabilityStats | integer |
返されたワーカー可用性統計の件数。 |
オーケストレーターから汎用資格情報を取得する
IA-Connect オーケストレーターに保存されている汎用資格情報を取得します。 資格情報には、ユーザー名、パスワード、ホスト名、URL、その他の一般的なデータを保持できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フレンドリ名
|
FriendlyName | string |
オーケストレーターに保存されている資格情報のフレンドリ名。 |
|
|
プレーン テキストのパスワードの取得
|
RetrievePlainTextPassword | boolean |
オンにすると、Orchestratorの汎用資格情報設定の [パスワードを公開しない] が無効になっている場合 (パスワードの取得が許可されている場合)、指定されたOrchestratorの汎用資格情報のパスワードがプレーン テキストとして返されます。 パスワードをプレーン テキストとして取得するのではなく、オーケストレーターは実行時にパスワードをアクションに直接挿入する、保存されたパスワードをサポートする IA-Connect アクション (たとえば、'Input password into UIA action') を使用することをお勧めします。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Username
|
Username | string |
汎用資格情報に保持されているユーザー名。 |
|
プレーン テキストのパスワード
|
PlainTextPassword | string |
汎用資格情報に保持されているパスワード。 オーケストレーターのパスワードは暗号化されて保存されますが、パスワードを必要とするアクションに渡すことができるようにプレーン テキストとして返されます。 |
|
Host name
|
Hostname | string |
汎用資格情報に保持されているホスト名またはドメイン名(使用されている場合)。 |
|
[URL]
|
Url | string |
汎用資格情報に保持されている URL (使用している場合)。 |
|
汎用プロパティ 1
|
GenericProperty1 | string |
汎用資格情報に保持される汎用プロパティ (使用されている場合)。 これは、資格情報に関連付けられている可能性のあるデータを格納するために使用できます。 |
|
汎用プロパティ 2
|
GenericProperty2 | string |
汎用資格情報に保持される汎用プロパティ (使用されている場合)。 これは、資格情報に関連付けられている可能性のあるデータを格納するために使用できます。 |
|
汎用プロパティ 3
|
GenericProperty3 | string |
汎用資格情報に保持される汎用プロパティ (使用されている場合)。 これは、資格情報に関連付けられている可能性のあるデータを格納するために使用できます。 |
オーケストレーター自動化タスクの状態を変更する
選択したオーケストレーター自動化タスクの状態を、完了、失敗、新規のいずれかに変更します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
TaskId | True | integer |
変更するオーケストレーター自動化タスクの ID。 |
|
自動化タスクの新しい状態
|
AutomationTaskStatus | string |
指定した自動化タスクの新しいタスク状態。 |
|
|
タスクを保留する
|
TaskOnHold | boolean |
状態を新規に変更し、この値を true に設定すると、タスクを保留します。 |
|
|
タスク入力データを消去する
|
EraseTaskInputData | boolean |
この値を true に設定すると、タスク入力データはすべて消去されます。 通常は、生データが不要になったあと、完了または失敗したタスクのストレージ領域を節約するために、これを使用します。 |
|
|
格納した延期データを消去する
|
EraseDeferralStoredData | boolean |
この値を true に設定すると、延期された保存データはすべて消去されます。 通常は、生データが不要になったあと、完了または失敗したタスクのストレージ領域を節約するために、これを使用します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
TasksChangeTaskStatusResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
オーケストレーター自動化タスクをすべて取得する
フィルターと一致するオーケストレーター自動化タスクをすべて取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
自動化名のフィルター
|
AutomationName | string |
任意の名前でオーケストレーター自動化タスクを返すには、空白のままにします。 この自動化名を持つタスクのみを取得するには、値を入力します。 |
|
|
自動化タスクの状態フィルター
|
AutomationTaskStatus | string |
指定した自動化タスク ステータスによって自動化をフィルターします。 すべての自動化タスクのステータスを返すには、フィールドを空白のままにします。 |
|
|
遅延日までの時間 (分)
|
MinutesUntilDeferralDate | integer |
指定された分数以内に実行する準備ができているオーケストレーター自動化タスクのみを返します。 今すぐ実行できる自動化タスクのみが必要な場合は、0 に設定します。 延期に関係なくタスクを取得する場合は、空白のままにします。 |
|
|
最小優先度レベル
|
MinimumPriorityLevel | integer |
指定された優先度レベル以上のオーケストレーター自動化タスクのみを返します。 例: 設定 2 は、優先度レベル 1 および 2 のタスクを返します。 |
|
|
延期日で並べ替える
|
SortByDeferralDate | boolean |
true に設定すると、延期日時順に並べ替えられたデータが返されます。 false に設定すると、データが保存されている順序で返されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
自動化タスク
|
AutomationTasks | array of object |
指定した検索条件を満たす、すべてのオーケストレーター自動化タスクを含むテーブル。 |
|
品目
|
AutomationTasks | object | |
|
自動化タスクの件数
|
NumberOfAutomationTasks | integer |
返された自動化タスクの件数。 |
オーケストレーター自動化タスクを削除する
延期したオーケストレーター自動化タスクを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
TaskId | True | integer |
削除するオーケストレーター自動化タスクの ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
TasksDeleteTaskResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
オーケストレーター自動化タスクを取得する
特定のオーケストレーション自動化タスクを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
TaskId | True | integer |
取得するオーケストレーター自動化タスクの ID。 |
|
状態を次に変更する
|
StatusChange | string |
'取得済み' に設定した場合: タスクを取得すると、他のアクションが同じタスクを実行しないように、タスクの状態を '取得済み' に変更します。 'なにもしない' に設定すると、タスクの状態を変更しません。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
自動化名
|
AutomationName | string |
取得したオーケストレーター タスクの名前。 |
|
遅延日時
|
DeferralDateTime | string |
取得したオーケストレーター タスクの準備完了がスケジュールされている日時。 これは UTC 形式の文字列として返されます。 |
|
保存済み遅延データ
|
DeferralStoredData | string |
タスクが延期されたときに保存されたオプションのデータ。 これは通常、プロセス/フローを続行するために必要なデータです。 |
|
遅延回数
|
DeferralCount | integer |
このタスクが延期された頻度。 これは通常、延期されなかった新しいタスクの場合は 0、延期されたタスクの場合は 1 以上になります。 延期されたタスクが再び延期されるたびに、オーケストレーターはこの数を自動的に増やします。 |
|
タスク入力データ
|
TaskInputData | string |
タスクが作成されたときに保存されたオプションのデータ。 このデータは通常、プロセス/フローを開始するのに使用されますが、このフィールドを任意の目的に使用できます。 |
|
優先順位
|
Priority | integer |
このオーケストレーター タスクの優先度レベルです (最高レベルは 1)。 |
|
自動化タスクの状態
|
AutomationTaskStatus | string |
取得したオーケストレーター タスクの状態です。 |
|
プロセス ステージ
|
ProcessStage | string |
延期後に自動化プロセス/フローを継続するポイント。 これは、特定のプロセス/フローに固有のオプションの文字列値です。 これは、次に実行するステップを決定するために、延期されたプロセス/フロー内の条件によって使用されます。 次に例を示します。延期後に継続する際、プロセス/フローを [Exchange] ステージで継続する場合は、値 'Exchange' を入力します。 |
|
受信日時
|
ReceivedDateTime | string |
オーケストレーターが最初にタスクを受信した日時。 これは UTC 形式の文字列として返されます。 |
|
遅延日までの時間 (分)
|
MinutesUntilDeferralDate | integer |
このタスクの延期日までの分数 (つまり、このタスクを実行する準備ができたとき)。 このタスクを実行する準備ができている場合、分は 0 になります。 |
|
保留中
|
OnHold | boolean |
タスクが保留中の場合は true に設定されます。 古い保留中のタスクは、'次のオーケストレーター自動化タスクを取得する' アクションで取得されないため、通常のワークフローでは処理されません。 |
キー イベントを送信する
グローバル キー押下イベントを IA-Connect Agent ユーザー セッションに送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Text
|
Text | True | string |
送信するテキスト。 |
|
間隔 (ミリ秒)
|
Interval | integer |
各キー押下イベント間のミリ秒数。 |
|
|
Is password
|
IsPassword | boolean |
パスワード値を入力するか? その場合は、代替の 'パスワード キー イベントの送信' アクションを使用する必要があります。 |
|
|
記号を解釈しない
|
DontInterpretSymbols | boolean |
テキスト内の記号を特殊キー (例: {SHIFT} は Shift、{CTRL} は Ctrl など) として解釈しないようにしますか? 実際の記号を入力する場合は、これを true に設定する必要があります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
キーを送信する
グローバル キー押下を IA-Connect Agent ユーザー セッションに送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Text
|
Text | True | string |
送信するテキスト。 |
|
間隔 (ミリ秒)
|
Interval | integer |
各キー押下間のミリ秒数。 |
|
|
Is password
|
IsPassword | boolean |
パスワード値を入力するか? その場合は、代替の 'パスワード キーの送信' アクションを使用する必要があります。 |
|
|
記号を解釈しない
|
DontInterpretSymbols | boolean |
テキスト内の記号を特殊キー (例: Shift は +、Ctrl は ^ など) として解釈しないようにしますか? 実際の記号を入力する場合は、これを true に設定する必要があります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
クライアントからサーバーにファイルをコピーする
(IA-Connect Director を実行している) ローカル コンピューター から (IA-Connect Agent を実行している) リモート コンピューターにファイルをコピーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
クライアント ファイルのパス
|
ClientFilePath | True | string |
ファイルのコピー元のファイル パス (IA-Connect Director を実行しているローカル コンピューター上)。 |
|
サーバー ファイルのパス
|
ServerFilePath | True | string |
ファイルのコピー先のファイル パス (IA-Connect Agent を実行しているローカル コンピューター上)。 |
|
圧縮
|
Compress | boolean |
コピー時にファイルを圧縮しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
クライアントのホスト名を取得する
IA-Connect Director が実行しているクライアントのホスト名を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
クライアントのホスト名
|
ClientHostname | string |
IA-Connect Director が実行しているクライアントのホスト名。 |
クリップボードをクリア
IA-Connect Agent のユーザー セッションで、クリップボードのコンテンツをクリアします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
クリップボードを取得する
IA-Connect Agent ユーザー セッションでクリップボードの現在コンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
クリップボード データ
|
ClipboardData | string |
クリップボードに含まれているデータ。 |
クリップボードを設定する
IA-Connect Agent ユーザー セッションでクリップボードのコンテンツを設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
新しいクリップボード データ
|
NewClipboardData | string |
クリップボードに設定するデータ。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
コンピューター ドメインを取得する
IA-Connect Agent ユーザー セッションを実行しているコンピューターのドメインを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ドメイン名
|
DomainName | string |
IA-Connect Agent ユーザー セッションを実行しているコンピューターの NetBIOS ドメイン名前。 |
|
DNS ドメイン名
|
DNSDomainName | string |
IA-Connect Agent ユーザー セッションを実行しているコンピューターの DNS ドメイン名。 |
コンピューター名を取得する
IA-Connect Agent ユーザー セッションを実行しているコンピューターの名前を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コンピューター名
|
MachineName | string |
IA-Connect Agent ユーザー セッションを実行しているコンピューターの名前。 |
スクリーン リーダーが有効
IA-Connect Agent ユーザー セッションでスクリーン リーダーが有効になっているかどうかを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
スクリーン リーダーが有効
|
ScreenReaderEnabled | boolean |
スクリーン リーダーが有効になっている場合は true を返します。 |
スクリーン リーダーを設定する
IA-Connect Agent ユーザー セッションでスクリーン リーダーを有効または無効にします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
スクリーン リーダーを有効にする
|
EnableScreenReader | boolean |
true に設定すると、スクリーン リーダーが有効になります。 false に設定すると、スクリーン リーダーは無効になります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
スクリーンショットを取得する
IA-Connect Agent ユーザー セッションのスクリーンショットを取得し、Base64 でエンコードされた文字列として返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
全画面表示
|
Fullscreen | boolean |
スクリーンショットを画面全体に含めますか? |
|
|
左の X ピクセル数
|
LeftXPixels | integer |
画面全体のスクリーンショットを取得しない場合は、スクリーンショットの開始位置からの X 値 (ピクセル単位) になります。 単一ディスプレイでは、左端の X ピクセルは 0 です。 マルチ モニター ディスプレイでは、左端の X ピクセルが負になる可能性があります (どのディスプレイがプライマリとしてマークされているか、および他のディスプレイとの相対位置に応じます)。 |
|
|
上部の Y ピクセル数
|
TopYPixels | integer |
画面全体のスクリーンショットを取得しない場合は、スクリーンショットの開始位置からの Y 値 (ピクセル単位) になります。 単一ディスプレイでは、上端の Y ピクセルは 0 です。 マルチ モニター ディスプレイでは、上端の Y ピクセルが負になる可能性があります (どのディスプレイがプライマリとしてマークされているか、および他のディスプレイとの相対位置に応じます)。 |
|
|
幅のピクセル数
|
WidthPixels | integer |
画面全体のスクリーンショットを取得しない場合は、開始位置からのスクリーンショットの幅になります。 |
|
|
高さのピクセル数
|
HeightPixels | integer |
画面全体のスクリーンショットを取得しない場合は、開始位置からのスクリーンショットの高さになります。 |
|
|
イメージの形式
|
ImageFormat | string |
イメージ形式 (PNG、JPG、BMP、または GIF) を指定します。 |
|
|
ディスプレイ デバイスを使用する
|
UseDisplayDevice | boolean |
IA-Connect Agent はディスプレイ デバイスの情報を考慮する必要がありますか? これは DPI スケールでより適切に機能し、複数のディスプレイのサポートを提供します。 |
|
|
エラー時に例外を発生する
|
RaiseExceptionOnError | boolean |
true に設定した場合: IA-Connect Agent は、スクリーンショットが失敗した場合 (たとえば、セッションがロックされている場合) に例外を発生します。 false に設定した場合: IA-Connect は、スクリーンショットが失敗した場合に空のビットマップを返し、「スクリーンショット成功」および「スクリーンショット エラー メッセージ」出力を投入します。 |
|
|
Agent を非表示にする
|
HideAgent | boolean |
true に設定すると、Agent (表示されている場合) が自動的に非表示になり、スクリーンショットが隠されないようになります。 |
|
|
物理座標を使用する
|
UsePhysicalCoordinates | boolean |
提供された座標が物理座標であることを指定するには、true に設定します (DPI スケールされていないため、ディスプレイ上の物理ピクセルと一致します)。 指定された座標が仮想座標 (DPI スケールされている) であることを指定するには、false (デフォルト) に設定します。 UIA、Java、および Web アクションは通常、仮想座標を使用します。 |
|
|
ディスプレイ デバイス ID
|
DisplayDeviceId | integer |
この入力は、「ディスプレイ デバイスを使用する」入力が true に設定されている場合にのみ機能します。 すべてのモニターを含めるには、0 (デフォルト) に設定します。 プライマリ モニターのみを含めるには、1 に設定します。 関連するセカンダリ モニターのみを含めるには、2 以上に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Base64 としての画面イメージ
|
ScreenBitmapBase64 | string |
Base64 でエンコードされた文字列としての画面イメージ。 これは、提供されているユーティリティ「Base64 からビットマップへ」を使用して表示できます。 |
|
スクリーンショットが成功
|
ScreenshotSuccessful | boolean |
スクリーンショットが成功した場合は true に設定します。 スクリーンショットが失敗し、「エラー時に例外を発生する」が false に設定された場合は、false に設定します。 スクリーンショットが失敗し、「エラー時に例外を発生させる」が true に設定されていた場合は、例外が発生します。 |
|
スクリーン ショットのエラー メッセージ
|
ScreenshotErrorMessage | string |
スクリーンショットが失敗し、「エラー時に例外を発生させる」が false に設定されていた場合、この出力フィールドにはエラー メッセージが保持されます。 これは、「エラー時に例外を発生させる」を true に設定の代替で、スクリーンショットの実行中にエラーが発生した場合に例外が発生します。 |
セッションのアクティブ状態を停止する
IA-Connect Agent ユーザー セッションのアクティブ状態を停止します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
StopKeepSessionAliveResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
セッションはロックされたか
IA-Connect Agent が実行されているセッションがロックされているかどうかを報告します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Session is locked
|
SessionIsLocked | boolean |
IA-Connect Agent が実行されているセッションがロックされている場合は true に設定します。 |
セッションをアクティブ状態に維持する
指定した間隔でマウスを移動して、セッションがアイドル状態になるのを防ぐことで、IA-Connect Agent ユーザー セッションをアクティブに維持します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ウィグル
|
XWiggle | integer |
マウスを水平方向に移動する際のピクセル数。 |
|
|
Y ウィグル
|
YWiggle | integer |
マウスを垂直方向に移動する際のピクセル数。 |
|
|
ウィグルの遅延 (秒)
|
WiggleDelayInSeconds | double |
ウィグル時のマウスの移動間の秒数。 |
|
|
アイドルしきい値 (秒)
|
IdleThresholdInSeconds | integer |
マウスを移動する前に最後の入力から経過した時間の秒数。 |
|
|
アイドル チェック期間 (秒)
|
IdleCheckPeriodInSeconds | integer |
最後の入力時間を確認する間隔の秒数 (アイドルしきい値を超えているかどうかを確認します)。 |
|
|
合計キープアライブ ランタイム (秒)
|
TotalKeepaliveRuntimeInSeconds | integer |
セッションをアクティブに維持する時間の合計秒数。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
KeepSessionAliveResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
セッションをロックする
IA-Connect Agent が実行しているセッションをロックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Lock after minutes of action inactivity
|
LockAfterMinutesOfActionInactivity | integer |
0 より大きい値に設定すると、エージェントはすぐにはロックされませんが、指定された分数の非アクティブなアクション (エージェントがアクションを受信しない) の後にロックされます。 これにより、多くのフローが連続して実行されている場合に、エージェントが継続的にロックおよびロック解除するのを防ぎます。 0 に設定すると、すぐにロックされます。 既定値は 5 分です。 |
|
|
Seconds to wait after lock
|
SecondsToWaitAfterLock | integer |
ロッキング後、指定された秒数待機します。 これにより、セッションが完全にロックされる時間が与えられます。 これは通常、ロックの直後にロック解除イベント (つまり、別のセッションの開始) が発生する可能性が予想される場合に使用されます。前のセッションがまだロックされている場合は失敗する可能性があります。 'アクションの非アクティブ時間後にロック' が 0 に設定されている場合にのみ使用されます (即時ロックが発生します)。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
LockSessionResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
セッションをロック解除する
IA-Connect Agent が実行しているセッションをロック解除します。 Credential Provider のみがコンピューターのロック解除できるため、セッションをホストしているコンピューターに IA-Connect Unlocker Credential Provider をインストールする必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Unlock password
|
UnlockPassword | True | string |
現在のセッションをロックを解除するためのパスワード。 これは、現在ロックされているセッションにログインしているアカウントの Windows ユーザー パスワードです。 '保存された' パスワードの場合は、{IAConnectPassword:StoredPasswordIdentifier} の形式で入力し、'保存されているパスワード' を true に設定します。 これがオーケストレーターが生成した資格情報の場合、{OrchestratorCredential:FriendlyName} の形式で入力し、'保存されているパスワード' を true に設定します。 |
|
保存されたパスワードを含むパスワード
|
PasswordContainsStoredPassword | boolean |
パスワードが IA-Connectに 保存されたパスワード識別子 (例:「パスワードを生成する」アクションによって生成される) または IA-Connect オーケストレーターの汎用資格情報 (例: PA フローで IA-Connect を使用する場合) の場合は true に設定します。 |
|
|
Detect if locked
|
DetectIfLocked | True | boolean |
IA-Connect Agent は、セッションがロックされているかどうかを検出しようとする必要があります。 true に設定されていて、セッションがロックされていることが検出されない場合、このアクションは単に何もしません (何もできないため)。 IA-Connect がセッションがロックされているかどうかを誤って検出し、強制的にロック解除を試みたい場合 (セッションがロックされていないと失敗します) にのみ、false に設定します。 |
|
Detect Credential Provider
|
DetectCredentialProvider | True | boolean |
ロック解除要求を送信する前に、IA-Connect Agent が IA-Connect Unlocker Credential Provider の存在を検出しようとする必要があります。 IA-Connect Credential Provider が存在して実行されているが、何らかの理由で IA-Connect Agent がそれを検出しない場合にのみ、これを無効にする必要があります。 |
|
Seconds to wait for unlock
|
SecondsToWaitForUnlock | integer |
IA-Connect Agent が (デスクトップのロック解除状態の検出によって) デスクトップが正常にロック解除されたというエビデンスを待機する時間 (秒単位) です。 既定では、これは最大で 5 秒です。 0 に設定すると、この機能が無効になり、デスクトップがロック解除されたことを確認せずに続行します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Session unlock performed
|
SessionUnlockPerformed | boolean |
セッションがロックされていて、ロック解除アクションが実行された場合は、true に設定します。 セッションがロックされておらず、'Detect if locked' が true に設定されている場合は、false に設定するとアクションは実行されません。 |
テキスト ファイルを書き込む
IA-Connect Agent を実行しているコンピューター上にテキスト ファイルを作成し、テキストをファイルに書き込みます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
Filename | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
書き込むテキスト
|
TextToWrite | string |
ファイルに書き込むテキスト コンテンツ。 |
|
|
既存のファイルの追加
|
AppendExistingFile | boolean |
ファイルが既に存在する場合、書き込む新しいテキストを既存のファイルの末尾に追加しますか? |
|
|
エンコード
|
Encoding | string |
ファイルのエンコード (Unicode、UTF8、UTF7、または ASCII) を指定するか、既定 (UTF8) の場合は空白のままにします。 |
|
|
必要な場合はフォルダーを作成
|
CreateFolderIfRequired | boolean |
'ファイル パス' パラメーターに指定された、ファイルを格納するためのフォルダーが存在しない場合、このフォルダーを作成しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ディスクの空き領域を取得する
IA-Connect Agent を実行しているコンピューター上の、指定したディスクの空き領域の容量を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドライブ文字
|
DriveLetter | True | string |
確認するディスクのドライブ文字。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ディスクの空き領域バイト数
|
FreeSpaceBytes | integer |
空きディスク領域の容量 (バイト数)。 |
|
ディスクの空き領域 KB
|
FreeSpaceKB | integer |
空きディスク領域の容量 (キロバイト数)。 |
|
ディスクの空き領域 MB
|
FreeSpaceMB | integer |
空きディスク領域の容量 (メガバイト数)。 |
|
ディスクの空き領域 GB
|
FreeSpaceGB | integer |
空きディスク領域の容量 (ギガバイト数)。 |
ディレクター クライアント タイプとセッション情報を取得する
ティア 1 ディレクターによって処理されているローカルまたはリモート セッションの詳細を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
リモート クライアント タイプ
|
RemoteClientType | string |
リモート クライアント タイプ (「ローカル」、「Citrix ICA」、または「Microsoft RDP」)。 |
|
仮想チャネルを接続する
|
VirtualChannelConnected | boolean |
Director と Agent の間で仮想チャネルを接続する場合は true。 |
|
Director バージョン
|
DirectorVersion | string |
IA-Connect Director DLL のバージョン。 例: 1.67.21.0。 |
|
Director リリース バージョン
|
DirectorReleaseVersion | string |
IA-Connect Director の IA-Connect リリース バージョン。 例: 9.4。 |
|
エージェントのバージョン
|
AgentVersion | string |
この Director が接続されている IA-Connect Agent EXE のバージョン。 例: 1.74.21.0。 |
|
Agent リリース バージョン
|
AgentReleaseVersion | string |
この Director が接続されている IA-Connect Agent の IA-Connect リリース バージョン。 例: 9.4。 |
|
Agent はライセンスされている
|
AgentIsLicensed | boolean |
この Director が接続されている IA-Connect Agent がライセンスされている場合は true。 IA-Connect Agent がライセンスされていない場合は false。 Agent のライセンス状態が不明な場合は null。 |
|
Agent ライセンス機能
|
AgentLicenseFeatures | string |
この Director が接続されている IA-Connect Agent に割り当てられてた IA-Connect ライセンス機能のカンマ区切りのリスト。 例: JML, DEV。 |
|
Director のホスト名
|
DirectorHostname | string |
Director が実行されているコンピューターのホスト名。 例: vmrpa1。 |
|
Director の NetBIOS ドメイン名
|
DirectorNetBIOSDomainName | string |
Director が実行されているコンピューターの NetBIOS ドメイン名。 例: domain1。 コンピュータがドメインのメンバーではない場合、通常はホスト名が返されます。 |
|
Director の DNS ドメイン名
|
DirectorDNSDomainName | string |
Director が実行されているコンピューターの DNS ドメイン名。 例: domain1.myorg.local。 コンピュータがドメインのメンバーではない場合、通常はホスト名が返されます。 |
|
ネクスト ホップ Director に接続されている
|
AttachedToNextHopDirector | boolean |
IA-Connect セッションが現在、この Director が接続されている Agent に接続されている場合は、false に設定します。 Director がすべてのアクション (接続されている) を別の Director (別の Agent に接続されている) に転送している場合は、true に設定します。 たとえば、この Director はローカル Agent と通信しているローカル Director ですが、IA-Connect セッションが現在 Citrix に接続されている場合、この値は true になります。 |
|
ネクスト ホップの Director セッションタイプ
|
NextHopDirectorSessionType | string |
この Director がネクスト ホップ ディレクターに接続されている場合、この値はネクスト ホップ セッション タイプを保持します。 たとえば、この Director はローカル Agent と通信するローカル Director ですが、IA-Connect セッションが現在 Citrix に接続されている場合、この値は「Citrix ICA」になります。一方、「リモート クライアント タイプ」の値は「ローカル」になります (Citrix にアクションを転送しているローカル Director を表します)。 |
ディレクトリが存在しない
IA-Connect Agent を実行しているコンピューター上にディレクトリ (フォルダー) が存在するかどうかを true または false で報告します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ディレクトリが存在する
|
DirectoryExists | boolean |
ディレクトリ (フォルダー) が存在する場合は true、そうでない場合は false を返します。 |
ディレクトリはアクセス可能
ディレクトリ (フォルダー) にアクセスできるかどうかと、IA-Connect Agent を実行しているコンピューター上でアクセス許可によってアクセスが制限されているかどうかを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アクセス可能なディレクトリ
|
DirectoryAccessible | boolean |
ディレクトリにアクセスできる場合は true、そうでない場合は false を返します。 |
|
アクセスが未承認のディレクトリ
|
DirectoryAccessUnauthorised | boolean |
アクセス許可によってアクセスが制限されているためにディレクトリにアクセスできない場合は true、アクセスできる場合は false を返します。 |
ディレクトリを作成する
IA-Connect Agent を実行しているコンピューター上にディレクトリ (フォルダー) を作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
既に存在する場合はエラー
|
ErrorIfAlreadyExists | boolean |
ディレクトリ (フォルダー) が既に存在する場合に IA-Connect でエラーを発生させますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ディレクトリを削除する
IA-Connect Agent を実行しているコンピューター上にディレクトリ (フォルダー) を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
再帰的
|
Recursive | boolean |
ディレクトリ内のサブディレクトリ (サブフォルダー) とファイルも削除しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ディレクトリを削除する
IA-Connect Agent を実行しているコンピューターのディレクトリ (フォルダー) を削除して、ディレクトリ内のすべてのファイルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
再帰的
|
Recursive | boolean |
すべてのサブフォルダーも削除しますか? |
|
|
最上位を削除する
|
DeleteTopLevel | boolean |
最上位のフォルダーも削除しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ドライブの一覧を取得する
IA-Connect Agent を実行しているコンピューター上のドライブの一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ドライブ JSON
|
DrivesJSON | string |
IA-Connect Agent を実行しているコンピューター上の JSON 形式のドライブの一覧。 |
パスワード キーを送信する
グローバル キー押下を、特にパスワード入力時に IA-Connect Agent ユーザー セッションに送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Password
|
Password | True | password |
送信するパスワード。 '保存された' パスワードの場合は、{IAConnectPassword:StoredPasswordIdentifier} の形式で入力し、'保存されているパスワード' を true に設定します。 これがオーケストレーターが生成した資格情報の場合、{OrchestratorCredential:FriendlyName} の形式で入力し、'保存されているパスワード' を true に設定します。 |
|
間隔 (ミリ秒)
|
Interval | integer |
各キー押下間のミリ秒数。 |
|
|
記号を解釈しない
|
DontInterpretSymbols | boolean |
パスワード内の記号を特殊キー (例: Shift は +、Ctrl は ^ など) として解釈しないようにしますか? 実際の記号を入力する場合は、これを true に設定する必要があります。 |
|
|
保存されたパスワードを含むパスワード
|
PasswordContainsStoredPassword | boolean |
パスワードが IA-Connectに 保存されたパスワード識別子 (例:「パスワードを生成する」アクションによって生成される) または IA-Connect オーケストレーターの汎用資格情報 (例: PA フローで IA-Connect を使用する場合) の場合は true に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
パスワードのキー イベントを送信する
グローバル キー押下イベントを、特にパスワード入力時に IA-Connect Agent ユーザー セッションに送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Password
|
Password | True | password |
送信するパスワード。 '保存された' パスワードの場合は、{IAConnectPassword:StoredPasswordIdentifier} の形式で入力し、'保存されているパスワード' を true に設定します。 これがオーケストレーターが生成した資格情報の場合、{OrchestratorCredential:FriendlyName} の形式で入力し、'保存されているパスワード' を true に設定します。 |
|
間隔 (ミリ秒)
|
Interval | integer |
各キー押下イベント間のミリ秒数。 |
|
|
記号を解釈しない
|
DontInterpretSymbols | boolean |
パスワード内の記号を特殊キー (例: {SHIFT} は Shift、{CTRL} は Ctrl など) として解釈しないようにしますか? 実際の記号を入力する場合は、これを true に設定する必要があります。 |
|
|
保存されたパスワードを含むパスワード
|
PasswordContainsStoredPassword | boolean |
パスワードが IA-Connectに 保存されたパスワード識別子 (例:「パスワードを生成する」アクションによって生成される) または IA-Connect オーケストレーターの汎用資格情報 (例: PA フローで IA-Connect を使用する場合) の場合は true に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
パスワードを Agent メモリに保存する
パスワードを Agent メモリに保存し (暗号化)、保存されたパスワードをサポートするアクションからそのパスワードを使用できるようにします。 パスワードはメモリにのみ保存され、Agent を終了すると失われます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
識別子
|
Identifier | True | string |
パスワードの一意識別子です。 識別子がすでに使用されている場合は上書きされます。 例: SAPGUILogon。 パスワードはフレーズ {IAConnectPassword:Identifier} を使用して取得されます。 |
|
Password
|
Password | True | password |
保存するパスワード。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
StorePasswordInAgentMemoryResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
パスワードを生成する
テンプレート形式で定義された辞書の単語、数字、記号、文字を含むパスワードを生成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
パスワード形式
|
PasswordFormat | True | string |
生成されたパスワードの形式。 記号 'w' は辞書の単語、'n' は数字、's' は記号、'l' は小文字、'L' は大文字を表します。 たとえば、wnnws なら Pluto35Marmite を生成する可能性があります。 |
|
Minimum length
|
MinimumLength | integer |
生成されたパスワードの最小長です。 生成されたパスワードが短かすぎる場合は、長さの条件が満たされるまで辞書の単語が追加されます。 長さの最小要件がない場合は、0 に設定します。 |
|
|
プレーン テキストとして返す
|
ReturnAsPlainText | boolean |
パスワードをプレーン テキストとして返す場合は true に設定します。 |
|
|
パスワードを識別子として保存
|
StorePasswordAsIdentifier | string |
識別子が指定されている場合、このパスワードはエージェント内に暗号化されて保存され、保存されている資格情報を利用できるコマンドで後で取得/使用できるようになります。 これらのパスワードはメモリにのみ保存され、エージェントを閉じると失われます。 例: MyExchangePassword。 |
|
|
対応する記号
|
SupportedSymbols | string |
生成したパスワードの形式で記号 's' を使用すると、ランダムに使用するシンボルのリストを提供できます。 指定しない場合は、組み込みのリストが使用されます。 例: !$()*。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プレーン テキストのパスワード
|
PlainTextPassword | string |
要求された場合はプレーン テキストのパスワード。 たとえば、SMS や電子メールを使用して転送される 1 回限りのパスワードであり、画面に表示されるのと同じものを取得する必要があるために、プレーン テキストで返すことが要求される可能性があります。 |
パスワード文字列を展開する
IA-Connect の保存済みのパスワードへの参照を含む入力文字列を受け入れ、その参照を保存済みのパスワードに置き換えた文字列を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力文字列
|
InputString | string |
IA-Connect に保存されているパスワード識別子を含む入力文字列。 例: 'ようこそ、新しいアカウントのパスワードは {IAConnectPassword:GeneratedPassword} です' の場合、'GeneratedPassword' は、保存されている IA-Connect パスワードの名前です。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力文字列
|
OutputString | string |
パスワード識別子が実際のパスワードに置き換えられた入力文字列を含む出力文字列。 例: 'ようこそ、新しいアカウントのパスワードは Fantastic12Monkeys です!'。 |
ファイル コンテンツを Base64 として取得する
指定したファイルのコンテンツを Base64 形式で取得します。Base64 形式は API 経由での送信に適した形式で、元のテキストまたはバイナリ形式に簡単に変換できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
FilePath | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
圧縮
|
Compress | boolean |
ファイル コンテンツを Base64 に変換する前に GZip で圧縮する場合は true に設定します。 ファイルはアクセスされず、すべての操作はメモリ内で実行されます。 この機能は、Base64 を取得した後でファイル コンテンツを GUnzip できる場合にのみ役立ちます (元のファイル コンテンツ テキストまたはバイナリ データにデコードする場合)。 Base64 を入力として受け入れて、GUnzip 機能を持たないアクションに、Base64 を直接渡す場合は、false に設定します。 |
|
|
最大ファイル サイズ
|
MaxFileSize | integer |
ファイルの最大サイズ。このサイズを超えると、ファイル コンテンツを取得する代わりに例外が発生します。 これにより、Agent が巨大なファイルを取得するように要求され、最終的にアクションがタイムアウトになるという状況を回避できます。ファイル サイズのチェックを無効にするには、-1 に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Base64 のファイル コンテンツ
|
FileContentsAsBase64 | string |
Base64 形式のファイル コンテンツ。 |
ファイル サイズを取得する
IA-Connect Agent を実行しているコンピューター上のファイルのサイズ (バイト数) を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
Filename | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ファイル サイズ
|
FileSize | integer |
ファイルのサイズ (バイト数)。 |
ファイルからすべてのテキストを読み取る
IA-Connect Agent を実行しているコンピューター上のファイルのテキスト コンテンツを読み取ります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
Filename | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ファイル テキスト コンテンツ
|
FileTextContents | string |
ファイルのテキスト コンテンツ。 |
ファイルに所有者を設定する
IA-Connect Agent を実行しているコンピューター上のファイルに所有者を設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
FilePath | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ユーザー ID
|
UserIdentity | True | string |
所有権を割り当てるユーザーの ID。 これは 'ユーザー名'、'DOMAIN\username'、または 'username@domainfqdn' の形式で指定できます。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ファイルのセキュリティ アクセス許可を取得する
IA-Connect Agent を実行しているコンピューター上のファイルに現在設定されているアクセス許可の一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
FilePath | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
セキュリティ アクセス許可の JSON
|
SecurityPermissionsJSON | string |
指定されたファイルに現在設定されている JSON 形式のアクセス許可。 |
ファイルのセキュリティから ID を削除する
IA-Connect Agent を実行しているコンピューター上のファイルのセキュリティ アクセス許可から ID (ユーザー、グループ、コンピューターなど) を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
FilePath | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
削除する ID
|
IdentityToRemove | True | string |
削除するユーザーまたはグループの ID。 これは 'ユーザー名'、'DOMAIN\username'、または 'username@domainfqdn' の形式で指定できます。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アクセス許可を削除しました
|
PermissionWasRemoved | boolean |
アクセス許可が正常に削除された場合に true を返します。 |
ファイルは存在しない
IA-Connect Agent を実行しているコンピューター上にファイルが存在するかどうかを true または false で報告します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
Filename | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ファイルが存在する
|
FileExists | boolean |
ファイルが存在する場合は true、そうでない場合は false を返します。 |
ファイルを ZIP に追加する
ファイルを圧縮します (ファイルを圧縮アーカイブに格納します)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ZIP に追加するソース ファイルのパス
|
SourceFilenameToAddToZIP | True | string |
ZIP に追加するファイルへのファイル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
出力 ZIP ファイルのパス
|
OutputZIPFilename | True | string |
ZIP の出力先のファイル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ZIP 内のフォルダーにファイル名を追加
|
AddFilenameToFolderInZIP | string |
ZIP ファイル内のフォルダーにソース ファイルを追加する場合は、ここにフォルダー名を入力します。 |
|
|
ZIP のコメントに追加するソース ファイル名
|
SourceFilenameToAddToZIPComment | string |
ZIP に追加する、このファイル用のオプションのコメント。 |
|
|
圧縮
|
Compress | boolean |
ZIP ファイル作成時にファイルを圧縮しますか? |
|
|
既存の ZIP ファイルに追加する
|
AddToExistingZIPFile | boolean |
既存の ZIP ファイルに追加する場合は True に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ファイルをクリップボードにコピーする
指定したローカル ファイルを IA-Connect Agent ユーザー セッションのクリップボードにコピーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File name
|
Filepath | True | string |
クリップボードにコピーするローカル ファイルへのファイル パス。 |
|
切り取り
|
Cut | boolean |
true に設定した場合、ファイルはコピーする代わりに切り取られます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
CopyFileToClipboardResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
ファイルをコピーする
IA-Connect Agent を実行しているコンピューター上のファイルをコピーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース ファイルのパス
|
SourceFilePath | True | string |
ソース ファイルへの完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ターゲット ファイルのパス
|
DestFilePath | True | string |
ファイルのコピー先への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ファイルを削除する
IA-Connect Agent を実行しているコンピューター上のファイルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File path
|
Filename | True | string |
ファイルのフルパスです。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ファイルを削除する
IA-Connect Agent を実行しているコンピューター上の指定されたフォルダーに含まれている、パターンに一致するファイルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Pattern
|
Pattern | string |
削除するファイルと一致させるパターン、例えば、すべてのファイルの場合は . .txt 拡張子を持つファイルの場合は *.txt。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
削除されたファイルの数
|
NumberOfFilesDeleted | integer |
正常に削除されたファイルの数。 |
|
削除に失敗したファイルの数
|
NumberOfFilesFailedToDelete | integer |
削除できなかったファイルの数。 |
ファイルを取得する
IA-Connect Agent を実行しているコンピューター上のフォルダー内のファイル一覧 (パターンの CSV 一覧に一致) を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
パターン CSV
|
PatternsCSV | True | string |
一致するファイル パターンのコンマ区切りリスト、たとえば、すべてのファイルの場合は . .txt または .docx 拡張子を持つファイルの場合は、'.txt,.docx'。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ファイル JSON
|
FilesJSON | string |
フォルダーに含まれている JSON 形式のファイルの一覧。 |
|
正常に読み取られたファイルの数
|
NumberOfFilesReadSuccessfully | integer |
正常に読み取られたファイルの数。 |
|
読み取りに失敗したファイルの数
|
NumberOfFilesFailedToRead | integer |
読み取ることができなかったファイルの数。 |
ファイルを移動する
IA-Connect Agent を実行しているコンピューター上のファイルを移動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース ファイルのパス
|
SourceFilePath | True | string |
ソース ファイルへの完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ターゲット ファイルのパス
|
DestFilePath | True | string |
ファイルの移動先への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
ファイルを解凍する
ZIP 圧縮を使用して圧縮されたファイルを解凍します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ZIP ファイル パス
|
ZIPFilename | True | string |
解凍する ZIP ファイルへの完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
抽出フォルダー
|
ExtractFolder | string |
ZIP に抽出するフォルダーへのパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
|
すべてのファイルを 1 つのフォルダーに抽出
|
ExtractAllFilesToSingleFolder | boolean |
True に設定した場合、ZIP 内のフォルダー構造は無視され、すべてのファイルが指定したフォルダーに抽出されます。 |
|
|
ファイルの正規表現を含める
|
IncludeFilesRegEx | string |
抽出するファイルを指定するためのオプションの正規表現です。 ファイル名のみ一致。 |
|
|
ファイルの正規表現を除外する
|
ExcludeFilesRegEx | string |
抽出から除外するファイルを指定するためのオプションの正規表現です。 ファイル名のみ一致。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
正常に抽出されたファイルの数
|
FilesExtractedSuccessfully | integer |
正常に ZIP から抽出されたファイルの数。 |
|
抽出に失敗したファイルの数
|
FilesFailedToExtract | integer |
ZIP からの抽出に失敗したファイルの数。 |
|
除外するファイルの数
|
FilesExcluded | integer |
除外されたファイルの数 ('ファイルの正規表現を除外する' 入力を使用している場合)。 |
フォルダーに所有者を設定する
IA-Connect Agent を実行しているコンピューター上のフォルダーに所有者を設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Folder path
|
FolderPath | True | string |
フォルダーへのフル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
ユーザー ID
|
UserIdentity | True | string |
所有権を割り当てるユーザーの ID。 これは 'ユーザー名'、'DOMAIN\username'、または 'username@domainfqdn' の形式で指定できます。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
フォルダーのセキュリティ アクセス許可を取得する
IA-Connect Agent を実行しているコンピューター上のフォルダーに現在設定されているアクセス許可の一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Folder path
|
FolderPath | True | string |
フォルダーへのフル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
セキュリティ アクセス許可の JSON
|
SecurityPermissionsJSON | string |
指定されたフォルダーに現在設定されている JSON 形式のアクセス許可。 |
フォルダーのセキュリティから ID を削除する
IA-Connect Agent を実行しているコンピューター上のフォルダーのセキュリティ アクセス許可から ID (ユーザー、グループ、コンピューターなど) を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Folder path
|
FolderPath | True | string |
フォルダーへのフル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
削除する ID
|
IdentityToRemove | True | string |
削除するユーザーまたはグループの ID。 これは 'ユーザー名'、'DOMAIN\username'、または 'username@domainfqdn' の形式で指定できます。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アクセス許可を削除しました
|
PermissionWasRemoved | boolean |
アクセス許可が正常に削除された場合に true を返します。 |
フォルダーのセキュリティ継承を有効にする
IA-Connect Agent を実行しているコンピューター上のフォルダーのセキュリティ継承を有効にします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Folder path
|
FolderPath | True | string |
フォルダーへのフル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
フォルダーのセキュリティ継承を解消する
IA-Connect Agent を実行しているコンピューター上のフォルダーのセキュリティ継承を解消します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Folder path
|
FolderPath | True | string |
フォルダーへのフル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
継承を明示に変換する
|
ConvertInheritedToExplicit | boolean |
現在継承されているアクセス許可を明示的なアクセス許可に変換しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
フォルダーを取得する
IA-Connect Agent を実行しているコンピューター上の指定されたフォルダー内のすべてのサブフォルダーを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ディレクトリ パス
|
DirectoryPath | True | string |
ディレクトリ (フォルダー) への完全なパス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
フォルダー JSON
|
FoldersJSON | string |
フォルダーに含まれている JSON 形式のサブフォルダーの一覧。 |
|
正常に読み取られたフォルダーの数
|
NumberOfFoldersReadSuccessfully | integer |
正常に読み取られたサブフォルダーの数。 |
|
読み取りに失敗したフォルダーの数
|
NumberOfFoldersFailedToRead | integer |
読み取ることができなかったサブフォルダーの数。 |
フローを完了としてマークする
フローを完了としてマークします。それによって、割り当てられているワーカー コンピューターが他のフローを処理できるようになったことが IA-Connect オーケストレーターに通知されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
フロー結果 JSON から失敗したアクションのエラー メッセージを取得する
1 つ以上のフロー result() 式の JSON 出力を逆シリアル化し、失敗したアクションの最初に見つかったエラー メッセージを取得します。 エラー メッセージは、さまざまな形式で JSON に保存できます。 このアクションは既知の形式を処理し、最初に見つかったエラー メッセージを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フロー結果 JSON
|
PowerAutomateResultJSON | True | array of string |
1 つ以上のフロー result() 式からの出力を含む JSON の配列。 単一のフロー result() 式の出力のみを処理する場合は、それを最初の配列項目に入力するだけです。 |
|
検索の状態
|
SearchStatus | string |
エラー メッセージを含むアクションの状態。 これは、デフォルトの「失敗」と異なる状態を検索する場合にのみ変更する必要があります。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アクション エラー メッセージ
|
ActionErrorMessage | string |
結果の JSON から抽出されたアクション エラー メッセージを返します。 エラー メッセージが見つからない場合は、空白の値が返されます。 |
|
Action name
|
ActionName | string |
エラー メッセージに関連付けられているアクションの名前を返します。 |
|
アクション コード
|
ActionCode | string |
エラー メッセージに関連付けられている結果コードの名前を返します。 |
プリンターの一覧を取得する
IA-Connect Agent セッションで使用可能なすべてのプリンターの一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ローカル プリンターの一覧
|
ListLocalPrinters | boolean |
ローカル プリンターを返しますか? |
|
|
ネットワーク プリンターの一覧
|
ListNetworkPrinters | boolean |
ネットワーク プリンターを返しますか? |
|
|
詳細情報を返す
|
ReturnDetailedInformation | boolean |
各プリンターの場所、ポート名、ドライバー名、状態などの詳細情報を返しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プリンター JSON
|
PrintersJSON | string |
見つかったすべてのプリンターの一覧 (JSON 形式)。 |
|
プリンターの数
|
NumberOfPrinters | integer |
見つかったプリンターの数。 |
プロセス ID でプロセスを取得する
指定したプロセス ID のプロセスが IA-Connect Agent ユーザー セッションで実行されているかどうかを返します。 プロセス ID は一意であるため、ID に一致できるプロセスは 1 つのみです。プロセス ID は動的であり、アプリケーションを起動するごとに異なります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロセス ID
|
ProcessId | True | integer |
取得するプロセスのプロセス ID。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プロセス実行中
|
ProcessRunning | boolean |
指定されたプロセス ID を持つプロセスが見つかった場合は true を返します。 |
プロセス ID のコマンド ライン プロパティを取得する
指定したプロセス ID を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスのコマンド ライン プロパティを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロセス ID
|
ProcessId | True | integer |
コマンド ライン プロパティの取得元プロセスのプロセス ID。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プロセス コマンド ライン
|
ProcessCommandLine | string |
プロセスのコマンド ライン プロパティ。 |
|
プロセスの引数
|
ProcessArguments | string |
プロセスの開始時に使用された引数。 |
|
プロセスの現在の作業ディレクトリ
|
ProcessCurrentWorkingDirectory | string |
プロセスの現在の作業ディレクトリ。 |
|
プロセス イメージのパス名
|
ProcessImagePathName | string |
プロセスを開始した実行可能ファイルへのパス。 |
プロセス ID を強制終了する
指定したプロセス ID を持つ IA-Connect Agent ユーザー セッションで実行されているプロセスを強制終了します。プロセス ID は一意であるため、ID に一致できるプロセスは 1 つのみです。プロセス ID は動的であり、アプリケーションを起動するごとに異なります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロセス ID
|
ProcessID | True | integer |
強制終了するプロセスのプロセス ID。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
キルしたプロセスの数
|
NumberOfProcessesKilled | integer |
強制終了されたプロセスの数。 |
プロセスを取得する
IA-Connect Agent ユーザー セッションで実行中のプロセスの一覧を返します。 オプションにより、プロセス名を指定してフィルター処理を行うことができます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロセス名
|
ProcessName | string |
プロセス名のオプションのフィルター。 |
|
|
プロセス コマンドラインの取得
|
GetProcessCommandLine | boolean |
true に設定した場合、プロセスのコマンドラインの詳細が返されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プロセスの数
|
NumberOfProcesses | integer |
ユーザー セッションで実行中のプロセスの数。 |
|
プロセス JSON
|
ProcessesJSON | string |
ユーザー セッションで実行されているプロセスの一覧 (JSON形式)。 |
プロセスを実行する
プロセス、コマンド、またはアプリケーションを起動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Process name
|
ProcessName | True | string |
実行するプロセス。 例: notepad.exe や C:\windows\system32\notepad.exe など。 |
|
引数
|
Arguments | string |
アプリケーションの起動時に使用する任意のコマンドライン引数。 |
|
|
作業フォルダー
|
WorkingDirectory | string |
プロセスの作業フォルダー/ディレクトリ。 |
|
|
シェル実行の使用
|
UseShellExecute | boolean |
オペレーティング システム シェルを使用してプロセスを開始しますか? |
|
|
ウィンドウを作成しない
|
CreateNoWindow | boolean |
プロセスをウィンドウなしで開始しますか? |
|
|
ウィンドウ スタイル
|
WindowStyle | string |
ウィンドウ スタイル (標準、最大、最小、または非表示) を指定します。 |
|
|
プロセスを待機
|
WaitForProcess | boolean |
プロセスが完了するまで待ちますか? これは通常、続行する前に終了する必要があるプログラムまたはスクリプトを実行する場合にのみ使用されます。 |
|
|
標準出力のリダイレクト
|
RedirectStandardOutput | boolean |
標準出力をリダイレクトしますか? |
|
|
標準エラーのリダイレクト
|
RedirectStandardError | boolean |
標準エラーをリダイレクトしますか? |
|
|
標準エラーを出力にリダイレクトする
|
RedirectStandardErrorToOutput | boolean |
標準エラーを出力にリダイレクトしますか? |
|
|
標準出力のエンコード
|
StandardOutputEncoding | string |
標準出力のエンコード (UTF8、UTF7、UTF16、ASCII、または UTF16BE) を指定します。 |
|
|
標準エラー エンコード
|
StandardErrorEncoding | string |
標準のエラー エンコード (UTF8、UTF7、UTF16、ASCII、または UTF16BE) を指定します。 |
|
|
RunAs ドメイン名
|
RunAsDomain | string |
ユーザーとしての実行のドメイン。 ドメインが指定されていない場合、ユーザー名は、username@domainFQDN の形式である必要があります。 |
|
|
RunAs のユーザー名
|
RunAsUsername | string |
ユーザーとしての実行のユーザー名。 |
|
|
RunAs のパスワード
|
RunAsPassword | password |
ユーザーとしての実行のパスワード。 |
|
|
RunAs ユーザー プロファイルの読み込み
|
RunAsLoadUserProfile | boolean |
ユーザーとしての実行の Windows ユーザー プロファイルを読み込みますか? |
|
|
RunAs の昇格
|
RunAsElevate | boolean |
プロセスの実行を昇格しますか? |
|
|
タイムアウト (秒)
|
TimeoutInSeconds | integer |
プロセスが完了までに待機する最大秒数。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プロセス開始
|
ProcessStarted | boolean |
プロセスが開始された場合は true を返します。 |
|
終了コード
|
ExitCode | integer |
プロセスの終了コードを返します。 |
|
プロセスのタイムアウト
|
ProcessTimedOut | boolean |
プロセスがタイムアウトした場合は true を返します。 |
|
プロセス ID
|
ProcessId | integer |
開始されたプロセスのプロセス ID。 |
|
標準出力
|
StandardOutput | string |
標準出力の内容。 |
|
標準エラー
|
StandardError | string |
標準エラーの内容。 |
プロセスを強制終了する
指定されたプロセス名を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスをすべて強制終了します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Process name
|
ProcessName | True | string |
強制終了するプロセス。 例: メモ帳。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
キルしたプロセスの数
|
NumberOfProcessesKilled | integer |
強制終了されたプロセスの数。 |
マウス ホイールを回転する
IA-Connect Agent ユーザー セッションでマウス ホイール (プラスまたはマイナスのノッチ) を回転します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ホイールの回転
|
WheelTurns | True | integer |
ホイールの回転数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスのウィグル
指定した座標数だけマウスを前後に移動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ウィグル
|
XWiggle | integer |
マウスを水平方向に移動する際のピクセル数。 |
|
|
Y ウィグル
|
YWiggle | integer |
マウスを垂直方向に移動する際のピクセル数。 |
|
|
ウィグルの遅延 (秒)
|
WiggleDelayInSeconds | double |
マウスの移動間の秒数。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスのカーソルの位置を設定する
IA-Connect Agent ユーザー セッションで、マウスのカーソルを指定した位置に設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
X | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
Y | True | integer |
Y 座標値 (ピクセル単位)。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの中央ボタンをクリックする
IA-Connect Agent ユーザー セッションでマウスの中央ボタンをクリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの中央ボタンを上に移動する
IA-Connect Agent ユーザー セッションでマウスの中央ボタンを離します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの中央ボタンを下に移動する
IA-Connect Agent ユーザー セッションでマウスの中央ボタンを押します (離しません)。 マウスを離すには、マウスの中央ボタンを上に移動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの中央ボタンを長押しする
指定した秒数間、IA-Connect Agent ユーザー セッションでマウスの中央ボタンを長押しします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
保留する秒数
|
SecondsToHold | True | double |
マウスの中央ボタンを長押しする秒数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの乗数を設定する
IA-Connect Agent ユーザー セッションでグローバル マウス乗数を設定します。 これは、開発中にリモート デスクトップのスケーリングで問題が発生した場合に役立ちます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X 乗数
|
MouseXMultiplier | double |
水平方向 (X) グローバル マウス乗数を設定します (Agent がマウスを移動する場合)。 乗数は、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
Y 乗数
|
MouseYMultiplier | double |
垂直方向 (X) グローバル マウス乗数を設定します (Agent がマウスを移動する場合)。 乗数は、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
|
mouse_event に適用
|
ApplyToMouseEvent | boolean |
この引数は、グローバル マウス乗数の値を mouse_event メソッドに適用するかどうかを指定します。 |
|
|
SetCursorPos に適用
|
ApplyToSetCursorPos | boolean |
この引数は、グローバル マウス乗数の値を SetCursorPos メソッドに適用するかどうかを指定します。 |
|
|
Apply to current mouse move method
|
ApplyToCurrentMouseMoveMethod | boolean |
この引数は、グローバル マウス乗数値を現在のマウス移動メソッドに適用するかどうかを指定します (例: SetCursorPos が現在のマウス移動メソッドである場合、乗数は SetCursorPos に適用されます)。 これが true に設定されている場合、入力 'Apply to mouse_event' と 'Apply to SetCursorPos' は無視されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの右ボタンを上に移動する
IA-Connect Agent ユーザー セッションでマウスの右ボタンを離します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの右ボタンを下に移動する
IA-Connect Agent ユーザー セッションでマウスの右ボタンを押します (離しません)。 マウスを離すには、マウスの右ボタンを上に移動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの右ボタンを長押しする
指定した秒数間、IA-Connect Agent ユーザー セッションでマウスの右ボタンを長押しします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
保留する秒数
|
SecondsToHold | True | double |
マウスの右ボタンを長押しする秒数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの左ボタンをダブルクリックする
IA-Connect Agent ユーザー セッションでマウスの左ボタンをダブル クリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
遅延 (ミリ秒)
|
DelayInMilliseconds | integer |
各クリック間の遅延 (ミリ秒)。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの左ボタンを上に移動する
IA-Connect Agent ユーザー セッションでマウスの左ボタンを解放します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの左ボタンを下に移動する
IA-Connect Agent ユーザー セッションでマウスの左ボタンを押します (離しません)。 マウスを離すには、マウスの左ボタンを上に移動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの左ボタンを長押しする
指定した秒数間、IA-Connect Agent ユーザー セッションでマウスの左ボタンを長押しします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
保留する秒数
|
SecondsToHold | True | double |
マウスの左ボタンを長押しする秒数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスの移動方法を取得する
現在のマウスの移動方法を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
マウスの移動方法
|
MouseMoveMethod | string |
現在のマウスの移動方法 (mouse_event または setcursorpos) を返します。 |
マウスの移動方法を設定する
現在のマウスの移動方法を mouse_event または setcursorpos に設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
マウスの移動方法を設定する
|
MouseMoveMethod | True | string |
マウスの移動方法 (mouse_event または setcursorpos) を指定します。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスを右クリックする
IA-Connect Agent ユーザー セッションでマウスの右ボタンをクリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスを左クリックする
IA-Connect Agent ユーザー セッションでマウスの左ボタンをクリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスを座標に移動する
IA-Connect Agent ユーザー セッションで、指定したピクセル座標にマウスを移動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
マウスの移動先の X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
マウスの移動先の Y 座標値 (ピクセル単位)。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウスを相対的に移動する
IA-Connect Agent ユーザー セッションで、指定したピクセル数だけ現在の位置に相対させてマウスを移動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
マウスを現在の位置から移動する X ピクセル数。 |
|
Y ピクセル数
|
YCoord | True | integer |
マウスを現在の位置から移動する Y ピクセル数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
マウス乗数を取得する
IA-Connect Agent ユーザー セッションでグローバル マウス乗数を取得します。 これはデフォルトで (1, 1) ですが、「マウスの乗数を設定する」アクションによって変更された可能性があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
X 乗数
|
MouseXMultiplier | double |
現在の水平方向 (X) グローバル マウス乗数 (Agent がマウスを移動する場合)。 乗数は、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
Y 乗数
|
MouseYMultiplier | double |
現在の垂直方向 (X) グローバル マウス乗数 (Agent がマウスを移動する場合)。 乗数は、「マルチ モニター機能」が無効になっている場合にのみ効果があります。 |
|
マウスの移動方法
|
MouseMoveMethod | string |
現在のグローバル マウス移動メソッド (mouse_event または setcursorpos) を返します。 |
ユーザーの資格情報から読み取る
IA-Connect Agent セッションでユーザーのプロファイルの資格情報からユーザー名とパスワードを読み取ります。 資格情報は、Windows のコントロール パネルから表示できます。 ユーザー名とパスワードの両方を汎用資格情報から取得できますが、Windows 資格情報から取得できるのはユーザー名のみです。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
資格情報の住所
|
CredentialAddress | True | string |
資格情報の名前/アドレスです。 |
|
資格情報の種類
|
CredentialType | True | string |
資格情報の種類: Windows または汎用。 |
|
対称暗号化キー
|
SymmetricKey | string |
資格情報パスワードを復号化するために使用されるオプションの対称暗号化キー (資格情報がキーで暗号化されている場合に使用)。 Windows 資格情報のパスワードは取得できないため、汎用資格情報でのみ使用できます。 |
|
|
パスワードを識別子として保存
|
StorePasswordAsIdentifier | string |
識別子が指定されている場合、取得された資格情報パスワードはエージェント内に暗号化されて保存され、保存されている資格情報を利用できるコマンドで後で取得/使用できるようになります。 これらのパスワードはメモリにのみ保存され、エージェントを閉じると失われます。 Windows 資格情報のパスワードは取得できないため、汎用資格情報でのみ使用できます。 例: MyExchangePassword。 |
|
|
パスワードを返さない
|
DontReturnPassword | boolean |
true に設定すると、資格情報パスワードは返されません。 これは、他のコマンドで使用するためにエージェント内にパスワードを保存する (つまり 'パスワードを識別子として保存する' が true) ものの、ワークフロー内で実際にパスワードを知る必要がない場合に便利です。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
User name
|
UserName | string |
資格情報のユーザー名です。 |
|
Password
|
Password | string |
資格情報のパスワードです。 |
ユーザーの資格情報を削除する
IA-Connect Agent セッションでユーザーのプロファイルの資格情報を削除します。 資格情報は、Windows のコントロール パネルから表示できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
資格情報の住所
|
CredentialAddress | True | string |
資格情報の名前/アドレスです。 |
|
資格情報の種類
|
CredentialType | True | string |
資格情報の種類: Windows または汎用。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
CredentialDeleteResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
ユーザー資格情報に書き込む
IA-Connect Agent セッションでユーザーのプロファイルにあるユーザー名とパスワードを資格情報に書き込み、存在しない場合はその資格情報を作成します。 資格情報は、Windows のコントロール パネルから表示できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
資格情報の住所
|
CredentialAddress | True | string |
資格情報の名前/アドレスです。 |
|
User name
|
UserName | True | string |
資格情報のユーザー名です。 |
|
Password
|
Password | True | string |
資格情報のパスワードです。 |
|
資格情報の種類
|
CredentialType | True | string |
資格情報の種類: Windows または汎用。 |
|
資格情報の永続性
|
CredentialPersistence | string |
資格情報の永続性: Session (このログイン セッションの間だけ持続する)、LocalMachine (このユーザーのセッションをまたいで、このコンピューターのみ再起動後も持続する)、Enterprise (コンピューター間で資格情報のローミングが可能)。 |
|
|
対称暗号化キー
|
SymmetricKey | string |
資格情報の暗号化に使用されるオプションの対称暗号化キー。 この資格情報は、キーを知っている場合にのみ取得できます。 汎用資格情報でのみ使用できます。 |
|
|
パスワードを識別子として保存
|
StorePasswordAsIdentifier | string |
識別子が指定されている場合、このパスワードもエージェント内に暗号化されて保存され、保存されている資格情報を利用できるコマンドで後で取得/使用できるようになります。 これらのパスワードはメモリにのみ保存され、エージェントを閉じると失われます。 例: MyExchangePassword。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
CredentialWriteResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
リモート セッションをログオフする
IA-Connect Agent が実行されているリモート セッションをログオフします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
待機する秒数
|
SecondsToWait | integer |
IA-Connect Agent がコマンドの完了を報告できるよう、ログオフ コマンドをオペレーティング システムに発行した後に待機する時間。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
リモート セッションを接続解除
IA-Connect Agent がリモート セッションで実行されている場合、このアクションによりリモート セッションが接続解除されます。 これはログオフとは異なり、リモート セッションが切断された状態で実行されます。 このアクションは、新しいセッションを開始するのではなく、後でリモート セッションに接続して同じ状態から継続したい場合に使用できます。 IA-Connect Agent がローカルで実行されている場合、このアクションによりセッションがロックされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
待機する秒数
|
SecondsToWait | integer |
IA-Connect Agent が接続を失う前にコマンドの完了を報告できるように (リモート セッションでのみ発生します)、オペレーティング システムに接続解除コマンドを発行するまでの待機時間。 |
|
|
ローカル Agent の場合は接続解除しない
|
DoNotDisconnectIfLocalAgent | boolean |
true に設定すると、IA-Connect Agent がローカル セッション (つまり、Worker 上で直接) で実行されている場合、このアクションは自動的に無視されます。 ローカル Agent を接続解除するとセッションがロックされ、セッションのロックが解除されるまで RPA 機能が制限されるため、これは便利です。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
リモート デスクトップ セッション (RDS) の起動ファイルを作成する
リモート デスクトップ セッション (RDS) の起動ファイルを作成します。このファイルを使用して、リモート デスクトップ クライアント UI の自動化を必要とせずに、指定したパラメーターを使用してリモート デスクトップ セッションを自動的に起動できます。 RDS 起動ファイルの拡張子は '.rdp' であるため、多くの場合に RDS ファイルと呼ばれます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リモート アドレス
|
RemoteAddress | True | string |
接続先のリモート システムのアドレス。 これは、IP アドレス、ホスト名、または完全修飾ドメイン名 (FQDN) などが考えられます。 |
|
出力フォルダー パス
|
OutputFolderPath | True | string |
RDP ファイルを保存するフォルダーです。 |
|
RDP ファイル名
|
RDPFileName | True | string |
出力フォルダー パスに作成される RDP ファイルの名前です。 |
|
RDP ファイルが既に存在する場合は上書きする
|
OverwriteRDPFileIfAlreadyExists | boolean |
同じフォルダ/ファイル名の RDP ファイルを自動的に上書きするには、true に設定します。 同じフォルダ/ファイル名の既存の RDP ファイルがすでに存在する場合に新しい RDP ファイルを作成しない場合は、false に設定します。 |
|
|
リモート コンピューターを信頼する
|
TrustRemoteComputer | boolean |
リモート アドレスを (Windows レジストリで) 信頼済みとしてマークするには true を設定します。これは主に、デバイスをリダイレクトする際、RDP ファイルの起動時にポップアップを表示しないようにする目的で使用されます。 |
|
|
資格情報を保存する
|
StoreCredentials | boolean |
true に設定すると、リモート デスクトップ認証の詳細を保持するユーザー資格情報が作成されます。 これにより、認証を求められることなくリモート デスクトップ システムに接続できます。 |
|
|
UserName
|
UserName | string |
リモート デスクトップ認証の詳細を保持するために資格情報を保存する場合、これにより資格情報に格納するユーザー名を指定できます。 |
|
|
Password
|
Password | string |
リモート デスクトップ認証の詳細を保持するために資格情報を保存する場合、これにより資格情報に格納するパスワードを指定できます。 |
|
|
資格情報の種類
|
CredentialType | string |
リモート デスクトップ認証の詳細を保持するために資格情報を保存する場合、これにより資格情報タイプ (Windows または汎用) を指定できます。 RDP 資格情報を保存するには、通常、Windows 資格情報を作成します。 |
|
|
資格情報の永続性
|
CredentialPersistence | string |
リモート デスクトップ認証の詳細を保持するための資格情報を保存する場合、これで資格情報の永続性を指定できます: Session (このログイン セッションの間だけ持続する)、LocalMachine (このユーザーのセッションと、このコンピューターのみの再起動で存続します)、Enterprise (これをコンピューター間でローミングできます)。 RDP ファイルを作成する場合は 'Session' が既定です。 |
|
|
プリンターをリダイレクトする
|
RedirectPrinters | boolean |
ローカル セッションのプリンターをリモート デスクトップ セッションにマッピングする必要がありますか? この設定はリモートエンドで適用される可能性があるため、有効になりません。 |
|
|
すべてのドライブをリダイレクトする
|
RedirectAllDrives | boolean |
ローカル セッションのすべてのドライブ文字 (C: など) をリモート デスクトップ セッションにマッピングする必要がありますか? この設定はリモートエンドで適用される可能性があるため、有効になりません。 |
|
|
クリップボードをリダイレクトする
|
RedirectClipboard | boolean |
クリップボードをローカル システムとリモート システムで共有して、2 つのシステム間でコピー アンド ペーストできるようにする必要がありますか? この設定はリモートエンドで適用される可能性があるため、有効になりません。 |
|
|
全画面表示
|
Fullscreen | boolean |
リモート デスクトップ セッションが全画面モードの場合。 |
|
|
デスクトップの幅
|
DesktopWidth | integer |
リモート デスクトップ セッションが全画面モードではない場合の、リモート デスクトップ セッションの幅 (ピクセル単位) です。 |
|
|
デスクトップの高さ
|
DesktopHeight | integer |
リモート デスクトップ セッションが全画面モードではない場合の、リモート デスクトップ セッションの高さ (ピクセル単位) です。 |
|
|
マルチモニタを使用する
|
UseMultiMonitor | boolean |
フルスクリーン リモート デスクトップ セッションで単一のモニターのみを使用する必要がある場合は、false に設定します。 フルスクリーン リモート デスクトップ セッションですべてのモニターを使用する必要がある場合は、true に設定します。 単一モニター システム (したがってほとんどの仮想マシン) には影響しません。 |
|
|
セッション カラーの深度
|
SessionBPP | integer |
リモート デスクトップ セッションの色深度 (ビット/ピクセル (BPP))。 数値が大きいほど、色が多くなります。 サポートされている値は 15、16、24、32 です。 |
|
|
スマート サイズ設定
|
SmartSizing | boolean |
ローカル コンピューターが Windows のサイズに合わせてリモート セッションの内容を自動的にスケールする場合は、true に設定します。 自動的にスケールしない場合は false に設定します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
RDP ファイル パス
|
RDPFilePath | string |
生成された RDP ファイルへの完全なパスです。 |
リモート デスクトップ セッション (RDS) を起動する
RDS 起動ファイルを使用して、リモート デスクトップ セッション (RDS) を起動します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
RDP ファイル パス
|
RDPFilePath | True | string |
RDP ファイルへの完全なパス。あらかじめ用意されているか、'リモート デスクトップ セッション (RDS) 起動ファイルの作成' のアクションを使用して作成します。 |
|
リモート コンピューターを信頼する
|
TrustRemoteComputer | boolean |
RDP ファイルに設定されたリモート アドレスを (Windows レジストリで) 信頼済みとしてマークするには true を設定します。これは主に、デバイスをリダイレクトする際、RDP ファイルの起動時にポップアップを表示しないようにする目的で使用されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
LaunchRemoteDesktopSessionResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
他のすべての IA-Connect Agent を強制終了する
ユーザー セッションで現在実行中の IA-Connect Agent のその他のインスタンスを強制終了します。 これにより、IA-Connect Agent のインスタンスが 1 つのみ実行されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
強制終了された Agent の数
|
NumberOfAgentsKilled | integer |
強制終了された IA-Connect Agent プロセスの数。 |
|
強制終了に失敗した Agent の数
|
NumberOfAgentsFailedToKill | integer |
強制終了に失敗した IA-Connect Agent プロセスの数。 |
代替 IA-Connect Agentを実行する
ファイルの場所から Agent 実行可能ファイルを読み込むことで、代替 IA-Connect Agent (新しいバージョンなど) を実行します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Filename
|
Filename | True | string |
実行する代替 IA-Connect Agent.exe への完全なパス。 パスは IA-Connect Agent が実行されているセッションからアクセスできる必要があります。 |
|
引数
|
Arguments | string |
IA-Connect Agent.exe の実行時に渡されるすべての引数です (オプション)。 |
|
|
メモリに読み込む
|
LoadIntoMemory | boolean |
代替 IA-Connect Agent をメモリ内で実行しますか? true に設定した場合、新しい Agent がメモリに読み込まれ、既存の Agent のアセンブリ内で実行されます。 false に設定した場合、新しい Agent は通常のプロセスとして実行され、既存の Agent EXE は終了します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
例外を発生する
入力例外が空白でない場合は、指定されたメッセージで例外を発生します。 これは、以前のアクションにエラーがあった場合に、フロー (HTTP 400) で例外メッセージをトリガーし、エラー処理ステージでキャッチするのに役立ちます。 この例外は、IA-Connect オーケストレーター フロー実行統計には記録されません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力例外
|
InputException | string |
この入力例外が空の文字列でない場合、提供された「例外メッセージ」で例外が発生します。 この入力例外が空白の場合、このアクションは何も行いません。 |
|
|
例外メッセージ
|
ExceptionMessage | string |
発生する例外メッセージです。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
RaiseExceptionResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
保存済みのパスワードを取得する
以前に生成または保存されたパスワードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
パスワード識別子
|
PasswordIdentifier | string |
保存されたパスワードの識別子。 これらのパスワードはメモリにのみ保存され、エージェントを閉じると失われます。 例: MyExchangePassword。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プレーン テキストのパスワード
|
PlainTextPassword | string |
プレーン テキストのパスワード。 たとえば、SMS や電子メールを使用して転送される 1 回限りのパスワードであり、画面に表示されるのと同じものを取得する必要がある場合、プレーン テキストで返すことが必要となる可能性があります。 |
利用可能な IA-Connect セッションを取得する
IA-Connect Director セッション (ローカル、Microsoft RDP または Citrix ICA など、IA-Connect Agent が実行されているセッションへの利用可能な接続) の一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
IA-Connect セッション JSON
|
IAConnectSessionsJSON | string |
すべての IA-Connect セッションの JSON 形式一覧。 |
|
IA-Connect セッションの数
|
NumberOfIAConnectSessions | integer |
開いている IA-Connect セッションの合計数。 |
|
ローカル IA-Connect セッションの数
|
NumberOfLocalIAConnectSessions | integer |
開いているローカル IA-Connect セッションの数。 |
|
Citrix ICA IA-Connect セッションの数
|
NumberOfCitrixICAIAConnectSessions | integer |
開いている Citrix ICA IA-Connect セッションの数。 |
|
Microsoft RDP IA-Connect の数
|
NumberOfMicrosoftRDPIAConnectSessions | integer |
開いている Microsoft RDP IA-Connect セッションの数。 |
名前ごとに IA-Connect セッションが存在しますか
指定した IA-Connect Director セッションが存在する場合は返します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 名前は前の 'アタッチ' アクションから取得されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
IA-Connect セッション名
|
IAConnectSessionName | True | string |
チェックする IA-Connect セッションの名前。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
IA-Connect セッションが存在する
|
IAConnectSessionExists | boolean |
指定された名前のセッションが存在する場合は true、存在しない場合は false を返します。 |
名前でプロセス数を取得する
指定されたプロセス名を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスの数を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Process name
|
ProcessName | True | string |
プロセス名。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
プロセスの数
|
NumberOfProcesses | integer |
指定されたプロセス名に一致するプロセスの数。 |
名前による IA-Connect セッションの強制終了
指定した IA-Connect Director セッションが存在する場合は、セッションを強制終了します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。 名前は前の 'アタッチ' アクションから取得されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
IA-Connect セッション名
|
IAConnectSessionName | True | string |
強制終了する IA-Connect セッションの名前。 |
|
成功時に、階層 1 の IA-Connect セッションに添付する
|
AttachToTier1IAConnectSessionOnSuccess | boolean |
セッションが正常に終了した場合に、IA-Connect を階層 1 の IA-Connect セッション (SOAP / REST メッセージのどちらかまたは両方を受信する Director の IA-Connect Director セッション) に接続しますか? |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
IA-Connect セッションが強制終了された
|
IAConnectSessionKilled | boolean |
指定された名前のセッションが強制終了された場合は true、そうでない場合は false を返します。 |
|
階層 1 の IA-Connect セッション名に添付する
|
AttachedTier1IAConnectSessionName | string |
接続した階層 1 の IA-Connect セッションの名前。 |
座標でマウスの中央ボタンをクリックする
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの中央ボタンをクリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
Y 座標値 (ピクセル単位)。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標でマウスの中央ボタンを長押しする
IA-Connect Agent ユーザー セッションにおいて、指定した秒数間、指定した座標でマウスの中央ボタンを長押しします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
Y 座標値 (ピクセル単位)。 |
|
保留する秒数
|
SecondsToHold | True | double |
マウスの中央ボタンを長押しする秒数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標でマウスの右ボタンを長押しする
IA-Connect Agent ユーザー セッションにおいて、指定した秒数間、指定した座標でマウスの右ボタンを長押しします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
Y 座標値 (ピクセル単位)。 |
|
保留する秒数
|
SecondsToHold | True | double |
マウスの右ボタンを長押しする秒数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標でマウスの左ボタンをダブルクリックする
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの左ボタンをダブル クリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
Y 座標値 (ピクセル単位)。 |
|
遅延 (ミリ秒)
|
DelayInMilliseconds | integer |
各クリック間の遅延 (ミリ秒)。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標でマウスの左ボタンを長押しする
IA-Connect Agent ユーザー セッションにおいて、指定した秒数間、指定した座標でマウスの左ボタンを長押しします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
Y 座標値 (ピクセル単位)。 |
|
保留する秒数
|
SecondsToHold | True | double |
マウスの左ボタンを長押しする秒数。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標でマウスを右クリックする
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの右ボタンをクリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
Y 座標値 (ピクセル単位)。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標でマウスを左クリックする
IA-Connect Agent ユーザー セッションにおいて、指定した座標でマウスの左ボタンをクリックします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
X ピクセル数
|
XCoord | True | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
YCoord | True | integer |
Y 座標値 (ピクセル単位)。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標のピクセルカラーを取得する
指定された座標のピクセルの RGB カラーを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
左の X ピクセル数
|
LeftXPixels | True | integer |
読み取るピクセルの X 位置。 単一ディスプレイでは、左端の X ピクセルは 0 です。 マルチ モニター ディスプレイでは、左端の X ピクセルが負になる可能性があります (どのディスプレイがプライマリとしてマークされているか、および他のディスプレイとの相対位置に応じます)。 |
|
上部の Y ピクセル数
|
TopYPixels | True | integer |
読み取るピクセルの Y 位置。 単一ディスプレイでは、上端の Y ピクセルは 0 です。 マルチ モニター ディスプレイでは、上端の Y ピクセルが負になる可能性があります (どのディスプレイがプライマリとしてマークされているか、および他のディスプレイとの相対位置に応じます)。 |
|
Agent を非表示にする
|
HideAgent | boolean |
true に設定すると、Agent (表示されている場合) が自動的に非表示になり、読み取り対象のピクセルが隠されないようになります。 |
|
|
物理座標を使用する
|
UsePhysicalCoordinates | boolean |
提供された座標が物理座標であることを指定するには、true に設定します (DPI スケールされていないため、ディスプレイ上の物理ピクセルと一致します)。 指定された座標が仮想座標 (DPI スケールされている) であることを指定するには、false (デフォルト) に設定します。 UIA、Java、および Web アクションは通常、仮想座標を使用します。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
赤の値
|
RedValue | integer |
ピクセルの赤の値を0 (赤なし) から255 (完全な赤) まで返します。 |
|
緑の値
|
GreenValue | integer |
ピクセルの緑の値を0 (緑なし) から255 (完全な緑) まで返します。 |
|
青の値
|
BlueValue | integer |
ピクセルの青の値を0 (青なし) から255 (完全な) まで返します。 |
|
アルファ値
|
AlphaValue | integer |
ピクセルのアルファ値を0 (完全に透明) から255 (完全に不透明) まで返します。 |
|
RRGGBB 16 進値
|
RRGGBBHexValue | string |
ピクセルの RRGGBB 16 進値を返します。 たとえば、FF0000 は完全な赤、00FF00 は完全な緑、0000FF は青、000000 は黒、FFFFFF は完全な白です。 |
|
AARRGGBB 16 進値
|
AARRGGBBHexValue | string |
ピクセルの AARRGGBB 16 進値を返します。これは RRGGBB と同じですが、先頭に 16 進アルファ値が含まれます。 完全に不透明なピクセル (最も一般的) の場合、値 FFRRGGBB が保持されます。 例: FFFF0000 は完全に不透明な完全な赤です。 |
座標間をマウスの中央ボタンでドラッグする
IA-Connect Agent ユーザー セッションで、指定した 2 つの座標間でマウスの中央ボタンをドラッグします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
開始 X ピクセル数
|
StartXCoord | True | integer |
開始 X 座標値 (ピクセル単位)。 |
|
開始 Y ピクセル数
|
StartYCoord | True | integer |
開始 Y 座標値 (ピクセル単位)。 |
|
最後の X ピクセル
|
EndXCoord | True | integer |
終了 X 座標値 (ピクセル単位)。 |
|
最後の Y ピクセル
|
EndYCoord | True | integer |
終了 Y 座標値 (ピクセル単位)。 |
|
ステップ数
|
NumberOfSteps | integer |
ドラッグ アクションを分解するステップの数。 |
|
|
合計時間 (秒)
|
TotalTimeInSeconds | double |
ドラッグ アクションの最初から最後までに要する合計時間。 |
|
|
最大移動ピクセル ジッター
|
MaximumMovementPixelJitter | integer |
ドラッグ アクション実行中の最大ピクセル ジッター。 値が高いほど、ドラッグ アクションの表示が 'スムーズ' でなくなります。 |
|
|
最大エンド ピクセル ジッター
|
MaximumEndPixelJitter | integer |
ドラッグ アクションの最後の最大ピクセル ジッター。 値が高いほど、終了座標に到達したときのドラッグの精度が低くなります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標間をマウスの右ボタンでドラッグする
IA-Connect Agent ユーザー セッションで、指定した 2 つの座標間でマウスの右ボタンをドラッグします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
開始 X ピクセル数
|
StartXCoord | True | integer |
開始 X 座標値 (ピクセル単位)。 |
|
開始 Y ピクセル数
|
StartYCoord | True | integer |
開始 Y 座標値 (ピクセル単位)。 |
|
最後の X ピクセル
|
EndXCoord | True | integer |
終了 X 座標値 (ピクセル単位)。 |
|
最後の Y ピクセル
|
EndYCoord | True | integer |
終了 Y 座標値 (ピクセル単位)。 |
|
ステップ数
|
NumberOfSteps | integer |
ドラッグ アクションを分解するステップの数。 |
|
|
合計時間 (秒)
|
TotalTimeInSeconds | double |
ドラッグ アクションの最初から最後までに要する合計時間。 |
|
|
最大移動ピクセル ジッター
|
MaximumMovementPixelJitter | integer |
ドラッグ アクション実行中の最大ピクセル ジッター。 値が高いほど、ドラッグ アクションの表示が 'スムーズ' でなくなります。 |
|
|
最大エンド ピクセル ジッター
|
MaximumEndPixelJitter | integer |
ドラッグ アクションの最後の最大ピクセル ジッター。 値が高いほど、終了座標に到達したときのドラッグの精度が低くなります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
座標間をマウスの左ボタンでドラッグする
IA-Connect Agent ユーザー セッションで、指定した 2 つの座標間でマウスの左ボタンをドラッグします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
開始 X ピクセル数
|
StartXCoord | True | integer |
開始 X 座標値 (ピクセル単位)。 |
|
開始 Y ピクセル数
|
StartYCoord | True | integer |
開始 Y 座標値 (ピクセル単位)。 |
|
最後の X ピクセル
|
EndXCoord | True | integer |
終了 X 座標値 (ピクセル単位)。 |
|
最後の Y ピクセル
|
EndYCoord | True | integer |
終了 Y 座標値 (ピクセル単位)。 |
|
ステップ数
|
NumberOfSteps | integer |
ドラッグ アクションを分解するステップの数。 |
|
|
合計時間 (秒)
|
TotalTimeInSeconds | double |
ドラッグ アクションの最初から最後までに要する合計時間。 |
|
|
最大移動ピクセル ジッター
|
MaximumMovementPixelJitter | integer |
ドラッグ アクション実行中の最大ピクセル ジッター。 値が高いほど、ドラッグ アクションの表示が 'スムーズ' でなくなります。 |
|
|
最大エンド ピクセル ジッター
|
MaximumEndPixelJitter | integer |
ドラッグ アクションの最後の最大ピクセル ジッター。 値が高いほど、終了座標に到達したときのドラッグの精度が低くなります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
新しいオーケストレーター延期タスクを追加する
フローから監視できるキューに新しいオーケストレーター延期タスクを追加します。 タスクは、将来の指定された時間に延期されます。 このアクションを使用して、指定した時間だけタスクを一時的に中断します (たとえば、何かを待っている場合など)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
自動化名を設定
|
SetAutomationName | string |
フロー名をタスク名として使用する場合は [自動] を選択します。または、[手動] を選択し、[自動化名] フィールドに名前を入力して、その名前を使用します。 |
|
|
自動化名
|
AutomationName | string |
これは、[自動化名の設定] フィールドで [手動] が選択されている場合にのみ使用されます。 後でタスクを識別したり、特定のフローに関連付けたりするために付けられたわかりやすい名前。 複数のタスクで同じ自動化名を使用できます。 |
|
|
遅延時間 (分)
|
DeferralTimeInMinutes | integer |
自動化タスクを遅延させる時間 (分) です。 |
|
|
保存済み遅延データ
|
DeferralStoredData | string |
このタスクで保存するオプションのデータ。 延期から継続すると、プロセス/フローで使用できるようになります。 これは通常、プロセス/フロー中に計算したデータを保存するために使用され、延期後に再び利用可能になる必要があります。 データは任意の形式で自由に保存できますが、JSON が一般的な形式です。 |
|
|
プロセス ステージ
|
ProcessStage | string |
延期後に自動化プロセス/フローを継続するポイント。 これは、特定のプロセス/フローに固有のオプションの文字列値です。 これは、次に実行するステップを決定するために、延期されたプロセス/フロー内の条件によって使用されます。 次に例を示します。延期後に継続する際、プロセス/フローを [Exchange] ステージで継続する場合は、値 'Exchange' を入力します。 |
|
|
優先順位
|
Priority | integer |
このタスクの優先度レベルを設定します (最高レベルは 1)。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
タスク ID
|
TaskId | integer |
作成した延期タスクの ID。 |
新しいオーケストレーター自動化タスクを追加する
フローから監視できるキューに新しいオーケストレーター自動化タスクを追加します。 タスクは、すぐに実行できるようにすることも、後で実行するために延期することもできます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
自動化名を設定
|
SetAutomationName | string |
フロー名をタスク名として使用する場合は [自動] を選択します。または、[手動] を選択し、[自動化名] フィールドに名前を入力して、その名前を使用します。 |
|
|
自動化名
|
AutomationName | string |
これは、[自動化名の設定] フィールドで [手動] が選択されている場合にのみ使用されます。 後でタスクを識別したり、特定のフローに関連付けたりするために付けられたわかりやすい名前。 複数のタスクで同じ自動化名を使用できます。 |
|
|
タスク入力データ
|
TaskInputData | string |
タスクの開始時にタスクで使用できるようにするオプションのデータ。 データは任意の形式で自由に保存できますが、JSON が一般的な形式です。 |
|
|
プロセス ステージ
|
ProcessStage | string |
自動化プロセス/フローを開始するポイント。 これは、特定のプロセス/フローに固有のオプションの文字列値です。 これは、次に実行するステップを決定するために、プロセス/フロー内の条件によって使用されます。 次に例を示します。プロセス/フローを [Exchange] ステージで開始する場合は、値 'Exchange' を入力します。 |
|
|
優先順位
|
Priority | integer |
この自動化タスクに優先レベルを設定します (1 が最高レベル)。 |
|
|
SLA (分単位)
|
SLA | integer |
SLA に必要な分数を設定します。 SLA がない場合は、これを 0 に設定します。 既定では、SLA の終わりに近い自動化タスクが他のタスクよりも優先されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
タスク ID
|
TaskId | integer |
作成したオーケストレーター自動化タスクの ID。 |
既存のオーケストレーター自動化タスクを延期する
すでにキューにある既存のオーケストレーター タスクを延期します。 タスクは、将来の指定された時間に延期されます。 これは通常、既存のタスクを再延期するために使用されます (つまり、タスクは以前に延期されていたため、再度延期する必要があります)。 このアクションを使用して、指定した時間だけタスクを一時的に中断します (たとえば、何かを待っている場合など)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タスク ID
|
TaskId | True | integer |
延期する (または再延期する) 既存のオーケストレーター自動化タスクの ID。 |
|
遅延時間 (分)
|
DeferralTimeInMinutes | integer |
自動化タスクを遅延させる時間 (分) です。 |
|
|
保存済み遅延データ
|
DeferralStoredData | string |
このタスクで保存するオプションのデータ。 延期から継続すると、プロセス/フローで使用できるようになります。 これは通常、プロセス/フロー中に計算したデータを保存するために使用され、延期後に再び利用可能になる必要があります。 データは任意の形式で自由に保存できますが、JSON が一般的な形式です。 |
|
|
プロセス ステージ
|
ProcessStage | string |
延期後に自動化プロセス/フローを継続するポイント。 これは、特定のプロセス/フローに固有のオプションの文字列値です。 これは、次に実行するステップを決定するために、延期されたプロセス/フロー内の条件によって使用されます。 次に例を示します。延期後に継続する際、プロセス/フローを [Exchange] ステージで継続する場合は、値 'Exchange' を入力します。 |
|
|
優先順位
|
Priority | integer |
このタスクの優先度レベルを設定します (最高レベルは 1)。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
TasksDeferExistingTaskResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
既定のプリンターを取得する
IA-Connect Agent セッションでユーザーの既定のプリンター名を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
既定のプリンター名
|
DefaultPrinterName | string |
ユーザーの既定のプリンター名。 |
既定のプリンターを設定する
IA-Connect Agent セッションでユーザーの既定のプリンターを設定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
既定のプリンター名
|
DefaultPrinterName | True | string |
ユーザーの既定のプリンター名。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
最後の入力情報を取得する
IA-Connect Agent ユーザー セッションで最後のユーザー入力を受信してから経過した時間を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
最後の入力以降の合計秒数
|
LastInputTotalSeconds | integer |
最後の入力から経過した秒数。 |
|
最後の入力以降の合計分数
|
LastInputTotalMinutes | integer |
最後の入力から経過した分数。 |
|
最後の入力以降の合計時間
|
LastInputTotalHours | integer |
最後の入力から経過した時間数。 |
最新の IA-Connect セッションに添付する
最後に接続した IA-Connect Director セッション添付します (オプションで指定されたタイプ)。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
IA-Connect のセッション タイプを検索する
|
SearchIAConnectSessionType | string |
検索するセッションの種類 (例: リモート セッションの場合は 'ローカル エージェント'、'Microsoft RDP'、'Citrix ICA'、'リモート' など)。 セッションの種類を検索するには空白のままにします。 |
|
|
待機する時間 (秒)
|
TimeToWaitInSeconds | integer |
指定したタイプのセッションが存在しない場合 (特定のタイプを指定した場合)、IA-Connect が待機すべき時間はどのくらいですか? |
|
|
タイムアウトしたら例外を発生する
|
RaiseExceptionIfTimedout | boolean |
タイムアウト期間の経過前に新しいセッションが接続されていない場合、IA-Connect で例外を発生させますか? |
|
|
仮想チャネルの接続が必要
|
VirtualChannelMustBeConnected | boolean |
IA-Connect Director は、セッションへの接続時に仮想チャネルが接続されていることを検証しますか? これにより、IA-Connect Agent は指定したセッションで確実に実行されます。 |
|
|
まだ閲覧していないセッションのみの件数
|
OnlyCountSessionsNotSeenBefore | boolean |
true に設定すると、以前に実行した '利用できる IA-Connect セッションを取得する' アクション (または IA-Connect Inspector の表示セッション) で見つかったセッションを、インデックスにカウントしません。 これにより '新しい' セッションのみをカウントできます (例: 最初の新しい Citrix セッションに添付する)。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
添付した IA-Connect セッション名
|
AttachedIAConnectSessionName | string |
接続した IA-Connect セッションの名前。 |
|
セッションに添付する
|
AttachedToSession | boolean |
IA-Connect がセッションに添付されている場合は true、そうでない場合は false を返します。 |
次のオーケストレーター自動化タスクを取得する
指定した検索条件と一致する、次のオーケストレーター自動化タスクを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
自動化名
|
AutomationName | string |
任意の名前でオーケストレーター自動化タスクを返すには、空白のままにします。 この自動化名を持つタスクのみを取得するには、値を入力します。 |
|
|
最小優先度レベル
|
MinimumPriorityLevel | integer |
指定された優先度レベル以上のオーケストレーター自動化タスクのみを返します。 例: 設定 2 は、優先度レベル 1 および 2 のタスクを返します。 |
|
|
状態を次に変更する
|
StatusChange | string |
'取得済み' に設定した場合: タスクを取得すると、他のアクションが同じタスクを実行しないように、タスクの状態を '取得済み' に変更します。 'なにもしない' に設定すると、タスクの状態を変更しません。 |
|
|
遅延日までの時間 (分)
|
MinutesUntilDeferralDate | integer |
指定された分数以内に実行する準備ができているオーケストレーター自動化タスクのみを返します。 今すぐ実行できる自動化タスクのみが必要な場合は、0 に設定します。 |
|
|
SLA を無視する
|
IgnoreSLA | boolean |
タスクに設定されている SLA を無視するには、これを true に設定します。 既定では、すぐに違反する SLA のあるタスクが、他のすべてよりも優先されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
取得したタスク
|
TaskRetrieved | boolean |
タスクが取得された場合は、true に設定します。 検索条件と一致するタスクがなかった場合は false に設定します。 |
|
タスク ID
|
TaskId | integer |
取得したオーケストレーター自動化タスクの ID。 |
|
自動化名
|
AutomationNameOutput | string |
取得した自動化タスクの名前。 |
|
遅延日時
|
DeferralDateTime | string |
取得したオーケストレーター タスクの準備完了がスケジュールされている日時。 これは UTC 形式の文字列として返されます。 |
|
保存済み遅延データ
|
DeferralStoredData | string |
タスクが延期されたときに保存されたオプションのデータ。 このデータは通常、プロセス/フローを継続するために必要ですが、このフィールドを任意の目的に使用できます。 |
|
遅延回数
|
DeferralCount | integer |
このタスクが延期された頻度。 これは通常、延期されなかった新しいタスクの場合は 0、延期されたタスクの場合は 1 以上になります。 延期されたタスクが再び延期されるたびに、オーケストレーターはこの数を自動的に増やします。 |
|
タスク入力データ
|
TaskInputData | string |
タスクが作成されたときに保存されたオプションのデータ。 このデータは通常、プロセス/フローを開始するのに使用されますが、このフィールドを任意の目的に使用できます。 |
|
優先順位
|
Priority | integer |
このオーケストレーター タスクの優先度レベルです (最高レベルは 1)。 |
|
自動化タスクの状態
|
AutomationTaskStatus | string |
取得したオーケストレーター タスクの状態です。 |
|
プロセス ステージ
|
ProcessStage | string |
延期後に延期されたプロセス/フローを継続するポイント。 これは、特定のプロセス/フローに固有のオプションの文字列値です。 これは、次に実行するステップを決定するために、延期されたプロセス/フロー内の条件によって使用されます。 |
|
受信日時
|
ReceivedDateTime | string |
オーケストレーターが最初にタスクを受信した日時。 これは UTC 形式の文字列として返されます。 |
|
遅延日までの時間 (分)
|
MinutesUntilDeferralDateOutput | integer |
このタスクの延期日までの分数 (つまり、このタスクを実行する準備ができたとき)。 このタスクを実行する準備ができている場合、分は 0 になります。 |
次のホップ IA-Connect Director を構成する
ダブルホップ シナリオで次のホップ Director を構成します。 これは、規定の IA-Connect の次のホップ Director 設定が適切でない場合にのみ必要です。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
SOAP が有効
|
SOAPEnabled | boolean |
次のホップ Director で SOAP インターフェイスを有効にしますか? |
|
|
REST が有効
|
RESTEnabled | boolean |
次のホップ Director で REST インターフェイスを有効にしますか? |
|
|
Web サーバーが有効
|
WebServerEnabled | boolean |
次のホップ Director で Web サーバーを (IA-Connect Inspector をホストするため) 有効にしますか? |
|
|
Director は localhost のみです
|
DirectorIsLocalhostOnly | boolean |
Director SOAP および REST のインターフェイスは 'localhost' のみでリッスンしますか? 他のコンピューターはこれらのインターフェイスと通信する必要がないため、これは true に設定する必要があります。 |
|
|
SOAP TCP ポート
|
SOAPTCPPort | integer |
SOAP インターフェイスが有効になっている場合、どの TCP ポートで実行しますか (デフォルトは 8002)? |
|
|
REST TCP ポート
|
RESTTCPPort | integer |
REST インターフェイスが有効になっている場合、どの TCP ポートで実行しますか (デフォルトは 8002)? |
|
|
SOAP は HTTPS を使用します
|
SOAPUsesHTTPS | boolean |
SOAP インターフェイスは HTTPS を使用していますか (HTTP ではなく)? True に設定した場合、HTTPS を容易にするために最初のホップ コンピューターに証明書が必要です。 これは、REST に使用される証明書と共有できます。 |
|
|
REST は HTTPS を使用します
|
RESTUsesHTTPS | boolean |
REST インターフェイスは HTTPS を使用しますか (HTTP ではなく)? True に設定した場合、HTTPS を容易にするために最初のホップ コンピューターに証明書が必要です。 これは、SOAP に使用される証明書と共有できます。 |
|
|
SessionId による Director TCP ポートの増分
|
IncrementDirectorTCPPortBySessionId | boolean |
Director TCP ポートが一意になるように (同じ最初のホップ ホストからのダブルホップを使用している並列セッションが複数ある場合)、最初のホップ セッション ID を Director TCP ポートに追加できます。 これは、最初のホップ Director で SOAP または REST のどちらかが有効になっている場合にのみ必要であり、既定では名前付きパイプが使用されているため、これらは通常は有効になっていません。 |
|
|
SOAP でユーザー認証を使用
|
SOAPUsesUserAuthentication | boolean |
HTTP SOAP TCP ポートでユーザー認証を使用する場合は True に設定します。 セットアップ方法については、IA-Connect インストール ガイドを参照してください。 |
|
|
REST でユーザー認証を使用
|
RESTUsesUserAuthentication | boolean |
HTTP REST TCP ポートでユーザー認証を使用する場合は True に設定します。 セットアップ方法については、IA-Connect インストール ガイドを参照してください。 |
|
|
名前付きパイプ コマンドが有効
|
CommandNamedPipeEnabled | boolean |
最初のホップ Agent は名前付きパイプを使用して最初のホップ Director と通信しますか? これは既定の通信方法です。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
次のホップの IA-Connect Director 設定をリセットする
設定されている IA-Connect Director のカスタム設定をリセットして既定の設定を復元します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
現在のマウスの座標を取得する
IA-Connect Agent ユーザー セッションで現在のマウス カーソル位置を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
X ピクセル数
|
X | integer |
X 座標値 (ピクセル単位)。 |
|
Y ピクセル数
|
Y | integer |
Y 座標値 (ピクセル単位)。 |
環境変数を展開する
IA-Connect Agent ユーザー セッションで環境変数 (%USERPROFILE% や %TEMP% など) を含む文字列を展開します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力文字列
|
InputString | True | string |
環境変数を含む入力文字列。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力文字列
|
OutputString | string |
環境変数が展開された文字列。 |
環境情報を取得する
IA-Connect Agent ユーザー セッションが実行されている環境に関する情報を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
OS のメジャー バージョン
|
OSVersionMajor | integer |
オペレーティング システムのメジャー バージョン。 |
|
OS のマイナー バージョン
|
OSVersionMinor | integer |
オペレーティング システムのマイナー バージョン。 |
|
OS ビルド バージョン
|
OSVersionBuild | integer |
オペレーティング システムのビルド バージョン。 |
|
OS は 64 ビット
|
OSIs64Bit | boolean |
オペレーティング システムが 64 ビットである場合は true を返します。 |
|
プロセッサ数
|
ProcessorCount | integer |
プロセッサ数。 |
|
合計物理 RAM (MB)
|
TotalPhysicalRAMInMB | integer |
物理 RAM の容量 (MB)。 |
|
合計仮想 RAM (MB)
|
TotalVirtualRAMInMB | integer |
仮想 RAM の容量 (MB)。 |
|
使用可能な物理 RAM (MB)
|
AvailablePhysicalRAMInMB | integer |
現在使用可能な物理 RAM の容量 (MB)。 |
|
使用可能な仮想 RAM (MB)
|
AvailableVirtualRAMInMB | integer |
現在使用可能な仮想 RAM の容量 (MB)。 |
|
OS の完全な名前
|
OSFullName | string |
オペレーティング システムの完全な名前 (Microsoft Windows Server 2019 Standard など)。 |
|
インストールされている UI のカルチャ名
|
InstalledUICultureName | string |
オペレーティング システムにインストールされているユーザー インターフェイス言語 (例: en-US)。 |
|
現在の UI のカルチャ名
|
CurrentUICultureName | string |
既定のユーザー インターフェイス言語 (例: en-US)。 |
|
現在のカルチャ名
|
CurrentCultureName | string |
既定のユーザー ロケール (例: en-GB)。 |
画面に長方形を描画する
画面座標、または画面座標を報告するアクションの出力を識別しやすくするために、画面上に長方形を描画します。 長方形は 5 秒後に自動的に削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
長方形の左端の画面ピクセルの X 座標
|
RectangleLeftPixelXCoord | True | integer |
表示する長方形の左端のピクセル。 入力「物理座標」によって、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
長方形の右端の画面ピクセルの X 座標
|
RectangleRightPixelXCoord | True | integer |
表示する長方形の右端のピクセル。 入力「物理座標」によって、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
長方形の上端の画面ピクセルの Y 座標
|
RectangleTopPixelYCoord | True | integer |
表示する長方形の上端のピクセル。 入力「物理座標」によって、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
長方形の下端の画面ピクセルの Y 座標
|
RectangleBottomPixelYCoord | True | integer |
表示する長方形の下端のピクセル。 入力「物理座標」によって、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
ペンの色
|
PenColour | string |
描画する長方形の色 (赤、緑、青、黄、紫、オレンジなど)、または文字列の 16 進コード (例: #FF0000)。 |
|
|
ペンの太さ (ピクセル単位)
|
PenThicknessPixels | integer |
強調表示の長方形の境界線の太さ (ピクセル単位)。 |
|
|
表示する秒数
|
SecondsToDisplay | integer |
長方形を表示する秒数。 |
|
|
物理座標
|
CoordinatesArePhysical | boolean |
指定されている座標が物理画面座標の場合は、true に設定します。 指定されるている座標が仮想座標の場合は false に設定します。 基本的な表示スケーリングが 100% の場合、物理座標と仮想座標は両方とも同じになります。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンド結果
|
DrawRectangleOnScreenResult | boolean |
コマンドの結果 (成功または失敗) です。 |
|
Error message
|
ErrorMessage | string |
コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。 |
親プロセス ID を取得する
指定したプロセス ID を持つ IA-Connect Agent ユーザー セッションで実行中のプロセスの親プロセスのプロセス ID を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロセス ID
|
ProcessId | True | integer |
子プロセスのプロセス ID。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
親プロセス ID
|
ParentProcessId | integer |
親プロセスのプロセス ID。 |
|
親プロセスがまだ実行中
|
ParentProcessStillRunning | boolean |
親プロセスがまだ実行中で終了していない場合は true を返します。 |
|
親プロセス名
|
ParentProcessName | string |
親プロセスのプロセス名。 |
長方形座標を変換する
長方形のピクセル座標を仮想から物理、または物理から仮想に変換します。 ポイントを変換する場合は、Right=Left、Bottom=Top と設定するだけです。 物理座標はモニター上のピクセルに直接マッピングされます。 仮想座標は DPI スケールされます。 すべての表示デバイスの基本的な表示スケーリングが 100% の場合、物理座標と仮想座標は両方とも同じになります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
長方形の左端の画面ピクセルの X 座標
|
RectangleLeftPixelXCoord | True | integer |
変換する長方形の左端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
長方形の上端の画面ピクセルの Y 座標
|
RectangleTopPixelYCoord | True | integer |
変換する長方形の上端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
長方形の右端の画面ピクセルの X 座標
|
RectangleRightPixelXCoord | True | integer |
変換する長方形の右端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
長方形の下端の画面ピクセルの Y 座標
|
RectangleBottomPixelYCoord | True | integer |
変換する長方形の下端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
変換の種類
|
ConversionType | True | string |
変換のタイプ: 物理から仮想 (PhysicalToVirtual または P2V)、または仮想から物理 (VirtualToPhysical または V2P)。 |
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
変換される長方形の左端の画面ピクセルの X 座標
|
ConvertedRectangleLeftPixelXCoord | integer |
変換される長方形の左端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
変換される長方形の上端の画面ピクセルの Y 座標
|
ConvertedRectangleTopPixelYCoord | integer |
変換される長方形の上端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
変換される長方形の右端の画面ピクセルの X 座標
|
ConvertedRectangleRightPixelXCoord | integer |
変換される長方形の右端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
変換される長方形の下端の画面ピクセルの Y 座標
|
ConvertedRectangleBottomPixelYCoord | integer |
変換される長方形の下端のピクセル。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
変換される長方形の幅
|
ConvertedRectangleWidth | integer |
変換される長方形のピクセル単位の幅。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
|
変換される長方形の高さ
|
ConvertedRectangleHeight | integer |
変換される長方形のピクセル単位の高さ。 変換タイプに応じて、仮想ピクセルまたは物理ピクセルで指定できます。 |
階層 1 の IA-Connect セッションに添付する
SOAP / REST メッセージのどちらかまたは両方を受信する Director の IA-Connect Director セッションに添付します。 これは、IA-Connect Agent へのコマンドの送信先となるセッションです。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
仮想チャネルの接続が必要
|
VirtualChannelMustBeConnected | boolean |
IA-Connect Director は、セッションへの接続時に仮想チャネルが接続されていることを検証しますか? これにより、IA-Connect Agent は指定したセッションで確実に実行されます。 |
|
|
Workflow
|
Workflow | True | string |
次の式をここに追加します: workflow() |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
階層 1 の IA-Connect セッション名に添付する
|
AttachedTier1IAConnectSessionName | string |
接続した階層 1 の IA-Connect セッションの名前。 |