PDAutomationProvider - 범위 지정, 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 15분

    • PDAutomationProvider API를 사용하면 프로세스가 실행되는 동안 선택적 활동을 프로세스에 삽입할 수 있습니다.

    이 API는 플러그인(com.glide.pad.core)의 플레이북 일부이며 sn_pad 네임스페이스에서 실행됩니다.

    이 API를 사용하여 스크립트를 호출하려면 다음 중 하나 이상이 필요합니다.
    • 호출자는 선택적 활동 트리거가 생성된 동일한 범위에 있어야 합니다.
    • 관리자 권한입니다.

    프로세스는 레인별로 정렬된 일련의 활동입니다. 선택적 활동은 프로세스 설계 중에 미리 정의됩니다. 활동이 정확한 시간에 실행되도록 예약되어 있지 않습니다. 활동을 레인에 할당하고 레인 실행 중에 실행할 수 있도록 할 수 있습니다. 활동을 프로세스에 할당하고 레인 실행 중에 실행할 수 있도록 할 수 있습니다.

    선택적 활동을 만들려면 활동 [sys_pd_activity] 테이블에서 시작 규칙 이 수동으로 설정되어 있어야 합니다. 플레이북 는 현재 수동 활동 생성을 지원하지 않습니다.

    에이전트가 다른 활동에 상대적인 레인 또는 활동에 선택적 활동을 추가합니다. 선택적 활동을 삽입하려면 프로세스가 실행 중이어야 합니다.

    참조 :

    PDAutomationProvider – activateProcess(String processDefinitionSysId)

    플레이북을 활성화합니다.

    표 1. 매개변수
    이름 유형 설명
    processDefinitionSysId 문자열 플레이북의 Sys_id입니다.

    테이블: 프로세스 정의 [sys_pd_process_definition]
    표 2. 반환
    속성 설명
    객체 프로세스 정의 활성화 상세 정보를 포함하는 객체입니다.
    {
  "errors": [Array]
  "process_definition": {Object},
  "state": "String"
}
    오류 오류 목록입니다. 성공하면 비어 있습니다.

    데이터 유형: 문자열 배열
    process_definition 활성화된 플레이북 및 해당 속성

    데이터 유형: 객체

    "process_definition":
{
  "active": Boolean,
  "snapshot": {Object},
  "status": "String"
}
    process_definition.active 비활성화된 플레이북에 대한 프로세스 정의가 활성 상태인지 여부를 나타내는 플래그입니다. 프로세스 정의 [sys_pd_process_definition] 목록에서 프로세스 정의를 찾습니다.
    유효한 값은 다음과 같습니다.
    • true: 비활성화된 플레이북에 대한 프로세스 정의가 활성 상태입니다.
    • false: 비활성화된 플레이북에 대한 프로세스 정의가 비활성 상태입니다.

    데이터 유형: 부울
    process_definition.snapshot 활성화 시점의 프로세스 정의에 대한 세부 정보를 포함합니다.

    데이터 유형: 객체

    {
  "snapshot":
    {
      "created": "String",
      "processDefinitionSysId": "String"
    }
}
    process_definition. 스냅샷. 작성됨 플레이북이 생성된 날짜입니다.

    데이터 유형: 문자열
    process_definition. 스냅샷. processDefinitionSysId 활성화된 플레이북의 sys_id입니다.

    데이터 유형: 문자열
    process_definition.status 플레이북의 게시 상태를 나타냅니다.
    가능한 값:
    • 초안: 플레이북이 초안 상태입니다.
    • 게시됨: 플레이북이 게시됨 상태입니다.

    데이터 유형: 문자열
    상태 활성화 요청의 성공 여부를 나타냅니다.
    가능한 값:
    • 성공 – 플레이북이 성공적으로 활성화되었습니다.
    • 실패 – 플레이북의 ID를 찾을 수 없습니다.

    데이터 유형: 객체

    다음 예는 플레이북을 활성화하는 방법을 보여줍니다.

    var myPlaybook = sn_pad.PDAutomationProvider.activateProcess('cdd1b85e43000210d96e29c28ab8f275');
