ScriptableFlowRunnerResult - 범위 지정됨

Xanadu API 참조

Release

xanadu

ft:locale

ko-KR

ft:publication_title

Xanadu API 참조

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

ScriptableFlowRunnerResult - 범위 지정됨

릴리스 버전: Xanadu

업데이트 날짜 2024년 08월 01일

읽기10분

ScriptableFlowRunner를 사용하여 플로우, 하위 플로우 또는 작업을 실행한 결과를 캡처합니다. 컨텍스트 ID, 도메인 및 플로우 실행의 출력과 같은 데이터를 포함합니다.

sn_fd 네임스페이스 식별자와 함께 서버 측 스크립트에서 이러한 메서드를 사용합니다.

API 호출 순서

다음 순서로 이러한 API를 사용하여 플로우, 하위 플로우 및 작업을 빌드하고 실행합니다.

1. FlowAPI: 빌더 객체 생성

getRunner()를 사용하여 ScriptableFlowRunner 빌더 객체를 인스턴스화합니다.

2. ScriptableFlowRunner: 실행할 콘텐츠 지정 워크플로우 스튜디오

다음 순서대로 다음 메서드를 사용하여 빌더 패턴을 생성합니다.

action(),datastream(),flow() 또는 subflow() 메서드 중 하나를 사용하여 빌드할 객체 유형을 워크플로우 스튜디오 지정합니다.
addInput(),inDomain() 또는 quick()과 같은 하나 이상의 메서드를 사용하여 실행 매개 변수를 지정합니다.
run() 메서드를 사용하여 제공된 매개변수로 작업, 플로우 또는 하위 플로우를 실행하고 ScriptableFlowRunnerResult 객체를 반환합니다.

3. ScriptableFlowRunnerResult: 실행 상세 정보 검색 워크플로우 스튜디오

getContextId(), getOutputs() 및 getDomainId()와 같은 하나 이상의 메서드를 사용하여 실행 상세 정보를 봅니다.

예제

이 예제에서는 ScriptableFlowRunner 빌더 객체를 생성하고 이를 사용하여 특정 기록에 대한 승인 작업을 실행하는 방법을 보여줍니다. ScriptableFlowRunnerResult 객체는 실행 인수와 작업 출력을 캡처합니다.


(function() {
  try {

    var inputs = {}; 

    inputs['sys_id'] = '57af7aec73d423002728660c4cf6a71c';  // Pass the record's sys_id in as input.  

    var result = sn_fd.FlowAPI.getRunner()  // Create a ScriptableFlowRunner builder object.
      .action('global.markapproved')        // Run the global scope action named markapproved.
      .inForeground()
      .inDomain('TOP/ACME')                 // Run the action from the TOP/ACME domain.                               
      .withInputs(inputs)
      .run();                               // Run the action and return a FlowRunnerResult object.

    var contextId = result.getContextId();  // Retrieve the context ID from the result
    var dateRun = result.getDate();
    var domainUsed = result.getDomainId();  // Retrieve the Domain ID from the result.
    var flowName = result.getFlowObjectName();
    var flowObjectType = result.getFlowObjectType();

    var outputs = result.getOutputs();            // Retrieve any outputs from the action execution.
    var newApprovalStatus = outputs['approval'];  // Echo back the approval status for verification.
		
  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }
	
})();

ScriptableFlowRunnerResult - debug()

컨텍스트 ID, 도메인 ID 및 실행 출력을 포함하여 실행된 플로우, 하위 플로우 또는 작업에 대한 정보를 반환합니다.

표 1. 매개변수
이름	유형	설명
없음

표 2. 반환
유형	설명
문자열	작업, 플로우 또는 하위 플로우 실행에 워크플로우 스튜디오 대한 실행 상세 정보입니다. 플로우 객체 이름: 플로우, 하위 플로우 또는 작업의 이름입니다. 플로우 객체 유형: 플로우, 하위 플로우, 작업 또는 데이터스트림 작업입니다. 도메인 ID: 플로우, 하위 플로우 또는 작업이 실행된 도메인의 ID입니다. 결과 시간: 실행하는 데 걸린 시간입니다. 컨텍스트 ID: 작업, 플로우 또는 하위 플로우에 대한 실행 세부 정보 기록의 Sys_id 워크플로우 스튜디오 입니다. output count: 작업 또는 하위 플로우 출력의 수입니다.

이 예시에서는 ScriptableFlowRunnerResult 객체에서 실행된 플로우, 하위 플로우 또는 작업에 대한 정보를 검색하는 방법을 보여줍니다.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.debug());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

출력:

*** Script: FlowRunnerResult
Flow Object Name: global.test_flow
Flow Object Type: flow
Domain: null
Result Time: 2020-06-08 18:28:41
ContextId: null
Output count: 0

ScriptableFlowRunnerResult - getContextId()

플로우, 하위 플로우 또는 작업의 컨텍스트 ID를 반환합니다.

표 3. 매개변수
이름	유형	설명
없음

