IA-Connect Dynamic Code (プレビュー)

IA-Connect はロボティック プロセス オートメーション (RPA) プラットフォームで、クラウドからオンプレミスの仮想マシン、Citrix や Microsoft リモート デスクトップ (RDS) の接続により、RPA 機能を追加します。 これは、動的コード モジュールを開発するモジュールです。

このコネクタは、次の製品および地域で利用可能です。

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 検索テーブルからタブレット PCの検索値

現在 IA-Connect Agent に読み込んだ検索テーブルから値を取得します。

IA-Connect 検索テーブルからタブレット PCの検索列

現在 IA-Connect Agent にロードされている検索テーブルから共通名の 1 つ以上の列を取得し、テーブルとして返します。 たとえば、検索テーブルには、複数の AD グループを表す 'AD group' という名前の複数の出力列を含めることができ、それらは出力テーブルに個別の行として返されます。

IA-Connect 検索テーブルの概要を取得する

現在 IA-Connect Agent に読み込んだ検索テーブルの概要を取得します。

IA-Connect 検索テーブルをすべて削除する

現在 IA-Connect Agent に読み込んだ検索テーブルをすべて削除します。

IA-Connect 検索テーブルを削除する

現在 IA-Connect Agent に読み込んだ検索テーブルを削除します。

IA-Connect 検索テーブルを読み込む

IA-Connect Agent が実行されているコンピューターから IA-Connect 検索テーブルを読込みます。 これらの検索テーブルは、データ検索を実行するためのさらなる IA-Connect アクションで使用できます。

JSON からテーブルを取得

JSON 形式の入力テーブルを受け取り、テーブルとして返します。 これを逆シリアル化と言います。

JSON テーブルから列を削除する

JSON 形式の入力テーブルを受け取り、1 つまたは複数の列を削除して、JSON 形式の新しいテーブルを返します。 実際のテーブルから列を削除する場合は (つまり、JSON 形式ではない)、アクション "テーブルから列を削除する" を使用します。

JSON テーブルから行を削除する

JSON 形式の入力テーブルを受け取り、指定した位置の 1 つまたは複数の行を削除して、JSON 形式の新しいテーブルを返します。 実際のテーブルから行を削除する場合は (つまり、JSON 形式ではない)、アクション "テーブルから行を削除する" を使用します。 文字列配列から 1 つまたは複数の行を削除する場合は、アクション "文字列配列から行を削除する" を使用します。

JSON テーブルのセルから文字列を取得する

JSON 形式の入力テーブルを受け取り、指定したセルを文字列として返します。

JSON テーブルの列名を変更する

JSON 形式の入力テーブルを受け取り、指定した列の名前を変更して、JSON 形式の新しいテーブルを返します。 実際のテーブルから列の名前を変更する場合は (JSON 形式ではない場合)、アクション "テーブルの列名を変更する" を使用します。

JSON テーブルをフィルター処理する

JSON 入力テーブルを受け取り、テーブルをフィルター処理し (.NET DataView 行フィルター構文を使用)、新しい JSON テーブルを返します。 実際のテーブルをフィルター処理する場合 (JSON 形式ではない場合)、アクション "テーブルのフィルター処理" を使用します。 文字列配列をフィルター処理する場合は、アクション "文字列配列のフィルター処理" を使用します。

JSON テーブルを並べ替え

JSON 入力テーブルを受け取り、テーブルを並べ替えて、新しい JSON テーブルを返します。 実際のテーブルを並べ替える場合 (JSON 形式ではない場合)、アクション "テーブルの並べ替え" を使用します。 文字列配列を並べ替える場合は、アクション "文字列配列の並べ替え" を使用します。

JSON テーブル列から文字列配列を取得する

JSON 形式の入力テーブルを受け取り、指定した列を文字列配列として返します。 実際のテーブルから (JSON 形式ではない場合) 文字列配列を取得する場合は、アクション "テーブルから配列を取得" を使用します。

PowerShell スクリプトを実行する

IA-Connect Agent が動作しているセッションの PowerShell スクリプトを実行します。'PowerShell script contents' (PowerShellScriptContents) 入力で、コマンドの一部としてスクリプト コンテンツが IA-Connect Agent に渡されます。 これは、独自のカスタム PowerShell コードを実行する場合に推奨されるアクションです。 PowerShell スクリプトは、Agent スレッドとして実行されたこのアクションの以前の実行からの結果を取得するために使用することもできます。 エージェントは、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x ~ v5.x (インストールされているバージョン) を使用して PowerShell を実行します。

PowerShell バージョンを取得する

IA-Connect Agent が実行されているセッションにインストールされている PowerShell のバージョンを取得します。 これは、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x から v5.x を検出します。

PowerShell モジュールをインストール済みである

IA-Connect Agent が実行されているコンピューター上で、指定された PowerShell モジュールを検索し、インストールされているかどうかを返します。

PowerShell 自動化をインストール済みである

IA-Connect Agent を実行しているコンピューター上で PowerShell 自動化が使用可能かどうかを報告します。 PowerShell 自動化を利用できない場合、PowerShell 自動化のアクションは動作しません。

アセンブリをローカル ファイルからインポートする

IA-Connect Director が実行されているコンピューターから、IA-Connect Agent に、DotNet アセンブリをアップロードします。これはメモリに読み込まれ、動的 DotNet コードから参照される場合に使用されます。

アセンブリ検索フォルダーをクリアする

IA-Connect Agent が外部参照を読み込むときにスキャンするフォルダーの追加一覧をリセットします。

アセンブリ検索フォルダーを追加する

IA-Connect が外部参照を読み込むときにスキャンするフォルダーの一覧に、(IA-Connect が実行されているコンピューター上の) フォルダー パスを追加します。

テーブルから列を削除する

入力テーブルを受け取り、1 つまたは複数の列を削除して、新しいテーブルを返します。 実際の JSON 形式のテーブルから列を削除する場合は、アクション "JSON 形式のテーブルから列を削除する" を使用します。

テーブルから行を削除する

入力テーブルを受け取り、指定した位置の 1 つまたは複数の行を削除して、新しいテーブルを返します。 文字列配列から 1 つまたは複数の行を削除する場合は、アクション "文字列配列から行を削除する" を使用します。 JSON 形式のテーブルから 1 つまたは複数の行を削除する場合は、アクション "JSON テーブルから行を削除する" を使用します。

テーブルの列名を変更する

入力テーブルを受け取り、指定した列の名前を変更して新しいテーブルを返します。 JSON 形式のテーブルから列の名前を変更する場合は、アクション "JSON テーブルで列名を変更する" を使用します。

テーブルをフィルター処理

入力テーブルを受け取り、テーブルをフィルター処理し (.NET DataView 行フィルター構文を使用)、新しいテーブルを返します。 JSON 形式のテーブルをフィルター処理する場合は、アクション "JSON テーブルのフィルター処理" を使用します。 文字列配列をフィルター処理する場合は、アクション "文字列配列のフィルター処理" を使用します。

テーブルを並べ替える

入力テーブルを受け取り、1 つまたは複数の行を並べ替えて新しいテーブルを返します。 JSON 形式のテーブルを並べ替える場合は、アクション "JSON テーブルの並べ替え" を使用します。 文字列配列を並べ替える場合は、アクション "文字列配列の並べ替え" を使用します。

テーブル列から文字列配列を取得する