gs.info(JSON.stringify(myPlaybook));
    출력: 
    {
  "process_definition": {
    "active": true,
    "snapshot": {
      "processDefinitionId": "cdd1b85e43000210d96e29c28ab8f275",
      "created": "2024-02-19 22:58:12"
    },
    "status": "published"
  },
  "state": "SUCCESS",
  "errors": []
}

    PDAutomationProvider – addOptionalActivityRelativeToActivityContext(String contextID, String activityId, String where, String relativeToId)

    프로세스 실행 중에 다른 활동을 기준으로 실행할 프로세스에 지정된 선택적 활동을 추가합니다.

    프로세스가 실행되면 각 활동에 대한 활동 컨텍스트가 생성됩니다. 컨텍스트는 활동이 실행을 처리하는 방식도 처리합니다. 자세한 내용은 프로세스 자동화 디자이너 레인 및 활동을 참조하십시오.

    표 3. 매개변수
    이름 유형 설명
    contextID 문자열 선택적 활동을 추가할 활동 실행의 Sys_id입니다. 액세스하려면 프로세스 실행 [sys_pd_context] 테이블에 나열된 프로세스를 클릭합니다. 선택한 실행은 진행 중 상태여야 합니다.
    activityId 문자열 활동 [sys_pd_activity] 테이블에 나열된 선택적 활동의 Sys_id입니다.
    주:
    선택적 활동을 만들려면 활동 [sys_pd_activity] 테이블에서 시작 규칙 이 수동으로 설정되어 있어야 합니다.
    위치 문자열 프로세스에서 활동을 배치할 위치를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • AFTER – 상대 활동 후에 이 활동을 실행합니다 컨텍스트.
    • WITH – 다른 상대 활동과 동시에 활동을 실행 컨텍스트.
    relativeToId 문자열 선택적 활동이 이후 또는 함께 실행될 상대 활동 컨텍스트의 ID입니다. 활동 컨텍스트 [sys_pd_activity_context] 테이블에 나열됩니다.
    표 4. 반환
    유형 설명
    부울 활동 실행이 성공적으로 예약되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 활동 실행이 성공적으로 예약되었습니다. 출력은 성공을 나타내는 문자열입니다.
    • false: 활동 실행이 성공적으로 예약되지 않았습니다. 출력은 하나 이상의 오류 메시지로 구성된 배열입니다.

    오류가 있는 경우 하나 이상의 오류 메시지 목록입니다. 그렇지 않으면 0개 이상의 요소로 구성된 배열 을 알리는 메시지입니다.
    배열 오류가 있는 경우 하나 이상의 오류 메시지 목록입니다. 그렇지 않으면 0개 이상의 요소로 구성된 배열 을 알리는 메시지입니다.
    가능한 오류 메시지:
    • 잘못된 선택적 활동 ID: 매개변수에 activityId 제공된 sys_id이 잘못되었습니다.
    • 잘못된 PD 컨텍스트 ID: 매개변수에 contextID 제공된 PD(프로세스 디자이너) sys_id이 잘못되었습니다.
    • 잘못된 위치 유형: 제공된 위치 유형이 잘못되었습니다. 유효한 유형은 매개변수에 대한 where 설명을 참조하십시오.
    • 잘못된 relative-to id: 매개변수에 relativeToId 제공된 sys_id이 잘못되었습니다.
    • 선택적 활동을 찾을 수 없음: 매개변수에 activityId 제공된 sys_id 찾을 수 없습니다.
    • 프로세스가 여전히 활성 상태여야 함: 선택적 활동을 실행하려면 이 활동을 포함하는 프로세스가 활성 상태여야 합니다.
    • 상대 활동 컨텍스트를 찾을 수 없음 : 매개변수에 relativeToId 제공된 sys_id를 찾을 수 없습니다.

    다음 예는 상대 활동 컨텍스트와 동시에 선택적 활동을 실행하는 방법을 보여줍니다.

    var contextId = '<context_id>';
var optionalActivityId = '<optional_activity_id>';
var where = 'WITH'; // options AFTER, WITH
var relativeToId = '<relative_activity_context_id>'; // relative activity context ID

var response = sn_pad.PDAutomationProvider.addOptionalActivityRelativeToActivityContext(contextId, optionalActivityId, where, relativeToId);

gs.info(JSUtil.describeObject(response));
    출력(성공):
    success: boolean = true
