[ServiceNow] Client Side ScriptからFlowを呼び出す

はじめに

ServiceNowのFlow機能は、従前のWorkflowに代わる新しい機能です。FlowはFlow Designerで定義でき、必ずしもリッチなScriptが書けなくても、ローコード・ノーコードで作れます。
Flow Designerは、ServiceNow上で、ビジネスフロー要件を実現する強力なツールですが、作成されたFlowは、OOTBでは、UI ActionなどのClient Side Scriptから呼び出すことはできません。
ここでは、ServiceNowインスタンス上で、基本的な設定をして、実際に簡単なFlowをUI Actionから呼び出してみます。

ACLの設定

最初に、Client Side ScriptがFlowを呼び出せるように、ACLを新規作成します。
ACLを以下のように設定します。

• Type: client_callable_flow_object
• Operation: execute
• Application: Global
• Name: (適当)（例: Trigger flow from client script）
• Requried roleとCoditionとScript: (適当)
  • 特にRoleやConditionの制限をせず、Login Userのみに許可する場合は、下記の様に設定します。

Script

answer = gs.getSession().isLoggedIn();
if (!answer) {
    answer = gs.getProperty('glide.security.allow_unauth_roleless_acl', false);
}

Flowの作成

Flow DesignerでFlowを作成します。ただし、FlowはTriggerを含む設定なので、CallableなFlowは、実際にはSub Flowになります。
ここでは、UI ActionからSub Flowを呼び出す検証なので、どんなロジックでも良いのですが、例としてsys_userのsys_idを引数に取り、そのUserのいくつかのField値を返すSub Flowを作成します。以下が例ですが、環境独自のUser Fieldを含んでいます。

Flow Designerの便利な機能として、作成したSub Flowを呼び出すためにCode Snippetを自動生成してくれます。右上の三点 （…）アイコンから、Create code snippetを選択すると、Server Side用とClient Side用の標準的なSub FlowをCallするScriptが表示されます。

UI Actionの作成

新規のUIアクションを作成して、Code Snippetをコピーして、多少のロジックを整形します。ここでは、Formで開いているUserのManager fieldの値を取って、そのManagerのUser情報を取得して、JavaScriptのAlert関数で表示しています。

Script

function Get_Manager_Info() {
	var inputs = {};

	inputs['user_sys_id'] = g_form.getValue('manager'); // String 

	GlideFlow.startSubflow('global.getuserinfo', inputs)
		.then(function(execution) {
			return execution.awaitCompletion();
		}, errorResolver)
		.then(function(completion) {

			var status = completion.status;

			// Available Outputs:
			var outputs = completion.outputs;		
			var user_company = outputs['user_company']; // String		
			var user_compan_ja = outputs['user_compan_ja']; // String		
			var user_email = outputs['user_email']; // String		
			var user_name = outputs['user_name']; // String

			var messageBody = "";
			messageBody += getMessage("Name") + ": " + user_name + "\n";
			messageBody += getMessage("Campany") + ": " + user_company + "\n";
			messageBody += getMessage("Campany (Ja)") + ": " + user_compan_ja + "\n";
			messageBody += getMessage("Email") + ": " + user_email;
			
			alert(messageBody);
		});

	function errorResolver(error) {
		// Handle errors in error resolver
	}
}

実行結果

関連リンクのGet Maneger Infoをクリックすると、次のようにAlertでUserとしてのManagerの情報を表示されます。
ちなみに、このManagerであるUser (Deleted User 01) は、Active:Falseで論理削除されており、通常は表示できないUserですが、Sub Flowをログインユーザーの権限ではなくSystem Userで実行しているため、強制的に表示することが可能です。これはFlowがBusiness Ruleではできない利点の一つです。
なお、一般的にFlowは処理が遅いので、Business RuleでできることをFlowで実装することは、市民開発（ユーザー部門によるEUC開発）でもない限りお勧めしません。