スクリプト呼び出し処理

オペレーション名

スクリプト呼び出し

機能概要

プロジェクト内の他のスクリプトやサーバに登録されたスクリプトを呼び出します。

プロパティ

基本設定

項目名	必須/省略可	変数の使用	説明	補足
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明	補足
同じプロジェクトのスクリプト	必須	使用不可	同一プロジェクト内のスクリプトを呼び出す場合に選択します。
スクリプト	必須	使用不可	呼び出し先スクリプト名を選択または入力します。	[同じプロジェクトのスクリプト]を選択した場合、有効になります。
サーバに登録されたプロジェクトのスクリプト	必須	使用不可	サーバに登録されたプロジェクト内のスクリプトを呼び出す場合に選択します。
サービス	必須	使用不可	呼び出し先スクリプトが含まれたサービスを選択または入力します。	[サーバに登録されたプロジェクトのスクリプト]を選択した場合、有効になります。
スクリプト	必須	使用不可	呼び出し先のスクリプト名を選択または入力します。	[サーバに登録されたプロジェクトのスクリプト]を選択した場合、有効になります。

入出力

項目名	必須/省略可	変数の使用	説明	補足
一覧を手動で設定	省略可	使用不可	[入力変数]/[出力変数]を手動で設定するかどうかを選択します。 [チェックあり]: 手動で設定します。 [チェックなし]:(デフォルト) 自動で設定します。
入力変数	省略可	-	呼び出し先スクリプトの入力変数を指定します。また、入力変数へ渡す値を入力します。各列は以下のボタンで操作することができます。 [追加]: 変数を追加します。 [上へ]: 選択している変数の順序を一つ上に上げます。 [下へ]: 選択している変数の順序を一つ下に下げます。 [削除]: 変数を削除します。	[一覧を手動で設定]にチェックを入れた場合、各列の操作を行うボタンが有効になります。
入力変数/変数名	必須	使用不可	変数名を入力します。	[一覧を手動で設定]にチェックを入れた場合、変数名を入力できます。
入力変数/型	必須	使用不可	変数の型を選択します。 [文字列型]:(デフォルト) [整数型]: [10進数型]: [日付/時間型]: [真偽値型]: [バイナリ型]: [XML型]:	[一覧を手動で設定]にチェックを入れた場合、変数の型を選択できます。
入力変数/値	省略可	使用可	変数に渡す値を入力します。
出力変数	省略可	-	呼び出し先スクリプトから受け取る出力変数を指定します。各列は以下のボタンで操作することができます。 [追加]: 変数を追加します。 [上へ]: 選択している変数の順序を一つ上に上げます。 [下へ]: 選択している変数の順序を一つ下に下げます。 [削除]: 変数を削除します。	[一覧を手動で設定]にチェックを入れた場合、各列の操作を行うボタンが有効になります。
出力変数/変数名	必須	使用不可	変数名を入力します。	[一覧を手動で設定]にチェックを入れた場合、変数名を入力できます。
出力変数/型	必須	使用不可	変数の型を選択します。 [文字列型]:(デフォルト) [整数型]: [10進数型]: [日付/時間型]: [真偽値型]: [バイナリ型]: [XML型]:	[一覧を手動で設定]にチェックを入れた場合、変数の型を選択できます。

プロパティアクション

項目名	説明	補足
再読み込み	呼び出し先スクリプトの[入力変数]/[出力変数]の一覧を再度読み込みます。	[サービス]または[スクリプト]に変数が指定されていない場合、有効になります。手動で設定した入力変数および出力変数は、呼び出し先スクリプトの入力変数および出力変数で上書きされます。

項目名	必須/省略可	変数の使用	説明	補足
コメント	省略可	使用不可	このアダプタの簡単な説明を記述することができます。説明を記述すると、仕様書に反映させることができます。

使用できるコンポーネント変数

