Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere

콘텐츠 닫기

콘텐츠

콘텐츠 열기

봇 수명주기 관리를 위한 봇 내보내기 및 가져오기 API

  • 업데이트: 5/10/2019
    • 11.3.x
    • 관리
    • Enterprise
    • API 문서

봇 수명주기 관리를 위한 봇 내보내기 및 가져오기 API

내보내기 및 가져오기 API를 이용하여 조직의 수명주기 관리 솔루션이 무중단 자동화 수명에 맞도록 사용자 정의합니다.

일반적으로 Enterprise 제어실 사용자는 TaskBot을 한 환경에서 다른 환경으로 배포하려면 Enterprise 제어실 이외의 수단(예: 이메일)을 사용해야 합니다. 내보내기/가져오기 API를 사용하면 간편하게 사용자 지정 봇 수명 주기 관리(BLM) 솔루션을 도입하여 자동화 수명주기를 중단시킬 수 있는 모든 외부 요인을 제거할 수 있습니다.

봇 내보내기 및 봇 다운로드 권한을 보유한 Enterprise 제어실 사용자는 봇 및 해당 종속 파일을 내보낼 수 있습니다. 마찬가지로, 봇 가져오기 및 봇 업로드 권한이 있는 사용자는 봇 및 해당 종속 파일을 가져올 수 있습니다.

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

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

Enterprise 제어실 사용자 인터페이스에서 이 기능을 사용하려면 봇 내보내기 및 봇 파일 가져오기 안내를 참고하십시오.

기능 및 이점

  • 봇 수명 주기 관리의 역할 기반 액세스 제어
  • 종속성(파일 및 봇) 자동 내보내기
  • 규정 준수를 위해 소스 및 대상 환경에 대한 감사 및 추적성
  • 내보내기/가져오기 실행 성공 또는 실패에 대한 이메일 알림.

내보내기

  • 자격 증명이 인증에 이용되는 Enterprise 제어실 사용자에게는 봇 내보내기 권한이 있어야 합니다.
  • 자격증명이 인증에 이용하는 Enterprise 제어실 사용자에게는 에 대한 다운로드 권한, 내보내는 MetaBot 및 종속 파일에 대한 최소한의 실행 권한이 있어야 합니다.
  • 소스 Enterprise 제어실에서 버전 관리가 활성화되면 내보내려는 모든 봇 및 종속 파일의 생산 버전이 설정되어야 합니다.
  • Enterprise 제어실 서비스 실행에 이용하는 사용자 계정에는 패키지를 내보내는 위치(예: 네트워크 위치(공유 드라이브) 또는 Enterprise 제어실 서버 시스템)에 대한 액세스 권한이 있어야 합니다.

가져오기

  • 자격증명이 인증에 이용하는 Enterprise 제어실 사용자에게는 봇 가져오기 권한이 있어야 합니다.
  • 자격증명이 인증에 이용하는 Enterprise 제어실 사용자에게는 가져오는 및 종속성에 대한 업로드 권한이 있어야 합니다.
  • 유틸리티를 실행하여 여러 봇을 가져올 Enterprise 제어실 사용자에게는 Automation Anywhere가 제공하는 내보낸 패키지 파일에 대한 액세스 권한이 있어야 합니다.

API 엔드포인트

  • 내보내기 - <Enterprise 제어실 URL>/v1/blm/export

    예: https://crdevenv.com:81/v1/alm/export

  • 가져오기 - <Enterprise 제어실 URL>/v1/blm/import

    예: https://crtestenv.com:82/v1/alm/import

위 BLM 내보내기 가져오기 API의 엔드포인트를 사용하여 단일 봇 및 모든 종속 파일을 내보내고 가져올 수 있습니다.

봇 내보내기

Automation Anywhere가 제공하는 내보내기 API를 사용하여 단일 봇을 해당 종속 파일과 함께 내보냅니다.

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

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

  2. Post 메소드를 사용하고 본문 데이터에 자격증명 매개변수를 입력합니다. 다음과 같은 샘플을 참고하십시오.

    {

    "username":"cradmin",

    "password":"cr@admin"

    }

  3. 재생/시작을 클릭합니다.
  4. BLM 내보내기 API가 인증 API를 이용하여 획득한 인증 토큰을 사용합니다. 이 인증을 BLM 내보내기 API에 헤더 입력 중 하나로 전달해야 합니다.
  5. 본문 데이터에서 filePath, destinationPathpackageName과 같은 매개변수를 제공하여 을 내보냅니다. 다음은 매개변수에 대한 설명입니다.
    • filePath - 이 매개변수를 사용하여 내보내려는 봇의 이름으로 끝나는 파일 경로를 지정합니다.
    • destinationPath - 이 매개변수를 사용하여 내보낸 패키지가 저장된 대상 경로를 지정합니다.
    • packageName - 이 매개변수를 사용하여 내보낸 패키지에 할당할 패키지 이름을 지정합니다.

      다음과 같은 샘플을 참고하십시오.

      {

      "filePath":"Automation Anywhere\\My Tasks\\Finance\\Account Reconciliation.atmx",

      "destinationPath":"tempshare\\datashare\\Finance Department",

      "packageName":"Finance package"

      }

  6. 재생/시작을 클릭합니다.
  7. 여러 소스를 사용하여 내보내기 결과를 볼 수 있습니다.
    • packagePathchecksum으로 구성되는 응답 데이터입니다.
    • 감사 로그 페이지(시작 페이지 및 상세 페이지)
    • 구성한 경우, 성공 또는 실패에 대한 알림을 수신하는 이메일

