Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere

콘텐츠 닫기

콘텐츠

콘텐츠 열기

10.x Enterprise 제어실에서 11.x Enterprise 제어실으로의 데이터 마이그레이션을 위한 API

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

10.x Enterprise 제어실에서 11.x Enterprise 제어실으로의 데이터 마이그레이션을 위한 API

마이그레이션 보기 및 관리 역할 권한이 있는 Enterprise 제어실 관리자로서 마이그레이션 API를 사용하여 10.x Enterprise 제어실에서 현재 Enterprise 제어실 버전 11.x로 데이터 마이그레이션을 수행할 수 있습니다.

마이그레이션 API를 사용하면 다음을 수행할 수 있습니다.

  1. 10.x Enterprise 제어실 데이터베이스에 대한 연결 구성 저장/업데이트
  2. 2.x Bot Insight 데이터베이스(사용 가능한 경우)에 대한 연결 구성 저장/업데이트
  3. 역할, 사용자 또는 봇을 기반으로 데이터를 마이그레이션하는 옵션 지정
  4. 마이그레이션에 대해 지정된 옵션, 즉 역할, 사용자 또는 봇에 따라 데이터 목록 가져오기
  5. 마이그레이션 진행률 요약 보기
  6. 마이그레이션별 성공/실패한 개체 수의 마이그레이션 통계 보기
  7. 마이그레이션 후 10.x Enterprise 제어실에서 새 봇 및 업데이트된 봇 목록 가져오기
  8. 마이그레이션 후 10.x Enterprise 제어실 내 문서 폴더에서 대량으로 파일을 마이그레이션

또는 관리 > 마이그레이션 모듈에 있는 마이그레이션 마법사를 사용하여 Enterprise 제어실 사용자 인터페이스에서 데이터를 마이그레이션할 수 있습니다. 세부 정보는 마이그레이션 개요를 참조하십시오.

주: 제공된 예시는 참조 전용입니다.

API 끝점

다음 엔드포인트를 사용하여 API에 액세스합니다.

  1. 마이그레이션 프로세스를 위해서는 <Enterprise 제어실URL>/v2/migration을 사용합니다.
  2. 마이그레이션 프로세스가 완료된 후 소스 10.x Enterprise 제어실내 문서 폴더에서 파일을 마이그레이션하기 위해서는 <Enterprise 제어실 URL>/v1/migration을 사용합니다.

예:

https://crdevenv.com:81/v2/migration

마이그레이션 프로세스 API

마이그레이션 API를 사용하면 앞에서 언급한 엔드포인트를 사용하여 10.x Enterprise 제어실 데이터를 11.x Enterprise 제어실으로 마이그레이션할 수 있습니다.

마이그레이션 API에 액세스하기 전에 먼저 인증 API를 사용하여 이를 특정한 마이그레이션 API를 사용할 토큰으로 전달해야 합니다.

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

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

  2. 헤더에 다음 요청 페이로드를 입력합니다.

    “X-Authorization” : “Authorization token”

    “Content-Type” : “application/json”

  3. 본문에 다음 요청 페이로드를 입력합니다.

    {

    "username": "<Username>",

    "password": "<Password>"

    }
    • 예:

      {

      "usename": "Ellie.Brown",

      "password": "12345678"

      }

1. 소스 Enterprise 제어실 데이터베이스에 연결

이 API를 사용하면 소스 10.x Enterprise 제어실 데이터베이스에 대한 연결 구성을 저장하고 업데이트할 수 있습니다.

  1. 헤더에 다음 "X-Authorization" 및 "Content Type" 매개변수를 입력합니다.
  2. 본문에 자격증명 매개변수를 입력합니다.
  3. POST 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/connection을 사용하여 10.x Enterprise 제어실 데이터베이스에 연결합니다.
    • 예:https://crdevenv.com:81/v2/migration/connection
  4. 본문에 다음 요청 매개변수를 입력합니다.

    {

    "host": "string", "port": 0, "databaseName": "string", "username": "string", "password": "string", "integratedSecurity": true, "encrypt": true, "privateKey": "string", "repoPath": "string"

    }
    • 예를 들어,

      {

      "host": "PRODUCTLT",

      "port": 1433,

      "databaseName": "CR104MIG",

      "username": "Ellie.Brown",

      "password": "12345678",

      "integratedSecurity": true,

      "encrypt": true,

      "privateKey": "ABC123",

      "repoPath": "D:\\Data\Automation Anywhere Server Files"

      }

  5. 보내기를 클릭합니다.

