manifest.json

manifest.json ファイルの最上位の設定に、次の JSON 要素が含まれています。

次のフィールドには、アクション設定のアクション要素が含まれています。

次のフィールドにはパラメータ形式が含まれています。

数値パラメータの場合、デフォルト値は最小値と最大値の間にある必要があります (両端を含む)。3 つの設定はすべて、-2147483648 から +2147483647 の範囲内である必要があります。

次のフィールドにはレスポンス形式が含まれています。

アプリケーションのレスポンスの浮動小数点数値は整数に変換されます。

マニフェストの例

次の manifest.json の例では、対応する関数を呼び出して 2 つの数値を加算するさまざまなコネクタ (shell、node、python、program) を使用しています。

関数パラメータは、この関数に渡される順序で定義されます(例: First number および Second number の順序)。

計算の結果は、Sum 値に割り当てられた変数に格納されてロボットに戻されます。

出力値は、コネクタごとに異なった方法で割り当てられます。

Python の例: 「Fibonacci」

次のコード例では、manifest.json ファイルの最上位 JSON 要素に Python コネクタを指定します。

{
	"actions": [
		{
			"name": "Fibonacci",
			"type": "python",
			"parameters": [
				{
					"name": "generation",
					"type": "number",
					"min": 1,
					"max": 100,
					"default": 3
				}
			],
			"response": [
				{
					"name": "bunnies",
					"type": "number"
				}
			],
			"commandline": [
				"import fib as f",
				"rpa_return = { 'bunnies': f.fib(%1) }"
			]
		},
		{
			"name": "Run Python (3.x) standard",
			"type": "python",
			"parameters": [
				{
					"name": "script",
					"type": "string",
					"escape": false
				}
			],
			"commandline": [
				"%1"
			]
		}
	],
	"name": "Python 3.x",
	"python-support": 3,
	"python-linux": "python3",
	"python-windows": "python"
}

Python の例: 「Adder」

このコネクタを機能させるには、コネクタを備えたロボットが実行されているコンピュータに最新の Python バージョンをインストールします。

{"actions": [
    {
      "name": "Adder",
      "type": "python",
      "parameters": [
        {
          "name": "First number",
          "type": "number"
        },
        {
          "name": "Second number",
          "type": "number",
          "min": 1,
          "default": 1000
        }
      ],
      "response": [
        {
          "name": "Sum",
          "type": "number"
        }
      ],
      "commandline": [
        "rpa_return = { 'Sum': %1 + %2 }"
      ]
    }
  ],
  "name": "Adder Function (python)"
}

シェルの例: 「Command Line」

次のコード例では、基盤となる OS にコマンドを渡します。

{
	"actions": [
		{
			"name": "Command Line",
			"type": "shell",
			"parameters": [
				{
					"name": "Command",
					"type": "string"
				},
				{
					"name": "Parameter",
					"type": "string",
					"optional": true
				}
			],
			"commandline": [
				"%1", "%2"
			],
			"wait": true,
			"stdout": true,
			"stderr": true
		}
	],
	"name": "Shell"
}

Linux シェルの例: 「Adder」

次のコード例は Linux 専用であり、Windows では動作しません。

{
  "actions": [
    {
      "name": "Adder",
      "type": "shell",
      "parameters": [
        {
          "name": "First number",
          "type": "number"
        },
        {
          "name": "Second number",
          "type": "number",
          "min": 1,
          "default": 1000
        }
      ],
      "response": [
        {
          "name": "Sum",
          "type": "number"
        }
      ],
      "commandline": [
	"echo \"{ \\\"Sum\\\": $((%1 + %2)) }\""
      ]
    }
  ],
  "name": "Adder Function (shell)"
}

ノードの例: 「Fibonacci」

次のコード例は Node.js で実行されます。

{
	"actions": [
		{
			"name": "Fibonacci",
			"type": "node",
			"parameters": [
				{
					"name": "generation",
					"type": "number",
					"min": 1,
					"max": 32,
					"default": 1
				}
			],
			"response": [
				{
					"name": "bunnies",
					"type": "number"
				}
			],
			"commandline": [
				"return { bunnies: require('Fibonacci').fib(%1) };"
			]
		},
		{
			"name": "Run JavaScript",
			"type": "node",
			"parameters": [
				{
					"name": "script",
					"type": "string",
					"escape": false
				}
			],
			"commandline": [
				"%1"
			]
		}
	],
	"name": "NodeJS"
}

ノードの例: 「Adder」

{
  "actions": [
    {
      "name": "Adder",
      "type": "node",
      "parameters": [
        {
          "name": "First number",
          "type": "number"
        },
        {
          "name": "Second number",
          "type": "number",
          "min": 1,
          "default": 1000
        }
      ],
      "response": [
        {
          "name": "Sum",
          "type": "number"
        }
      ],
      "commandline": [
        "return { Sum: %1 + %2 };"
      ]
    }
  ],
  "name": "Adder Function (node)"
}