표 4. 반환
유형	설명
문자열	작업, 플로우 또는 하위 플로우에 대한 실행 세부 정보 기록의 sys_id 워크플로우 스튜디오 입니다.

이 예제에서는 ScriptableFlowRunnerResult 객체에서 컨텍스트 ID를 검색하는 방법을 보여줍니다.

var contextId = result.getContextId();

출력:

4ecead85c4da1110598d0c7d6bf73554

ScriptableFlowRunnerResult - getDate()

작업, 플로우 또는 하위 플로우가 GlideDateTime 객체로 실행된 날짜 및 시간을 워크플로우 스튜디오 반환합니다.

표 5. 매개변수
이름	유형	설명
없음

표 6. 반환
유형	설명
GlideDateTime	플로우, 하위 플로우 또는 작업의 실행 날짜 및 시간입니다.

이 예제에서는 ScriptableFlowRunnerResult 객체에서 흐름 실행의 날짜 및 시간을 검색하는 방법을 보여줍니다.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getDate());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

출력:

2020-05-22 18:45:42

ScriptableFlowRunnerResult - getDataStream()

데이터 스트림 작업에서 데이터 스트림을 반환합니다.

datastream() 메서드가 ScriptableFlowRunner 빌더 클래스에서 사용된 경우 데이터 스트림을 ScriptableDataStream 객체로 반환합니다. ScriptableDataStream 클래스를 사용하여 스트림의 항목을 반복합니다. ScriptableDataStream을 참조하세요.

데이터 스트림 작업에 대한 자세한 내용은 데이터 스트림 작업 및 페이지 매김을 참조하십시오.

표 7. 매개변수
이름	유형	설명
없음

표 8. 반환
유형	설명
스크립트 가능 데이터 스트림	데이터 스트림의 항목을 반복하는 데 사용할 수 있는 ScriptableDataStream 객체입니다. ScriptableDataStream 클래스의 메서드를 사용하여 이 객체와 상호 작용합니다. ScriptableDataStream을 참조하세요.

이 예제에서는 ScriptableFlowRunnerResult 객체에서 데이터 스트림을 검색하는 방법을 보여줍니다.

var datastream = result.getDataStream();

ScriptableFlowRunnerResult - getDomainId()

작업, 플로우 또는 하위 플로우가 실행된 워크플로우 스튜디오 도메인의 sys_id 반환합니다.

표 9. 매개변수
이름	유형	설명
없음

표 10. 반환
유형	설명
문자열	작업, 플로우 또는 하위 플로우가 실행된 워크플로우 스튜디오 도메인의 sys_id입니다.

이 예제에서는 ScriptableFlowRunnerResult 객체에서 도메인 ID를 검색하는 방법을 보여줍니다.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .inDomain('TOP/ACME')
      .timeout(12000)
      .run();

    gs.info(result.getDomainId());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

출력:

4ecead85a4da1110598d0c7d6bf75554

ScriptableFlowRunnerResult - getFlowObjectType()

객체 실행의 워크플로우 스튜디오 유형을 반환합니다.

표 11. 매개변수
이름	유형	설명
없음

표 12. 반환
유형	설명
FlowObjectType	객체 실행 유형 워크플로우 스튜디오 으로, 작업, 플로우 또는 하위 플로우입니다.

이 예제에서는 ScriptableFlowRunnerResult API에서 플로우 객체 유형을 검색하는 방법을 보여줍니다.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getFlowObjectType());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

출력:

flow

ScriptableFlowRunnerResult - getFlowObjectName()

작업, 플로우 또는 하위 플로우 실행의 워크플로우 스튜디오 범위와 내부 이름을 반환합니다.

표 13. 매개변수
이름	유형	설명
없음

표 14. 반환
유형	설명
문자열	작업, 플로우 또는 하위 플로우 실행의 워크플로우 스튜디오 범위 및 내부 이름입니다. 예: `global.emailflow`.

이 예제에서는 ScriptableFlowRunnerResult 객체에서 플로우, 하위 플로우 또는 작업 이름을 검색하는 방법을 보여줍니다.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .flow('global.test_flow')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getFlowObjectName());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

출력:

global.test_flow

ScriptableFlowRunnerResult - getOutputs()

완료된 워크플로우 스튜디오 작업, 플로우 또는 하위 플로우의 출력을 반환합니다.

표 15. 매개변수
이름	유형	설명
없음

표 16. 반환
유형	설명
객체	완료된 워크플로우 스튜디오 작업, 플로우 또는 하위 플로우의 출력을 포함하는 객체입니다.

이 예제에서는 ScriptableFlowRunner API를 사용하여 실행되는 작업, 플로우 또는 하위 플로우에서 출력을 워크플로우 스튜디오 검색하는 방법을 보여줍니다.

(function() {
  try {

    var result = sn_fd.FlowAPI.getRunner()
      .action('global.test_action')
      .inForeground()
      .timeout(12000)
      .run();

    gs.info(result.getOutputs());

  } catch (ex) {
    var message = ex.getMessage();
    gs.error(message);
  }

})();

출력:

Flow Designer: Warning. This is an important log message.