入力テーブルを受け取り、指定した列を文字列配列として返します。 JSON 形式のテーブルから文字列配列を取得する場合は、アクション "JSON テーブルから配列を取得" を使用します。

入力変数から JSON を作成する

入力変数の配列を受け取り、JSON 形式、またはオプションで JSON テーブルで返します。

入力変数の行を JSON テーブルに挿入

JSON 形式の入力テーブルを受け取り、入力変数から作成した行を指定した位置に挿入して、JSON 形式の新しいテーブルを返します。 入力行スキーマは、入力テーブルのスキーマと一致する必要があります (同じプロパティ名とデータ型を使用します)。 実際のテーブルに行を挿入する場合は (JSON 形式ではない場合)、アクション "テーブルに行を挿入する" を使用します。 文字列配列に文字列を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。

文字列から文字を削除する

入力文字列を受け取り、指定した文字が削除された状態で返します。 指定された文字が見つからない場合は、元の文字列が返されます。

文字列配列から JSON テーブルを取得する

文字列項目の入力配列を受け取り、JSON テーブルとして返します。

文字列配列からテーブルを取得

文字列項目の入力配列を受け取り、テーブルとして返します。

文字列配列から項目を削除する

文字列項目の入力配列を受け取り、指定された位置にある 1 つまたは複数の項目を削除して、新しい配列を返します。 テーブルから 1 つまたは複数の行を削除する場合は、アクション "テーブルから行を削除する" を使用します。 JSON 形式のテーブルから 1 つまたは複数の行を削除する場合は、アクション "JSON テーブルから行を削除する" を使用します。

文字列配列をフィルター処理する

文字列項目の入力配列を受け取り、配列をフィルター処理し (.NET DataView 行フィルター構文を使用)、新しい配列を返します。 テーブルをフィルター処理する場合は、アクション "テーブルのフィルター処理" を使用します。 JSON 形式のテーブルをフィルター処理する場合は、アクション "JSON テーブルのフィルター処理" を使用します。

文字列配列を並べ替える

文字列項目の入力配列を受け取り、配列を並べ替えて新しい配列を返します。 テーブルを並べ替える場合は、アクション "テーブルの並べ替え" を使用します。 JSON 形式のテーブルを並べ替える場合は、アクション "JSON テーブルの並べ替え" を使用します。

文字列間を取得

入力文字列を受け取り、指定した 2 つの文字列の間または文字列と行末尾の間にある文字列の、最初のインスタンスを返します。

正規表現の一致を取得する

入力文字列に対して正規表現 (regex) による照合を実行し、文字列が式と一致したかどうか、さらにその一致の詳細を返します。

正規表現の一致を取得する

入力文字列に対して正規表現 (regex) による照合を実行し、文字列配列で一致したすべてを返します。 一致するものがなかった場合、配列は空になります。

正規表現を使用して文字列を分割する

正規表現 (regex) による照合で入力文字列を分割し、文字列を分割した個別のコンポーネントを文字列配列として返します。

正規表現グループの一致を取得する

入力文字列に対して正規表現 (regex) による照合を実行し、一致したグループ名と値のリストを返します。

行を JSON テーブルに挿入

JSON 形式の入力テーブルを受け取り、指定した位置の行を挿入して、JSON 形式の新しいテーブルを返します。 実際のテーブルに行を挿入する場合は (JSON 形式ではない場合)、アクション "テーブルに行を挿入する" を使用します。 文字列配列に文字列を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。

行をテーブルに挿入する

入力テーブルを受け取り、指定した位置に行を挿入して、新しいテーブルを返します。 文字列配列に文字列を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。 JSON 形式のテーブルに行を挿入する場合は、アクション "JSON テーブルに行を挿入する" を使用します。

行を文字列配列に挿入する

文字列項目の入力配列を受け取り、指定された位置に行を挿入して、新しい配列を返します。 テーブルに行を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。 JSON 形式のテーブルに行を挿入する場合は、アクション "JSON テーブルに行を挿入する" を使用します。

IA-Connect 検索テーブルからタブレット PCの検索値

現在 IA-Connect Agent に読み込んだ検索テーブルから値を取得します。

パラメーター

名前 キー 必須 説明
Lookup table name
LookupTableName True string

IA-Connect Agent に読み込まれた検索テーブルの名前です。

Input data JSON
InputDataJSON string

検索に使用する JSON 形式の入力データです。

Search result value column name
SearchResultValueColumnName True string

読み取る戻り値を保持する、検索テーブルの列。

Search result value column index
SearchResultValueColumnIndex integer

1 (既定) に設定すると、要求した名前と一致する最初の結果列の値を返します。 N 番目に一致する列を返すには、より高い値 (N) に設定します。

Raise exception if no match
RaiseExceptionIfNoMatch boolean

検索がデータに一致しない場合に例外を発生させるには、true (規定) に設定します。 検索がデータと一致しない場合に空白の文字列を返すには、false に設定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
Output lookup value
OutputLookupValue string

IA-Connect 検索テーブルの入力データを検索することで取得した、指定した検索テーブル列による出力値。

IA-Connect 検索テーブルからタブレット PCの検索列

現在 IA-Connect Agent にロードされている検索テーブルから共通名の 1 つ以上の列を取得し、テーブルとして返します。 たとえば、検索テーブルには、複数の AD グループを表す 'AD group' という名前の複数の出力列を含めることができ、それらは出力テーブルに個別の行として返されます。

パラメーター

名前 キー 必須 説明
Lookup table name
LookupTableName True string

IA-Connect Agent に読み込まれた検索テーブルの名前です。

Input data JSON
InputDataJSON string

検索に使用する JSON 形式の入力データです。

Search result table column name
SearchResultTableColumnName True string

出力テーブルで返す値を保持する、検索テーブルが含む 1 件以上の列の名前。

Raise exception if no match
RaiseExceptionIfNoMatch boolean

検索がデータに一致しない場合に例外を発生させるには、true (規定) に設定します。 検索がデータと一致しない場合に空白の文字列を返すには、false に設定します。

Return blank cells
ReturnBlankCells boolean

返すテーブルに空白のセルを含める場合は、true に設定します。 false (規定) に設定すると、値を持つセルのみが含まれます。

Return format
ReturnFormat string

結果を返す際に使用する形式。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
Output lookup table JSON
OutputLookupTableJSON string

IA-Connect 検索テーブルに対して入力データを検索することで取得した、指定した名前を持つ 1 つ以上の検索テーブル列からの出力テーブル読み取り。 出力テーブルには、JSON 形式の 1 つの列 (要求された結果テーブルの列名と一致) と 1 つ以上の行があります。

Output lookup table
OutputLookupTable array of object

IA-Connect 検索テーブルに対して入力データを検索することで取得した、指定した名前を持つ 1 つ以上の検索テーブル列からの出力テーブル読み取り。 出力テーブルには、1 つの列 (要求された結果テーブルの列名と一致) と 1 つ以上の行があります。

items
OutputLookupTable object
Output lookup array
OutputLookupArray array of object

IA-Connect 検索テーブルに対して入力データを検索することで取得した、指定した名前を持つ 1 つ以上の検索テーブル列からの出力配列読み取り。 出力配列は、1 つ以上の行を持つ単一の列です。

items
OutputLookupArray object
Number of rows in output
NumberOfRowsInOutput integer

出力の行数。

IA-Connect 検索テーブルの概要を取得する

現在 IA-Connect Agent に読み込んだ検索テーブルの概要を取得します。

パラメーター

