워크플로우에서 변수 사용

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기6분
  • 워크플로우 내에는 여러 가지 유형의 변수를 사용할 수 있습니다.

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

    활동 변수

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

    시작하기 전에

    필요한 역할: admin

    이 태스크 정보

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

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

    변수를 추가, 보기 또는 수정하는 방법:

    프로시저

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

    워크플로우 입력 변수

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

    시작하기 전에

    필요한 역할: admin

    이 태스크 정보

    워크플로우 변수는 스크립트에서 외부적으로 선언되어 기본 워크플로우에 전달되거나, 기본 워크플로우 내에서 선언되어 하위 플로우에 입력으로 전달될 수 있습니다.
    주:
    요청된 항목 [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");