こんにちは、NTTデータ WinActor技術支援チームです。
いつもユーザーフォーラムをご利用いただき、ありがとうございます。

＊＊＊＊＊＊お願い＊＊＊＊＊＊
本コラムをご覧いただいた方へ、簡単なアンケートのご協力をお願いしております。
URLはこちら　→　https://forms.office.com/r/qgecyfEkaA
＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊

今回のコラムはこんな方にオススメです☆
　・「シナリオファイル呼び出し」を使用したことがない方、これから使用するために設定方法などを知りたい方
　・「シナリオファイル呼び出し」と「サブルーチン呼び出し」の違いを知りたい方

■「シナリオファイル呼び出し」と「サブルーチン呼び出し」

「シナリオファイル呼び出し」と似ているノードとして「サブルーチン呼び出し」がありますが、

どちらもシナリオ内で”特定の処理を行う何か“を呼び出すという点は同じです。

呼び出すものが、シナリオファイルかサブルーチングループかの違いになります。

上記以外の違いとしては・・・「サブルーチン呼び出し」はサブルーチングループを作成したシナリオでしか使用できませんが、

「シナリオファイル呼び出し」は呼び出すシナリオを作成しておくと、複数のシナリオで共通して使用できます。

＜例＞サブルーチン呼び出しの場合

　シナリオA内で作成したサブルーチンをシナリオBでも使用したい場合、
　「サブルーチン呼び出し」でシナリオBからシナリオA内のサブルーチンを呼び出すことはできません。

　※インポート機能でシナリオAのサブルーチンのみをシナリオBにインポートして使用することは可能ですが、
　　シナリオAのサブルーチンが修正された場合、インポートしたサブルーチンには修正が反映されません。
　　そのため、元シナリオに修正が発生しないような処理内容の場合にインポートを使用することをオススメします。

■「シナリオファイル呼び出し」

　シナリオ実行中に「シナリオファイル呼び出し」で指定された他のシナリオファイルを読み込んで実行します。
　他のシナリオファイルを呼び出す側を「呼び出し元」、呼び出された側を「呼び出し先」と呼びます。

　「シナリオファイル呼び出し」で指定されたシナリオの実行後は、
　呼び出し元シナリオに戻り、シナリオファイル呼び出し以降の処理が実行されます。

　＜例＞シナリオファイル呼び出しの場合

　複数のシナリオで使用したい共通の処理（例：エラーが発生したらお知らせメールを送信など）をシナリオファイルとして作成しておくと、
　複数シナリオの必要箇所に「シナリオファイル呼び出し」を配置することで同じシナリオを呼び出すことが可能となります。
　※共通シナリオが修正された場合でも、シナリオAB共に修正後の共通シナリオを呼び出すため、シナリオAB側での修正は不要です。

■プロパティ画面での設定

　・シナリオファイル名：呼び出すシナリオファイルのパスを指定
　　※選択できるシナリオファイルは、「.ums7」「.uss7」「.wsb7」
　　　「.ums6」「.ums5」のいずれかの拡張子が付いたファイルです。

　・戻り値：呼び出し先シナリオからの戻り値を設定する変数を指定（省略可）
　　※呼び出し先シナリオの処理結果を「戻り値」として呼び出し元シナリオに渡すことで、
　　　呼び出し元シナリオ内で戻り値をもとに処理を分岐したりすることが可能です。

　・呼び出し設定タブ：呼び出し先シナリオで使われている変数の初期値を指定することが可能
　　[変数名]⇒リストから選択 or 直接入力が可能　　[値]⇒変数名 or 値を設定

　・戻り設定タブ：呼び出し元と呼び出し先で同じ名前の変数が使われている場合、
　　　　　　　　　呼び出し先の実行終了時の変数値を呼び出し元に引き継ぐことが可能

■オプション画面での設定

　【呼び出し先のシナリオファイルにパスワードが設定されている時のみ、呼び出し先のシナリオファイルを呼び出す】
　　┗ チェックを付けると、呼び出し先のシナリオファイルにパスワードが設定されている場合にのみ
　　　「シナリオファイル呼び出し」が実行できるよう制限されます。
　　　呼び出し先のシナリオファイルにパスワードが設定されていない場合は、
　　　「シナリオファイル呼び出し」がエラーとなってしまうため、必要な場合にのみチェックを付けてください。

　【シナリオ呼び出しで呼び出し元のシナリオファイルへ戻るときに、呼び出し先のシナリオファイルを閉じる】
　　┗ チェックを付けると、「シナリオファイル呼び出し」で呼び出し元のシナリオファイルへ戻る際に、
　　　呼び出し先シナリオファイルを閉じるようになります。
　　　ただし、シナリオ実行前に呼び出し先シナリオファイルが手動で既に開かれていた場合は、
　　　チェックが付いていても呼び出し先シナリオファイルを閉じません。

※「シナリオファイル呼び出し」の注意点※
　・呼び出し先シナリオでは、データ一覧は使用できません。
　・呼び出し先シナリオにパスワードが設定されている場合、そのシナリオが呼び出される際に
　　「シナリオパスワード」画面が表示されて、パスワードの入力が求められます。
　（呼び出し先シナリオのパスワードが直前に開いたシナリオと同じ場合、パスワード画面は表示されません。）

【動作検証環境】
WinActor Ver.7.4.4

＜お願い＞
　本投稿に関しての問合せにつきましては、
　恐れ入りますがコメントではなく、個別問合せにてお願いいたします。
★お問合せ方法はこちらのコラムをご参照ください
　【WA0116】ユーザーフォーラムで質問を投稿するときの手順

☆★ほかのコラムは WinActor利用者向けコラム一覧 から★☆