매개변수 설명

매개변수 셜명
host 소스 Enterprise 제어실 데이터베이스 호스트 이름
port 소스 Enterprise 제어실 데이터베이스 포트 번호
databaseName 소스 Enterprise 제어실 데이터베이스 이름
사용자 이름 데이터베이스에 연결하는 사용자 이름
비밀번호 데이터베이스에 연결하는 암호
integratedSecurity 소스 데이터베이스에 연결할 때 Windows 인증 사용 여부를 나타내는 표시기입니다. Windows 인증을 사용하려는 경우 true로 설정합니다. 기본값은 false입니다.
encrypt 소스 데이터베이스에 보안 연결을 사용할지 여부를 나타내는 표시기입니다. 보안 연결을 사용하려는 경우 true로 설정합니다. 기본값은 false입니다.
privateKey 소스 데이터베이스의 자격증명 값을 해독하기 위한 프라이빗 키입니다. 이 기능은 초기 Enterprise 제어실 설정 중에 사용할 수 있습니다.
repoPath Enterprise 제어실 10.x 리포지토리가 저장되는 공유 리포지토리 경로입니다.

2. 저장된 연결 세부 정보 가져오기

이 API를 사용하면 데이터를 마이그레이션할 수 있는 소스 10.x Enterprise 제어실 데이터베이스의 저장된 연결 세부 정보를 가져올 수 있습니다.

  1. 헤더에 다음 "X-Authorization" 및 "Content Type" 매개변수를 입력합니다.
  2. 본문에 자격증명 매개변수를 입력합니다.
  3. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/connection을 사용하여 10.x Enterprise 제어실 데이터베이스의 연결 구성을 가져옵니다.
    • 예:https://crdevenv.com:81/v2/migration/connection
  4. 보내기를 클릭합니다.
  5. 본문 데이터에서 결과를 볼 수 있습니다.

    {

    "host": "productlt",

    "port": 1433,

    "databaseName": "CR104MIG",

    "username": "",

    "password": "",

    "integratedSecurity": true,

    "encrypt": false,

    "privateKey": "",

    "repoPath": "D:\\DATA\AUTOMATION ANYWHERE SERVER FILES"

    }

매개변수 설명

매개변수 셜명
host 소스 데이터베이스 호스트
port 소스 데이터베이스 포트
databaseName 소스 데이터베이스 이름
사용자 이름 소스 데이터베이스에 연결하는 사용자 이름
비밀번호 소스 데이터베이스에 연결하는 암호
integratedSecurity 소스 데이터베이스에 연결할 때 Windows 인증 사용 여부를 나타내는 표시기로 기본값은 false입니다.
encrypt 소스 데이터베이스에 연결할 때 보안 연결 사용 여부를 나타내는 표시기로 기본값은 false입니다.
privateKey 소스 데이터베이스의 자격증명 값을 해독하기 위한 프라이빗 키입니다.
repoPath Enterprise 제어실 10.x 리포지토리가 저장되는 공유 리포지토리 경로입니다.

3. 2.x Bot Insight 데이터베이스(사용 가능한 경우)에 연결

이 API를 사용하면 소스 2.x Bot Insight 데이터베이스(사용 가능한 경우)에 연결하여 분석 데이터를 마이그레이션할 수 있습니다.

  1. 헤더에 다음 "X-Authorization" 및 "Content Type" 매개변수를 입력합니다.
  2. 본문에 자격증명 매개변수를 입력합니다.
  3. POST 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/connection /botinsight를 사용하여 Bot Insight 데이터베이스에 연결합니다.
    • 예: https://crdevenv.com:81/v2/migration/connection/botinsight
  4. 본문에 다음 요청 매개변수를 입력합니다.

    {

    "host": "string",

    "port": 0,

    "databaseName": "string",

    "username": "string",

    "password": "string",

    "integratedSecurity": true,

    "encrypt": true,

    "serverUrl": "string"

    }
    • 예를 들어,

      {

      "host": "Productlt",

      "port": 8091,

      "databaseName": "BotInsight",

      "username": "Ellie.Brown",

      "password": "12345678",

      "integratedSecurity": true,

      "encrypt": true,

      "serverUrl": "https://productlt.aae.com:82/analytics"

      }

  5. 보내기를 클릭합니다.
  6. 응답 상태가 200 성공적인 작동이면 연결 매개변수가 성공적으로 저장된 것입니다.

매개변수 설명