errors: Array of 0 elements

    PDAutomationProvider – addOptionalActivityRelativeToLaneContext(String contextID, String activityId, String where, String relativeToId)

    해당 레인의 실행 컨텍스트 동안 실행할 선택적 활동을 레인에 할당합니다.

    레인 컨텍스트는 프로세스가 실행될 때 각 레인에 대해 생성됩니다. 컨텍스트는 레인이 실행을 처리하는 방식도 처리합니다. 자세한 내용은 프로세스 자동화 디자이너 레인 및 활동을 참조하십시오.

    표 5. 매개변수
    이름 유형 설명
    contextID 문자열 선택적 활동을 추가할 활동 실행의 Sys_id입니다. 액세스하려면 프로세스 실행 [sys_pd_context] 테이블에 나열된 프로세스를 클릭합니다. 선택한 실행은 진행 중 상태여야 합니다.
    activityId 문자열 활동 [sys_pd_activity] 테이블에 나열된 선택적 활동의 Sys_id입니다.
    주:
    선택적 활동을 만들려면 활동 [sys_pd_activity] 테이블에서 시작 규칙 이 수동으로 설정되어 있어야 합니다.
    위치 문자열 프로세스에서 활동을 배치할 위치를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • LAST – 레인에서 마지막 활동으로 실행합니다 컨텍스트.
    • 다음 – 레인의 다음 활동에서 실행합니다. 컨텍스트.
    relativeToId 문자열 선택적 활동이 실행될 상대 레인 컨텍스트의 ID입니다. 레인 컨텍스트 [sys_pd_lane_context] 테이블에 나열됩니다.
    표 6. 반환
    유형 설명
    부울 활동 실행이 성공적으로 예약되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 활동 실행이 성공적으로 예약되었습니다. 출력은 성공을 나타내는 문자열입니다.
    • false: 활동 실행이 성공적으로 예약되지 않았습니다. 출력은 하나 이상의 오류 메시지로 구성된 배열입니다.
    배열 오류가 있는 경우 하나 이상의 오류 메시지 목록입니다. 그렇지 않으면 0개 이상의 요소로 구성된 배열 을 알리는 메시지입니다.
    가능한 오류 메시지:
    • 잘못된 선택적 활동 ID: 매개변수에 activityId 제공된 sys_id이 잘못되었습니다.
    • 잘못된 PD 컨텍스트 ID: 매개변수에 contextID 제공된 PD(프로세스 디자이너) sys_id이 잘못되었습니다.
    • 잘못된 위치 유형: 제공된 위치 유형이 잘못되었습니다. 유효한 유형은 매개변수에 대한 where 설명을 참조하십시오.
    • 잘못된 relative-to id: 매개변수에 relativeToId 제공된 sys_id이 잘못되었습니다.
    • 선택적 활동을 레인에 추가할 수 없음: 매개변수에 제공된 activityId 선택적 활동은 매개변수에 제공된 relativeToId 레인을 기준으로 추가할 수 없습니다. 선택한 활동 실행 이 진행 중 상태인지 확인합니다.
    • 선택적 활동을 찾을 수 없음: 매개변수에 activityId 제공된 sys_id 찾을 수 없습니다.
    • 프로세스가 여전히 활성 상태여야 함: 선택적 활동을 실행하려면 이 활동을 포함하는 프로세스가 활성 상태여야 합니다.
    • 상대 레인 컨텍스트를 찾을 수 없음 : 매개변수에 relativeToId 제공된 sys_id를 찾을 수 없습니다.

    다음 예는 레인 컨텍스트에서 선택적 활동을 최종 활동으로 실행하는 방법을 보여줍니다.

    var contextId = '<context_id>';
var optionalActivityId = '<optional_activity_id>';
var where = 'LAST'; // options LAST, NEXT
var relativeToId = '<relative_lane_context_id>'; // relative lane context ID

var response = sn_pad.PDAutomationProvider.addOptionalActivityRelativeToLaneContext(contextId, optionalActivityId, where, relativeToId);

gs.info(JSUtil.describeObject(response));
    출력(성공):
    success: boolean = true