コンポーネント変数名	説明
exitStatus	呼び出し先スクリプトの戻り値を返します。
error_type	エラーが発生したときに、エラーの種類を返します。 java.io.FileNotFoundExceptionというような形式で返されます。エラーが発生しなかった時にはnullを返します。バージョンにより、内容が変わる可能性があります。
error_message	エラーが発生したときのエラーメッセージを返します。バージョンにより、内容が変わる可能性があります。
error_trace	エラーが発生したときのトレース情報を返します。バージョンにより、内容が変わる可能性があります。
[<出力変数名>]	[出力変数]で設定した出力変数値を返します。 XML型の出力変数はコンポーネント変数として出力しません。結果データとして出力します。

主な例外

例外名	原因	対策
InvalidPropertyConfigurationException <プロパティ名>が指定されていません。	[<プロパティ名>]が指定されていません。	[<プロパティ名>]を指定してください。
ProjectNotFoundException	[サービス]で指定したサービスがサーバに登録されていません。	[サービス]で指定したサービスがサーバに登録されているかどうかを確認してください。
ScriptCallFailedException	呼び出したスクリプトの処理が失敗しました。	呼び出したスクリプトの処理内容を確認してください。
ScriptNotFoundException	[スクリプト]で指定したスクリプトが見つかりません。	[スクリプト]で指定したスクリプトが存在するかどうかを確認してください。

入出力変数について

呼び出し先スクリプトにスクリプト入力変数/スクリプト出力変数を用意することにより、スクリプト間のデータの受け渡しが可能になります。

スクリプト入力変数/スクリプト出力変数の作成(呼び出し先スクリプト)
プロジェクトエクスプローラで対象のスクリプト変数のプロパティを開き、[スクリプト入力変数として使用する]または[スクリプト出力変数として使用する]にチェックを入れます。
詳細については、「プロジェクトエクスプローラ」を参照してください。
使用方法(XML型のスクリプト変数以外の場合)
- 呼び出し元スクリプトでの使い方
  - 入力変数
    スクリプト呼び出し処理のプロパティから、対象のスクリプト変数に代入する値を指定します。
  - 出力変数
    Mapperから、コンポーネント変数として値を取得します。
- 呼び出し先スクリプトでの使い方
  通常のスクリプト変数としてスクリプト内で使用します。
使用方法(XML型のスクリプト変数の場合)
XML型スクリプトを入出力変数として使用すると、各コンポーネントの結果データをそのまま受け渡すことができます。また、Mapperでスキーマの設定を行いXML変数の値をスクリプト内で使用することもできます。
- 呼び出し元スクリプトでの使い方
  スクリプト呼び出し処理とその他のコンポーネントをデータフローでつなぎます。
  
  対象のコンポーネントからスクリプト呼び出し処理に右クリックドラッグ&ドロップを行い、メニューの[データフローを引く]または[プロセスフローとデータフローを引く]から「main_data → <スクリプト入力変数名>」を選択します。
  
  スクリプト呼び出し処理から対象のコンポーネントに右クリックドラッグ&ドロップを行い、メニューの[データフローを引く]または[プロセスフローとデータフローを引く]から「<スクリプト出力変数名> → main_data」を選択します。
  
  処理の概要としては、コンポーネントから受け取った結果データを呼び出し先スクリプトのXML型スクリプト入力変数に渡し、呼び出し先スクリプトの結果データをXML型スクリプト出力変数経由でコンポーネントに渡します。
- 呼び出し先スクリプトでの使い方
  startコンポーネント、endコンポーネントとその他のコンポーネントをデータフローでつなぎます。
  
  startコンポーネントから対象のコンポーネントに右クリックドラッグ&ドロップを行い、メニューの[データフローを引く]または[プロセスフローとデータフローを引く]から「<スクリプト入力変数名> → main_data」を選択します。
  
  対象コンポーネントからendコンポーネントに右クリックドラッグ&ドロップを行い、メニューの[データフローを引く]または[プロセスフローとデータフローを引く]から「main_data → <スクリプト出力変数名>」を選択します。
  
  処理の概要としては、呼び出し元のスクリプトから受け取ったデータをXML型スクリプト入力変数からコンポーネントに渡し、その結果データをXML型スクリプト出力変数経由で呼び出し元スクリプトに戻します。