名前 キー 必須 説明
Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
Lookup tables JSON
LookupTablesJSON array of object

IA-Connect Agent に読み込んだ検索テーブル。

件名
LookupTablesJSON.Name string
ThenColumnIndex
LookupTablesJSON.ThenColumnIndex integer
NumberOfRows
LookupTablesJSON.NumberOfRows integer
NumberOfColumns
LookupTablesJSON.NumberOfColumns integer
NumberOfUniqueHeaderProperties
LookupTablesJSON.NumberOfUniqueHeaderProperties integer
Number of lookup tables
NumberOfLookupTables integer

現在 IA-Connect Agent に読み込んだ検索テーブルの件数。

IA-Connect 検索テーブルをすべて削除する

現在 IA-Connect Agent に読み込んだ検索テーブルをすべて削除します。

パラメーター

名前 キー 必須 説明
Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
コマンド結果
RemoveAllIAConnectLookupTablesResult boolean

コマンドの結果 (成功または失敗) です。

Error message
ErrorMessage string

コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。

IA-Connect 検索テーブルを削除する

現在 IA-Connect Agent に読み込んだ検索テーブルを削除します。

パラメーター

名前 キー 必須 説明
Lookup table name
LookupTableName True string

IA-Connect Agent に読み込まれた検索テーブルの名前です。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
コマンド結果
RemoveIAConnectLookupTableResult boolean

コマンドの結果 (成功または失敗) です。

Error message
ErrorMessage string

コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。

IA-Connect 検索テーブルを読み込む

IA-Connect Agent が実行されているコンピューターから IA-Connect 検索テーブルを読込みます。 これらの検索テーブルは、データ検索を実行するためのさらなる IA-Connect アクションで使用できます。

パラメーター

名前 キー 必須 説明
Lookup table path
Path True string

検索テーブルへのフル パス。 IA-Connect Agent が実行されているセッションからこれにアクセスできる必要があります。 フォルダーが指定されている場合、そのフォルダーの下にあるすべてのファイルが処理されます。

Raise exception if any table fails to load
RaiseExceptionIfAnyTableFailsToLoad True boolean

IA-Connect 検索テーブルの読込みに失敗した場合 (たとえば、テーブルに問題がある場合)、例外が発生します。 これは規定です。テーブルの読込みに失敗した場合、通常、プロセスの後半で例外が発生するためです。 false に設定すると、問題の検索テーブルは無視され、使用可能な検索テーブルのみが loade3d になります。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
Number of lookup tables loaded
NumberOfLookupTablesLoaded integer

正常に読み込んだ検索テーブルの件数。

Number of lookup tables failed to load
NumberOfLookupTablesFailedToLoad integer

The number of lookup tables which failed to load. 'いずれかのテーブルが読み込みに失敗したら例外を発生させる' を false に設定した場合のみ、これが設定されます。それ以外の場合は例外が発生するためです。

JSON からテーブルを取得

JSON 形式の入力テーブルを受け取り、テーブルとして返します。 これを逆シリアル化と言います。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

開始行インデックス
StartRowIndex True integer

取得する最初の行のインデックス。 1 を使用して最初の行で開始し、N を使用して N 番目の行で開始します。

取得する行の数
NumberOfRowsToRetrieve integer

取得する行の数。 すべての行を取得するには、0 を使用します (または空白のままにします)。

開始列インデックス
StartColumnIndex integer

取得する最初の列のインデックス。 1 を使用して最初の列で開始し、N を使用して N 番目の列で開始します。 取得する最初の列を名前別に指定する場合は、ここを空白のままにし、代わりに "開始する列名" 入力を使用してください。

開始する列名
StartColumnName string

取得する最初の列のオプションの名前。 インデックスを指定して列を取得する場合は、ここに何も入力せず、代わりに "開始する列インデックス" を使用して入力してください。

取得する列の数
NumberOfColumnsToRetrieve integer

取得する列の数。 すべての列を取得するには、0 を使用します (または空白のままにします)。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です (常に 1 である必要があります)。

JSON テーブルから列を削除する

JSON 形式の入力テーブルを受け取り、1 つまたは複数の列を削除して、JSON 形式の新しいテーブルを返します。 実際のテーブルから列を削除する場合は (つまり、JSON 形式ではない)、アクション "テーブルから列を削除する" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

開始列インデックス
StartColumnIndex integer

削除を開始する列のインデックス。 1 を使用して最初の列を削除し、N を使用して N 番目の列を削除します。 名前を指定して列を削除する場合は、ここに何も入力せず、代わりに "削除する列名" を使用して入力してください。

削除する列名
ColumnNameToDelete string

削除する列の名前 (オプション) です。 インデックスを指定して列を削除する場合は、ここに何も入力せず、代わりに "列インデックスの開始" を使用して入力してください。

削除する列の数
NumberOfColumnsToDelete True integer

指定したインデックスまたは名前から始まる、削除する列の数です。

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

JSON テーブルから行を削除する

JSON 形式の入力テーブルを受け取り、指定した位置の 1 つまたは複数の行を削除して、JSON 形式の新しいテーブルを返します。 実際のテーブルから行を削除する場合は (つまり、JSON 形式ではない)、アクション "テーブルから行を削除する" を使用します。 文字列配列から 1 つまたは複数の行を削除する場合は、アクション "文字列配列から行を削除する" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

開始行インデックス
StartRowIndex True integer

削除を開始する行のインデックス。 1 を使用して最初の行を削除し、N を使用して N 番目の行を削除します。

削除する行の数
NumberOfRowsToDelete True integer

削除する行の数です。

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

JSON テーブルのセルから文字列を取得する

JSON 形式の入力テーブルを受け取り、指定したセルを文字列として返します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

行インデックス
RowIndex integer

取得するセルを含む行のインデックス。 最初の行には 1 を使用し、N 番目の行には N を使用します。

列のインデックス
ColumnIndex integer

取得するセルを含む列のインデックス。 最初の列には 1 を使用し、N 番目の列には N を使用します。 名前を指定して列を取得する場合は、ここに何も入力せず、代わりに "列名" を使用して入力してください。

列名
ColumnName string

取得するセルを含む列のオプションの名前。 インデックスを指定して列を取得する場合は、ここに何も入力せず、代わりに "列インデックス" を使用して入力してください。

戻り値

名前 パス 説明
出力文字列
OutputString string

出力されるセルの内容 (文字列) です。

JSON テーブルの列名を変更する

JSON 形式の入力テーブルを受け取り、指定した列の名前を変更して、JSON 形式の新しいテーブルを返します。 実際のテーブルから列の名前を変更する場合は (JSON 形式ではない場合)、アクション "テーブルの列名を変更する" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

ソース列名
SourceColumnName True string

名前を変更する列の名前です。

新しい列名
NewColumnName True string

列の新しい名前。

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

JSON テーブルをフィルター処理する

JSON 入力テーブルを受け取り、テーブルをフィルター処理し (.NET DataView 行フィルター構文を使用)、新しい JSON テーブルを返します。 実際のテーブルをフィルター処理する場合 (JSON 形式ではない場合)、アクション "テーブルのフィルター処理" を使用します。 文字列配列をフィルター処理する場合は、アクション "文字列配列のフィルター処理" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

フィルター
Filter True string

.NET DataView 行フィルター構文のフィルター。 例: "*要素" などの [名前]。

列名を並べ替える
SortColumnName string

並べ替えるオプションの列名です (フィルターの適用後)。 複数の列で並べ替える場合は、複数の列をコンマ区切りで指定します。