errors: Array of 0 elements

    PDAutomationProvider – deactivateProcess(String processDefinitionSysId)

    플레이북을 비활성화합니다.

    표 7. 매개변수
    이름 유형 설명
    processDefinitionSysId 문자열 플레이북의 Sys_id입니다.

    테이블: 프로세스 정의 [sys_pd_process_definition]
    표 8. 반환
    속성 설명
    객체 프로세스 정의 비활성화 상세 정보를 포함하는 객체입니다.
    {
  "errors": [Array]
  "process_definition": {Object},
  "state": "String"
}
    오류 오류 목록입니다. 성공하면 비어 있습니다.

    데이터 유형: 문자열 배열
    process_definition 비활성화된 플레이북 및 해당 속성입니다.

    데이터 유형: 객체

    "process_definition":
{
  "active": Boolean,
  "snapshot": {Object},
  "status": "String"
}
    process_definition.active 비활성화된 플레이북에 대한 프로세스 정의가 활성 상태인지 여부를 나타냅니다. 프로세스 정의 [sys_pd_process_definition] 목록에서 프로세스 정의를 찾습니다.
    가능한 값:
    • true: 비활성화된 플레이북에 대한 프로세스 정의가 활성 상태입니다.
    • false: 비활성화된 플레이북에 대한 프로세스 정의가 비활성 상태입니다.

    데이터 유형: 부울
    process_definition.description 비활성화된 플레이북에 대한 상세 정보입니다.

    데이터 유형: 문자열
    process_definition.label 인터페이스에서 사용자에게 표시되는 비활성화된 플레이북의 이름입니다.

    데이터 유형: 문자열
    process_definition.name 코드에 있는 비활성화된 플레이북의 이름입니다. 스크립팅에서 요청 매개변수로만 사용됩니다.

    데이터 유형: 문자열
    process_definition.scope 플레이북이 비활성화되는 애플리케이션 범위의 sys_id입니다.

    데이터 유형: 문자열
    process_definition.status 플레이북이 게시되면 다시 초안으로 변경됩니다.

    데이터 유형: 문자열
    상태 비활성화가 성공했는지 여부를 나타냅니다.
    가능한 값:
    • 성공 – 플레이북이 성공적으로 비활성화되었습니다.
    • 실패 – 플레이북의 ID를 찾을 수 없습니다.

    데이터 유형: 문자열

    플레이북을 비활성화합니다.

    sn_pad.PDAutomationProvider.deactivateProcess('cdd1b85e43000210d96e29c28ab8f275')

    출력:

    {"process_definition":{"scope":"global","name":"test","active":true,"description":"","label":"test","status":"draft"},"state":"SUCCESS"}

    PDAutomationProvider – duplicateProcess(String processDefinitionSysId, 문자열 레이블, 문자열 설명, 문자열 scopeId, 문자열 triggerTypeId)

    플레이북을 복제합니다.

    표 9. 매개변수
    이름 유형 설명
    processDefinitionSysId 문자열 플레이북의 Sys_id입니다.

    테이블: 프로세스 정의 [sys_pd_process_definition]
    레이블 문자열 복제된 플레이북의 이름입니다.
    설명 문자열 옵션입니다. 플레이북에 대한 상세 정보를 추가합니다.
    scopeId 문자열 플레이북을 실행할 애플리케이션 범위의 sys_id입니다. 범위가 지정된 이름은 프로세스 정의 [sys_pd_process_definition] 테이블에서 scope.name 형식으로 가져온 것입니다. 전역 범위에 대한 sys_id 입력하면 모든 애플리케이션 범위에서 플레이북을 실행할 수 있습니다.
    triggerTypeId 문자열 플레이북 실행을 시작할 트리거의 sys_id입니다. 트리거 유형 [sys_pd_trigger_type] 테이블에서 트리거 유형을 찾아 해당 sys_id 복사합니다.
    표 10. 반환
    속성 설명
    객체 프로세스 정의 중복 상세 정보를 포함하는 객체입니다.
    {
  "errors": [Array]
  "processDefinitionSysId": "String",
  "state": "String"
}
    오류 오류 목록입니다. 성공하면 비어 있습니다.

    데이터 유형: 문자열 배열

    가능한 오류 메시지:
    • scopeId에 대한 범위를 찾을 수 없음: xyz
    • ID에 대한 프로세스 정의를 찾을 수 없음: xyz
    • triggerTypeId에 대한 트리거 유형을 찾을 수 없음: xyz
    processDefinitionSysId 프로세스 정의 [sys_pd_process_definition] 테이블에 있는 새 플레이북의 sys_id입니다.

    데이터 유형: 문자열
    상태 플레이북 복제가 성공했는지 여부를 나타냅니다.
    가능한 값:
    • 성공 – 플레이북이 성공적으로 복제되었습니다.
    • 실패 – 플레이북, 애플리케이션 범위 또는 트리거의 ID를 찾을 수 없습니다.

    데이터 유형: 객체

    이 예는 sys_id f8ca6192ec210210f8772cbd595eab20을 사용하여 플레이북을 복제하는 방법을 보여줍니다. 새 플레이북의 이름은 플레이북 2.0이고 애플리케이션 범위는 전역이며 기록이 생성될 때 트리거됩니다. 기록 생성 트리거 유형의 sys_id은 ab6951170f1200108c87f4f0ff767e4f입니다.

    sn_pad.PDAutomationProvider.duplicateProcess('f8ca6192ec210210f8772cbd595eab20', 'Playbook 2.0', '', 'global', 'ab6951170f1200108c87f4f0ff767e4f');

    출력:

    {"processDefinitionSysId":"6e4f0b8fece9c210f8772cbd595eabda","state":"SUCCESS"}