Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere

콘텐츠 닫기

콘텐츠

콘텐츠 열기

워크로드 관리 구성 내보내기 및 가져오기 API

  • 업데이트: 5/10/2019

    워크로드 관리 구성 내보내기 및 가져오기 API

    Enterprise 제어실 관리자 또는 내보내기 및 가져오기 권한을 보유한 사용자는 워크로드 구성의 내보내기 및 가져오기를 하여 한 환경에서 다른 환경으로 검증된 구성을 이동할 수 있습니다.

    예를 들어 생산 준비가 완료된 대기열을 준비 단계에서 생산 단계로 옮길 수 있습니다.

    조직의 자동화 요구 사항에 따라 개발, 테스트, 검수, 운용과 같은 다양한 환경에서 Enterprise 제어실 내보내기 가져오기 REST API를 사용하여 자동화를 관리할 수 있습니다.

    기능 및 이점

    • 워크로드 관리 모듈에 대한 역할 기반 액세스 제어
    • 규정 준수를 위해 소스 및 대상 환경에 대한 감사 및 추적성

    선행조건

    내보내기

    • 자격증명을 인증에 이용하는 Enterprise 제어실 사용자는 관리자이거나 봇 내보내기 권한을 보유해야 합니다.
    • Enterprise 제어실 사용자는 대기열 관리자 또는 특정 대기열로 내보낼 대기열의 소유자여야 합니다.
    • 소유자, 사용자, 참가자의 세부 정보는 내보내기의 일부분이 아니기 때문에, 가져오기 이후 필요에 따라 이러한 세부 정보를 수동으로 추가해야 합니다.
    • Enterprise 제어실 서비스 실행에 이용하는 사용자 계정은 패키지를 내보내는 폴더에 대한 읽기/쓰기 액세스 권한을 보유해야 합니다. 즉, 네트워크 위치(공유 드라이브) 또는 로컬 시스템이 될 수 있는 애플리케이션 경로가 있습니다.

      예:

      C:\Users\Public\Documents\Server Files\wlm-files\export

    • 패키지에 최대 200개의 대기열을 내보낼 수 있습니다.
    • 초안 상태 대기열을 내보낼 수 없습니다.
    • 대기열 내보내기에 실패하는 경우 전체 내보내기 작업이 실패합니다.

    가져오기

    • 자격증명이 인증에 이용하는 Enterprise 제어실 사용자에게는 봇 가져오기 권한이 있어야 합니다.
    • Enterprise 제어실 대기열 관리자는 모든 대기열을 가져올 수 있습니다.
    • API를 사용하여 여러 봇을 가져오는 Enterprise 제어실 사용자는 Automation Anywhere에서 내보내기한 패키지 파일이 제공되는 폴더에 대한 읽기/쓰기 액세스 권한을 보유해야 합니다. 즉, 네트워크 위치(공유 드라이브) 또는 로컬 시스템이 될 수 있는 애플리케이션 경로가 있습니다.

      예를 들어,

      C:\Users\Public\Documents\Server Files\wlm-files\import

    • 패키지를 가져오는 사용자는 기본적으로 가져온 대기열의 소유자가 됩니다. 필요한 경우 가져온 대기열에 참가자, 사용자 또는 추가 소유자를 추가합니다.
    • 대기열 카테고리가 이전 가져오기에서 이미 생성된 경우, 후속 가져오기는 모든 열 이름 및 유형이 일치하는 한 대기열 카테고리를 사용합니다.

    API 엔드포인트

    1. 내보내기 - <Enterprise 제어실 URL>/v1/wlm/queues

      예: https://crdevenv.com:81/v1/wlm/queues

    2. 가져오기 - <Enterprise 제어실 URL>/v1/wlm/queues

      예를 들어,

      https://crtestenv.com:82/v1/wlm/queues

    WLM 내보내기 가져오기 API의 위 엔드포인트를 사용하여 대기열의 내보내기 및 가져오기가 가능합니다.

    대기열 내보내기

    Automation Anywhere에서 제공한 내보내기 API를 사용하여 대기열을 내보내려면 다음을 합니다.

    1. POST 메소드를 사용하여 엔드포인트 http(s)://<hostname:port>/v1/authentication을 사용하는 토큰을 생성합니다. 이를 위해 Enterprise 제어실 인스턴스를 서버 이름/호스트 이름/IP포트 번호로 입력합니다.

      예: https://crdevenv.com:81/v1/authentication

    2. POST 메소드를 사용하고 본문 데이터에 자격증명 매개변수를 입력합니다.

      예를 들어,

      {

      "username":"Mike.Lee",

      "password":"1234567890"

      }

    3. 재생/시작/보내기를 클릭합니다.
    4. 워크로드 내보내기 API가 인증 API를 이용하여 획득한 인증 토큰을 사용합니다. 이 인증은 워크로드 내보내기 API에 헤더 입력 중 하나로 전달되어야 합니다.
    5. 요청 매개변수 X-Authorization, 동의queue-ids를 헤더로 입력합니다.

      예를 들어,

      {

      "X-Authorization":"authorization token issued by Enterprise 제어실 after login",

      "Accept":"application/json/file",

      "queue-ids":"1,2,3,4,5"

      }

    6. 재생/시작/보내기를 클릭합니다.
    7. 응답 상태가 200 OK인 경우, 작업에 성공한 것입니다.
    8. 응답 프레임에서 패키지 이름을 복사합니다. 이를 사용하여 대기열 패키지를 가져올 수 있습니다.
      팁: 가져오기 패키지 확장자가 올바른지 확인합니다(.wlmpkg).

      예를 들어 content-disposition에 제공된 filename을 복사합니다.

      cache-control → no-cache, no-store, max-age=0, must-revalidate

      content-disposition → attachment; filename=WorkloadPackage_20180524_180900.wlmpkg

      content-length → 887

      content-type → application/aapkg

      date → Thu, 24 May 2018 12:39:00 GMT

      expires → 0

      pragma → no-cache

      x-frame-options → SAMEORIGIN

    대기열 가져오기

    대기열 패키지를 네트워크 드라이브 또는 Enterprise 제어실 시스템 경로에 성공적으로 내보낸 후 다른 승인된 사용자가 가져오기 API를 사용하여 해당 패키지를 다른 Enterprise 제어실으로 가져올 수 있습니다.

    1. Post 메소드를 이용하여 엔드포인트 http(s)://<hostname:port>/v1/authentication을 사용하는 토큰을 생성합니다. 서버 이름/호스트 이름/IP포트 번호로 Enterprise 제어실 인스턴스를 입력합니다.

      예: https://crtestenv.com:82/v1/authentication

    2. POST 메소드를 사용하고 요청된 본문에 자격증명 매개변수를 입력합니다.

      다음 샘플을 참조하십시오.

      {

      "username":"Tom.Watson",

      "password":"1234567890"

      }

    3. 재생/시작/보내기를 클릭합니다.
    4. 워크로드 가져오기 API가 인증 API를 이용하여 획득한 인증 토큰을 사용합니다. 이 인증은 워크로드 가져오기 API에 헤더 입력 중 하나로 전달되어야 합니다.
    5. 요청 매개변수 X-AuthorizationContent-Type을 헤더로 입력합니다.

      예를 들어,

      "X-Authorization":"authorization token issued by Enterprise 제어실 after login",

      "Content-Type":"multipart/form-data"

    6. 이제 다음 매개변수를 입력합니다. Content-Disposition: form-data; name="upload"; filename="{file name}". 이를 통해 요청 본문에서 대기열 패키지를 가져옵니다.

      예를 들어,

      Content-Disposition: form-data;

      name="upload"; filename="{WorkloadPackage_20180524_180900.wlmpkg}"

    7. 재생/시작/보내기를 클릭합니다.
    8. 응답 상태가 200 OK인 경우, 작업에 성공한 것입니다.

    API 응답 코드

    HTTP (s) 상태 코드 응답 - 설명 수정 작업
    200 패키지가 성공적으로 생성됨 NA
    400 잘못된 요청 매개 변수 유효한 매개 변수로 다시 시도하십시오.
    404 파일을 찾을 수 없음 Enterprise 제어실에 대기열이 있는지 확인하십시오.
    501 Permission error 필요한 권한이 있는지 확인하십시오.

    감사 로그

    감사 항목은 대기열을 내보내거나 가져올 때 Enterprise 제어실 감사 로그 페이지에 로깅됩니다.

    피드백을 보내주십시오