昇順に並べ替え
Ascending boolean

[昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 2
SortColumnName2 string

並べ替えるオプションの 2 列目の名前です (最初の列による並べ替え後)。

昇順で並べ替え 2
Ascending2 boolean

[2 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 3
SortColumnName3 string

並べ替えるオプションの 3 列目の名前です (1 列目と 2 列目による並べ替え後)。

昇順で並べ替え 3
Ascending3 boolean

[3 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

JSON テーブルを並べ替え

JSON 入力テーブルを受け取り、テーブルを並べ替えて、新しい JSON テーブルを返します。 実際のテーブルを並べ替える場合 (JSON 形式ではない場合)、アクション "テーブルの並べ替え" を使用します。 文字列配列を並べ替える場合は、アクション "文字列配列の並べ替え" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

列名を並べ替える
SortColumnName True string

並べ替えに使用する列名。

昇順で並べ替え
Ascending boolean

[昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 2
SortColumnName2 string

並べ替えるオプションの 2 列目の名前です (最初の列による並べ替え後)。

昇順で並べ替え 2
Ascending2 boolean

[2 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 3
SortColumnName3 string

並べ替えるオプションの 3 列目の名前です (1 列目と 2 列目による並べ替え後)。

昇順で並べ替え 3
Ascending3 boolean

[3 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

JSON テーブル列から文字列配列を取得する

JSON 形式の入力テーブルを受け取り、指定した列を文字列配列として返します。 実際のテーブルから (JSON 形式ではない場合) 文字列配列を取得する場合は、アクション "テーブルから配列を取得" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

列のインデックス
ColumnIndex integer

配列として返される列のインデックス。 最初の列には 1 を使用し、N 番目の列には N を使用します。 名前を指定して列を取得する場合は、ここに何も入力せず、代わりに "列名" を使用して入力してください。

列名
ColumnName string

配列として返される列のオプションの名前。 インデックスを指定して列を取得する場合は、ここに何も入力せず、代わりに "列インデックス" を使用して入力してください。

戻り値

名前 パス 説明
出力配列
OutputArray array of string

文字列の出力配列です。

項目の数
NumberOfItems integer

出力配列内の項目の数です。

PowerShell スクリプトを実行する

IA-Connect Agent が動作しているセッションの PowerShell スクリプトを実行します。'PowerShell script contents' (PowerShellScriptContents) 入力で、コマンドの一部としてスクリプト コンテンツが IA-Connect Agent に渡されます。 これは、独自のカスタム PowerShell コードを実行する場合に推奨されるアクションです。 PowerShell スクリプトは、Agent スレッドとして実行されたこのアクションの以前の実行からの結果を取得するために使用することもできます。 エージェントは、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x ~ v5.x (インストールされているバージョン) を使用して PowerShell を実行します。

パラメーター

名前 キー 必須 説明
PowerShell スクリプトのコンテンツ
PowerShellScriptContents string

実行する PowerShell スクリプトのコンテンツ。 IA-Connect は、PowerShell 自動化エンジンに直接渡してこのスクリプトをそのまま実行します。 PowerShell スクリプトは、実際にはディスク上に作成されません。

コンピューター名
ComputerName string

PowerShell スクリプトを実行するコンピューターの名前。 空白のままにした場合、IA-Connect Agent が実行されているコンピューターでスクリプトが実行されます。

結果が返されない場合にエラーかどうか
IsNoResultAnError boolean

PowerShell コマンドからデータが返されない場合に、エラーを意味するかどうか

複合型を返す
ReturnComplexTypes boolean

(System.String、System.Boolean、System.Date などの単純型でなく) 複合型を持つプロパティを返すかどうか。

ブール値をブール値として返す
ReturnBooleanAsBoolean boolean

ブール値プロパティをブール値として返す必要がありますか? false の場合、文字列として返されます。

数値を小数として返す
ReturnNumericAsDecimal boolean

数値プロパティを数値として返す必要がありますか? false の場合、文字列として返されます。

日付を日付として返す
ReturnDateAsDate boolean

日付プロパティは日付として返す必要がありますか? false の場合、文字列として返されます。

Properties to return as collection
PropertiesToReturnAsCollectionJSON string

一部のプロパティ (PowerShell の戻り結果) は値のコレクション (配列やテーブルなど) であり、既定では IA-Connect PowerShell 応答では返されません。 このオプションを使用すると、IA-Connect がコレクションとして返そうとするプロパティを指定することができ、JSON または CSV 形式で入力できます。 例: EmailAddresses および MemberOf 配列プロパティを返すには、[{PropertyName": "EmailAddresses"}、{"PropertyName": "MemberOf"}] (JSON 形式) または EmailAddresses、MemberOf (CSV 形式) を入力します。

Authentication mechanism
AuthenticationMechanism string

リモート コンピューターに接続する場合、または代替ユーザーとしてスクリプトを実行する場合に使用される認証メカニズム。 サポートされる値は、「Basic」、「Credssp」、「Default」、「Digest」、「Kerberos」、「Negotiate」です。

接続の試行
ConnectionAttempts integer

リモート コンピューターに接続する場合に試行する接続の数。

ユーザー名
Username string

代替ユーザーとしてスクリプトを実行する場合に使用するユーザー名。

パスワード
Password password

代替ユーザーとしてスクリプトを実行する場合に使用するパスワード。

スレッドとしてスクリプトを実行する
RunScriptAsThread boolean

False (デフォルト) に設定すると、 IA-Connect エージェントは PowerShell スクリプトをすぐに実行し、スクリプトが完了すると結果をディレクター Director に返します。 長いまたは複雑な PowerShell スクリプトを実行している場合、このアクションはタイムアウトになることがあります。true に設定すると、 IA-Connect Agent は PowerShell スクリプトを Agent スレッドとして読み取り、IA-Connect Director (またはオーケストレーター、PowerShell モジュール、Blue Prism) は、この Agent スレッドのステータスを監視し、完了するのを待つことができます。 これにより、長いまたは複雑な PowerShell スクリプトをタイムアウトせずに実行できます。 IA-Connect Agent 9.3 以前では、PowerShell スクリプトを Agent スレッドとして実行できません。

スレッド ID の出力データを取得する
RetrieveOutputDataFromThreadId integer

以前に PowerShell スクリプトを Agent スレッドとして実行し、「スレッドを待機する秒数」を 0 に設定した場合は、Agent スレッド ID を指定して結果を取得します。 このエージェント スレッド ID は、このアクションへの以前の呼び出しによって提供されます。 PowerShell スクリプトを実行している場合 (したがって、Agent スレッドとして実行された以前の PowerShell スクリプトの結果を取得しない場合) は、0 (デフォルト) に設定します。

スレッドを待機する秒数
SecondsToWaitForThread integer

「スクリプトをスレッドとして実行する」が true に設定されている場合に、Agent スレッドが完了するまで待機する秒数。 PowerShell スクリプトを実行する Agent スレッドがこの時間内に完了していない場合、例外が発生します。 待機をバイパスするには、0 に設定します。Agent は PowerShell スクリプトの実行を続けますが、次のアクションでも使用できます。 その後、「Agent スレッドが正常に完了するまで待機する」アクションを使用して Agent スレッドが完了するのを待ってから、入力「スレッド ID の出力データを取得する」をAgent スレッド ID に設定してこの「PowerShell スクリプトを実行する」アクションを再実行することで、後でスクリプト (DataGrid のコンテンツ) を取得できます。

スクリプトには保存されたパスワードが含まれます
ScriptContainsStoredPassword boolean

スクリプトに、IA-Connect に保存されているパスワード識別子 (形式: {IAConnectPassword:StoredPasswordIdentifier}) または IA-Connect オーケストレーター汎用資格情報 (形式: {OrchestratorCredential:FriendlyName}) が含まれる場合は、true に設定します。 { } フレーズは、指定されたパスワードに置き換えられ、エスケープされ、一重引用符で囲まれます (スクリプト内で既に引用符で囲まれている場合を除く)。

冗長出力を記録する
LogVerboseOutput boolean

PowerShell の冗長出力を IA-Connect ログに記録するには、true に設定します。 これは、機能はデバッグに役立つ可能性があります。

安全な文字列を返す
ReturnSecureStrings boolean

PowerShell スクリプト出力でセキュリティで保護された文字列プロパティを返すには、true に設定します。 セキュリティで保護された文字列として保持されるプロパティを返さない場合は、false (デフォルト) に設定します。 これにより、パスワードが送信される可能性があるため (PowerShell スクリプト出力にパスワードがある場合)、何をしているのかわかっている場合にのみ true に設定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
PowerShell 出力 JSON
PowerShellJSONOutput string

JSON 形式の PowerShell スクリプトの出力。

スレッド ID
ThreadId integer

PowerShell スクリプトが Agent スレッドとして実行されている場合、この出力には Agent スレッド ID が保持されます。これを使用して、アクションのプロセスを監視し、スクリプトが完了したときに PowerShell スクリプト結果を取得できます。

PowerShell バージョンを取得する

IA-Connect Agent が実行されているセッションにインストールされている PowerShell のバージョンを取得します。 これは、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x から v5.x を検出します。

パラメーター

名前 キー 必須 説明
コンピューター名
ComputerName string

PowerShell バージョンを確認するコンピューターの名前。 空白のままにした場合、IA-Connect Agent が実行されているコンピューターが使用されます。

Authentication mechanism
AuthenticationMechanism string

リモート コンピューターに接続する場合、または代替ユーザーとしてスクリプトを実行する場合に使用される認証メカニズム。 サポートされる値は、「Basic」、「Credssp」、「Default」、「Digest」、「Kerberos」、「Negotiate」です。

接続の試行
ConnectionAttempts integer

リモート コンピューターに接続する場合に試行する接続の数。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
PowerShell メジャー バージョン
PowerShellMajorVersion integer

PowerShell のメジャー (整数) バージョン。 例: PowerShell 5.1 は 5 を返します。

PowerShell マイナー バージョン
PowerShellMinorVersion integer

PowerShell のマイナー (小数点以下) バージョン。 例: PowerShell 5.1 は 1 を返します。

PowerShell モジュールをインストール済みである

IA-Connect Agent が実行されているコンピューター上で、指定された PowerShell モジュールを検索し、インストールされているかどうかを返します。

パラメーター

名前 キー 必須 説明
PowerShellモジュール
PowerShellModuleName True string

検索する PowerShell モジュールの名前。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
PowerShell モジュールをインストール済みである
PowerShellModuleIsInstalled boolean

指定された PowerShell モジュールがインストールされている場合は true、そうでない場合は false を返します。

PowerShell 自動化をインストール済みである

IA-Connect Agent を実行しているコンピューター上で PowerShell 自動化が使用可能かどうかを報告します。 PowerShell 自動化を利用できない場合、PowerShell 自動化のアクションは動作しません。

パラメーター

名前 キー 必須 説明
Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
PowerShell 自動化をインストール済みである
PowerShellAutomationIsInstalled boolean

PowerShell 自動化を利用できる場合は true、そうでない場合は false を返します。

アセンブリをローカル ファイルからインポートする

IA-Connect Director が実行されているコンピューターから、IA-Connect Agent に、DotNet アセンブリをアップロードします。これはメモリに読み込まれ、動的 DotNet コードから参照される場合に使用されます。

パラメーター

名前 キー 必須 説明
ローカル アセンブリのファイル パス
LocalAssemblyFilePath True string

ローカル セッションのローカル アセンブリ ファイルへのファイルパス (IA-Connect Director が実行されている場所)。

アセンブリ名
AssemblyName True string

インポートされるアセンブリの名前。

圧縮
Compress boolean

アップロードする前にアセンブリを圧縮するかどうか。

ワークフロー
Workflow True string

次の式をここに追加します: workflow()

戻り値

アセンブリ検索フォルダーをクリアする

IA-Connect Agent が外部参照を読み込むときにスキャンするフォルダーの追加一覧をリセットします。

パラメーター

名前 キー 必須 説明
Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

アセンブリ検索フォルダーを追加する

IA-Connect が外部参照を読み込むときにスキャンするフォルダーの一覧に、(IA-Connect が実行されているコンピューター上の) フォルダー パスを追加します。

パラメーター

名前 キー 必須 説明
Folder path
FolderPath True string

IA-Connect Agent が外部参照を読み込むときにスキャンするフォルダーの一覧に追加するフォルダーへのパス。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

テーブルから列を削除する

入力テーブルを受け取り、1 つまたは複数の列を削除して、新しいテーブルを返します。 実際の JSON 形式のテーブルから列を削除する場合は、アクション "JSON 形式のテーブルから列を削除する" を使用します。

パラメーター

名前 キー 必須 説明
入力テーブル
Input table object
開始列インデックス
StartColumnIndex integer

削除を開始する列のインデックス。 1 を使用して最初の列を削除し、N を使用して N 番目の列を削除します。 名前を指定して列を削除する場合は、ここに何も入力せず、代わりに "削除する列名" を使用して入力してください。

削除する列名
ColumnNameToDelete string

削除する列の名前 (オプション) です。 インデックスを指定して列を削除する場合は、ここに何も入力せず、代わりに "列インデックスの開始" を使用して入力してください。

削除する列の数
NumberOfColumnsToDelete True integer

指定したインデックスまたは名前から始まる、削除する列の数です。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

テーブルから行を削除する

入力テーブルを受け取り、指定した位置の 1 つまたは複数の行を削除して、新しいテーブルを返します。 文字列配列から 1 つまたは複数の行を削除する場合は、アクション "文字列配列から行を削除する" を使用します。 JSON 形式のテーブルから 1 つまたは複数の行を削除する場合は、アクション "JSON テーブルから行を削除する" を使用します。

パラメーター

名前 キー 必須 説明
入力テーブル
Input table object
開始行インデックス
StartRowIndex True integer

削除を開始する行のインデックス。 1 を使用して最初の行を削除し、N を使用して N 番目の行を削除します。

削除する行の数
NumberOfRowsToDelete True integer

削除する行の数です。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

テーブルの列名を変更する

入力テーブルを受け取り、指定した列の名前を変更して新しいテーブルを返します。 JSON 形式のテーブルから列の名前を変更する場合は、アクション "JSON テーブルで列名を変更する" を使用します。

パラメーター

名前 キー 必須 説明
入力テーブル
Input table object
ソース列名
SourceColumnName True string

名前を変更する列の名前です。

新しい列名
NewColumnName True string

列の新しい名前。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

テーブルをフィルター処理

入力テーブルを受け取り、テーブルをフィルター処理し (.NET DataView 行フィルター構文を使用)、新しいテーブルを返します。 JSON 形式のテーブルをフィルター処理する場合は、アクション "JSON テーブルのフィルター処理" を使用します。 文字列配列をフィルター処理する場合は、アクション "文字列配列のフィルター処理" を使用します。

パラメーター

名前 キー 必須 説明
入力テーブル
Input table object
フィルター
Filter True string

.NET DataView 行フィルター構文のフィルター。 例: "*要素" などの [名前]。

列名を並べ替える
SortColumnName string

並べ替えるオプションの列名です (フィルターの適用後)。 複数の列で並べ替える場合は、複数の列をコンマ区切りで指定します。

昇順に並べ替え
Ascending boolean

[昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 2
SortColumnName2 string

並べ替えるオプションの 2 列目の名前です (最初の列による並べ替え後)。

昇順で並べ替え 2
Ascending2 boolean

[2 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 3
SortColumnName3 string

並べ替えるオプションの 3 列目の名前です (1 列目と 2 列目による並べ替え後)。

昇順で並べ替え 3
Ascending3 boolean

[3 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

テーブルを並べ替える

入力テーブルを受け取り、1 つまたは複数の行を並べ替えて新しいテーブルを返します。 JSON 形式のテーブルを並べ替える場合は、アクション "JSON テーブルの並べ替え" を使用します。 文字列配列を並べ替える場合は、アクション "文字列配列の並べ替え" を使用します。

パラメーター

名前 キー 必須 説明
入力テーブル
Input table object
列名を並べ替える
SortColumnName True string

並べ替えに使用する列名。 複数の列で並べ替える場合は、複数の列をコンマ区切りで指定します。

昇順に並べ替え
Ascending True boolean

[昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 2
SortColumnName2 string

並べ替えるオプションの 2 列目の名前です (最初の列による並べ替え後)。

昇順で並べ替え 2
Ascending2 boolean

[2 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

列名を並べ替える 3
SortColumnName3 string

並べ替えるオプションの 3 列目の名前です (1 列目と 2 列目による並べ替え後)。

昇順で並べ替え 3
Ascending3 boolean

[3 列目の名前を昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

テーブル列から文字列配列を取得する

入力テーブルを受け取り、指定した列を文字列配列として返します。 JSON 形式のテーブルから文字列配列を取得する場合は、アクション "JSON テーブルから配列を取得" を使用します。

パラメーター

名前 キー 必須 説明
入力テーブル
Input table object
列のインデックス
ColumnIndex integer

配列として返される列のインデックス。 最初の列には 1 を使用し、N 番目の列には N を使用します。 名前を指定して列を取得する場合は、ここに何も入力せず、代わりに "列名" を使用して入力してください。

列名
ColumnName string

配列として返される列のオプションの名前。 インデックスを指定して列を取得する場合は、ここに何も入力せず、代わりに "列インデックス" を使用して入力してください。

戻り値

名前 パス 説明
出力配列
OutputArray array of string

文字列の出力配列です。

項目の数
NumberOfItems integer

出力配列内の項目の数です。

入力変数から JSON を作成する

入力変数の配列を受け取り、JSON 形式、またはオプションで JSON テーブルで返します。

パラメーター

名前 キー 必須 説明
プロパティ名
PropertyName string
プロパティのデータ型
DataType string
プロパティ値
Value string
JSON テーブルとして返す
ReturnAsJSONTable True boolean

true に設定すると、JSON はテーブル/データテーブル形式 (つまり、[{}] の形式) で返されます。 false に設定すると、JSON は単一のエンティティとして (つまり、{} の形式) 返されます。 使用する形式は、JSON で何をしているかによって異なります。 ほとんどの IA-Connect アクションは、データテーブル形式を想定しています。

戻り値

名前 パス 説明
出力 JSON
OutputJSON string

JSON 形式でエンコードされた変数とその値。

入力変数の行を JSON テーブルに挿入

JSON 形式の入力テーブルを受け取り、入力変数から作成した行を指定した位置に挿入して、JSON 形式の新しいテーブルを返します。 入力行スキーマは、入力テーブルのスキーマと一致する必要があります (同じプロパティ名とデータ型を使用します)。 実際のテーブルに行を挿入する場合は (JSON 形式ではない場合)、アクション "テーブルに行を挿入する" を使用します。 文字列配列に文字列を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

行インデックス
RowIndex True integer

挿入する行のインデックス。 テーブルの最初に挿入するには 0 を使用し、行 1 の後に挿入するには 1 を使用します。行 N の後に挿入するには N を使用します。テーブルの最後に挿入する場合は -1 またはテーブルの項目数よりも大きい任意の数字を使用します (テーブルの長さがわからない場合に便利です)。

プロパティ名
PropertyName string
プロパティのデータ型
DataType string
プロパティ値
Value string

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

文字列から文字を削除する

入力文字列を受け取り、指定した文字が削除された状態で返します。 指定された文字が見つからない場合は、元の文字列が返されます。

パラメーター

名前 キー 必須 説明
入力文字列
InputString string

文字の削除が実行される入力文字列。

入力文字列から削除する文字
CharactersToRemoveFromInputString string

入力から削除するすべての文字を含む文字列。 例: !@&?^*.

入力文字列から発音区別符号を削除する
RemoveDiacriticsFromInputString boolean

true を設定すると、IA-Connect は入力文字列からすべての発音記号の削除を試み、発音記号を持つ文字を、同じ文字から発音記号を除いたものに置き換えます。 例: 'acute accented a' を 'a' に置き換える。 単純な文字に直接対応するものがないシナリオでは、その文字は削除されます。 例: ドイツのシャープ S が削除されます。

入力文字列から英数字以外を削除する
RemoveNonAlphaNumericFromInputString boolean

true に設定すると、IA-Connect は入力文字列から英数字以外の文字をすべて削除します。

入力文字列から数値を削除する
RemoveNumericFromInputString boolean

true に設定すると、IA-Connect は入力文字列から数字をすべて削除します。

入力文字列から小文字を削除する
RemoveLowercaseCharactersFromInputString boolean

true に設定すると、IA-Connect は入力文字列から小文字の英数字をすべて削除します。

入力文字列から大文字を削除する
RemoveUppercaseCharactersFromInputString boolean

true に設定すると、IA-Connect は入力文字列から大文字の英数字をすべて削除します。

戻り値

名前 パス 説明
出力文字列
OutputString string

文字が削除された文字列。 指定された文字が見つからなかった場合、これは元の文字列になります。

文字列配列から JSON テーブルを取得する

文字列項目の入力配列を受け取り、JSON テーブルとして返します。

パラメーター

名前 キー 必須 説明
入力配列
InputArray True array of string

文字列の入力配列です。

列名
ColumnName True string

テーブル列に使用する名前です。

空の項目を破棄する
DropEmptyItems boolean

[配列内の空の項目を無視 (破棄) する] を、true に設定します。 [すべての項目を含める] を、false に設定します。

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です (常に 1 である必要があります)。

文字列配列からテーブルを取得

文字列項目の入力配列を受け取り、テーブルとして返します。

パラメーター

名前 キー 必須 説明
入力配列
InputArray True array of string

文字列の入力配列です。

列名
ColumnName True string

テーブル列に使用する名前です。

空の項目を破棄する
DropEmptyItems boolean

[配列内の空の項目を無視 (破棄) する] を、true に設定します。 [すべての項目を含める] を、false に設定します。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です (常に 1 である必要があります)。

文字列配列から項目を削除する

文字列項目の入力配列を受け取り、指定された位置にある 1 つまたは複数の項目を削除して、新しい配列を返します。 テーブルから 1 つまたは複数の行を削除する場合は、アクション "テーブルから行を削除する" を使用します。 JSON 形式のテーブルから 1 つまたは複数の行を削除する場合は、アクション "JSON テーブルから行を削除する" を使用します。

パラメーター

名前 キー 必須 説明
入力配列
InputArray True array of string

文字列の入力配列です。

開始項目インデックス
StartItemIndex True integer

削除を開始する項目のインデックス。 1 を使用して最初の項目を削除し、N を使用して N 番目の項目を削除します。

削除する項目の数
NumberOfItemsToDelete True integer

削除する項目の数です。

戻り値

名前 パス 説明
出力配列
OutputArray array of string

文字列の出力配列です。

項目の数
NumberOfItems integer

出力配列内の項目の数です。

文字列配列をフィルター処理する

文字列項目の入力配列を受け取り、配列をフィルター処理し (.NET DataView 行フィルター構文を使用)、新しい配列を返します。 テーブルをフィルター処理する場合は、アクション "テーブルのフィルター処理" を使用します。 JSON 形式のテーブルをフィルター処理する場合は、アクション "JSON テーブルのフィルター処理" を使用します。

パラメーター

名前 キー 必須 説明
入力配列
InputArray True array of string

文字列の入力配列です。

列名
ColumnName True string

フィルター処理中に配列を保持するテーブル列に使用する名前。 この名前は、.NET DataView 行フィルター構文の列名として使用できます。 たとえば、MyColumnは、[MyColumn] として使用できます。

フィルター
Filter True string

.NET DataView 行フィルター構文のフィルター。 例: "*要素" などの [名前]。

戻り値

名前 パス 説明
フィルター処理された出力配列
OutputArray array of string

フィルター処理された文字列の出力配列です。

項目の数
NumberOfItems integer

出力配列内の項目の数です。

文字列配列を並べ替える

文字列項目の入力配列を受け取り、配列を並べ替えて新しい配列を返します。 テーブルを並べ替える場合は、アクション "テーブルの並べ替え" を使用します。 JSON 形式のテーブルを並べ替える場合は、アクション "JSON テーブルの並べ替え" を使用します。

パラメーター

名前 キー 必須 説明
入力配列
InputArray True array of string

文字列の入力配列です。

昇順で並べ替え
Ascending boolean

[昇順に並べ替え] を true に設定します。 [降順に並べ替え] を false に設定します。

大文字小文字を区別
CaseSensitive boolean

大文字と小文字を区別して並べ替える (大文字と小文字を別々に並べ替える) 場合は true に設定します。 大文字と小文字を区別しない場合は false に設定します。

戻り値

名前 パス 説明
並べ替えられた出力配列
OutputArray array of string

並べ替えられた文字列の出力配列です。

項目の数
NumberOfItems integer

出力配列内の項目の数です。

文字列間を取得

入力文字列を受け取り、指定した 2 つの文字列の間または文字列と行末尾の間にある文字列の、最初のインスタンスを返します。

パラメーター

名前 キー 必須 説明
入力文字列
InputString string

検索が実行される入力文字列です。

検索開始文字列
StartSearchString string

検索開始文字列です。

検索終了文字列
EndSearchString string

検索終了文字列を指定するか、行の末尾まで検索する場合は空のままにします。

行ごとに検索する
SearchLineByLine boolean

入力文字列を 1 行で検索し、結果を検索して現在の行に一致する文字列のみを含む場合は true に設定します。 [入力文字列を単一の項目として扱う] を、false に設定します。

見つからない場合は例外をスローする
ThrowExceptionIfNotFound boolean

検索文字列が見つからない場合に例外を発生させる場合は true に設定し、検索文字列が見つからない場合に 'String between found'=false を返す場合は false に設定します。

結果をトリミング
TrimResult boolean

結果の前または後にスペースやタブを追加してトリミングする場合は true に設定します。

検索で正規表現を使用する
SearchIsRegularExpression boolean

検索文字列が正規表現の場合は true に設定します。 標準テキストが正規表現の場合は false に設定します。

大文字と小文字を区別して検索
CaseSensitiveSearch boolean

検索で大文字と小文字を区別する必要がある場合は true に設定します。 検索で大文字と小文字を区別しない場合は false に設定します。

戻り値

名前 パス 説明
検索文字列が見つかりました
SearchStringFound boolean

"見つからない場合は例外をスローする" を false に設定すると、この出力が、検索文字列が見つかった場合に true に、見つからない場合は false に設定されます。

文字列間
StringBetween string

指定された文字列の間で見つかった文字列です。

正規表現の一致を取得する

入力文字列に対して正規表現 (regex) による照合を実行し、文字列が式と一致したかどうか、さらにその一致の詳細を返します。

パラメーター

名前 キー 必須 説明
Input text to match
TextToMatch True string

正規表現で照合する入力テキストです。

Regular expression
Regex True string

入力テキストと照合する正規表現です。

Search index
SearchIndex integer

取得するための一致結果のインデックス。1 から始まります。 最初の結果 (規定の動作) と一致させる場合は、1 を入力します。 例: 入力文字列が 5 箇所で正規表現と一致すると予想され、4 番目の一致に関心がある場合は、4 と入力します。

Case sensitive match
CaseSensitive boolean

大文字と小文字を区別して (たとえば A と a は同じではない) 照合する場合は true (既定) を設定し、大文字と小文字を区別せずに (たとえば A と a は同じ) 照合する場合は false を設定します。

Regex timeout in seconds
RegexTimeoutInSeconds integer

正規表現を処理できる、タイムアウトするまでの最大秒数。特定の正規表現が発生させる無限ループを、これにより停止します。

戻り値

名前 パス 説明
Successful match
SuccessfulMatch boolean

(指定した検索インデックスで) 成功した一致がある場合は True、一致しない場合は false。

Match string value
MatchStringValue string

照合に成功した場合、入力テキストのうち正規表現と一致するテキストを、この文字列値に保持します。

Match position index
MatchIndex integer

照合に成功した場合、この値は一致がある場所と一致する入力テキスト内の場所を保持します。 この値は 0 から始まり、入力テキスト文字列の始まりを表します。

一致した文字列の長さ
MatchStringLength integer

照合に成功した場合、入力テキストのうち正規表現と一致したテキストの長さを、この値に保持します (例: 出力値である '一致した文字列値' の長さ)。

正規表現の一致を取得する

入力文字列に対して正規表現 (regex) による照合を実行し、文字列配列で一致したすべてを返します。 一致するものがなかった場合、配列は空になります。

パラメーター

名前 キー 必須 説明
Input text to match
TextToMatch True string

正規表現で照合する入力テキストです。

Regular expression
Regex True string

入力テキストと照合する正規表現です。

Maximum matches to perform
MaximumMatches integer

実行する正規表現の一致の最大量。 一致する数に制限がない場合 (つまり、一致するものがなくなるまで一致し続ける)、値を入力しないか、値 0 (規定) を入力します。 この入力は、一致する数に制限を設けることにより、無限の正規表現ループを回避するように設計されています。

Case sensitive match
CaseSensitive boolean

大文字と小文字を区別して (たとえば A と a は同じではない) 照合する場合は true (既定) を設定し、大文字と小文字を区別せずに (たとえば A と a は同じ) 照合する場合は false を設定します。

Trim results
TrimResults boolean

出力配列の各要素を別々にトリミングする場合は true (既定) に設定します。

Remove empty results
RemoveEmptyResults boolean

空の出力配列要素を出力配列から削除する場合 (空の結果が不要な場合) は true に設定します。

Regex timeout in seconds
RegexTimeoutInSeconds integer

正規表現を処理できる、タイムアウトするまでの最大秒数。特定の正規表現が発生させる無限ループを、これにより停止します。

戻り値

名前 パス 説明
Output array
OutputArray array of object

正規表現に一致した個々の項目を含む出力文字列配列。

items
OutputArray object
Number of elements in output
NumberOfElementsInOutput integer

出力配列内の項目の数です。

正規表現を使用して文字列を分割する

正規表現 (regex) による照合で入力文字列を分割し、文字列を分割した個別のコンポーネントを文字列配列として返します。

パラメーター

名前 キー 必須 説明
Input text to split
TextToSplit True string

正規表現に対して分割する入力テキスト。

Regular expression
Regex True string

入力テキストを分割するための正規表現。

Case sensitive split
CaseSensitive boolean

既定である true に設定すると大文字と小文字を区別して分割し (例: A と a は異なる)、false に設定すると大文字と小文字を区別せずに分割します (例: A と a を同等に扱う)。

Trim results
TrimResults boolean

出力配列の各要素を別々にトリミングする場合は true (既定) に設定します。

Remove empty results
RemoveEmptyResults boolean

空の出力配列要素を出力配列から削除する場合 (空の結果が不要な場合) は true に設定します。

Regex timeout in seconds
RegexTimeoutInSeconds integer

正規表現を処理できる、タイムアウトするまでの最大秒数。特定の正規表現が発生させる無限ループを、これにより停止します。

戻り値

名前 パス 説明
Output array
OutputArray array of object

正規表現で分割した文字列の個々のコンポーネントを含む、出力文字列配列。

items
OutputArray object
Number of elements in output
NumberOfElementsInOutput integer

出力配列内の項目の数です。

正規表現グループの一致を取得する

入力文字列に対して正規表現 (regex) による照合を実行し、一致したグループ名と値のリストを返します。

パラメーター

名前 キー 必須 説明
Input text to match
TextToMatch True string

正規表現で照合する入力テキストです。

Regular expression
Regex True string

入力テキストと照合する正規表現です。

取得するグループ
GroupsToRetrieve array of string

取得する正規表現グループの名前を含む文字配列。 空の配列を指定すると、すべてのグループが取得されます。 例: 正規表現に (?(Yes|No)) が含まれ、'NeedsUpdating' グループを取得するように指定した場合、その名前付きグループの一致した値が返されます。

Search index
SearchIndex integer

取得するための一致結果のインデックス。1 から始まります。 最初の結果 (規定の動作) と一致させる場合は、1 を入力します。 例: 入力文字列が 5 箇所で正規表現と一致すると予想され、4 番目の一致に関心がある場合は、4 と入力します。

Case sensitive match
CaseSensitive boolean

大文字と小文字を区別して (たとえば A と a は同じではない) 照合する場合は true (既定) を設定し、大文字と小文字を区別せずに (たとえば A と a は同じ) 照合する場合は false を設定します。

Regex timeout in seconds
RegexTimeoutInSeconds integer

正規表現を処理できる、タイムアウトするまでの最大秒数。特定の正規表現が発生させる無限ループを、これにより停止します。

戻り値

名前 パス 説明
Regular expression groups
RegexGroups array of object

入力文字列と照合した正規表現グループの名前と値を含む配列。

Property
RegexGroups.Property string
Value
RegexGroups.Value string
Number of groups
NumberOfRegexGroups integer

正規表現グループの件数。

行を JSON テーブルに挿入

JSON 形式の入力テーブルを受け取り、指定した位置の行を挿入して、JSON 形式の新しいテーブルを返します。 実際のテーブルに行を挿入する場合は (JSON 形式ではない場合)、アクション "テーブルに行を挿入する" を使用します。 文字列配列に文字列を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。

パラメーター

名前 キー 必須 説明
JSON 入力テーブル
JSONTable True string

JSON 形式の入力テーブルです。

行インデックス
RowIndex True integer

挿入する行のインデックス。 テーブルの最初に挿入するには 0 を使用し、行 1 の後に挿入するには 1 を使用します。行 N の後に挿入するには N を使用します。テーブルの最後に挿入する場合は -1 またはテーブルの項目数よりも大きい任意の数字を使用します (テーブルの長さがわからない場合に便利です)。

挿入する JSON 行
RowToInsertJSON string

JSON 形式に挿入する行のコンテンツ。 空の行を挿入する場合は、空白のままにします。 例:「Simon」を「名前」列に挿入するには、{"名前":"Simon"} を使用し、「英国」を「国」の列に挿入するには、{"名前":"Simon"、"国":"英国"} を使用します。。

戻り値

名前 パス 説明
JSON 出力テーブル
OutputJSONTable string

JSON 形式の出力テーブルです。

行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

行をテーブルに挿入する

入力テーブルを受け取り、指定した位置に行を挿入して、新しいテーブルを返します。 文字列配列に文字列を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。 JSON 形式のテーブルに行を挿入する場合は、アクション "JSON テーブルに行を挿入する" を使用します。

パラメーター

名前 キー 必須 説明
入力テーブル
Input table object
行インデックス
RowIndex True integer

挿入する行のインデックス。 テーブルの最初に挿入するには 0 を使用し、行 1 の後に挿入するには 1 を使用します。行 N の後に挿入するには N を使用します。テーブルの最後に挿入する場合は -1 またはテーブルの項目数よりも大きい任意の数字を使用します (テーブルの長さがわからない場合に便利です)。

挿入する JSON 行
RowToInsertJSON string

JSON 形式に挿入する行のコンテンツ。 空の行を挿入する場合は、空白のままにします。 例:「Simon」を「名前」列に挿入するには、{"名前":"Simon"} を使用し、「英国」を「国」の列に挿入するには、{"名前":"Simon"、"国":"英国"} を使用します。。

戻り値

名前 パス 説明
出力テーブル
OutputTable array of object

出力テーブルです。

項目
OutputTable object
行数
NumberOfRows integer

出力テーブル内の行の数です。

列数
NumberOfColumns integer

出力テーブル内の列の数です。

行を文字列配列に挿入する

文字列項目の入力配列を受け取り、指定された位置に行を挿入して、新しい配列を返します。 テーブルに行を挿入する場合は、アクション "文字列配列に行を挿入する" を使用します。 JSON 形式のテーブルに行を挿入する場合は、アクション "JSON テーブルに行を挿入する" を使用します。

パラメーター

名前 キー 必須 説明
入力配列
InputArray True array of string

文字列の入力配列です。

行インデックス
RowIndex True integer

挿入する行のインデックス。 配列の最初に挿入するには 0 を使用し、行 1 の後に挿入するには 1 を使用します。行 N の後に挿入するには N を使用します。配列の最後に挿入する場合は -1 または配列の項目数よりも大きい任意の数字を使用します (配列の長さがわからない場合に便利です)。

挿入する値
ValueToInsert string

新しい行に挿入する文字列の値。 空の行を挿入する場合は、空白のままにします。

戻り値

名前 パス 説明
出力配列
OutputArray array of string

文字列の出力配列です。

項目の数
NumberOfItems integer

出力配列内の項目の数です。