매개변수 셜명
host 소스 Bot Insight 데이터베이스 호스트 이름
port 소스 Bot Insight 데이터베이스 포트 번호
databaseName 소스 Bot Insight 데이터베이스 이름
사용자 이름 데이터베이스에 연결하는 사용자 이름
비밀번호 데이터베이스에 연결하는 암호
integratedSecurity 소스 데이터베이스에 연결할 때 Windows 인증 사용 여부를 나타내는 표시기입니다. Windows 인증을 사용하려는 경우 true로 설정합니다. 기본값은 false입니다.
encrypt 소스 데이터베이스에 보안 연결을 사용할지 여부를 나타내는 표시기입니다. 보안 연결을 사용하려는 경우 true로 설정합니다. 기본값은 false입니다.
serverUrl Bot Insight 시각화 서버 포트가 있는 서버 URL

4. 저장된 연결 세부 정보 가져오기

이 API를 사용하면 데이터를 마이그레이션할 수 있는 소스 2.x Bot Insight 데이터베이스의 저장된 연결 세부 정보를 가져올 수 있습니다.

  1. 헤더에 다음 "X-Authorization" 및 "Content Type" 매개변수를 입력합니다.
  2. 본문에 자격증명 매개변수를 입력합니다.
  3. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/connection/botinsight를 사용하여 10.x Enterprise 제어실 데이터베이스의 연결 정보를 가져옵니다.
    • 예:https://crdevenv.com:81/v2/migration/connection/botinsight
  4. 보내기를 클릭합니다.
  5. 응답 상태가 200 마이그레이션 구성이면 연결 매개변수가 성공적으로 저장된 것입니다.
  6. 본문 데이터에서 결과를 볼 수 있습니다.

    {

    "host": "Productlt",

    "port": 8091,

    "databaseName": "BotInsight",

    "username": "Ellie.Brown",

    "password": "12345678",

    "integratedSecurity": true,

    "encrypt": true,

    "serverUrl": "https://productlt.aae.com:82/analytics"

    }

매개변수 설명

매개변수 셜명
host 소스 Bot Insight 데이터베이스 호스트 이름
port 소스 Bot Insight 데이터베이스 포트 번호
databaseName 소스 Bot Insight 데이터베이스 이름
사용자 이름 데이터베이스에 연결하는 사용자 이름
비밀번호 데이터베이스에 연결하는 암호
integratedSecurity 소스 데이터베이스에 연결할 때 Windows 인증 사용 여부를 나타내는 표시기입니다. Windows 인증을 사용하려는 경우 true로 설정합니다. 기본값은 false입니다.
encrypt 소스 데이터베이스에 보안 연결을 사용할지 여부를 나타내는 표시기입니다. 보안 연결을 사용하려는 경우 true로 설정합니다. 기본값은 false입니다.
serverUrl Bot Insight 시각화 서버 포트가 있는 서버 URL

5. 소스 데이터베이스에서 마이그레이션에 사용할 수 있는 TYPE의 개체 목록

이 API는 소스 데이터베이스에서 마이그레이션에 사용할 수 있는 개체 목록을 TYPE 매개변수별로 반환합니다. 역할, 사용자, 봇 또는 일정 옵션 중 하나를 사용하여 선택한 매개변수와 관련된 모든 데이터를 마이그레이션할 수 있습니다.

주: 데이터의 선택적 마이그레이션, 즉 지정된 매개변수를 기반으로 특정 데이터만 선택하려면 Enterprise 제어실에서 제공하는 마이그레이션 마법사를 사용합니다.
  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/connection /entities를 사용하여 Enterprise 제어실 데이터베이스에 연결합니다. 엔드포인트 뒤에 TYPE 매개변수(역할, 사용자, 봇 또는 일정 옵션 중 하나를 포함)를 붙입니다.
    • 예:https://crdevenv.com:81/v2/migration/connection/entities?Type=ROLE
  3. 보내기를 클릭합니다.
  4. 응답 상태가 200이면 데이터가 반환됩니다.
  5. TYPE 매개변수에 기반한 개체 목록이 본문에 표시됩니다.

    {

    "entities":

    [

    { "id": "0", "type": "ROLE", "sourceId": "1", "targetId": "0", "name": "Admin", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "2", "targetId": "0", "name": "Basic", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "3", "targetId": "0", "name": "IQBotValidator", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "4", "targetId": "0", "name": "AnalyticsExperts", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "5", "targetId": "0", "name": "AnalyticsConsumers", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "6", "targetId": "0", "name": "BotAgentUser", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "7", "targetId": "0", "name": "BotFarmAdmin", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "8", "targetId": "0", "name": "IQBotServices", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "9", "targetId": "0", "name": "Bot Creator 10x", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "10", "targetId": "0", "name": "Bot Runner 10x", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "11", "targetId": "0", "name": "Bot Scheduler 10x", "status": "SUCCESS", "reason": "" }

    ]

    }