봇 가져오기

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

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

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

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

    다음과 같은 샘플을 참고하십시오.

    {

    "username":"cradmin2",

    "password":"cr@admin"

    }

  3. 재생/시작을 클릭합니다.
  4. BLM 가져오기 API가 인증 API를 이용하여 획득한 인증 토큰을 사용합니다. 이 인증을 BLM 가져오기 API에 헤더 입력 중 하나로 전달해야 합니다.
  5. 자격증명이 인증된 후 본문 데이터에 내보내기 도중 토큰으로 생성된 패키지 경로체크섬과 같은 매개변수를 입력합니다.

    다음과 같은 샘플을 참고하십시오.

    {

    "packagePath":"tempshare\\datashare\\Finance Department\\Finance Package_20171221-154403.aapkg",

    "checksum":"ZLyQ+Lbu2N+beEuXf6qd2Qi9uwi3BZxApn57C7mYjKQ="

    }

팁: 패키지 경로가 동일하고 BLM 가져오기 API 사용자에 액세스할 수 있는 경우 BLM 내보내기 API의 응답을 복사하여 BLM 가져오기 API에 대한 입력으로 직접 전달할 수 있습니다.

API 응답 코드

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

내보내기-가져오기 API 유틸리티

여러 봇을 내보내고 가져오려면 Automation Anywhere가 제공하는 배치 및 jar 파일로 구성된 유틸리티를 사용할 수 있습니다*.

*Java 버전 1.8 이상.

봇 내보내기

Enterprise 제어실 봇 수명 주기 관리 내보내기 유틸리티를 사용하여 Enterprise 제어실 리포지터리에서 여러 봇을 내보낼 수 있습니다. 여기에서는 배치 파일을 사용하여 Enterprise 제어실 리포지터리에서 TaskBot을 내보내는 방법을 설명합니다.

  1. Enterprise 제어실에서 을 내보내는 데 필요한 API 명령 및 매개변수로 구성된 BLM 배치 파일을 엽니다. 또한 이 파일은 간편하게 사용할 수 있도록 샘플 매개변수도 제공합니다.
    주: 이 유틸리티는 여러 을 내보내기 위해 배경에서 BLM 내보내기 API를 사용합니다. 선행조건을 참고하십시오. BLM 내보내기 배치 파일
    팁: 내보내기 프로세스를 시작하기 전에 배치 파일의 사본을 만드는 것이 좋습니다.
  2. 이제 TaskBot 및 종속 파일을 내보낼 파일에 다음과 같은 매개변수를 입력해야 합니다.
    • source_CR 매개변수로서 Enterprise 제어실 인스턴스.

      예: http://stagingCR-mydomain.com:8081/

    • 사용자 이름암호 매개변수로 Enterprise 제어실 로그인 자격증명.

      예: 사용자 이름: Mike, 암호: Mike@123

    • export_files 매개변수로 TaskBot 파일 이름. 쉼표로 구분된 /파일을 지정할 수 있습니다.

      예: Automation Anywhere\\My Tasks\\Finance Bots\\Account Reconciliation_master.atmx,Automation Anywhere\\My Tasks\\Finance REM Bots\\Comparison Data.atmx

    • export_directories 매개변수로 TaskBot 리포지터리 경로 이름. 폴더에서 다수의 을 내보내려면 이 매개변수를 사용합니다.

      예: Automation Anywhere\\My Tasks\\Utilities Bots\\312018, Automation Anywhere\\My Tasks\\Sample Tasks\\Analytics Tasks

    • export_CSVs 매개변수로 CSV 파일 이름 및 해당 경로. 외부 .csv/.txt 파일에서 /파일을 내보내려면 이 매개변수를 사용합니다.
      • 파일 이름, 디렉토리 및 .csv 파일을 결합하여 여러 소스에서 여러 파일을 내보낼 수 있습니다.

        예: Automation Anywhere\My Tasks\Finance\Bank Account Reconcilation.atmx, Automation Anywhere\My Tasks\Banking\Audit Certification Generation.atmx, Automation Anywhere\My MetaBots\Import Customer Data.mbot, Automation Anywhere\My Docs\daily sales data.xlsx

      • 최소한 하나의 매개변수를 전달해야 하며, 필요하지 않은 매개변수는 공백으로 두어야 합니다.

        예: SET export_CSVs=""

    • package_name 매개변수로 패키지 이름. 이 파일은 압축 파일로 저장되어 을 다른 Enterprise 제어실 인스턴스로 가져오는 데 사용됩니다.

      예: Bank Account Reconciliation

    • package_path 매개변수로 패키지의 대상 경로.
      주: 이 경로는 Enterprise 제어실 서비스 사용자가 쓰기 권한을 보유한 공유 드라이브 또는 Enterprise 제어실 시스템 경로일 수 있습니다.
      예:\\\\network_share\\BLM Export Packages
  3. 배치 명령을 실행하여 내보내기 명령을 실행합니다.
  4. 패키지가 package_path 매개변수에 지정된 위치에 생성되었는지 확인합니다.

    이 패키지는 Enterprise 제어실 사용자가 을 다른 Enterprise 제어실 인스턴스로 가져오는 데 사용됩니다.

