워크플로우에서 변수 사용

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 7분
  • 워크플로우 내에서 사용할 수 있는 여러 유형의 변수가 있습니다.

    일부 변수는 워크플로우의 각 부분(예: 워크플로우 활동)을 정의, 설명 또는 구성합니다. 일부 변수는 특히 워크플로우 실행을 용이하게 하기 위해 사용할 수 있습니다(예: 스크래치패드 변수). 일부 변수는 워크플로우 프로세스에 의해 조작되는 데이터 기록을 정의, 설명 또는 구성합니다(예: 인시던트와 같이 기록을 설명하는 dictionary.xml 파일에 정의된 Glide 기록의 요소).

    활동 변수

    활동 변수는 워크플로우 활동과 특별히 연결된 속성입니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    특정 활동을 워크플로우 캔버스로 끌어올 때 활동 정의에 나타나는 입력입니다. 이러한 변수는 워크플로우 활동 또는 수행하도록 설계된 작업을 정의, 작성 또는 설명하는 속성입니다.

    활동 변수는 워크플로우 활동 정의 내 관련 목록에서 선언됩니다.

    변수를 추가하거나, 열람하거나, 수정하는 방법은 다음과 같습니다.

    프로시저

    1. 다음으로 이동 모두 > 워크플로우 > 활동 정의.
    2. 워크플로우 활동(예: 승인 - 사용자)을 선택합니다.
    3. 활동 변수 섹션 또는 탭에서 변수를 추가, 보기 또는 수정합니다. 활동 변수는 시스템 딕셔너리와 동일한 필드를 사용하여 정의됩니다.
      주:
      다른 활동 변수에 종속되는 새 활동 변수를 정의하는 경우 상위 활동 변수의 이름 앞에 프리픽스 "vars."를 넣습니다. 예를 들어, 하위 필드가 parent라는 필드에 종속되는 경우 종속 필드에 vars.parent 값을 입력합니다.
      활동을 캔버스로 끌어온 후 워크플로우 캔버스에서 활동 변수의 표시 여부를 제어하려면 wf_activity 테이블에서 UI 정책을 사용합니다.
      워크플로우 활동 내에서 변수에 액세스하거나 이러한 변수에 값을 할당하려면 워크플로우 활동의 vars 변수를 사용합니다.
       activity.vars.variable_name = new_variable_value 

    워크플로우 입력 변수

    워크플로우 변수는 워크플로우가 실행되는 동안 워크플로우에 전달되고 워크플로우에서 참조하는 외부 값입니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    워크플로우 변수는 스크립트에서 외부적으로 선언되어 메인 워크플로우에 전달되거나, 메인 워크플로우 내에서 선언되어 하위 플로우에 입력으로 전달될 수 있습니다.
    주:
    요청된 항목 [sc_request_item] 테이블에 대해 선언된 모든 워크플로우에 대한 특정 종류의 입력 변수가 있습니다. 이러한 변수의 사용법을 이해하려면 다음 문서를 참조하십시오 워크플로우 카탈로그 변수.

    워크플로우 변수는 워크플로우 편집기 기어 메뉴에서 사용할 수 있는 양식으로 선언됩니다.

    프로시저

    1. 다음으로 이동 모두 > 워크플로우 > 워크플로우 편집기.
    2. 워크플로우를 편집하고 체크 아웃합니다.
    3. 워크플로우 활동 메뉴를 선택하고 입력 편집을 선택합니다.
    4. 기존 변수를 선택하거나 새로 만들기를 선택합니다.

      열 이름 필드를 확인합니다. 스크립트에서 변수에 액세스할 때 이 값을 사용합니다.

      워크플로우 변수는 워크플로우 캔버스에 나타나지 않으며, 워크플로우 활동 메뉴에서만 볼 수 있습니다.

      입력 변수는 스크립트에서 사용할 수 있습니다. 스크립트에서 입력 변수에 액세스하려면 다음을 수행합니다.
      var input  = workflow. variables. variableName //get the workflow variable identified by column name.

    워크플로우 외부에서 변수에 값 할당

    워크플로우에서 선언된 후에는 워크플로우가 시작되는 변수에 값을 할당할 수 있습니다.

    다음 예는 스크립트 포함, 비즈니스 규칙 또는 UI 작업에서 워크플로우 변수의 값을 설정하는 방법을 보여줍니다.
     
    //Declare an instance  of workflow.js 
    var wf  = new Workflow ( ) //Get the workflow id 
    var  wfId  = wf. getWorkflowFromName ( "Workflow Name" ) ; 
    //Start workflow, passing along name : value pair(s) for mapping to variable 
    //where input_var_name is the name of the variable declared in gear menu 
    //and input_var_value is whatever that value should be for this execution of 
    //workflow
    wf. startFlow (wfId , null , "Workflow Name" , {input_var_name : input_var_value } ) ;
    여러 변수를 전달하는보다 읽기 쉬운 방법을 보여주는 또 다른 예는 객체를 선언하고 객체에 이름 / 값을 추가 한 다음 전달하는 것입니다.
    //Declare an instance  of workflow.js 
    var wf  = new Workflow ( ) 
    //Get the workflow id 
    var  wfId  = wf. getWorkflowFromName ( "Workflow Name" ) ; 
    //Start workflow, passing along object containing name/value pairs mapping to inputs expected by the workflow 
    var vars  = { } ;
    vars. input_var_name1 = input_var_value1 ;
    vars. input_var_name2 = input_var_value2 ; 
    // add as many variables as your workflow is expecting, then pass the object
    wf. startFlow (wfId , null , "Workflow Name" , vars ) ;

    메인 워크플로우 내부에서 하위 플로우 입력에 값 할당

    입력을 받는 워크플로우가 다른 워크플로우 내에서 호출되는 경우 해당 입력 값은 워크플로우 활동의 UI 내에 있는 워크플로우 캔버스에서 설정할 수 있습니다. 하위 플로우에 대해 선언된 각 입력 변수에는 활동에 표시되는 텍스트 상자 입력 영역이 있습니다. 이러한 텍스트 상자 내에서 스크래치패드 또는 현재 기록 내의 값으로 변수를 설정할 수 있습니다.

    자세한 내용은 하위 플로우로 사용되는 워크플로우 문서를 참조하십시오.

    워크플로우 입력 변수의 값 읽기

    워크플로우 입력 변수의 값은 현재 워크플로우 객체에 닷워킹을 통해 JavaScript를 허용하는 워크플로우 내 어디에서나 액세스할 수 있습니다.
    var readValue = workflow.inputs.variable_name;

    워크플로우 스크래치패드 변수

    문자열 기반 변수를 워크플로우 활동 간에 이름-값 쌍으로 저장하고 공유합니다.

    스크래치패드는 실행 중인 워크플로우의 인스턴스 전체에 적용되므로 모든 활동에 동일하게 사용할 수 있습니다.

    선언

    스크래치패드 자체는 실행 중인 워크플로에 자동으로 사용할 수 있으며 특정 선언이 필요하지 않습니다. 변수는 스크래치패드를 참조하여 동시에 선언되고 저장됩니다. 예:
    workflow.scratchpad.variableName = variableValue;

    표시

    워크플로우 활동 이력 스크래치패드 [wf_history_scratchpad] 테이블에서 활동 스크래치패드 값을 봅니다. 워크플로우 활동 이력 스크래치패드는 Worfklow 활동 이력 기록에 포함된 목록이기도 합니다.

    그림 1. 샘플 워크플로우 활동 이력 스크래치패드 기록

    액세스 및 할당

    표준 JavaScript 객체 표기법을 사용하여 스크래치패드 값에 액세스하거나 스크래치패드 값을 할당합니다. 예를 들어, 이 형식을 사용하여 특정 스크래치패드 변수 값을 할당할 수 있습니다.
    workflow.scratchpad.variableName = variableValue;
    이 형식을 사용하여 JavaScript 변수를 스크래치패드 변수에 할당합니다.
    var myValue = workflow.scratchpad.variableName;

    현재 변수

    Current는 워크플로우 속성 테이블의 테이블과의 연결 또는 카탈로그 항목과의 연결을 통해 워크플로우를 시작한 데이터베이스 GlideRecord입니다.

    선언

    current의 변수는 데이터베이스 레코드를 지원하는 dictionary.xml 파일에 정의된 열입니다. 런타임에 현재 기록에 변수를 추가할 수 있는 방법은 없습니다.

    표시

    현재 기록의 변수는 이를 사용하는 애플리케이션 전체의 Glide 양식 및 목록에 표시됩니다.

    액세스 및 할당

    워크플로우 활동 내의 변수에 액세스하거나 변수에 값을 할당하려면 Glide 요소를 참조하여 현재 기록에서 값을 가져옵니다.
    var myVarValue = current.getElement(nameOfTheField);
    또는
    var myVarValue = current.fieldName;
    또는
    current.variableName.setValue( "A Variable Value");