動的コードの IA-Connect (プレビュー)
IA-Connect は、クラウドからオンプレミスの仮想マシンに、または Citrix または Microsoft リモート デスクトップ 'RDS' 接続経由で RPA 機能を追加する、ロボット プロセス オートメーション 'RPA' プラットフォームです。 これは、動的コード モジュールを開発するためのモジュールです。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | ウルティマビジネス |
| Website | https://www.ultima.com/ultima-labs |
| プライバシー ポリシー | https://www.ultima.com/privacy-policy |
| カテゴリ | IT 運用;生産性 |
IA-Connect は、Power Automate Cloud Flows からオンプレミスの仮想マシン、または Citrix または Microsoft Remote Desktop (RDS) 接続経由で RPA 機能を追加する、RPA (ロボティック プロセス オートメーション) プラットフォームです。 IA-Connect コネクタには 800 を超えるアクションが用意されており、Power Automate Cloud Flow から直接、あらゆる種類のオンプレミス アプリケーションを自動化できます。 すべての IA-Connect アクションは Power Automate Cloud Flow から直接利用でき、クラウド ベースとオンプレミスのアプリケーション間の統合が容易になり、既存の Power Automate 条件、ループ、動的コンテンツ、式、および例外処理を RPA プロセスで利用できます。 また、IA-Connect コネクタを利用すると、フロー実行履歴から完全な実行履歴と監査機能が提供される一方で、RPA プロセスを開発するために別のアプリケーション/コンソール/スタジオを用意する必要も排除されます。
[前提条件]
IA-Connect コネクタのいずれかを使用するには、IA-Connect ソフトウェアをインストールする必要があります。 これは 30 日間無料でテストできます。その後、IA-Connect ライセンスが必要になります。
IA-Connect ソフトウェアは、次の 2 つの主要なコンポーネントで構成されています。
IA-Connect Orchestrator。これは、独自の Azure テナントでホストする Azure WebApp です。 これにより、1 つ以上のオンプレミスまたはクラウドベースの仮想マシンへの RPA フローのルーティングとセキュリティが処理されます。
IA-Connect エージェントとディレクター。自動化するソフトウェアにアクセスできる仮想マシンにインストールされます。 さらに、IA-Connect エージェントは Citrix または Microsoft Remote Desktop Services (RDS) セッション内で実行できます。このセッションでは、RPA コマンドが仮想チャネルをリモート セッションに渡して実行されます。 IA-Connect エージェントはネットワーク共有から実行でき、インストールは必要ありません。
使用可能な IA-Connect コネクタ
使用可能な IA-Connect コネクタは次のとおりです。
- 動的コードの IA-Connect
- IA-Connect Java
- JML の IA-Connect
- メインフレームの IA-Connect
- IA-Connect Microsoft Office
- SAP GUI の IA-Connect
- IA-Connect セッション
- IA-Connect UI
- IA-Connect Web ブラウザー
資格情報を取得する方法
ライセンスを受け取り、30日間の無料試用版を開始するには、当社のウェブサイト(https://www.ultima.com/IA-Connect/Power-Automate)でリクエストを送信してください。
試用版の要求を受け取ったら、IA-Connect ソフトウェアの設定を支援し、試用版ライセンスを提供するために提供された電子メール アドレスを介して、お客様に連絡します。 これは完全な機能を備えた試用版であり、試用期間中に、ご自身の環境内の 9 つの IA-Connect コネクタすべてに対して 800 個のアクションのいずれかをテストできます。
コネクタの概要
IA-Connect の試用版要求を送信すると、インストールとセットアップに関する IA-Connect ソフトウェアとドキュメントを含む ZIP ファイルをダウンロードできるようになります。 また、必要に応じてインストールプロセスを通じてサポートとガイダンスを提供するために、お客様に連絡します。
Support
試用期間中は、Ultima Labs (IAConnect@ultima.com) に問い合わせてサポートとサポートを受けることができます。
IA-Connect ライセンスを購入すると、Ultimaの英国ベースのテクニカルサービスセンター(TSC)から、特注のトレーニングまたはサポートに利用できるサポートトークンを受け取ります。
既知の問題、一般的なエラー、FAQ
ナレッジ ベースには、既知の問題、IA-Connect コネクタの使用時に発生する可能性がある一般的なエラー、よく寄せられる質問に関する記事が多数含まれています。 これは https://support.ultima.com/ultimalabs でアクセスでき、これらのリソースにアクセスするためのアカウントは、IA-Connect 試用版中および IA-Connect ライセンスの購入時に提供されます。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API キー | securestring | この API の API キー | 正しい |
| IA-Connect Orchestrator アドレス | 文字列 | HTTP(S) コンポーネントを使用せずに IA-Connect Orchestrator アドレスを指定する | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| IA-Connect 参照テーブルをすべて削除する |
IA-Connect エージェントに現在読み込まれているすべての参照テーブルを削除します。 |
| JSON からテーブルを取得する |
JSON 形式の入力テーブルを受け取り、テーブルとして返します。 これは逆シリアル化と呼ばれます。 |
| JSON テーブル セルから文字列を取得する |
JSON 形式の入力テーブルを受け取り、指定したセルを文字列として返します。 |
| JSON テーブルから列を削除する |
JSON 形式の入力テーブルを取得し、列または列を削除し、JSON 形式で新しいテーブルを返します。 実際のテーブル (つまり JSON 形式ではない) から列を削除する場合は、"テーブルから列を削除する" アクションを使用します。 |
| JSON テーブルから行を削除する |
JSON 形式の入力テーブルを取得し、指定した位置にある行または行を削除し、JSON 形式で新しいテーブルを返します。 実際のテーブルから行または行を削除する (つまり、JSON 形式ではない) 場合は、"テーブルから行を削除する" アクションを使用します。 文字列配列から行または行を削除する場合は、「文字列配列から行を削除する」アクションを使用します。 |
| JSON テーブルに入力変数の行を挿入する |
JSON 形式の入力テーブルを取得し、入力変数から作成された行を指定した位置に挿入し、JSON 形式で新しいテーブルを返します。 入力行スキーマは、入力テーブルのスキーマと一致する必要があります (つまり、同じプロパティ名とデータ型を使用します)。 実際のテーブルに行を挿入する場合 (つまり、JSON 形式ではない場合)、"テーブルに行を挿入する" アクションを使用します。 文字列配列に文字列を挿入する場合は、「文字列配列に行を挿入する」アクションを使用します。 |
| JSON テーブルに行を挿入する |
JSON 形式の入力テーブルを取得し、指定した位置に行を挿入し、JSON 形式で新しいテーブルを返します。 実際のテーブルに行を挿入する場合 (つまり、JSON 形式ではない場合)、"テーブルに行を挿入する" アクションを使用します。 文字列配列に文字列を挿入する場合は、「文字列配列に行を挿入する」アクションを使用します。 |
| JSON テーブルのフィルター処理 |
入力 JSON テーブルを受け取り、(.NET DataView 行フィルター構文を使用して) テーブルをフィルター処理し、新しい JSON テーブルを返します。 実際のテーブル (つまり JSON 形式ではない) をフィルター処理する場合は、"テーブルのフィルター処理" アクションを使用します。 文字列配列をフィルター処理する場合は、"文字列配列のフィルター処理" アクションを使用します。 |
| JSON テーブルの並べ替え |
入力 JSON テーブルを取得し、テーブルを並べ替え、新しい JSON テーブルを返します。 実際のテーブル (つまり JSON 形式ではない) を並べ替える場合は、"テーブルの並べ替え" アクションを使用します。 文字列配列を並べ替える場合は、"文字列配列の並べ替え" アクションを使用します。 |
| JSON テーブル内の列の名前を変更する |
JSON 形式の入力テーブルを取得し、指定した列の名前を変更し、JSON 形式で新しいテーブルを返します。 実際のテーブルから列の名前を変更する場合 (つまり、JSON 形式ではない場合)、"テーブル内の列の名前を変更する" アクションを使用します。 |
| JSON テーブル列から文字列配列を取得する |
JSON 形式の入力テーブルを取得し、指定した列を文字列配列として返します。 実際のテーブルから文字列配列を取得する場合 (つまり、JSON 形式ではない場合)、"テーブルから配列を取得する" アクションを使用します。 |
| Orchestrator リストに CSV IA-Connect アップロードする |
既存の内容を置き換えて、置換 CSV データを IA-Connect Orchestrator リストにアップロードします。 |
| Orchestrator 参照テーブルに CSV IA-Connect アップロードする |
既存の内容を置き換えて、置換 CSV データを IA-Connect Orchestrator 参照テーブルにアップロードします。 このアクションは、IA-Connect エージェント (ディスクに保持されている CSV ファイル) によって処理される参照テーブルとは対話しません。 |
| Orchestrator 参照テーブルの内容 IA-Connect 取得する |
Orchestrator に保持されている IA-Connect Orchestrator 参照テーブルからすべてのデータを取得します。 これにより、IA-Connect エージェントによって処理される参照テーブル (ディスクに保持されている CSV ファイル) は取得されません。 |
|
Power |
IA-Connect エージェントが実行されているセッションの PowerShell のバージョンを取得します。 これにより、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x から v5.x が検出されます。 |
|
Power |
IA-Connect エージェントが実行されているコンピューターで PowerShell オートメーションを使用できるかどうかを報告します。 PowerShell オートメーションを使用できない場合、PowerShell オートメーション アクションは機能しません。 |
|
Power |
IA-Connect エージェントが実行されているセッションで PowerShell スクリプトを実行します。このセッションでは、スクリプトの内容が "PowerShell スクリプトの内容" (PowerShellScriptContents) 入力の IA-Connect エージェントに渡されます。 これは、独自のカスタム PowerShell コードを実行する場合に推奨されるアクションです。 このアクションを使用して、PowerShell スクリプトの前回の実行から結果を取得し、エージェント スレッドとして実行することもできます。 エージェントは、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x から v5.x (インストールされているバージョン) を使用して PowerShell を実行します。 |
|
Power |
IA-Connect エージェントが実行されているコンピューターで、指定した PowerShell モジュールを検索し、インストールされているかどうかを返します。 |
| アセンブリ検索フォルダーをクリアする |
IA-Connect エージェントが外部参照を読み込もうとしたときにスキャンするフォルダーの追加リストをリセットします。 |
| アセンブリ検索フォルダーを追加する |
(IA-Connect エージェントが実行されているコンピューター上の) フォルダー パスを、IA-Connect エージェントが外部参照を読み込もうとしたときにスキャンするフォルダーの一覧に追加します。 |
| テーブルから列を削除する |
入力テーブルを取得し、列または列を削除し、新しいテーブルを返します。 JSON 形式のテーブルから列を削除する場合は、「JSON テーブルから列を削除する」アクションを使用します。 |
| テーブルから行を削除する |
入力テーブルを取得し、指定した位置にある行を削除し、新しいテーブルを返します。 文字列配列から行または行を削除する場合は、「文字列配列から行を削除する」アクションを使用します。 JSON 形式のテーブルから行または行を削除する場合は、「JSON テーブルから行を削除する」アクションを使用します。 |
| テーブルに行を挿入する |
入力テーブルを取得し、指定した位置に行を挿入し、新しいテーブルを返します。 文字列配列に文字列を挿入する場合は、「文字列配列に行を挿入する」アクションを使用します。 JSON 形式のテーブルに行を挿入する場合は、"行を JSON テーブルに挿入する" アクションを使用します。 |
| テーブルの並べ替え |
入力テーブルを取得し、1 つ以上の行を並べ替え、新しいテーブルを返します。 テーブルを JSON 形式で並べ替える場合は、"JSON テーブルの並べ替え" アクションを使用します。 文字列配列を並べ替える場合は、"文字列配列の並べ替え" アクションを使用します。 |
| テーブル内の列の名前を変更する |
入力テーブルを取得し、指定した列の名前を変更し、新しいテーブルを返します。 JSON 形式のテーブルから列の名前を変更する場合は、「JSON テーブルの列の名前を変更する」アクションを使用します。 |
| テーブル列から文字列配列を取得する |
入力テーブルを取得し、指定した列を文字列配列として返します。 JSON 形式のテーブルから文字列配列を取得する場合は、"JSON テーブルから配列を取得する" アクションを使用します。 |
| フィルター テーブル |
入力テーブルを取得し、(.NET DataView 行フィルター構文を使用して) テーブルをフィルター処理し、新しいテーブルを返します。 JSON 形式でテーブルをフィルター処理する場合は、"JSON テーブルのフィルター処理" アクションを使用します。 文字列配列をフィルター処理する場合は、"文字列配列のフィルター処理" アクションを使用します。 |
| リストから列 IA-Connect 取得する |
IA-Connect Orchestrator リストから列を取得します。 |
| リストの内容 IA-Connect 取得する |
IA-Connect Orchestrator リストからすべてのデータを取得します。 |
| ローカル ファイルからアセンブリをインポートする |
IA-Connect Director が実行されているコンピューターから、メモリに読み込まれる IA-Connect エージェントに DotNet アセンブリをアップロードし、動的な DotNet コードによって参照される場合に使用します。 |
| 入力変数から JSON を作成する |
入力変数の配列を受け取り、JSON 形式で返し、必要に応じて JSON テーブルとして返します。 |
| 参照テーブル IA-Connect 削除する |
IA-Connect エージェントに現在読み込まれている参照テーブルを削除します。 |
| 参照テーブル IA-Connect 読み込む |
IA-Connect エージェントが実行されているコンピューターから IA-Connect 参照テーブルを読み込みます。 これらの参照テーブルは、さらに IA-Connect アクションでデータ参照を実行するために使用できます。 |
| 参照テーブルからの参照値 IA-Connect |
入力データに一致する最初の行から、Orchestrator 参照テーブル (Orchestrator を使用したオートメーション用) または現在 IA-Connect エージェントに読み込まれている参照テーブルから値を取得します。 Orchestrator に、IA-Connect エージェントに読み込まれた名前と同じ名前の参照テーブルがある場合は、Orchestrator 参照テーブルが使用されます (自動化が Orchestrator を通過している場合)。 |
| 参照テーブルからデータ セル IA-Connect 参照する |
入力データに一致する最初の行から、Orchestrator 参照テーブル (Orchestrator を使用したオートメーション用) からすべてのデータ セルを取得し、テーブルとして返します。 このアクションでは、IA-Connect エージェントに読み込まれた参照テーブルはサポートされません。 |
| 参照テーブルから列 IA-Connect 参照する |
Orchestrator 参照テーブル (Orchestrator を使用した自動化用) または現在 IA-Connect エージェントに読み込まれている参照テーブルから、入力データに一致する最初の行から 1 つ以上の同じ名前の列を取得し、テーブルとして返します。 たとえば、参照テーブルには、複数の AD グループを表す "AD グループ" という名前の複数の出力列を含め、出力テーブル内の個別の行として返されます。 Orchestrator に、IA-Connect エージェントに読み込まれた名前と同じ名前の参照テーブルがある場合は、Orchestrator 参照テーブルが使用されます (自動化が Orchestrator を通過している場合)。 |
| 参照テーブルの概要 IA-Connect 取得する |
IA-Connect エージェントに現在読み込まれている参照テーブルの概要を取得します。 |
| 文字列から文字を削除する |
入力文字列を受け取り、指定した文字を削除して返します。 指定した文字が見つからない場合は、元の文字列が返されます。 |
| 文字列配列から JSON テーブルを取得する |
文字列項目の入力配列を受け取り、JSON テーブルとして返します。 |
| 文字列配列からテーブルを取得する |
文字列項目の入力配列を受け取り、テーブルとして返します。 |
| 文字列配列から項目を削除する |
文字列項目の入力配列を取得し、指定した位置にある項目を削除し、新しい配列を返します。 テーブルから行または行を削除する場合は、"テーブルから行を削除する" アクションを使用します。 JSON 形式のテーブルから行または行を削除する場合は、「JSON テーブルから行を削除する」アクションを使用します。 |
| 文字列配列に行を挿入する |
文字列項目の入力配列を取得し、指定した位置に行を挿入し、新しい配列を返します。 テーブルに行を挿入する場合は、「行をテーブルに挿入する」アクションを使用します。 JSON 形式のテーブルに行を挿入する場合は、"行を JSON テーブルに挿入する" アクションを使用します。 |
| 文字列配列のフィルター処理 |
文字列項目の入力配列を受け取り、(.NET DataView 行フィルター構文を使用して) 配列をフィルター処理し、新しい配列を返します。 テーブルをフィルター処理する場合は、[テーブルのフィルター] アクションを使用します。 JSON 形式でテーブルをフィルター処理する場合は、"JSON テーブルのフィルター処理" アクションを使用します。 |
| 文字列配列の並べ替え |
文字列項目の入力配列を受け取り、配列を並べ替え、新しい配列を返します。 テーブルを並べ替える場合は、"テーブルの並べ替え" アクションを使用します。 テーブルを JSON 形式で並べ替える場合は、"JSON テーブルの並べ替え" アクションを使用します。 |
| 次の間の文字列を取得します。 |
入力文字列を受け取り、指定された 2 つの文字列の間、または文字列と行の末尾の間にある文字列の最初のインスタンスを返します。 |
| 正規表現の一致を取得する |
入力文字列に対して正規表現 (regex) 一致を実行し、文字列が式と一致の詳細と一致したかどうかを返します。 |
| 正規表現の一致を取得する |
入力文字列に対して正規表現 (正規表現) の一致を実行し、文字列配列内のすべての一致を返します。 一致がない場合、配列は空になります。 |
| 正規表現を使用して文字列を分割する |
正規表現 (正規表現) の一致を使用して入力文字列を分割し、文字列の個々の分割コンポーネントを文字列配列として返します。 |
| 正規表現グループの一致を取得する |
入力文字列に対して正規表現 (正規表現) の一致を実行し、一致するグループの名前と値の一覧を返します。 |
| 配列を JSON に変換する |
入力配列を受け取り、JSON 文字列にシリアル化します。 |
IA-Connect 参照テーブルをすべて削除する
IA-Connect エージェントに現在読み込まれているすべての参照テーブルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンドの結果
|
RemoveAllIAConnectLookupTablesResult | boolean |
コマンドの結果 (成功または失敗)。 |
|
エラーメッセージ
|
ErrorMessage | string |
コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。 |
JSON からテーブルを取得する
JSON 形式の入力テーブルを受け取り、テーブルとして返します。 これは逆シリアル化と呼ばれます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力 JSON テーブル
|
JSONTable | True | string |
JSON 形式の入力テーブル。 |
|
開始行インデックス
|
StartRowIndex | True | integer |
取得する最初の行のインデックス。 最初の行から始まる場合は 1 を使用し、N は N 行目から開始します。 |
|
取得する行の数
|
NumberOfRowsToRetrieve | integer |
取得する行の数。 すべての行を取得するには、0 (または空白のままに) を使用します。 |
|
|
列インデックスの開始
|
StartColumnIndex | integer |
取得する最初の列のインデックス。 最初の列から始まる場合は 1 を使用し、N は N 番目の列から始まります。 名前で取得する最初の列を指定する場合は、この入力を空白のままにし、代わりに入力 'Start column name' を使用します。 |
|
|
開始列名
|
StartColumnName | string |
取得する最初の列の省略可能な名前。 インデックスで列を取得する場合は、この入力を空白のままにし、代わりに入力 '列インデックスの開始' を使用します。 |
|
|
取得する列の数
|
NumberOfColumnsToRetrieve | integer |
取得する列の数。 すべての列を取得するには、0 (または空白のままに) を使用します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テーブル
|
OutputTable | array of object |
出力テーブル。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数 (常に 1 にする必要があります)。 |
JSON テーブル セルから文字列を取得する
JSON 形式の入力テーブルを受け取り、指定したセルを文字列として返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力 JSON テーブル
|
JSONTable | True | string |
JSON 形式の入力テーブル。 |
|
行インデックス
|
RowIndex | integer |
取得するセルを含む行のインデックス。 最初の行には 1 を使用し、N 行目には N を使用します。 |
|
|
列インデックス
|
ColumnIndex | integer |
取得するセルを含む列のインデックス。 最初の列には 1 を使用し、N 番目の列には N を使用します。 名前で列を取得する場合は、この入力を空白のままにし、代わりに入力 'Column name' を使用します。 |
|
|
列名
|
ColumnName | string |
取得するセルを含む列の省略可能な名前。 インデックスで列を取得する場合は、この入力を空白のままにし、代わりに入力 'Column index' を使用します。 |
|
|
セルが存在しない場合のフォールバック
|
FallBackIfCellDoesNotExist | boolean |
この入力は、指定された行インデックス、列インデックス、または名前が存在しない場合の結果を制御します。 この入力が false (既定値) に設定されている場合は、例外が発生します。 この入力が true に設定されている場合、'Output string' はフォールバック値に設定され、空白または選択した値を指定できます。 |
|
|
フォールバック値
|
FallbackValue | string |
指定した行インデックス、列インデックス、または名前が存在せず、入力 'Fallback if cell does not exist' が true に設定されている場合、このフォールバック値が出力文字列に使用されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力文字列
|
OutputString | string |
出力セルの内容を文字列として指定します。 |
JSON テーブルから列を削除する
JSON 形式の入力テーブルを取得し、列または列を削除し、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 形式の入力テーブルを取得し、指定した位置にある行または行を削除し、JSON 形式で新しいテーブルを返します。 実際のテーブルから行または行を削除する (つまり、JSON 形式ではない) 場合は、"テーブルから行を削除する" アクションを使用します。 文字列配列から行または行を削除する場合は、「文字列配列から行を削除する」アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力 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 形式で新しいテーブルを返します。 入力行スキーマは、入力テーブルのスキーマと一致する必要があります (つまり、同じプロパティ名とデータ型を使用します)。 実際のテーブルに行を挿入する場合 (つまり、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 |
出力テーブル内の列の数。 |
JSON テーブルに行を挿入する
JSON 形式の入力テーブルを取得し、指定した位置に行を挿入し、JSON 形式で新しいテーブルを返します。 実際のテーブルに行を挿入する場合 (つまり、JSON 形式ではない場合)、"テーブルに行を挿入する" アクションを使用します。 文字列配列に文字列を挿入する場合は、「文字列配列に行を挿入する」アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力 JSON テーブル
|
JSONTable | True | string |
JSON 形式の入力テーブル。 |
|
行インデックス
|
RowIndex | True | integer |
挿入する行のインデックス。 0 を使用してテーブルの先頭に挿入し、1 を行 1 の後に挿入し、N を使用して行 N の後に挿入します。-1、またはテーブルの末尾に挿入するテーブル内の項目の数以上の数を使用します (テーブルの長さがわからない場合に便利です)。 |
|
挿入する JSON 行
|
RowToInsertJSON | string |
JSON 形式で挿入する行の内容。 空の行を挿入する場合は、空白のままにします。 たとえば、列 'Name' に 'Simon' を挿入するには、{"Name":"Simon"} を使用し、さらに 'England' を列 'Country' に挿入するには、{"Name":"Simon","Country":"England"} を使用します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力 JSON テーブル
|
OutputJSONTable | string |
JSON 形式の出力テーブル。 |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数。 |
JSON テーブルのフィルター処理
入力 JSON テーブルを受け取り、(.NET DataView 行フィルター構文を使用して) テーブルをフィルター処理し、新しい JSON テーブルを返します。 実際のテーブル (つまり JSON 形式ではない) をフィルター処理する場合は、"テーブルのフィルター処理" アクションを使用します。 文字列配列をフィルター処理する場合は、"文字列配列のフィルター処理" アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力 JSON テーブル
|
JSONTable | True | string |
JSON 形式の入力テーブル。 |
|
Filter
|
Filter | True | string |
.NET DataView 行フィルター構文のフィルター。 たとえば、'*Element' のような [Name] です。 |
|
列名の並べ替え
|
SortColumnName | string |
フィルターの適用後に並べ替えるオプションの列名。 複数の列で並べ替える場合は、コンマ区切りの列を一覧表示します。 |
|
|
昇順で並べ替え
|
Ascending | boolean |
昇順で並べ替えるには、true に設定します。 降順で並べ替えるには false に設定します。 |
|
|
列名の並べ替え 2
|
SortColumnName2 | string |
(最初の列で並べ替えられた後に) 並べ替える 2 番目の列名 (省略可能)。 |
|
|
昇順で並べ替え 2
|
Ascending2 | boolean |
2 番目の列名を昇順で並べ替えるには、true に設定します。 降順で並べ替えるには false に設定します。 |
|
|
列名の並べ替え 3
|
SortColumnName3 | string |
並べ替えの基準となる省略可能な 3 番目の列名 (最初と 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 番目の列名 (最初と 2 番目の列による並べ替え後)。 |
|
|
昇順で並べ替え 3
|
Ascending3 | boolean |
3 番目の列名を昇順で並べ替えるには、true に設定します。 降順で並べ替えるには false に設定します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力 JSON テーブル
|
OutputJSONTable | string |
JSON 形式の出力テーブル。 |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数。 |
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 形式の入力テーブルを取得し、指定した列を文字列配列として返します。 実際のテーブルから文字列配列を取得する場合 (つまり、JSON 形式ではない場合)、"テーブルから配列を取得する" アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力 JSON テーブル
|
JSONTable | True | string |
JSON 形式の入力テーブル。 |
|
列インデックス
|
ColumnIndex | integer |
配列として返す列のインデックス。 最初の列には 1 を使用し、N 番目の列には N を使用します。 名前で列を取得する場合は、この入力を空白のままにし、代わりに入力 'Column name' を使用します。 |
|
|
列名
|
ColumnName | string |
配列として返す列の省略可能な名前。 インデックスで列を取得する場合は、この入力を空白のままにし、代わりに入力 'Column index' を使用します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力配列
|
OutputArray | array of string |
文字列の出力配列。 |
|
品目数
|
NumberOfItems | integer |
出力配列内の項目の数。 |
Orchestrator リストに CSV IA-Connect アップロードする
既存の内容を置き換えて、置換 CSV データを IA-Connect Orchestrator リストにアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リスト名
|
ListName | True | string |
Orchestrator リストの名前。 |
|
CSV データ
|
CSVData | True | string |
Orchestrator リストに格納する置換 CSV データ。 リストが既に存在する場合、リストの内容はこの CSV データに置き換えられます。 空の CSV 入力を指定することはできませんが、データ行のない CSV ヘッダー行を指定できます。 |
|
リストが存在しない場合は作成する
|
CreateListIfNotExist | boolean |
false (既定値) に設定し、名前付きリストがまだ存在しない場合は、例外が発生します。 true に設定すると、名前付きリストが存在しない場合は作成されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンドの結果
|
UploadCSVToIAConnectListResult | boolean |
コマンドの結果 (成功または失敗)。 |
|
エラーメッセージ
|
ErrorMessage | string |
コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。 |
Orchestrator 参照テーブルに CSV IA-Connect アップロードする
既存の内容を置き換えて、置換 CSV データを IA-Connect Orchestrator 参照テーブルにアップロードします。 このアクションは、IA-Connect エージェント (ディスクに保持されている CSV ファイル) によって処理される参照テーブルとは対話しません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
参照テーブル名
|
LookupTableName | True | string |
Orchestrator 参照テーブルの名前。 |
|
CSV データ
|
CSVData | True | string |
Orchestrator 参照テーブルに格納する置換 CSV データ。 ルックアップ テーブルが既に存在する場合、テーブルの内容はこの CSV データに置き換えられます。 空の CSV 入力を指定することはできませんが、データ行のない CSV ヘッダー行を指定できます。 |
|
参照テーブルが存在しない場合は作成する
|
CreateLookupTableIfNotExist | boolean |
false (既定値) に設定し、名前付き参照テーブルがまだ存在しない場合は、例外が発生します。 true に設定すると、名前付き参照テーブルが存在しない場合は作成されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンドの結果
|
UploadCSVToIAConnectLookupTableResult | boolean |
コマンドの結果 (成功または失敗)。 |
|
エラーメッセージ
|
ErrorMessage | string |
コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。 |
Orchestrator 参照テーブルの内容 IA-Connect 取得する
Orchestrator に保持されている IA-Connect Orchestrator 参照テーブルからすべてのデータを取得します。 これにより、IA-Connect エージェントによって処理される参照テーブル (ディスクに保持されている CSV ファイル) は取得されません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
参照テーブル名
|
LookupTableName | True | string |
Orchestrator 参照テーブルの名前。 |
|
戻り値の形式
|
ReturnFormat | string |
結果を返すときに使用する形式。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力参照テーブル JSON
|
OutputLookupTableJSON | string |
JSON 形式のルックアップ テーブルからの出力データ。 |
|
出力参照テーブル
|
OutputLookupTable | array of object |
参照テーブルからの出力データ (データテーブル形式)。 |
|
items
|
OutputLookupTable | object | |
|
出力参照テーブル CSV
|
OutputLookupTableCSV | string |
CSV 形式のルックアップ テーブルからの出力データ。 |
|
出力内の行数
|
NumberOfRowsInOutput | integer |
出力内の行数。 |
|
出力内の列の数
|
NumberOfColumnsInOutput | integer |
出力内の列の数。 |
PowerShell のバージョンを取得する
IA-Connect エージェントが実行されているセッションの PowerShell のバージョンを取得します。 これにより、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x から v5.x が検出されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コンピューター名
|
ComputerName | string |
PowerShell のバージョンを確認するコンピューターの名前。 空白のままにすると、IA-Connect エージェントが実行されているコンピューターが使用されます。 |
|
|
認証メカニズム
|
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 エージェントが実行されているコンピューターで PowerShell オートメーションを使用できるかどうかを報告します。 PowerShell オートメーションを使用できない場合、PowerShell オートメーション アクションは機能しません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
PowerShell オートメーションがインストールされているか
|
PowerShellAutomationIsInstalled | boolean |
PowerShell オートメーションが使用可能な場合は true、使用できない場合は false を返します。 |
PowerShell スクリプトを実行する
IA-Connect エージェントが実行されているセッションで PowerShell スクリプトを実行します。このセッションでは、スクリプトの内容が "PowerShell スクリプトの内容" (PowerShellScriptContents) 入力の IA-Connect エージェントに渡されます。 これは、独自のカスタム PowerShell コードを実行する場合に推奨されるアクションです。 このアクションを使用して、PowerShell スクリプトの前回の実行から結果を取得し、エージェント スレッドとして実行することもできます。 エージェントは、PowerShell コア (6.x 以降) ではなく、Microsoft PowerShell v3.x から v5.x (インストールされているバージョン) を使用して PowerShell を実行します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
PowerShell スクリプトの内容
|
PowerShellScriptContents | string |
実行する PowerShell スクリプトの内容。 IA-Connect は、PowerShell オートメーション エンジンに直接渡すことによって、このスクリプト as-is を実行します。 PowerShell スクリプトは実際にはディスク上に作成されません。 または、次のように入力して、ディスク上で既存の PowerShell スクリプトを実行できます。 例: return & 'c:\scripts\TestScript.ps1'。 |
|
|
コンピューター名
|
ComputerName | string |
PowerShell スクリプトを実行するコンピューターの名前。 空白のままにすると、IA-Connect エージェントが実行されているコンピューターでスクリプトが実行されます。 |
|
|
結果がエラーでありません
|
IsNoResultAnError | boolean |
PowerShell コマンドによってデータが返されない場合、エラーが推奨されますか? |
|
|
複合型を返す
|
ReturnComplexTypes | boolean |
PowerShell の戻り値データに 'complex' プロパティ (値、配列、テーブル、クラスのコレクションなど) が含まれている場合、これらのプロパティは既定では、IA-Connect PowerShell 応答では返されません。 入力 "コレクションとして返すプロパティ"、"シリアル化するプロパティ名"、および "シリアル化するプロパティ型" を使用すると、返される '複合' プロパティと、データの書式設定に使用するメソッドを指定できます (プロパティごとに、最適なものを選択します)。 この入力を使用すると、残りのプロパティ (つまり、"複雑" で明示的に名前が付かないプロパティ) で何を行う必要があるかを指定できます。 true に設定すると、IA-Connect は ToString() を使用してデータの文字列表現を返そうとします。 false (既定値) に設定した場合、IA-Connect はプロパティを返しません。 |
|
|
ブール値をブール値として返す
|
ReturnBooleanAsBoolean | boolean |
ブール値プロパティはブール値として返す必要がありますか? false の場合、これらは文字列として返されます。 |
|
|
数値を 10 進数として返す
|
ReturnNumericAsDecimal | boolean |
数値プロパティは数値として返す必要がありますか? false の場合、これらは文字列として返されます。 |
|
|
日付として返される日付
|
ReturnDateAsDate | boolean |
Date プロパティは日付として返す必要がありますか? false の場合、これらは文字列として返されます。 |
|
|
コレクションとして返すプロパティ
|
PropertiesToReturnAsCollectionJSON | string |
PowerShell の戻り値データに 'complex' プロパティ (値、配列、テーブル、クラスのコレクションなど) が含まれている場合、これらのプロパティは既定では、IA-Connect PowerShell 応答では返されません。 このオプションを使用すると、IA-Connect がコレクションとして返す必要がある '複合' プロパティを (名前で) 指定できます。 プロパティ、その型、値に応じて、代替入力の "シリアル化するプロパティ名" と "シリアル化するプロパティ型" (いずれかを選択) の使用も検討する必要があります。 この入力は JSON または CSV 形式で入力できます。 例: EmailAddresses および MemberOf 配列プロパティを返すには、「{"PropertyName": "EmailAddresses"},{"PropertyName": "MemberOf"}] (JSON テーブル形式)、["EmailAddresses", "MemberOf"] (JSON 配列形式)、EmailAddresses、MemberOf (CSV 形式) を入力します。 |
|
|
認証メカニズム
|
AuthenticationMechanism | string |
リモート コンピューターに接続する場合、または別のユーザーとしてスクリプトを実行する場合に使用する認証メカニズム。 サポートされている値は、'Basic'、'Credssp'、'Default'、'Digest'、'Kerberos'、および 'Negotiate' です。 |
|
|
接続の試行
|
ConnectionAttempts | integer |
リモート コンピューターに接続する場合に試行する接続の数。 |
|
|
ユーザー名
|
Username | string |
代替ユーザーとしてスクリプトを実行する場合に使用するユーザー名。 |
|
|
パスワード
|
Password | password |
代替ユーザーとしてスクリプトを実行する場合に使用するパスワード。 |
|
|
スクリプトをスレッドとして実行する
|
RunScriptAsThread | boolean |
false (既定値) に設定すると、IA-Connect エージェントは PowerShell スクリプトを直ちに実行し、スクリプトの完了時に結果をディレクターに返します。 長いまたは複雑な PowerShell スクリプトを実行している場合、このアクションはタイムアウトになる可能性があります。true に設定すると、IA-Connect エージェントはエージェント スレッドとして PowerShell スクリプトを実行し、IA-Connect Director (または Orchestrator、PowerShell モジュール、Blue Prism) はこのエージェント スレッドの状態を監視し、完了を待機できます。 これにより、長時間または複雑な PowerShell スクリプトをタイムアウトなしで実行できます。 IA-Connect Agents 9.3 以前では、エージェント スレッドとして PowerShell スクリプトを実行できません。 |
|
|
スレッド ID の出力データを取得する
|
RetrieveOutputDataFromThreadId | integer |
以前にエージェント スレッドとして PowerShell スクリプトを実行し、"スレッドを待機する秒数" を 0 に設定した場合は、エージェント スレッド ID を指定して結果を取得します。 このエージェント スレッド ID は、このアクションに対する以前の呼び出しによって提供されます。 単に PowerShell スクリプトを実行している場合は 0 (既定値) に設定します (そのため、以前の PowerShell スクリプトの結果を取得しない場合は、エージェント スレッドとして実行されます)。 |
|
|
スレッドを待機する秒数
|
SecondsToWaitForThread | integer |
[Run script as thread]\(スクリプトをスレッドとして実行\) が true に設定されている場合、エージェント スレッドが完了するまで待機する秒数。 この時点で PowerShell スクリプトを実行しているエージェント スレッドが完了していない場合は、例外が発生します。 待機をバイパスするには 0 に設定します。エージェントは引き続き PowerShell スクリプトを実行しますが、次のアクションにも使用できます。 その後、"エージェント スレッドが正常に完了するまで待機する" アクションを使用してエージェント スレッドが完了するのを待ってから、"スレッド ID の出力データを取得する" という入力をエージェント スレッド ID に設定して、この "PowerShell スクリプトの実行" アクションを再実行することで、後でスクリプトの結果を取得できます。 |
|
|
スクリプトに格納されているパスワードが含まれている
|
ScriptContainsStoredPassword | boolean |
スクリプトに {IAConnectPassword:StoredPasswordIdentifier} 形式または IA-Connect Orchestrator 汎用資格情報 ({OrchestratorCredential:FriendlyName} 形式) の IA-Connect 格納されたパスワード識別子が含まれている場合は true に設定します。 { } 句は、指定されたパスワードに置き換えられ、エスケープされ、単一引用符で囲まれます (スクリプト内で既に引用符で囲まれている場合を除きます)。 |
|
|
ログの詳細出力
|
LogVerboseOutput | boolean |
powerShell の詳細出力を IA-Connect ログに記録するには、true に設定します。 これはデバッグに役立ちます。 スクリプトで詳細にログを記録するには、次の PowerShell を使用します。 Write-Verbose 'My message' -Verbose。 |
|
|
セキュリティで保護された文字列を返す
|
ReturnSecureStrings | boolean |
PowerShell スクリプト出力でセキュリティで保護された文字列プロパティを返すには、true に設定します。 セキュリティで保護された文字列として保持されているプロパティを返さない場合は、false (既定値) に設定します。 パスワードが送信される可能性があるため (PowerShell スクリプトの出力にパスワードがある場合)、実行していることがわかっている場合にのみ true に設定します。 |
|
|
シリアル化するプロパティ名
|
PropertyNamesToSerializeJSON | string |
PowerShell の戻り値データに 'complex' プロパティ (値、配列、テーブル、クラスのコレクションなど) が含まれている場合、これらのプロパティは既定では、IA-Connect PowerShell 応答では返されません。 このオプションを使用すると、JSON としてシリアル化する必要 IA-Connect (名前による) '複合' プロパティを指定して、文字列型 (受信後に逆シリアル化できます) として返すことができます。 プロパティ、その型、値に応じて、代替入力の "コレクションとして返すプロパティ" と "シリアル化するプロパティ型" (いずれかを選択) の使用も検討する必要があります。 例: EmailAddresses プロパティと MemberOf プロパティをシリアル化するには、"{"PropertyName": "EmailAddresses"}、{"PropertyName": "MemberOf"}] (JSON テーブル形式)、["EmailAddresses"、"MemberOf"] (JSON 配列形式)、EmailAddresses、MemberOf (CSV 形式) を入力します。 |
|
|
シリアル化するプロパティ型
|
PropertyTypesToSerializeJSON | string |
PowerShell の戻り値データに 'complex' プロパティ (値、配列、テーブル、クラスのコレクションなど) が含まれている場合、これらのプロパティは既定では、IA-Connect PowerShell 応答では返されません。 このオプションを使用すると、JSON としてシリアル化する必要 IA-Connect がある "複合" プロパティ (型別) を指定できるため、文字列型 (受信した後に逆シリアル化できます) として返されます。 プロパティ、その型、値に応じて、代替入力の "コレクションとして返すプロパティ" と "シリアル化するプロパティ名" (1 つを選択) の使用も検討する必要があります。 この入力は、単一の 'PropertyType' フィールドを持つコレクションです。 例: Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]型の任意のプロパティをシリアル化するには、 enter [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (JSON テーブル形式)、["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON 配列形式)、または 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 形式)。 |
|
|
名前
|
Name | string |
入力 PowerShell パラメーターの名前。 これは、PowerShell 変数の名前付け形式を満たしている必要があります (つまり、スペースや特別なシンボルを使用しないことをお勧めします)。 PowerShell 変数名では、大文字と小文字は区別されません。 たとえば、MyVariable は変数$MyVariable作成されます。 |
|
|
文字列値
|
StringValue | string |
入力 PowerShell パラメーターに割り当てる文字列値。 または、ブール値または数値を入力する場合は、他の値入力を使用します。 |
|
|
整数値
|
IntValue | integer |
入力 PowerShell パラメーターに割り当てる整数 (整数) 値。 または、文字列、ブール値、または数値を入力する場合は、他の値入力を使用します。 |
|
|
ブール値
|
BooleanValue | boolean |
入力 PowerShell パラメーターに割り当てるブール値 (true または false)。 または、文字列または数値を入力する場合は、他の値入力を使用します。 |
|
|
10 進値
|
DecimalValue | double |
入力 PowerShell パラメーターに割り当てる 10 進値。 または、文字列、ブール値、または整数値を入力する場合は、他の値入力を使用します。 |
|
|
オブジェクト値
|
ObjectValue | object |
入力 PowerShell パラメーターに割り当てるオブジェクト値。 これは PowerShell スクリプトで JSON シリアル化された文字列変数になるため、ConvertFrom-Json を使用してオブジェクトに逆シリアル化します。 または、文字列、ブール値、または数値を入力する場合は、他の値入力を使用します。 |
|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
PowerShell 出力 JSON
|
PowerShellJSONOutput | string |
JSON 形式の PowerShell スクリプトの出力。 |
|
スレッド ID
|
ThreadId | integer |
PowerShell スクリプトがエージェント スレッドとして実行されている場合、この出力には、PowerShell スクリプトの実行を監視し、スクリプトが完了したときに PowerShell スクリプトの結果を取得するために使用できるエージェント スレッド ID が保持されます。 |
PowerShell モジュールがインストールされているか
IA-Connect エージェントが実行されているコンピューターで、指定した PowerShell モジュールを検索し、インストールされているかどうかを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
PowerShellモジュール
|
PowerShellModuleName | True | string |
検索する PowerShell モジュールの名前。 |
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
PowerShell モジュールがインストールされているか
|
PowerShellModuleIsInstalled | boolean |
指定した PowerShell モジュールがインストールされている場合は true、インストールされていない場合は false を返します。 |
アセンブリ検索フォルダーをクリアする
IA-Connect エージェントが外部参照を読み込もうとしたときにスキャンするフォルダーの追加リストをリセットします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
アセンブリ検索フォルダーを追加する
(IA-Connect エージェントが実行されているコンピューター上の) フォルダー パスを、IA-Connect エージェントが外部参照を読み込もうとしたときにスキャンするフォルダーの一覧に追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー パス
|
FolderPath | True | string |
IA-Connect エージェントが外部参照を読み込もうとしたときにスキャンするフォルダーの一覧に追加するフォルダーへのパス。 |
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
テーブルから列を削除する
入力テーブルを取得し、列または列を削除し、新しいテーブルを返します。 JSON 形式のテーブルから列を削除する場合は、「JSON テーブルから列を削除する」アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力テーブル
|
Input table | object | ||
|
列インデックスの開始
|
StartColumnIndex | integer |
削除を開始する列のインデックス。 1 を使用して最初の列を削除し、N 番目の列を削除する場合は N を使用します。 名前で列を削除する場合は、この入力を空白のままにし、代わりに入力 "削除する列名" を使用します。 |
|
|
削除する列名
|
ColumnNameToDelete | string |
削除する列の省略可能な名前。 インデックスで列を削除する場合は、この入力を空白のままにし、代わりに入力 '列インデックスの開始' を使用します。 |
|
|
削除する列の数
|
NumberOfColumnsToDelete | True | integer |
指定したインデックスまたは名前から始まる、削除する列の数。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テーブル
|
OutputTable | array of object |
出力テーブル。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数。 |
テーブルから行を削除する
入力テーブルを取得し、指定した位置にある行を削除し、新しいテーブルを返します。 文字列配列から行または行を削除する場合は、「文字列配列から行を削除する」アクションを使用します。 JSON 形式のテーブルから行または行を削除する場合は、「JSON テーブルから行を削除する」アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力テーブル
|
Input table | object | ||
|
開始行インデックス
|
StartRowIndex | True | integer |
削除を開始する行のインデックス。 最初の行を削除するには 1 を使用し、N 行目を削除するには N を使用します。 |
|
削除する行の数
|
NumberOfRowsToDelete | True | integer |
削除する行数。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テーブル
|
OutputTable | array of object |
出力テーブル。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数。 |
テーブルに行を挿入する
入力テーブルを取得し、指定した位置に行を挿入し、新しいテーブルを返します。 文字列配列に文字列を挿入する場合は、「文字列配列に行を挿入する」アクションを使用します。 JSON 形式のテーブルに行を挿入する場合は、"行を JSON テーブルに挿入する" アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力テーブル
|
Input table | object | ||
|
行インデックス
|
RowIndex | True | integer |
挿入する行のインデックス。 0 を使用してテーブルの先頭に挿入し、1 を行 1 の後に挿入し、N を使用して行 N の後に挿入します。-1、またはテーブルの末尾に挿入するテーブル内の項目の数以上の数を使用します (テーブルの長さがわからない場合に便利です)。 |
|
挿入する JSON 行
|
RowToInsertJSON | string |
JSON 形式で挿入する行の内容。 空の行を挿入する場合は、空白のままにします。 たとえば、列 'Name' に 'Simon' を挿入するには、{"Name":"Simon"} を使用し、さらに 'England' を列 'Country' に挿入するには、{"Name":"Simon","Country":"England"} を使用します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テーブル
|
OutputTable | array of object |
出力テーブル。 |
|
items
|
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 番目の列名 (最初と 2 番目の列による並べ替え後)。 |
|
|
昇順で並べ替え 3
|
Ascending3 | boolean |
3 番目の列名を昇順で並べ替えるには、true に設定します。 降順で並べ替えるには false に設定します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テーブル
|
OutputTable | array of object |
出力テーブル。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数。 |
テーブル内の列の名前を変更する
入力テーブルを取得し、指定した列の名前を変更し、新しいテーブルを返します。 JSON 形式のテーブルから列の名前を変更する場合は、「JSON テーブルの列の名前を変更する」アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力テーブル
|
Input table | object | ||
|
ソース列名
|
SourceColumnName | True | string |
名前を変更する列の名前。 |
|
新しい列名
|
NewColumnName | True | string |
列の新しい名前。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テーブル
|
OutputTable | array of object |
出力テーブル。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数。 |
テーブル列から文字列配列を取得する
入力テーブルを取得し、指定した列を文字列配列として返します。 JSON 形式のテーブルから文字列配列を取得する場合は、"JSON テーブルから配列を取得する" アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力テーブル
|
Input table | object | ||
|
列インデックス
|
ColumnIndex | integer |
配列として返す列のインデックス。 最初の列には 1 を使用し、N 番目の列には N を使用します。 名前で列を取得する場合は、この入力を空白のままにし、代わりに入力 'Column name' を使用します。 |
|
|
列名
|
ColumnName | string |
配列として返す列の省略可能な名前。 インデックスで列を取得する場合は、この入力を空白のままにし、代わりに入力 'Column index' を使用します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力配列
|
OutputArray | array of string |
文字列の出力配列。 |
|
品目数
|
NumberOfItems | integer |
出力配列内の項目の数。 |
フィルター テーブル
入力テーブルを取得し、(.NET DataView 行フィルター構文を使用して) テーブルをフィルター処理し、新しいテーブルを返します。 JSON 形式でテーブルをフィルター処理する場合は、"JSON テーブルのフィルター処理" アクションを使用します。 文字列配列をフィルター処理する場合は、"文字列配列のフィルター処理" アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力テーブル
|
Input table | object | ||
|
Filter
|
Filter | True | string |
.NET DataView 行フィルター構文のフィルター。 たとえば、'*Element' のような [Name] です。 |
|
列名の並べ替え
|
SortColumnName | string |
フィルターの適用後に並べ替えるオプションの列名。 複数の列で並べ替える場合は、コンマ区切りの列を一覧表示します。 |
|
|
昇順で並べ替え
|
Ascending | boolean |
昇順で並べ替えるには、true に設定します。 降順で並べ替えるには false に設定します。 |
|
|
列名の並べ替え 2
|
SortColumnName2 | string |
(最初の列で並べ替えられた後に) 並べ替える 2 番目の列名 (省略可能)。 |
|
|
昇順で並べ替え 2
|
Ascending2 | boolean |
2 番目の列名を昇順で並べ替えるには、true に設定します。 降順で並べ替えるには false に設定します。 |
|
|
列名の並べ替え 3
|
SortColumnName3 | string |
並べ替えの基準となる省略可能な 3 番目の列名 (最初と 2 番目の列による並べ替え後)。 |
|
|
昇順で並べ替え 3
|
Ascending3 | boolean |
3 番目の列名を昇順で並べ替えるには、true に設定します。 降順で並べ替えるには false に設定します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力テーブル
|
OutputTable | array of object |
出力テーブル。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数。 |
リストから列 IA-Connect 取得する
IA-Connect Orchestrator リストから列を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リスト名
|
ListName | True | string |
Orchestrator リストの名前。 |
|
列インデックスの検索
|
SearchColumnIndex | integer |
返されるリスト内の列のインデックス。 既定値は 1 で、最初の列が返されます。 名前で列を取得する場合は、これを 0 に設定し、代わりに列名を指定します。 |
|
|
検索列の名前
|
SearchColumnName | string |
リストから名前で列を取得する場合に返すリスト内の列の名前。 この入力を使用する場合は、"列インデックスの検索" を 0 に設定します。 |
|
|
空白のセルを返す
|
ReturnBlankCells | boolean |
戻り値のデータに空白のセルを含める場合は true に設定します。 値を持つセルのみを含めるには、false (既定値) に設定します。 |
|
|
リストが存在しない場合のフォールバック
|
FallBackIfListDoesNotExist | boolean |
この入力は、指定されたリストが存在しない場合の結果を制御します。 この入力が false (既定値) に設定されている場合は、例外が発生します。 この入力が true に設定されている場合、'Output list' (要求された戻り値形式で書式設定) がフォールバック値に設定されます。フォールバック値は空白または選択した値にすることができます。 |
|
|
フォールバック値
|
FallbackValue | string |
指定したリストが存在せず、入力 'リストが存在しない場合はフォールバック' が true に設定されている場合、このフォールバック値は、要求された戻り値の形式で出力に使用されます。 これは、ルックアップ テーブルからデータを読み取り、一部のデータ項目がリストを表すのに対し、一部の項目が実際のデータである場合に便利です。 |
|
|
戻り値の形式
|
ReturnFormat | string |
結果を返すときに使用する形式。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力リスト JSON
|
OutputListJSON | string |
JSON 形式のリストからの出力列。 |
|
出力リスト
|
OutputList | array of object |
データテーブル形式のリストからの出力列。 |
|
items
|
OutputList | object | |
|
出力リスト配列
|
OutputListArray | array of object |
配列形式のリストからの出力列。 |
|
items
|
OutputListArray | object | |
|
出力内の行数
|
NumberOfRowsInOutput | integer |
出力内の行数。 |
リストの内容 IA-Connect 取得する
IA-Connect Orchestrator リストからすべてのデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
リスト名
|
ListName | True | string |
Orchestrator リストの名前。 |
|
戻り値の形式
|
ReturnFormat | string |
結果を返すときに使用する形式。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力リスト JSON
|
OutputListJSON | string |
JSON 形式のリストからの出力データ。 |
|
出力リスト
|
OutputList | array of object |
リストからの出力データ (データテーブル形式)。 |
|
items
|
OutputList | object | |
|
出力リスト CSV
|
OutputListCSV | string |
CSV 形式の一覧からの出力データ。 |
|
出力内の行数
|
NumberOfRowsInOutput | integer |
出力内の行数。 |
|
出力内の列の数
|
NumberOfColumnsInOutput | integer |
出力内の列の数。 |
ローカル ファイルからアセンブリをインポートする
IA-Connect Director が実行されているコンピューターから、メモリに読み込まれる IA-Connect エージェントに DotNet アセンブリをアップロードし、動的な DotNet コードによって参照される場合に使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ローカル アセンブリ ファイルのパス
|
LocalAssemblyFilePath | True | string |
ローカル セッション (IA-Connect Director が実行されている場所) のローカル アセンブリ ファイルへのファイル パス。 |
|
アセンブリ名
|
AssemblyName | True | string |
インポートするアセンブリの名前。 |
|
圧縮する
|
Compress | boolean |
アップロードする前にアセンブリを圧縮する必要がありますか? |
|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
入力変数から JSON を作成する
入力変数の配列を受け取り、JSON 形式で返し、必要に応じて JSON テーブルとして返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
プロパティ名
|
PropertyName | string | ||
|
プロパティのデータ型
|
DataType | string | ||
|
プロパティ値
|
Value | string | ||
|
JSON テーブルとして返す
|
ReturnAsJSONTable | True | boolean |
true に設定すると、JSON はテーブル/データテーブル形式 (つまり、[{}] 形式) で返されます。 false に設定すると、JSON は 1 つのエンティティ (つまり、 {}形式) として返されます。 どの形式を使用するかは、JSON で実行している内容によって異なります。 ほとんどの IA-Connect アクションでは、データテーブル形式が必要です。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力 JSON
|
OutputJSON | string |
JSON 形式でエンコードされた変数とその値。 |
参照テーブル IA-Connect 削除する
IA-Connect エージェントに現在読み込まれている参照テーブルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
参照テーブル名
|
LookupTableName | True | string |
IA-Connect エージェントに読み込まれた参照テーブルの名前。 |
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コマンドの結果
|
RemoveIAConnectLookupTableResult | boolean |
コマンドの結果 (成功または失敗)。 |
|
エラーメッセージ
|
ErrorMessage | string |
コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。 |
参照テーブル IA-Connect 読み込む
IA-Connect エージェントが実行されているコンピューターから IA-Connect 参照テーブルを読み込みます。 これらの参照テーブルは、さらに IA-Connect アクションでデータ参照を実行するために使用できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
参照テーブルのパス
|
Path | True | string |
参照テーブルへの完全なパス。 これは、IA-Connect エージェントが実行されているセッションからアクセスできる必要があります。 フォルダーが指定されている場合、そのフォルダーの下にあるすべてのファイルが処理されます。 |
|
テーブルの読み込みに失敗した場合に例外を発生させる
|
RaiseExceptionIfAnyTableFailsToLoad | True | boolean |
true に設定すると、IA-Connect 参照テーブルの読み込みに失敗した場合 (テーブルに問題がある場合など)、例外が発生します。 テーブルの読み込みに失敗した場合、通常はプロセスの後半で例外が発生するため、これが既定です。 false に設定すると、問題の参照テーブルは無視され、使用可能な参照テーブルのみが読み込まれます。 |
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
読み込まれた参照テーブルの数
|
NumberOfLookupTablesLoaded | integer |
正常に読み込まれた参照テーブルの数。 |
|
読み込みに失敗した参照テーブルの数
|
NumberOfLookupTablesFailedToLoad | integer |
読み込みに失敗した参照テーブルの数。 これは、'テーブルの読み込みに失敗した場合に例外を発生させる' が false に設定されている場合にのみ設定されます。それ以外の場合は例外が発生するためです。 |
参照テーブルからの参照値 IA-Connect
入力データに一致する最初の行から、Orchestrator 参照テーブル (Orchestrator を使用したオートメーション用) または現在 IA-Connect エージェントに読み込まれている参照テーブルから値を取得します。 Orchestrator に、IA-Connect エージェントに読み込まれた名前と同じ名前の参照テーブルがある場合は、Orchestrator 参照テーブルが使用されます (自動化が Orchestrator を通過している場合)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
参照テーブル名
|
LookupTableName | True | string |
IA-Connect エージェントに読み込まれた Orchestrator 参照テーブルまたは参照テーブルの名前。 |
|
入力データ JSON
|
InputDataJSON | string |
検索に使用する入力データ (JSON 形式)。 たとえば、ルックアップ テーブルに 'JobTitle' プロパティ列と 'Country' プロパティ列がある場合は、次の JSON を送信できます: { "JobTitle": "Consultant"、"Country": "England" }。 |
|
|
検索結果の値の列名
|
SearchResultValueColumnName | True | string |
読み取る戻り値を保持する参照テーブル内の列。 |
|
検索結果の値の列インデックス
|
SearchResultValueColumnIndex | integer |
1 (既定値) に設定すると、要求された名前に一致する最初の結果列の値が返されます。 N 番目に一致する列を返すには、より大きい値 (N) に設定します。 |
|
|
一致しない場合は例外を発生させる
|
RaiseExceptionIfNoMatch | boolean |
ルックアップがデータと一致しない場合に例外を発生させる場合は、true (既定値) に設定します。 検索がデータと一致しない場合に空白の文字列を返す場合は false に設定します。 |
|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力ルックアップ値
|
OutputLookupValue | string |
指定した参照テーブル列からの出力値。IA-Connect 参照テーブルに対して入力データを検索することによって取得されます。 |
参照テーブルからデータ セル IA-Connect 参照する
入力データに一致する最初の行から、Orchestrator 参照テーブル (Orchestrator を使用したオートメーション用) からすべてのデータ セルを取得し、テーブルとして返します。 このアクションでは、IA-Connect エージェントに読み込まれた参照テーブルはサポートされません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
参照テーブル名
|
LookupTableName | True | string |
Orchestrator 参照テーブルの名前。 |
|
入力データ JSON
|
InputDataJSON | string |
検索に使用する入力データ (JSON 形式)。 たとえば、ルックアップ テーブルに 'JobTitle' プロパティ列と 'Country' プロパティ列がある場合は、次の JSON を送信できます: { "JobTitle": "Consultant"、"Country": "England" }。 |
|
|
一致しない場合は例外を発生させる
|
RaiseExceptionIfNoMatch | boolean |
ルックアップがデータと一致しない場合に例外を発生させる場合は、true (既定値) に設定します。 検索がデータと一致しない場合に空白の文字列を返す場合は false に設定します。 |
|
|
空白のセルを返す
|
ReturnBlankCells | boolean |
戻り値テーブルに空白のセルを含める場合は、true に設定します。 値を持つデータ セルのみを含めるには、false (既定値) に設定します。 |
|
|
戻り値の形式
|
ReturnFormat | string |
結果を返すときに使用する形式。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力参照テーブル JSON
|
OutputLookupTableJSON | string |
入力データと一致する行のデータ セルを含む出力テーブル。IA-Connect 参照テーブルに対して入力データを検索して取得します。 出力テーブルには、JSON 形式の 1 つの行と 1 つ以上のデータ列があります。 |
|
出力参照テーブル
|
OutputLookupTable | array of object |
入力データと一致する行のデータ セルを含む出力テーブル。IA-Connect 参照テーブルに対して入力データを検索して取得します。 出力テーブルには、1 つの行と 1 つ以上のデータ列があります。 |
|
items
|
OutputLookupTable | object | |
|
出力内のセルの数
|
NumberOfCellsInOutput | integer |
出力内のセルの数。 |
参照テーブルから列 IA-Connect 参照する
Orchestrator 参照テーブル (Orchestrator を使用した自動化用) または現在 IA-Connect エージェントに読み込まれている参照テーブルから、入力データに一致する最初の行から 1 つ以上の同じ名前の列を取得し、テーブルとして返します。 たとえば、参照テーブルには、複数の AD グループを表す "AD グループ" という名前の複数の出力列を含め、出力テーブル内の個別の行として返されます。 Orchestrator に、IA-Connect エージェントに読み込まれた名前と同じ名前の参照テーブルがある場合は、Orchestrator 参照テーブルが使用されます (自動化が Orchestrator を通過している場合)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
参照テーブル名
|
LookupTableName | True | string |
IA-Connect エージェントに読み込まれた Orchestrator 参照テーブルまたは参照テーブルの名前。 |
|
入力データ JSON
|
InputDataJSON | string |
検索に使用する入力データ (JSON 形式)。 たとえば、ルックアップ テーブルに 'JobTitle' プロパティ列と 'Country' プロパティ列がある場合は、次の JSON を送信できます: { "JobTitle": "Consultant"、"Country": "England" }。 |
|
|
検索結果テーブルの列名
|
SearchResultTableColumnName | True | string |
出力テーブルに返される値を保持する参照テーブル内の出力列の名前。 ルックアップ テーブル内の出力列にこの名前が 1 つしかない場合、出力テーブルには 1 つの行が含まれます。 ルックアップ テーブル内の複数の出力列が共通の名前を共有している場合、出力テーブルには複数の行が含まれます。 |
|
一致しない場合は例外を発生させる
|
RaiseExceptionIfNoMatch | boolean |
ルックアップがデータと一致しない場合に例外を発生させる場合は、true (既定値) に設定します。 検索がデータと一致しない場合に空白の文字列を返す場合は false に設定します。 |
|
|
空白のセルを返す
|
ReturnBlankCells | boolean |
戻り値テーブルに空白のセルを含める場合は、true に設定します。 値を持つセルのみを含めるには、false (既定値) に設定します。 |
|
|
戻り値の形式
|
ReturnFormat | string |
結果を返すときに使用する形式。 |
|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力参照テーブル JSON
|
OutputLookupTableJSON | string |
指定した名前の 1 つ以上の参照テーブル列から読み取られた出力テーブル。入力データを IA-Connect 参照テーブルに対して検索することによって取得されます。 出力テーブルには、JSON 形式で 1 つの列 (要求された結果テーブルの列名に一致する) と 1 つ以上の行が含まれます。 |
|
出力参照テーブル
|
OutputLookupTable | array of object |
指定した名前の 1 つ以上の参照テーブル列から読み取られた出力テーブル。入力データを IA-Connect 参照テーブルに対して検索することによって取得されます。 出力テーブルには、1 つの列 (要求された結果テーブルの列名に一致する) と 1 つ以上の行が含まれます。 |
|
items
|
OutputLookupTable | object | |
|
出力ルックアップ配列
|
OutputLookupArray | array of object |
指定した名前の 1 つ以上の参照テーブル列から読み取られた出力配列。入力データを IA-Connect 参照テーブルに対して検索することによって取得されます。 出力配列は、1 つ以上の行を含む 1 つの列です。 |
|
items
|
OutputLookupArray | object | |
|
出力内の行数
|
NumberOfRowsInOutput | integer |
出力内の行数。 |
参照テーブルの概要 IA-Connect 取得する
IA-Connect エージェントに現在読み込まれている参照テーブルの概要を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
workflow() に次の式を追加します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ルックアップ テーブルの JSON
|
LookupTablesJSON | array of object |
IA-Connect エージェントに読み込まれた参照テーブル。 |
|
名前
|
LookupTablesJSON.Name | string | |
|
ThenColumnIndex
|
LookupTablesJSON.ThenColumnIndex | integer | |
|
NumberOfRows
|
LookupTablesJSON.NumberOfRows | integer | |
|
NumberOfColumns
|
LookupTablesJSON.NumberOfColumns | integer | |
|
NumberOfUniqueHeaderProperties
|
LookupTablesJSON.NumberOfUniqueHeaderProperties | integer | |
|
参照テーブルの数
|
NumberOfLookupTables | integer |
IA-Connect エージェントに現在読み込まれている参照テーブルの数。 |
文字列から文字を削除する
入力文字列を受け取り、指定した文字を削除して返します。 指定した文字が見つからない場合は、元の文字列が返されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力文字列
|
InputString | string |
文字の削除が実行される入力文字列。 |
|
|
入力文字列から削除する文字
|
CharactersToRemoveFromInputString | string |
入力から削除するすべての文字を含む文字列。 例: !@>^* です。 |
|
|
入力文字列から分音記号を削除する
|
RemoveDiacriticsFromInputString | boolean |
true に設定すると、IA-Connect は入力文字列からすべての分音記号の削除を試み、文字を同じ文字から分音記号を引いた分音記号に置き換えます。 たとえば、"急性アクセント 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 |
出力テーブル。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
出力テーブル内の行数。 |
|
列の数
|
NumberOfColumns | integer |
出力テーブル内の列の数 (常に 1 にする必要があります)。 |
文字列配列から項目を削除する
文字列項目の入力配列を取得し、指定した位置にある項目を削除し、新しい配列を返します。 テーブルから行または行を削除する場合は、"テーブルから行を削除する" アクションを使用します。 JSON 形式のテーブルから行または行を削除する場合は、「JSON テーブルから行を削除する」アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力配列
|
InputArray | True | array of string |
文字列の入力配列。 |
|
開始項目のインデックス
|
StartItemIndex | True | integer |
削除を開始する項目のインデックス。 最初の項目を削除するには 1 を使用し、N 番目の項目を削除するには N を使用します。 |
|
削除する項目の数
|
NumberOfItemsToDelete | True | integer |
削除する項目の数。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力配列
|
OutputArray | array of string |
文字列の出力配列。 |
|
品目数
|
NumberOfItems | 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 |
出力配列内の項目の数。 |
文字列配列のフィルター処理
文字列項目の入力配列を受け取り、(.NET DataView 行フィルター構文を使用して) 配列をフィルター処理し、新しい配列を返します。 テーブルをフィルター処理する場合は、[テーブルのフィルター] アクションを使用します。 JSON 形式でテーブルをフィルター処理する場合は、"JSON テーブルのフィルター処理" アクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力配列
|
InputArray | True | array of string |
文字列の入力配列。 |
|
列名
|
ColumnName | True | string |
フィルター操作中に配列を保持するテーブル列に使用する名前。 この名前は、.NET DataView 行フィルター構文の列名として使用できます。 たとえば、[MyColumn] と呼ばれる MyColumn などです。 |
|
Filter
|
Filter | True | string |
.NET DataView 行フィルター構文のフィルター。 たとえば、'*Element' のような [Name] です。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
フィルター処理された出力配列
|
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 |
末尾の検索文字列。行の末尾まで検索する場合は空白のままにします。 |
|
|
1 行ずつ検索
|
SearchLineByLine | boolean |
入力文字列を 1 行ずつ検索し、結果に現在の行に一致する文字列のみを含める場合は true に設定します。 入力文字列を 1 つの項目として扱う場合は false に設定します。 |
|
|
見つからない場合は例外をスローする
|
ThrowExceptionIfNotFound | boolean |
検索文字列が見つからなかった場合に例外を発生させる場合は true に設定し、検索文字列が見つからなかった場合にアクションが 'String between found'=false を返す必要がある場合は false に設定します。 |
|
|
結果をトリミングする
|
TrimResult | boolean |
結果の前後にスペースまたはタブをトリミングする場合は、true に設定します。 |
|
|
検索は正規表現です
|
SearchIsRegularExpression | boolean |
検索文字列が正規表現の場合は true に設定します。 検索文字列が通常のテキストの場合は false に設定します。 |
|
|
大文字と小文字を区別する検索
|
CaseSensitiveSearch | boolean |
検索で大文字と小文字を区別する必要がある場合は true に設定します。 大文字と小文字を区別しない検索の場合は false に設定します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
検索文字列が見つかりました
|
SearchStringFound | boolean |
'Throw exception if not found' が false に設定されている場合、検索文字列が見つかった場合、この出力は true に設定され、見つからない場合は false に設定されます。 |
|
文字列の間
|
StringBetween | string |
指定した文字列の間に見つかった文字列。 |
正規表現の一致を取得する
入力文字列に対して正規表現 (regex) 一致を実行し、文字列が式と一致の詳細と一致したかどうかを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
一致する入力テキスト
|
TextToMatch | True | string |
正規表現と照合する入力テキスト。 |
|
正規表現
|
Regex | True | string |
入力テキストの照合対象となる正規表現。 |
|
検索インデックス
|
SearchIndex | integer |
取得する一致結果のインデックス (1 から始まる)。 最初の結果 (既定の動作) と一致させる場合は、「1」と入力します。 例: 入力文字列が 5 か所の正規表現と一致することが予想され、4 番目の一致に関心がある場合は、「4」と入力します。 |
|
|
大文字と小文字が区別される一致
|
CaseSensitive | boolean |
大文字と小文字を区別する一致の場合は true (既定値) に設定し (例: A は a ではない)、大文字と小文字を区別しない一致の場合は false に設定します (たとえば、A と a は同一として扱われます)。 |
|
|
正規表現のタイムアウト (秒単位)
|
RegexTimeoutInSeconds | integer |
タイムアウトするまでに正規表現を処理できる最大秒数。これにより、特定の正規表現によって発生する無限ループが停止します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
成功した一致
|
SuccessfulMatch | boolean |
(指定した検索インデックスで) 一致が成功した場合は True、そうでない場合は false。 |
|
文字列値と一致する
|
MatchStringValue | string |
一致が成功した場合、この文字列値は正規表現に一致した入力テキストのテキストを保持します。 |
|
位置インデックスの一致
|
MatchIndex | integer |
一致が成功した場合、この値は入力テキスト内の位置を保持し、一致する場所と一致します。 この値は、入力テキスト文字列の先頭を表す 0 から始まります。 |
|
文字列の長さを一致させる
|
MatchStringLength | integer |
一致が成功した場合、この値は正規表現に一致した入力テキストのテキストの長さ (つまり、出力値 'Match string value' の長さ) を保持します。 |
正規表現の一致を取得する
入力文字列に対して正規表現 (正規表現) の一致を実行し、文字列配列内のすべての一致を返します。 一致がない場合、配列は空になります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
一致する入力テキスト
|
TextToMatch | True | string |
正規表現と照合する入力テキスト。 |
|
正規表現
|
Regex | True | string |
入力テキストの照合対象となる正規表現。 |
|
実行する最大一致数
|
MaximumMatches | integer |
実行する正規表現の一致の最大量。 一致の数に制限がない場合 (つまり、一致がなくなったら一致し続ける) には、値または値 0 (既定値) を入力します。 この入力は、一致する数に制限を設定することで、無限の正規表現ループを回避するように設計されています。 |
|
|
大文字と小文字が区別される一致
|
CaseSensitive | boolean |
大文字と小文字を区別する一致の場合は true (既定値) に設定し (例: A は a ではない)、大文字と小文字を区別しない一致の場合は false に設定します (たとえば、A と a は同一として扱われます)。 |
|
|
結果をトリミングする
|
TrimResults | boolean |
個々の出力配列要素をトリミングする必要がある場合は、true (既定値) に設定します。 |
|
|
空の結果を削除する
|
RemoveEmptyResults | boolean |
空の出力配列要素を出力配列から削除する必要がある場合は true に設定します (つまり、空の結果は必要ありません)。 |
|
|
正規表現のタイムアウト (秒単位)
|
RegexTimeoutInSeconds | integer |
タイムアウトするまでに正規表現を処理できる最大秒数。これにより、特定の正規表現によって発生する無限ループが停止します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力配列
|
OutputArray | array of object |
個々の正規表現が一致する出力文字列配列。 |
|
items
|
OutputArray | object | |
|
出力内の要素の数
|
NumberOfElementsInOutput | integer |
出力配列内の要素の数。 |
正規表現を使用して文字列を分割する
正規表現 (正規表現) の一致を使用して入力文字列を分割し、文字列の個々の分割コンポーネントを文字列配列として返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
分割する入力テキスト
|
TextToSplit | True | string |
正規表現に対して分割する入力テキスト。 |
|
正規表現
|
Regex | True | string |
入力テキストを分割する正規表現。 |
|
大文字と小文字を区別する分割
|
CaseSensitive | boolean |
大文字と小文字を区別する分割の場合は true (既定値) に設定し (例: A は a ではない)、大文字と小文字を区別しない分割の場合は false に設定します (たとえば、A と a は同一として扱われます)。 |
|
|
結果をトリミングする
|
TrimResults | boolean |
個々の出力配列要素をトリミングする必要がある場合は、true (既定値) に設定します。 |
|
|
空の結果を削除する
|
RemoveEmptyResults | boolean |
空の出力配列要素を出力配列から削除する必要がある場合は true に設定します (つまり、空の結果は必要ありません)。 |
|
|
正規表現のタイムアウト (秒単位)
|
RegexTimeoutInSeconds | integer |
タイムアウトするまでに正規表現を処理できる最大秒数。これにより、特定の正規表現によって発生する無限ループが停止します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力配列
|
OutputArray | array of object |
正規表現を使用して分割された、文字列の個々のコンポーネントを含む出力文字列配列。 |
|
items
|
OutputArray | object | |
|
出力内の要素の数
|
NumberOfElementsInOutput | integer |
出力配列内の要素の数。 |
正規表現グループの一致を取得する
入力文字列に対して正規表現 (正規表現) の一致を実行し、一致するグループの名前と値の一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
一致する入力テキスト
|
TextToMatch | True | string |
正規表現と照合する入力テキスト。 |
|
正規表現
|
Regex | True | string |
入力テキストの照合対象となる正規表現。 |
|
取得するグループ
|
GroupsToRetrieve | array of string |
取得する正規表現グループの名前を含む文字列配列。 空の配列を指定すると、すべてのグループが取得されます。 例: 正規表現に (?< が含まれている場合NeedsUpdating>(はい|いいえ)) を指定し、'NeedsUpdating' グループを取得するように指定すると、その名前付きグループの一致する値が返されます。 |
|
|
検索インデックス
|
SearchIndex | integer |
取得する一致結果のインデックス (1 から始まる)。 最初の結果 (既定の動作) と一致させる場合は、「1」と入力します。 例: 入力文字列が 5 か所の正規表現と一致することが予想され、4 番目の一致に関心がある場合は、「4」と入力します。 |
|
|
大文字と小文字が区別される一致
|
CaseSensitive | boolean |
大文字と小文字を区別する一致の場合は true (既定値) に設定し (例: A は a ではない)、大文字と小文字を区別しない一致の場合は false に設定します (たとえば、A と a は同一として扱われます)。 |
|
|
正規表現のタイムアウト (秒単位)
|
RegexTimeoutInSeconds | integer |
タイムアウトするまでに正規表現を処理できる最大秒数。これにより、特定の正規表現によって発生する無限ループが停止します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
正規表現グループ
|
RegexGroups | array of object |
入力文字列と一致する正規表現グループの名前と値を含む配列。 |
|
プロパティ
|
RegexGroups.Property | string | |
|
価値
|
RegexGroups.Value | string | |
|
グループの数
|
NumberOfRegexGroups | integer |
正規表現グループの数。 |
配列を JSON に変換する
入力配列を受け取り、JSON 文字列にシリアル化します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
入力オブジェクト
|
Input object | object |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
出力 JSON
|
OutputJSON | string |
出力 JSON 文字列。 |