매개변수 설명

매개변수 셜명
id 마이그레이션 ID
type 마이그레이션을 위해 선택한 개체 유형 - 역할(Role), 사용자(User) 또는 봇(Bot)
sourceId 소스 데이터베이스의 개체 ID
targetId 대상 데이터베이스에서 마이그레이션한 후의 개체 ID
name 소스 데이터베이스에서의 개체 이름
상태 해당 특정 개체의 마이그레이션 상태
이유 해당 특정 개체에 대한 마이그레이션 실패 이유

6. 사용자 입력을 기반으로 데이터 마이그레이션 준비

이 API를 사용하면 마이그레이션에 지정된 개체 유형의 하위 섹션을 기반으로 연결된 데이터가 있는 개체를 마이그레이션할 수 있습니다.

  1. 헤더에 다음 "X-Authorization" 및 "Content Type" 매개변수를 입력합니다.
  2. POST 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/prepare를 사용하여 데이터를 마이그레이션합니다.
    • 예: https://crdevenv.com:81/v2/migration/prepare
  3. 본문에 다음 요청 페이로드를 입력합니다.

    {

    "selected":

    [

    { "type": "<enitity type>",

    "sourceId": "string" }

    ],

    "excludes": [ "<entity type>"

    ]

    }
    • 예를 들어,

      { "selected": [ { "type": "ROLE", "sourceId": "12" } ], "excludes": [ "BOT" ] }

  4. 보내기를 클릭합니다.
  5. 응답 상태가 200이면 데이터가 마이그레이션에 대해 성공적으로 나열된 것입니다.
  6. 결과가 본문에 표시됩니다.

    { "selected":

    [

    { "type": "ROLE", "sourceId": "12" } ],

    "excludes": [ "BOT" ]

    }

매개변수 설명

매개변수 셜명
type 마이그레이션을 위해 선택한 개체 유형 - 역할, 사용자 또는 봇 및 일정
sourceId 소스 데이터베이스의 개체 ID
excludes

마이그레이션에서 제외되는 개체 이름입니다. 선택한 개체 유형에 따라 옵션을 사용할 수 있습니다.

따라서 역할 또는 사용자를 선택하면 봇 및 일정 제외를 수행할 수 있으며, 봇 및 일정을 선택하면 MetaBot 제외 및/또는 기존 봇 덮어쓰기를 수행할 수 있습니다.

7. 마이그레이션 시작

이 API를 사용하면 마이그레이션 프로세스를 시작할 수 있습니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. POST 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/start/async를 사용하여 데이터를 마이그레이션합니다.
    • 예: https://crdevenv.com:81/v2/migration/start/async

  3. 보내기를 클릭합니다.
  4. 응답 상태가 200 성공적인 작업이면 데이터 마이그레이션이 성공적으로 시작된 것입니다.
  5. 결과가 본문 데이터에 표시됩니다.

    {

    "id": 1,

    "name": "2018.07.17.16.13.48.ellie.brown",

    "createdBy": 1,

    "migrationType": "ROLE_EXCLUDE_BOT_SCHEDULE"

    }

매개변수 설명

매개변수 셜명
id 마이그레이션 ID
name 마이그레이션을 시작한 사용자의 이름
createdBy 마이그레이션을 시작한 개체 ID(예: Enterprise 제어실 관리자)
migrationType 선택한 마이그레이션 유형 - 역할, 사용자 또는 봇 및 일정

8. ID별 마이그레이션 객체

이 API는 마이그레이션 시작 API를 사용하여 생성된 ID를 기반으로 마이그레이션 객체 세부 정보를 나열합니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/<id>를 사용하여 ID별로 객체 세부 정보를 가져옵니다.
    • 예: https://crdevenv.com:81/v2/migration/9

  3. 보내기를 클릭합니다.
  4. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  5. 세부 정보가 본문 데이터에 표시됩니다.

    {

    "id": "9",

    "name": "2018.07.17.16.13.48.ellie.brown",

    "startTime": "2018-07-17T10:43:48.127Z",

    "endTime": "2018-07-17T10:43:49.833Z",

    "createdBy": "1",

    "migrationType": "ROLE_EXCLUDE_BOT_SCHEDULE",

    "entities": []

    }

매개변수 설명

