PDAutomationProvider - 범위 지정, 전역

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기7분

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

    이 API는 플러그인(com.glide.pad.core)의 Playbooks 일부입니다. 이 API는 sn_pad 네임스페이스 내에서 제공됩니다.

    이 API를 사용하여 스크립트를 호출하려면 다음 중 하나 이상이 필요합니다.
    • 호출자는 선택적 활동 트리거가 만들어진 범위와 같아야 합니다.
    • 관리자 권한.

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

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

    에이전트는 레인에 선택적 활동을 추가하거나 다른 활동과 관련된 활동을 추가합니다. 선택적 활동을 삽입하려면 프로세스가 실행 중이어야 합니다.

    참고 항목:

    PDAutomationProvider – addOptionalActivityRelativeToActivityContext(문자열 contextID, 문자열 activityId, 문자열 위치, 문자열 relativeToId)

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

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

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

    오류인 경우 하나 이상의 오류 메시지 목록입니다. 그렇지 않으면 0개 이상의 요소로 구성된 배열 을 나타내는 메시지입니다.
    배열 오류인 경우 하나 이상의 오류 메시지 목록입니다. 그렇지 않으면 0개 이상의 요소로 구성된 배열 을 나타내는 메시지입니다.
    가능한 오류 메시지:
    • 잘못된 선택적 활동 ID – 매개변수에 제공된 activityId sys_id가 잘못되었습니다.
    • 잘못된 PD 컨텍스트 ID – 매개변수에 제공된 프로세스 디자이너(PD) sys_id가 잘못되었습니다 contextID .
    • 잘못된 직책 유형 - 제공된 직책 유형이 잘못되었습니다. 유효한 형식에 대해서는 매개변수에 where 대한 설명을 참조하십시오.
    • Invalid 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(문자열 contextID, 문자열 activityId, 문자열 위치, 문자열 relativeToId)

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

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

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