次の方法で共有


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 セッションの名前。