매개변수 셜명
id 마이그레이션 ID
name 마이그레이션을 시작한 사용자의 이름
startTime 마이그레이션이 시작된 시간
endTime 마이그레이션이 종료된 시간
createdBy 마이그레이션을 시작한 개체 ID(예: Enterprise 제어실 관리자)
entities 마이그레이션 프로세스 중에 마이그레이션된 개체 목록
migrationType 선택한 마이그레이션 유형 - 역할, 사용자 또는 봇 및 일정

9. 마이그레이션 진행률

이 API를 사용하면 진행 중인 마이그레이션 프로세스를 볼 수 있습니다.

  1. 헤더에 다음 "X-Authorization" 및 "Content Type" 매개변수를 입력합니다.
  2. 본문에 자격증명 매개변수를 입력합니다.
  3. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/pogress를 사용하여 ID별로 객체 세부 정보를 가져옵니다.
    • 예: https://crdevenv.com:81/v2/migration/progress

  4. 보내기를 클릭합니다.
  5. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  6. 세부 정보가 본문 데이터에 표시됩니다.

    {

    "migration":

    { "id": "10", "name": "2018.07.17.16.55.59.ellie.brown", "startTime": "2018-07-17T11:25:59.800Z", "endTime": "2018-07-17T11:26:16.002Z", "createdBy": "1", "migrationType": "BOT_EXCLUDE_MetaBot", "entities": [] },

    "current": "SCHEDULE",

    "progress":

    {

    "BOT": { "total": "10", "successful": "7", "failed": "0", "skipped": "3" },

    "SCHEDULE": { "total": "8", "successful": "8", "failed": "0", "skipped": "0" }

    }

    }

매개변수 설명

매개변수 셜명
id 마이그레이션 ID
name 표시된 마이그레이션 이름
startTime 마이그레이션 프로세스가 시작될 때의 타임스탬프
endTime 마이그레이션 프로세스가 완료될 때의 타임스탬프. 마이그레이션이 진행 중일 때 Null
createdBy 마이그레이션 프로세스를 만들거나 시작한 사용자의 ID
현재 현재 마이그레이션 중인 개체 유형 - 역할, 사용자, 자격증명, 봇 또는 일정
진척도

개체의 진행률 -

  • total - 마이그레이션할 특정 유형의 총 개체 수
  • successful - 마이그레이션이 성공한 총 개체 수
  • failed - 마이그레이션이 실패한 총 개체 수
  • skipped - 마이그레이션 중에 건너뛴 총 개체 수

10. 마이그레이션 통계 - 마이그레이션당 성공/실패한 개체 수

이 API를 사용하면 마이그레이션당 성공 또는 실패한 개체 수를 볼 수 있습니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v2/migration/statistics를 사용하여 ID별로 객체 세부 정보를 가져옵니다.
    • 예: https://crdevenv.com:81/v2/migration/statistics

  3. 보내기를 클릭합니다.
  4. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  5. 세부 정보가 본문 데이터에 표시됩니다.

    {

    "items": [

    { "id": "1", "name": "2018.07.13.11.14.59.ellie.brown", "startTime": "2018-07-13T05:44:59.787Z", "endTime": "2018-07-13T06:56:25.537Z", "createdBy": "1", "duration": "4285s", "numSuccess": 0, "numFailed": 0, "numSkipped": 0 },

    { "id": "2", "name": "2018.07.13.12.28.08.ellie.brown", "startTime": "2018-07-13T06:58:09.283Z", "endTime": "2018-07-13T06:58:12.910Z", "createdBy": "1", "duration": "3s", "numSuccess": 1, "numFailed": 1, "numSkipped": 0 },

    { "id": "3", "name": "2018.07.13.12.40.34.ellie.brown", "startTime": "2018-07-13T07:10:34.470Z", "endTime": "2018-07-13T07:10:40.060Z", "createdBy": "1", "duration": "5s", "numSuccess": 10, "numFailed": 0, "numSkipped": 0 },

    { "id": "4", "name": "2018.07.13.12.42.19.ellie.brown", "startTime": "2018-07-13T07:12:20.007Z", "endTime": "2018-07-13T07:12:23.107Z", "createdBy": "1", "duration": "3s", "numSuccess": 0, "numFailed": 0, "numSkipped": 6 },

    { "id": "5", "name": "2018.07.13.13.39.53.ellie.brown", "startTime": "2018-07-13T08:09:53.113Z", "endTime": "2018-07-13T08:10:02.673Z", "createdBy": "1", "duration": "9s", "numSuccess": 4, "numFailed": 0, "numSkipped": 0 }

    ]

    }

