마이그레이션용 Bot Scanner 보고서 분석
- 최종 업데이트2022/12/27
마이그레이션용 Bot Scanner 보고서 분석
Bot Scanner에서 생성된 보고서를 분석하여 마이그레이션 할 수 있는 봇(Task Bots 및 MetaBot)과 프로세스에 대한 정보를 가져올 수 있습니다. Bot Scanner를 사용하여 지금 마이그레이션을 시작할 준비가 되었는지 아니면 더 많은 명령이 지원될 때까지 기다릴지 결정합니다.
Bot Scanner 보고서는 다음 정보를 제공합니다.
- Bot: Bot Scanner 보고서에서 봇은 다른 봇에서 사용되는 개별 Task Bot(.atmx) 또는 MetaBot(.mbot)입니다.
Bots 탭은 마이그레이션할 수 있는 봇, 조치 또는 검토가 필요한 Bot, 마이그레이션할 수 없는 Bot에 관한 자세한 정보를 제공합니다.
- 프로세스: Bot Scanner 보고서에서 프로세스는 다른 봇에서 사용되지 않으며 하나 이상의 하위 봇를 포함할 수 있는 봇입니다.
프로세스 탭은 마이그레이션할 수 있는 프로세스, 조치 또는 검토가 필요한 프로세스, 마이그레이션할 수 없는 프로세스에 관한 자세한 정보를 제공합니다.
- 분석된 봇 및 프로세스의 수
- 봇 및 프로세스의 마이그레이션 상태를 나타내는 보드 형태의 개략적인 요약
- Automation 360로 마이그레이션할 수 있는/없는 봇 및 프로세스의 수
- 봇에서 사용되는 명령과 그 사용 빈도
- 현재 봇 및 프로세스를 마이그레이션 할 수 없는 이유 및 이러한 사항 발생 빈도
- 명령 동작의 변경으로 인해 사용자가 마이그레이션 후 수행해야 하는 작업 및 검토
- 마이그레이션할 수 없는 Bot 및 프로세스와 해당 오류 메시지
- 봇의 라인 수 그리고 프로세스와 연결된 각 봇 라인의 총 수
- 검토 또는 조치가 필요한 개별 봇 및 프로세스의 라인 번호
Enterprise 10 또는 Enterprise 11 기능의 대부분은 있는 그대로 사용할 수 있지만, 일부 기능은 (클라이언트가 없는) 웹 운영을 지원하기 위해 다르게 구현됩니다. 이러한 기능의 경우, 봇의 작성 방식을 변경해야 합니다.
Bot Scanner은 Enterprise Client의 Enterprise 10 및 Enterprise 11 버전을 모두 사용하여 만든 봇(Task Bots 및 MetaBot)를 스캔하도록 설계되었습니다. 총 파일 수에는 건너뛰고 검사하지 않은 파일 수가 포함됩니다.
보고서는 Automation Anywhere Bot Scanner 대화 상자의 대상 폴더 선택 필드에서 지정한 출력 위치에서 사용할 수 있습니다. Bot Scanner는 스캔한 각각의 봇에 대해 요약 보고서(summary.html)와 별도의 XML을 생성합니다. MetaBot에서 사용할 수 있는 각 로직에 대한 별도의 리포트를 생성합니다.
스캔한 각각의 봇에 대한 보고서(XML 형식)가 포함된 raw-data 폴더가 생성됩니다. 이는 엔지니어들이 마이그레이션 프로세스를 추가로 분석하고 필요한 경우 시정 조치를 취하는 데 도움이 됩니다. 요약 보고서 또는 스캔한 봇의 개별 보고서에는 개인 식별 정보(PII)가 포함되지 않습니다.
제품 개선을 위해 보고서를 당사와 공유하기로 선택한 경우 raw-data 폴더에서 파일을 압축하고 고객 성공 관리자(CSM) 또는 파트너 지원 관리자(PEM)와 조율합니다. Automation Anywhere와 자동으로 공유되는 데이터는 없습니다.
전체 봇 요약 보고서
- Automation 360로 마이그레이션할 수 있는지 여부
- 스캔된 봇의 총 수
- Automation 360로 마이그레이션 시 지원되는 봇에 관한 정보(백분율)를 제공하는 봇 전용 보고서
- Automation 360로 마이그레이션 시 지원되는 프로세스에 관한 정보를 제공하는 프로세스 전용 보고서
- Automation 360로 마이그레이션 시 지원되는 봇 및 프로세스에 관한 정보를 제공하는 봇 및 프로세스 통합 보고서
예를 들어, Bot Scanner가 10개의 봇을 스캔했다고 가정합니다. 10개 봇 중 8개의 봇이 Automation 360로 마이그레이션할 준비가 되었으면 마이그레이션할 수 있는 봇의 비율은 80%이며 지금 마이그레이션할 수 없는 봇의 비율은 20%입니다.
- 대다수 봇을 마이그레이션하고 마이그레이션 이후 Automation 360에서 실행할 수 있도록 나머지 5%의 봇에 대한 작업 및 검토를 식별합니다.
- 어떤 수동 개입도 없이 Automation 360로 마이그레이션할 수 있는 봇을 식별합니다.
- 2%의 봇을 현재 마이그레이션할 수 없는 이유 및 나중에 마이그레이션할 수 있을 때 예상 시간을 식별합니다. 그 이유는 아직 Automation 360에서 지원되지 않는 명령 및 변수 때문일 수 있습니다.
- 프로세스 탭을 클릭합니다.
- 검토할 메시지 탭을 클릭합니다.
- 마스터 태스크 참조 열에서 확장 아이콘()을 클릭하여 프로세스를 확인합니다.
- 메시지를 보려면 프로세스 이름을 클릭하십시오.
- 대다수 프로세스를 성공적으로 마이그레이션하고 그 후 Automation 360에서 사용할 수 있도록 나머지 15개의 프로세스에 대한 작업 및 검토를 식별합니다.
- 어떤 수동 개입도 없이 Automation 360로 마이그레이션할 수 있는 프로세스를 식별합니다.
- 현재 1개의 프로세스를 마이그레이션할 수 없는 이유 그리고 나중에 마이그레이션할 수 있을 때 예상 시간을 각각 식별합니다.
그 이유는 아직 Automation 360에서 지원되지 않는 명령 및 변수 때문일 수 있습니다.
다음 이미지는 Bot Scanner의 샘플 보고서입니다.
다음 표에서는 샘플 Bot Scanner 보고서(이전 이미지에서 번호 지정한 대로)의 다양한 필드에 대해 설명합니다.
필드 및 옵션 | 설명 |
---|---|
1 | 봇의 마이그레이션 준비 상태에 관한 요약 및 현황을 제공합니다. 다음을 기준으로 마이그레이션된 상태를 검토합니다.
|
2 | 봇에 대한 다음 정보의 요약을 제공합니다.
|
3 | 마이그레이션 프로세스를 쉽게 수행하기 위한 추가 리소스를 제공합니다. |
4 | 프로세스에 대한 다음 정보의 요약을 제공합니다.
|
5 |
주: 각 메시지에는 마이그레이션 후 검토해야 하는 정보가 포함되어 있습니다. 이러한 메시지 목록은 마이그레이션 메시지를 참조하십시오. 특정 메시지를 빠르게 보려면 메시지 코드(예:
R102 )를 사용합니다. |
6 | Automation 360로 마이그레이션 후 작업이 필요한 봇 또는 프로세스의 목록을 보려면 이 보기로 이동하십시오.
주: 각 메시지에는 마이그레이션 후 검토해야 하는 정보가 포함되어 있습니다. 이러한 메시지 목록은 마이그레이션 메시지를 참조하십시오. 특정 메시지를 빠르게 보려면 메시지 코드(예:
R102 )를 사용합니다. |
또는 :
7 |
Enterprise 11 또는 Enterprise 10 동작과 비교되는 명령에 대한 Automation 360 동작의 변경 사항에 관한 정보를 보려면 메시지 코드를 클릭하십시오. 주: 각 메시지에는 마이그레이션 후 검토해야 하는 정보가 포함되어 있습니다. 이러한 메시지 목록은 마이그레이션 메시지를 참조하십시오. 특정 메시지를 빠르게 보려면 메시지 코드(예:
R102 )를 사용합니다. |
8 | Automation 360로 마이그레이션할 수 있는 봇 또는 프로세스의 목록을 보려면 이 보기로 이동하십시오. | 또는 : 어떠한 수동 개입도 없이
9 | Automation 360로 마이그레이션할 수 없는 봇 또는 프로세스의 목록을 보려면 이 보기로 이동하십시오. | 또는 : 현재
10 | 봇에서 명령을 사용한 횟수를 보려면 이 보기로 이동하십시오. | : 마이그레이션할 수 있는 명령 목록과 스캔한 모든
11 |
Automation 360에서 성공적으로 마이그레이션된 프로세스를 실행하기 위해 수행해야 하는 수동 단계를 확인하려면 메시지 코드를 클릭하십시오. 봇이 포함하는 명령을 보거나 봇에서 명령이 사용된 빈도 또는 횟수를 볼 수도 있습니다. 주: 각 메시지에는 원인과 마이그레이션 후 수행해야 하는 작업이 포함되어 있습니다. 이러한 메시지 목록은 마이그레이션 메시지를 참조하십시오. 특정 메시지를 빠르게 보려면 메시지 코드(예:
A101 )를 사용합니다. |
12 | 봇의 위치를 제공합니다. |
13 | 봇 또는 프로세스의 상태를 제공합니다. |
14 |
|
15 | 프로세스의 경우, 이 필드는 Automation 360로 마이그레이션 후 작업이 필요한 프로세스 내 봇의 수를 표시합니다. 확장 아이콘()을 클릭한 다음 작업 필요 플래그가 지정된 태스크 참조 이름을 클릭합니다. Enterprise 11 또는 Enterprise 10 동작과 비교되는 명령에 대한 Automation 360 동작의 변경 사항에 관한 정보를 보려면 메시지 코드를 클릭하십시오. 주: 이 필드는 프로세스에 대해서만 사용할 수 있습니다.
|
16 | 프로세스의 경우, 이 필드는 Automation 360로 마이그레이션 후 검토가 필요한 프로세스 내 봇의 수를 표시합니다. 확장 아이콘()을 클릭한 다음 검토 필요 플래그가 지정된 태스크 참조 이름을 클릭합니다 . Enterprise 11 또는 Enterprise 10 동작과 비교되는 명령에 대한 Automation 360 동작의 변경 사항에 관한 정보를 보려면 메시지 코드를 클릭하십시오. 주: 이 필드는 프로세스에 대해서만 사용할 수 있습니다.
|
17 | 마이그레이션할 수 있거나 마이그레이션할 수 없는 봇, 프로세스 또는 명령의 목록을 다운로드(CSV 파일)하여 다른 사람과 파일을 공유할 수 있습니다. |
18 |
|
이 보고서는 다음 버전의 Bot Scanner을 사용할 수 있을 때까지 유효합니다. 다음 버전의 Bot Scanner을 사용할 수 있게 되면 보고서 만료 메시지가 표시됩니다. Bot Scanner의 최신 버전을 다운로드하고 봇를 다시 스캔해야 합니다.
마이그레이션 후 필요한 검증 및 조치
봇의 일부 명령은 Bot Scanner 보고서에 검토 필요로 표시될 수 있습니다. 이러한 항목의 경우, 봇을 마이그레이션한 후 특정 검증이나 업데이트를 수행해야 합니다.
다음 Bot Scanner 메시지는 확인 또는 일부 조치를 요구합니다.
- 하위 Bot 경로는 완전히 변수로 되어 있으며 런타임에서 확인됩니다. 변수에 지정된 경로가 올바르지 않으면 Bot은 실행 시 실패합니다. Bot 마이그레이션을 검토하십시오.
하위 봇이 변수로 된 경로에서 지정된 위치에서 사용할 수 있는지 확인하십시오. 상위 봇의 경로가 올바르지 않으면 올바른 하위 봇을 가리키도록 경로를 업데이트합니다.
- 시스템 변수 "오류 설명"에서 반환되는 값은 다른 레거시 버전일 수 있습니다. 마이그레이션된 Bot을 검토하십시오.
Automation 360의 일부 오류 메시지에 대한 설명이 동일한 오류에 대한 Enterprise 11 또는 Enterprise 10와 다를 수 있습니다. Enterprise 11 또는 Enterprise 10 봇이 오류 메시지 설명에 따라 결정되도록 구성된 경우, 오류 메시지에 대한 새 설명을 기준으로 마이그레이션된 봇을 업데이트해야 할 수 있습니다.
- "Database - Connect" 명령의 마이그레이션은 완료되었지만 "Windows 인증"에 대한 추가 구성이 필요합니다. 자세한 내용은 데이터베이스 패키지 설명서를 참조하십시오.
지정된 단계를 완료하여 Windows 인증을 사용하여 Microsoft SQL Server에 연결하십시오. Windows 인증을 사용하여 Microsoft SQL Server에 연결 항목을 참조하십시오.
- 가변 조건을 포함한 "IF"의 마이그레이션이 완료되었습니다. 그러나, 사용자 변수의 날짜 형식을 확인할 수 없으므로, 기본 날짜 형식 mm/dd/yyyy HH:mm:ss로 마이그레이션되었습니다. 필요한 경우 형식을 검토하고 변경하십시오.
마이그레이션된 봇의 날짜 형식을 해당 봇에 대해 Enterprise 11에서 사용된 형식과 동일한 형식으로 업데이트합니다.
- 위치로 사용된 변수가 인덱스 또는 열 이름인지 확인할 수 없습니다. 인덱스 위치는 1이 아닌 0부터 시작하므로 필요한 경우 필요한 조치를 취합니다.
Enterprise 11 또는 Enterprise 10 봇에서 FileData Column[$variable$] 또는 Excel Column[$variable$] 시스템 변수를 사용한 경우 $variable$에서 열 이름을 사용한 것으로 가정합니다. 이러한 경우 마이그레이션된 봇에 FileData Column{$variable$} 식이 포함됩니다. Enterprise 11 또는 Enterprise 10 봇의 $variable$에 열 번호가 포함되어 있으면 마이그레이션된 봇의 식을 FileDataColumn[$var.String:toNumber()$]로 업데이트해야 합니다.
- MetaBot의 로직에 대한 입력으로 자격증명 변수를 사용하는 로직 실행 명령
Task Bot에서 MetaBot 로직으로 Credential Vault 속성을 전달하는 로직 실행 명령을 사용하는 Bot은 Automation 360로 마이그레이션할 수 있습니다. 자격증명 이름 및 속성 이름은 마이그레이션된 봇의 해당 행에 있는 필드에 표시됩니다.
복원된 Enterprise 11 데이터베이스를 사용하여 마이그레이션한 경우, Automation 360에 Enterprise 11 봇에서 사용된 자격증명 변수에 대해 로커가 생성됩니다.
다음 옵션 중 하나를 선택하여 마이그레이션된 봇을 성공적으로 실행하십시오.- 옵션 1: 자격증명 유형 변수를 전달합니다.
- 하위 객체에 입력 봇 변수로 자격증명 유형 변수를 만듭니다.
- 상위 봇의 Task Bot 패키지에 대한 실행 작업에서 입력 값 필드를 업데이트하여 (MetaBot 로직에 해당하는) 하위 봇에 대해 생성된 자격증명 변수에 대한 Credential Vault 속성을 사용합니다.
- 옵션 2: 자격증명 값을 글로벌 값으로 전달합니다.
- Automation 360에 Enterprise 11의 로직 실행 명령에서 사용하는 자격증명에 대한 글로벌 값을 생성합니다.
- 상위 봇의 Task Bot 패키지에 대한 Run 작업에서 입력 값 필드를 업데이트하여 (MetaBot 로직에 해당하는) 하위 봇에 대해 생성된 자격증명 변수에 대해 글로벌 값을 사용합니다.
Automation 360 설치 시 복원된 Enterprise 11 데이터베이스를 사용하지 않았다면, 먼저 Enterprise 11 봇에서 사용된 자격증명 변수에 대한 필수 로커를 생성한 후, 선행 단계를 수행해야 합니다.주: Automation 360는 Credential Vault 속성을 자격증명 유형 변수에만 할당할 수 있도록 하여 보안을 강화시켜 줍니다. 이렇게 하면 자격증명이 아닌 유형 변수에 할당되었을 수 있는 Credential Vault 속성이 안전하지 않는 방식으로 처리되는 경우가 제한됩니다. - 옵션 1: 자격증명 유형 변수를 전달합니다.
개별 봇에 대한 보고서
각각의 봇에 대한 보고서는 종속성, 변수 및 사용된 명령에 대한 정보를 제공합니다.
개별 봇 보고서는 다음 코드와 비슷합니다.
<analysis version="1.3.0"> <stat> <dependencies ucount="0" count="0"/> <errors ucount="6" count="12"> <error count="1">System variable $AAApplicationPathlt;/error> <error count="1">Command [If FolderNotExist] is not supported</error> <error count="3">System variable $CurrentDirectorylt;/error> <error count="3">System variable $Extensionlt;/error> </errors> </stat> <commands> <command target-action="assign" name="VariableOperation" line="1" grp="VariableOperation" api="VarOpe"> <msg type="error" review="true" category="variable">System variable $AAApplicationPathlt;/msg> <msg type="info" review="false" category="default">Command parameter [Option] of type [String] is not required.</msg> </command> <command target-action="createFolder" name="createFolder" line="3" grp="FilesFolders" api="CreateFolder"/> <command target-action="copyFiles" name="CopyFiles" line="5" grp="FilesFolders" api="CreateFolder"/> <command target-action="connect" name="Connect" line="3" grp="Database" api="Connect"/> <command target-action="OpenCSVTXT" name="ReadFrom" line="9" grp="CsvText" api="Csv" <msg tpye="info" review="false" category="command">Line in 11.x client, there is no separate option given for CSV and TEXT in Automation 360</msg> <msg type="error" review="true" category="variable">System variable $CurrentDirectorylt;/msg> <msg type="error" review="true" category="variable">System variable $Extensionlt;/msg> <msg type="error" review="true" category="variable">System variable $FileNamelt;/msg> </command> </commands> <variables> <variable name="$CSV-TXT-Default-DATAquot; type="TABLE" value-type=""/> </varaibles> </analysis>
노드 | 속성 | 설명 |
---|---|---|
Stat | -- | 종속성, 오류 및 경고 수에 대한 정보를 제공합니다. |
-- | dependencies | 봇에 대한 종속성 수를 지정합니다. ucount 는 고유한 종속성의 수를 나타내고 count 는 총 종속성 수를 나타냅니다. |
-- | error | 봇에 대한 오류 수를 지정합니다. ucount 는 고유한 오류의 수를 나타내고 count 는 총 오류 수를 나타냅니다. |
명령 | -- | 봇에서 사용되는 다양한 명령 및 동작에 대한 정보를 제공합니다. |
-- | command target-action | 명령에 대해 수행 중인 작업을 지정합니다. |
-- | name | 명령의 이름을 지정합니다. |
-- | line | 봇에서 명령을 사용할 수 있는 행 번호를 지정합니다. |
-- | grp | 명령이 속하는 명령 그룹을 지정합니다. |
-- | api | 명령이 사용하는 API의 이름을 지정합니다. |
-- | msg type | 메시지 유형에 대한 정보를 제공합니다. error 유형은 명령을 Automation 360로 마이그레이션할 수 없음을 나타내고, info 유형은 명령을 마이그레이션할 수 있지만 마이그레이션 중에 일부 속성이 변경됩니다. |
-- | review | 명령을 검토해야 하는지 여부에 대한 정보를 제공합니다. 이 속성은 |
-- | category | 메시지가 표시되는 명령 또는 변수에 대한 정보를 제공합니다. |
변수 | 봇에서 사용하는 시스템 변수에 대한 정보를 제공합니다. | |
-- | variable name | 변수의 이름을 지정합니다. |
-- | 유형 | 변수의 유형을 지정합니다. |
-- | value type | 해당 변수에 대해 제공된 값 유형을 지정합니다. |
스캐너 보고서를 분석하는 방법은 다음 비디오를 시청하십시오.