プログラムの例: 「Adder」

このコネクタは、コネクタによって呼び出される実行可能プログラム「add」を使用します。

{
  "actions": [
    {
      "name": "Adder",
      "type": "program",
      "parameters": [
        {
          "name": "First number",
          "type": "number"
        },
        {
          "name": "Second number",
          "type": "number",
          "min": 1,
          "default": 1000
        }
      ],
      "response": [
        {
          "name": "Sum",
          "type": "number"
        }
      ],
      "commandline": {
      "windows":["./add.exe", "%1", "%2"],
      "linux":["./add", "%1", "%2"],
    }
  ],
  "name": "Adder Function (program)"
}

プログラム

応答として送信される JSON データは、JavaScript Object Notation (JSON) Data Interchange Format 標準 RFC-8259 に準拠する必要があります。プログラム コネクタは、この標準で要求されているように、出力が必ず UTF-8 でエンコードされているようにする必要があります。

プログラムのアクションは次のとおりです。

• アクションに応答配列がある場合、待機フィールドは無視され、プログラムが終了するまでロボットは待機します。プログラムの標準出力はキャプチャされ、JSON 文字列として解析され、変数にはこの文字列の各フィールドが入力されます。プログラムが有効な JSON 文字列を生成しない場合、ロボットは失敗します。
• アクションにレスポンス配列がなく、待機フィールドが false の場合、ステップにはレスポンス変数がありません。
• アクションにレスポンス配列がなく、待機フィールドが true の場合、ステップには次のレスポンス変数があります。
  • rc: プログラムの戻りコード。
  • stdout: プログラムの標準出力ストリーム (stdout が true の場合のみ提供されます)。
  • stderr: プログラムの標準エラー ストリーム (stderr が true の場合のみ提供されます)。

Connector の構成に関係なく、標準出力ストリームと標準エラー ストリームは、INFO レベルで Tungsten RPA ログに記録されます。

シェル

応答として送信される JSON データは、JavaScript Object Notation (JSON) Data Interchange Format 標準 RFC-8259 に準拠する必要があります。シェル コネクタは、この標準で要求されているように、出力が必ず UTF-8 でエンコードされているようにする必要があります。

シェル アクションは、Windows では CMD.EXE、Linux では bash を使用して実行されます。

• アクションに応答配列がある場合、待機フィールドは無視され、シェルが終了するまでロボットは待機します。シェルの標準出力はキャプチャされ、JSON 文字列として解析され、変数にはこの文字列の各フィールドが入力されます。プログラムが有効な JSON 文字列を生成しない場合、ロボットは失敗します。
• アクションにレスポンス配列がなく、待機フィールドが false の場合、ステップにはレスポンス変数がありません。
• アクションにレスポンス配列がなく、待機フィールドが true の場合、ステップには次のレスポンス変数があります。
  • rc: シェルの戻りコード。
  • stdout: シェルの標準出力ストリーム (stdout が true 場合のみ提供されます)。
  • stderr: シェルの標準エラー ストリーム (stderr が true 場合のみ提供されます)。

Connector の構成に関係なく、標準出力ストリームと標準エラー ストリームは、INFO レベルで Tungsten RPA ログに記録されます。

JavaScript: NodeJS

コマンド ラインは、関数のコンテキストで実行されます。コマンドは、結果をロボットに返すために return ステートメントを使用する必要があります。

• アクションにレスポンス ブロックがある場合、オブジェクトまたは JSON 文字列を返すことが期待され、変数にはこのオブジェクトの各フィールドが入力されます。例外がスローされ、処理されない場合、ロボットは失敗します。
• アクションにレスポンス ブロックがない場合、ステップには次の 2 つの応答変数があります。

  結果: ステートメントが正常に完了した場合、この変数はステートメントによって返された値を受け取ります。

  エラー: 例外がスローされ、JavaScript コードで処理されない場合、この変数には例外のテキストが含まれます。

Python

コマンド ラインは exec() 関数を使用して実行されます。このコマンドは、ロボットに結果を返すために、グローバル変数 rpa_return に値を割り当てる必要があります。

1. アクションにレスポンス ブロックがある場合、rpa_return はオブジェクトまたは JSON 文字列を含める必要があり、変数にはこのオブジェクトの各フィールドが入力されます。例外がスローされ、処理されない場合、ロボットは失敗します。

1. アクションにレスポンス ブロックがない場合、ステップには次の 2 つの応答変数があります。

   • 結果: ステートメントが正常に完了した場合、この変数は rpa_return の値を受け取ります。

   • エラー: 例外がスローされ、Python コードで処理されない場合、この変数には例外のテキストが含まれます。

.zip ファイルの次の要素は予約されています。