API Tasks를 예약하는 방법

API Task를 예약하면 Bot Runner 인프라(사용자 및 기기)와 독립적인 자동화를 시작할 수 있습니다. API Tasks는 Cloud에서 실행되기 때문에 개별 사용자 라이선스가 필요하지 않으므로 비용을 절감하고 자동화 관리를 간소화할 수 있습니다.

사용 가능한 API Tasks가 지정된 시간에 실행되도록 예약할 수 있습니다. 예를 들어, 매주 수요일 오후 5시에 실행되도록 .csv 파일로 송장을 일괄 처리하는 것입니다.
주: Control Room에서 API Tasks를 예약하려면 Enterprise Platform 라이선스가 필요합니다. Enterprise Platform 항목을 참조하십시오.

전제 조건

Control Room에 관리자 또는 다음 권한이 있는 사용자로 로그인해야 합니다.

프로시저

  1. Control Room에 로그인하십시오.
  2. 왼쪽 창에서 다음 방법 중 하나를 선택하여 일정을 만듭니다.
    • 자동화를 클릭합니다.

      일정을 만들고자 하는 API Task의 오른쪽에 있는 작업 메뉴(세로 줄임표)를 클릭하고 API 태스크 예약을 클릭합니다.

    • 관리 > 예약 > 일정 만들기를 클릭합니다.
    자동화 및 종속성 화면이 표시됩니다. 또한 선택 옵션을 클릭하여 특정 API Task를 찾을 수도 있습니다.
  3. 예약하려는 API Task를 선택하고 선택을 클릭합니다.
    다양한 탭과 함께 일정 만들기 화면이 표시됩니다.
  4. 자동화 및 종속성 탭을 사용하여 다음 필드를 검토하고 업데이트하십시오.
    • 자동화 파일: 선택한 API Task를 표시합니다.

      다른 API Task를 선택하려면 선택을 클릭합니다.

    • 자동화 및 종속성을 실행할 버전 선택: 다음 API Task 버전 중 하나를 선택하여 실행할 수 있습니다.
      • 최신 버전: 최신 버전을 사용해서 선택한 API Task 및 종속성의 일정을 생성합니다.
      • 프로덕션 라벨: 프로덕션 버전을 사용하여 선택한 API Task 및 종속성의 일정을 생성합니다.

      기본적으로 최신 버전의 API Task이 선택됩니다.

    • 종속성: 선택한 API Task에 대한 종속성 목록
  5. 다음을 클릭합니다.
  6. API Task에 예약 세부 정보를 추가합니다.
    일정 필드에서 다음 옵션 중 하나를 선택합니다.
    • 한 번 실행: 지정된 날짜와 시간에 API Task를 한 번 실행합니다.

      다음 옵션을 사용하여 한 번 실행 설정을 구성할 수 있습니다.

      • 시작 날짜: 기본값은 현재 날짜입니다.
      • 시작 시간: 기본값은 다음 30분으로 반올림됩니다.
      • 시간대: 로컬 장치의 시스템 시간대입니다.
        주: EST, HST 또는 MST 시간대는 사용이 중단되었습니다. Upcoming feature deprecations 항목을 참조하십시오.
    • 반복 실행: API Task가 지정된 날의 정해진 시간에 실행되게 하려면 이 옵션을 사용합니다.

      다음 옵션을 사용하여 반복 실행 설정을 구성할 수 있습니다.

      • 시작 날짜: API Task을 실행할 날짜를 입력합니다.

        날짜를 YYYY-MM-DD 형식의 수동으로 또는 팝업 캘린더를 사용하여 입력합니다. 시작 날짜 필드의 기본값은 로컬 장치에 설정된 현재 날짜로 설정됩니다.

      • 종료 날짜: 일정을 종료할 날짜를 입력합니다.

        종료 날짜는 기본적으로 설정되지 않습니다.

      • 시작 시간: 드롭다운 목록을 사용하여 시작 시간을 입력하여 일정을 시작할 시간 값을 설정합니다.

        이 목록에는 12시간 형식으로 15분 간격의 미리 정의된 시간 값이 포함되어 있습니다. 12시간 형식의 시간 값을 수동으로 설정할 수도 있습니다.

      • 시간대: 시작 시간과 종료 시간 모두에 대하여 시간대를 선택합니다.

        기본값은 시스템의 현재 위치로 설정되어 있습니다. 일정은 일정을 만들거나 편집할 때 선택한 시간대를 기반으로 실행됩니다.

      • 매번 반복: 일정을 반복하려면 이 옵션을 선택합니다.
    • 빈도: 다음 옵션 중 하나를 일정을 실행할 빈도로 선택합니다.
      • 일간: 스케줄을 실행할 일수를 선택합니다.
      • 주간: 일정을 실행할 주와 특정 요일을 선택합니다.

        예를 들어 2주마다 월요일과 목요일에 스케줄을 실행하려면 매번 옵션에서 월요일과 목요일 확인란을 선택합니다.

      • 월간: 다음 옵션 중 하나를 선택합니다.
        • 날: 일정을 실행할 월 중 날짜를 선택합니다.
        • 요일: 일정을 실행하려는 달의 특정 요일을 선택합니다.

          예를 들어 1월, 5월, 9월의 두 번째 목요일에 일정을 실행하려면 주어진 옵션에서 둘째, 목요일, 1월, 5월, 9월을 선택합니다.

        주: 일광 절약 시간이 활성화되어 있고 시작 날짜가 예약되어 있다면, 사용자의 현재 시간대가 아닌 시작 날짜가 속한 시간대로 표시됩니다. 하지만 다음 발생은 일광 절약 시간에 따른 시간대(사용자의 시스템 시간대)로 표시됩니다.

        예를 들어 GMT 시간대에서 3월 15일에 생성된 스케줄의 경우, 시작 날짜는 GMT 시간대에 속하는 Mar-15th로 표시됩니다. 나중에 일광 절약 시간을 켜고 BST 시간대의 8월에서 이 스케줄을 편집하거나 확인하면, 다음 발생은 BST 시간대에 속하는 8월로 표시됩니다.

        2023년 11월 23일 오전 9시부터 2023년 11월 30일 오전 9시까지 태스크를 실행하도록 예약하고 빈도를 매일로 설정하면 해당 태스크는 2023년 11월 23일 오전 9시부터 매일 실행되고 마지막 태스크는 2023년 11월 30일 오전 9시에 실행됩니다.

    • 놓친 스케줄 설정 섹션에서 스케줄 다시 배포 확인란을 선택하면 Control Room 종료로 인해 놓친 일정을 다시 배포할 수 있습니다.

      스케줄 다시 배포 옵션이 선택되면, Control Room 종료 때문에 놓친 스케줄은 Control Room이 다시 시작되면 자동으로 다시 배포됩니다. 또한 이벤트 유형을 Schedule misfired로 표시하는 감사 로그 항목이 추가됩니다.

      주: 스케줄 다시 배포 옵션을 사용할 때 성공적으로 배포하려면 Control Room 서비스를 다시 시작하기 전에 컴파일러 서비스를 시작해야 합니다.
  7. 다음을 클릭합니다.
  8. 실행 주체 사용자 탭을 사용하여 다음을 수행합니다.
    • 사용 가능한 실행 주체 사용자 테이블 목록에서 해당 사용자를 선택하고 아래쪽 화살표를 클릭하여 선택 항목을 추가합니다.

      선택한 사용자들이 선택됨 테이블에 나열됩니다. 위쪽 화살표를 사용하여 선택한 사용자를 제거할 수 있습니다.

      주: 시스템에서 AAE_API 태스크 러너와 연결되어 API Tasks에 대해 실행 주체 사용자 컨텍스트를 설정하는 apitaskrunner라는 사용자를 생성합니다.
    • 사용할 실행 주체 사용자 수 정의 필드에서 다음 중 하나를 선택합니다.
      • 모든 실행 주체 사용자: 이 옵션을 선택하면 API Task를 실행하는 동안 선택된 테이블에서 사용 가능한 모든 사용자를 실행 주체 사용자로 지정할 수 있습니다.
      • 사용자 정의 실행 주체 사용자 수: 이 옵션을 선택하면 선택한 테이블에서 실행 주체 사용자로 사용할 특정 수의 사용자를 제공할 수 있습니다.

        예를 들어, 선택된 테이블에 5명의 사용자가 있고 그 중 3명만 실행 주체 사용자로 사용하려는 경우 3을 입력하십시오. 테이블 위쪽에 나열된 3명의 사용자가 API Task를 실행하는 동안 실행 주체 사용자로 사용됩니다.

  9. 다음을 클릭합니다.
  10. 옵션: 일반 탭에서 다음 옵션의 기본 설정을 변경할 수 있습니다.
    • 활동 이름: API Task을 편집하거나 이름을 변경합니다.
    • 자동화 우선순위: 드롭다운 메뉴를 클릭하여 자동화 우선순위를 설정합니다.

      중간이 자동화 우선순위의 기본 옵션이지만, 이를 변경하면 그에 맞게 자동화가 배포됩니다.

  11. 일정 만들기를 클릭합니다.
    API Task가 예정되어 있습니다. 관리 > 예약된 페이지에서 예약된 API Tasks의 상태를 확인할 수 있습니다.