샘플 코드

SET source_CR=<Enterprise 제어실 URL>

SET username=<Enterprise 제어실 Username>

SET password=<Enterprise 제어실 Password>

SET export_files="<Comma separated list of bots to be exported>"

SET export_directories="<Comma separated list of directories to be exported>"

SET export_CSVs="<Comma separated list of CSVs whose content are to be exported>"

SET package_name=<Name of the export package>

SET package_path=<Path at which package will be exported>

java -jar %utility_path% -Oexport -H%source_CR% -U%username% -P%password% -N%package_name% -K%package_path% -F%export_files% -D%package_path% -C%export_CSVs%

일시 중지

@echo off

REM *****************************매개변수 예***************************************

REM SET source_CR=http://123.456.78.90:8080

REM SET username=Mike

REM SET password=Mike@123

REM SET export_files="Automation Anywhere\\My Tasks\\Finance Bots\\Account Reconciliation_master.atmx,Automation Anywhere\\My Tasks\\Finance REM Bots\\Comparison Data.atmx"

REM SET export_directories="Automation Anywhere\\My Tasks\\Utilities Bots\\312018"

REM SET export_CSVs="D:\BLM\Account Reconciliation Bots.csv"

REM SET package_name=Bank Account Reconciliation

REM SET package_path=\\\\network_share\\BLM Export Packages

REM SET utility_path=D:\BLM\BLM_Export_Import_Utility-1.0.jar

봇 가져오기

Enterprise 제어실 봇 수명주기 관리 가져오기 유틸리티를 사용하여 여러 봇을 Enterprise 제어실 리포지터리로 가져올 수 있습니다. 여기에서는 배치 파일을 사용하여 TaskBotEnterprise 제어실 리포지터리로 가져오는 방법을 설명합니다.

  1. Enterprise 제어실으로 가져오는 데 필요한 API 명령 및 매개변수로 구성된 BLM 가져오기 배치 파일을 엽니다. 또한 이 파일은 간편하게 사용할 수 있도록 샘플 매개변수도 제공합니다.
    팁: 가져오기 프로세스를 시작하기 전에 배치 파일의 사본을 만드는 것이 좋습니다.
  2. 이제 TaskBot 및 종속 파일을 가져올 파일에 다음과 같은 매개변수를 입력해야 합니다.
    1. target_CR 매개변수로 대상 Enterprise 제어실 인스턴스.

      예: http://prodCR-mydomain.com:80/

    2. 사용자 이름암호 매개변수로 Enterprise 제어실 로그인 자격증명.

      예: 사용자 이름: John.Smith, 암호: John@123

    3. package_path 매개변수로 내보내기 패키지의 절대 경로 이름.

      예: \\\\network_share\\BLM Export Packages

  3. 배치 명령을 실행하여 가져오기 명령을 실행합니다.
  4. BLM Logs.log 파일의 /파일 내보내기 또는 가져오기 목록에서 Enterprise 제어실 리포지터리로 가져왔는지 확인할 수 있습니다. 이 파일은 유틸리티(.jar 파일)와 동일한 폴더에 저장됩니다.

샘플 코드

SET target_CR=<Target Enterprise 제어실 URL>

SET username=<Enterprise 제어실 Username>

SET password=<Enterprise 제어실 Password>

SET package_path=<Absolute path of the export package>

java -jar %utility_path% -Oimport -S%package_path% -U%username% -P%password% -H%target_CR%

일시 중지

@echo off

REM *****************************매개변수 예***************************************

REM SET target_CR=http://987.654.32.10:8080

REM SET username=John

REM SET password=John@123

REM SET package_path=\\\\network_share\\BLM Export Packages

REM SET utility_path=D:\BLM\BLM_Export_Import_Utility-1.0.jar

감사 로그

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

피드백을 보내주십시오