매개변수 설명

매개변수 셜명
id 마이그레이션 ID
name 표시된 마이그레이션 이름
startTime 마이그레이션 프로세스가 시작될 때의 타임스탬프
endTime 마이그레이션 프로세스가 완료될 때의 타임스탬프. 마이그레이션이 진행 중일 때 Null
createdBy 객체를 만든 사용자의 ID
지속 시간 마이그레이션 기간 - 초 또는 나노초
numSuccess 마이그레이션이 성공한 개체 수
numFailed 마이그레이션이 실패한 개체 수
numSkipped 마이그레이션 중에 건너뛴 개체 수

마이그레이션 프로세스 후 API

프로세스가 완료된 후 마이그레이션 API를 사용하여 다음을 수행할 수 있습니다.

  1. 10.x Enterprise 제어실의 내 문서 폴더에서 파일 가져오기
  2. 마지막 마이그레이션 실행 이후 10.x Enterprise 제어실에서 새 봇 또는 수정된 봇 목록 가져오기
    주: API에 액세스하기 전에 먼저 인증 API를 사용하여 이를 특정한 마이그레이션 API를 사용할 토큰으로 전달해야 합니다.
  3. POST 메소드를 사용하여 엔드포인트 http(s)://<hostname:port>/v1/authentication을 사용하는 토큰을 생성합니다. 이를 위해 Enterprise 제어실 인스턴스를 서버 이름/호스트 이름/IP포트 번호로 입력합니다.

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

  4. 헤더에 다음 요청 페이로드를 입력합니다.

    “X-Authorization” : “Authorization token”

    “Content-Type” : “application/json”

  5. 본문에 다음 요청 페이로드를 입력합니다.

    {

    "username": "<Username>",

    "password": "<Password>"

    }

  • 예를 들어,

    {

    "사용자 이름": "Ellie.Brown",

    "password": "12345678"

    }

중요사항: 마이그레이션 후 API를 사용하는 동안 오류 코드 404가 표시되면 API를 다시 사용하여 10.x Enterprise 제어실에서 루트 폴더 목록을 가져옵니다(예: http(s)://<hostname:port>/v1/migration/legacyrepository/rootDirectories).

A. 내 문서 폴더에서 파일 가져오기

특정 API 세트를 사용하여 10.x Enterprise 제어실의 내 문서 폴더에서 파일을 마이그레이션합니다. 이러한 API를 사용하면 봇에서 종속성으로 사용될 수 있거나 독립적으로 이 자동화에 유용한 많은 수의 파일을 가져올 수 있습니다.

1. 10.x Enterprise 제어실에서 루트 폴더 목록 가져오기

이 API를 사용하면 10.x Enterprise 제어실 리포지토리에서 사용할 수 있는 폴더 목록을 가져올 수 있습니다. 이렇게 하면 소스 Enterprise 제어실에서 사용 가능한 폴더 구조를 이해하는 데 도움이 됩니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v1/migration/legacyrepository/rootDirectories를 사용하여 ID별로 객체 세부 정보를 가져옵니다. 엔드포인트 뒤에 excludeMetaBot 매개변수를 붙입니다.
    • 예: https://crdevenv.com:81/v1/migration/legacyrepository/rootDirectories?excludeMetaBot=true

  3. 보내기를 클릭합니다.
  4. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  5. 세부 정보가 본문 데이터에 표시됩니다.

    [

    { "name": "My Docs", "path": "Automation Anywhere\\My Docs" },

    { "name": "My Exes", "path": "Automation Anywhere\\My Exes" },

    { "name": "My Reports", "path": "Automation Anywhere\\My Reports" },

    { "name": "My Scripts", "path": "Automation Anywhere\\My Scripts" },

    { "name": "My Tasks", "path": "Automation Anywhere\\My Tasks" },

    { "name": "My Workflow", "path": "Automation Anywhere\\My Workflow" }

    ]

매개변수 설명

매개변수 셜명
name 디렉토리/폴더의 이름
path 디렉토리/폴더의 경로

2. 10.x 컨트롤룸에서 루트 폴더의 하위 폴더 목록 가져오기

이 API를 사용하면 10.x Enterprise 제어실 리포지토리에서 사용할 수 있는 특정 루트 폴더에 대한 하위 폴더 목록을 가져올 수 있습니다. 이렇게 하면 소스 Enterprise 제어실의 폴더 구조를 이해하는 데 도움이 됩니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v1/migration/legacyrepository/childDirectories를 사용하여 ID별로 객체 세부 정보를 가져옵니다. 엔드포인트 뒤에 path 매개변수를 붙입니다.
    • 예: https://crdevenv.com:81/v1/migration/legacyrepository/childDirectories?path=Automation Anywhere\My Docs

  3. 보내기를 클릭합니다.
  4. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  5. 세부 정보가 본문 데이터에 표시됩니다.

    {

    "folders":

    [

    { "name": "Log-Files", "path": "Automation Anywhere\\My Docs\\Log-Files" }

    ]

    }

매개변수 설명

매개변수 셜명
예약된 활동 하위 디렉토리 목록
name 디렉토리/폴더의 이름
경로(PATH) 디렉토리/폴더의 경로

3. 지정된 폴더에 있는 파일 목록 가져오기

이 API를 이용하면 소스 Enterprise 제어실 리포지토리의 지정된 폴더에서 사용 가능한 파일 목록을 가져올 수 있습니다

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v1/migration/legacyrepository/childFiles를 사용하여 ID별로 객체 세부 정보를 가져옵니다. 엔드포인트 뒤에 pathexcludeMetaBot 매개변수를 붙입니다.
    • 예: https://crdevenv.com:81/v1/migration/legacyrepository/childFiles?path=Automation Anywhere\My Docs\Log-Files&excludeMetaBot=false

  3. 보내기를 클릭합니다.
  4. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  5. 세부 정보가 본문 데이터에 표시됩니다.

    {

    "files":

    [

    { "id": "280", "name": "ActiveMQServer-2018-Jul-17-2.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\ActiveMQServer-2018-Jul-17-2.log.zip" },

    { "id": "281", "name": "IgniteServer-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\IgniteServer-2018-Jul-17-4.log.zip" },

    { "id": "283", "name": "WebCR_Ignite-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Ignite-2018-Jul-17-4.log.zip" },

    { "id": "284", "name": "WebCR_License-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_License-2018-Jul-17-4.log.zip" },

    { "id": "292", "name": "WebCR_Migration-2018-Jul-17-4.log", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.log" },

    { "id": "285", "name": "WebCR_Migration-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.log.zip" },

    { "id": "293", "name": "WebCR_Migration-2018-Jul-17-4.txt", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.txt" }

    ]

    }

매개변수 설명

매개변수 셜명
files 하위 파일의 목록
id 봇의 파일 ID
name 디렉토리/폴더의 이름
경로(PATH) 디렉토리/폴더의 경로

4. Enterprise 제어실 10.x에서 이름으로 폴더 검색

이 API를 사용하면 소스 Enterprise 제어실 내 문서 리포지토리에서 지정된 이름으로 폴더를 검색할 수 있습니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. GET 메소드에서 엔드포인트 http(s)://<hostname:port>/v1/migration/legacyrepository/folders를 사용하여 ID별로 객체 세부 정보를 가져옵니다. 엔드포인트 뒤에 taskName 매개변수를 붙입니다.
    • 예: https://crdevenv.com:81/v1/migration/legacyrepository/folders?taskName=Import-Table

  3. 보내기를 클릭합니다.
  4. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  5. 세부 정보가 본문 데이터에 표시됩니다.

    {

    "paths":

    [ "Automation Anywhere\\My Docs\\Import-Table" ]

    }

매개변수 설명

매개변수 셜명
paths 디렉토리/폴더 경로 목록

5. Enterprise 제어실 10.x에서 지정된 폴더의 파일 목록 가져오기

이 API를 사용하면 소스 Enterprise 제어실 내 문서 리포지토리의 지정된 폴더에서 파일 목록을 가져올 수 있습니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. POST 메소드에서 엔드포인트 http(s)://<hostname:port>/v1/legacyrepository/files를 사용하여 지정된 폴더의 파일 목록을 가져옵니다.
    • 예: https://crdevenv.com:81/v1/legacyrepository/files

  3. 본문에 요청 페이로드로 폴더 경로 목록을 입력합니다.

    [

    "string"

    ]
    • 예를 들어, 다음은 사용 가능한 파일 목록입니다.

      [

      "Automation Anywhere\\My Docs\\Import-Table"

      ]

  4. 보내기를 클릭합니다.
  5. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  6. 응답 세부 정보가 본문 데이터에 표시됩니다.

    {

    "files":

    [

    { "id": 1281, "type": "BOT", "sourceId": "1281", "targetId": 0, "name": "Automation Anywhere\\My Docs\\Import-Table\\Import-Table.txt", "status": "SUCCESS", "reason": "" },

    { "id": 293, "type": "BOT", "sourceId": "293", "targetId": 0, "name": "Automation Anywhere\\My Docs\\Import-Table\\WebCR_Migration-2018-Jul-17-4.txt", "status": "SUCCESS", "reason": "" }

    ]

    }

매개변수 설명

매개변수 셜명
files 하위 파일의 목록
type 파일 형식
sourceId 소스 데이터베이스의 개체 ID
targetId 대상 데이터베이스에서 마이그레이션한 후의 개체 ID
name 디렉토리/폴더의 이름
상태 응답 상태 - 성공, 건너뜀 또는 실패
이유 실패 또는 건너뜀 상태에 대한 이유 설명

B. 11.x에서 마지막 마이그레이션 이후 10.x에서 새 봇 또는 수정된 봇 마이그레이션

이 API를 사용하면 대상 Enterprise 제어실 버전 11.x로 이미 마이그레이션한 이후에도 소스 Enterprise 제어실 버전 10.x에서 새 봇 또는 수정된 봇 목록을 가져올 수 있습니다. 본질적으로 이 API를 사용하면 11.x 환경이 생산 단계에 들어갈 준비가 된 상태에서도 계속해서 10.x 환경을 사용할 수 있습니다.

  1. 헤더에 'X-Authorization' 매개변수를 제공합니다.
  2. POST 메소드에서 엔드포인트 http(s)://<hostname:port>/v1/legacyrepository/changedfiles를 사용하여 ID별로 객체 세부 정보를 가져옵니다.
    • 예: https://crdevenv.com:81/v1/legacyrepository/changedfiles
  3. 본문에 요청 페이로드로 폴더 경로 목록을 입력합니다.

    {

    "changeSince": "<last migration date and time>"

    }

    • 예를 들어, 다음은 마이그레이션 후 업데이트된 봇 이름 목록입니다.

      {

      "changeSince":"2018-06-25T12:05:00+05:30"

      }

    팁: 마지막 마이그레이션 날짜 및 시간의 차이를 고려하기 위해 changeSince 매개변수를 지정하지 마십시오.
  4. 보내기를 클릭합니다.
  5. 응답 상태가 200이면 객체 세부 정보가 성공적으로 나열된 것입니다.
  6. 응답 세부 정보가 본문 데이터에 표시됩니다.

    {

    "changedfiles":

    [

    { "type": "BOT", "sourceId": "6", "name": "Automation Anywhere\\My Tasks\\Sample Tasks\\Import-Table.atmx" },

    { "type": "BOT", "sourceId": "7", "name": "Automation Anywhere\\My Tasks\\Sample Tasks\\List-Variable.atmx" }

    ]

    }

매개변수 설명

매개변수 셜명
changedFiles 마지막 마이그레이션 실행 이후 변경되었거나 새로운 개체의 목록
type 개체 유형
sourceId 소스 데이터베이스의 개체 ID
name 디렉토리/폴더의 이름

API 응답 코드

HTTP (s) 상태 코드 응답 - 설명 수정 작업
200 성공적인 작동 해당 없음
400 잘못된 요청 유효한 매개 변수로 다시 시도하십시오.
401 인증 필요 인증 매개변수를 제공하여 다시 시도하십시오.
403 승인되지 않은 액세스 이 작업을 수행할 수 있는 적절한 권한이 있는지 확인하십시오.
404 찾을 수 없음 Enterprise 제어실에 요청된 데이터가 있는지 확인하십시오.
409 충돌 제공된 매개변수가 올바른지 확인하십시오.
500 내부 서버 오류 서버가 작동되어 실행 중인지 확인하십시오.
501 권한 오류 필요한 권한이 있는지 확인하십시오.

감사 로그

감사 로그는 마이그레이션되는 각 개체에 대한 개별 개체를 표시합니다.

마이그레이션되는 각 개체의 세부 정보를 보여주는 감사 로그

마이그레이션 프로세스가 시작되면 마이그레이션 시작됨 개체가 감사 로그에 기록됩니다. 마찬가지로 마이그레이션 프로세스가 완료되면 마이그레이션 완료됨 항목이 로깅됩니다. 이 두 개체 사이에는 생성, 업데이트 또는 업로드 작업과 같이 마이그레이션되는 각 개체에 대한 마이그레이션 항목이 로깅됩니다.

아이콘을 클릭하여 프로세스의 세부 정보를 볼 수 있습니다.
피드백을 보내주십시오