다음을 통해 공유


IA-Connect 세션

IA-Connect 클라우드에서 온-프레미스 가상 머신 또는 Citrix 또는 Microsoft 원격 데스크톱 'RDS' 연결을 통해 RPA 기능을 추가하는 로봇 프로세스 자동화 'RPA' 플랫폼입니다. 환경, 세션, 파일 관리를 자동화하고 IA-Connect를 구성하기 위한 모듈입니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate (파워 오토메이트) Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Ultima Labs
URL https://www.ultima.com/ultima-labs
전자 메일 IAConnect@ultima.com
커넥터 메타데이터
게시자 Ultima Business
웹 사이트 https://www.ultima.com/ultima-labs
개인 정보 보호 정책 https://www.ultima.com/privacy-policy
카테고리 IT 작업; 생산력

IA-Connect Power Automate Cloud Flows의 RPA 기능을 온-프레미스 가상 머신 또는 Citrix 또는 RDS(Microsoft Remote Desktop) 연결을 통해 RPA 기능을 추가하는 RPA(로봇 프로세스 자동화) 플랫폼입니다. IA-Connect 커넥터는 800개 이상의 작업을 제공하므로 Power Automate 클라우드 흐름에서 직접 모든 유형의 온-프레미스 애플리케이션을 자동화할 수 있습니다. 모든 IA-Connect 작업은 Power Automate Cloud Flow에서 직접 사용할 수 있으며, 클라우드 기반 애플리케이션과 온-프레미스 애플리케이션 간에 쉽게 통합할 수 있으며, RPA 프로세스에서 기존 Power Automate 조건, 루프, 동적 콘텐츠, 식 및 예외 처리를 활용할 수 있습니다. IA-Connect 커넥터를 활용하면 흐름 실행 기록의 전체 실행 기록 및 감사 가능성도 제공하는 동시에 RPA 프로세스를 개발하기 위한 별도의 애플리케이션/콘솔/스튜디오가 필요하지 않습니다.

필수 조건

IA-Connect 커넥터를 사용하려면 IA-Connect 소프트웨어를 설치해야 합니다. 30일 동안 무료로 테스트할 수 있으며, IA-Connect 라이선스가 필요합니다.

IA-Connect 소프트웨어는 다음 두 가지 주요 구성 요소로 구성됩니다.

  • IA-Connect Orchestrator는 사용자 고유의 Azure 테넌트에서 호스트할 Azure WebApp입니다. 이는 하나 이상의 온-프레미스 또는 클라우드 기반 가상 머신에 대한 RPA 흐름의 라우팅 및 보안을 처리합니다.

  • 자동화하려는 소프트웨어에 액세스할 수 있는 가상 머신에 설치된 IA-Connect 에이전트 및 디렉터입니다. 또한 IA-Connect 에이전트는 Citrix 또는 Microsoft RDS(원격 데스크톱 서비스) 세션 내에서 실행할 수 있습니다. 여기서 RPA 명령은 실행을 위해 가상 채널을 원격 세션으로 전달합니다. IA-Connect 에이전트는 네트워크 공유에서 실행할 수 있으며 설치가 필요하지 않습니다.

사용 가능한 IA-Connect 커넥터

사용 가능한 IA-Connect 커넥터는 다음과 같습니다.

  • 동적 코드 IA-Connect
  • java IA-Connect
  • JML IA-Connect
  • IA-Connect 메인프레임
  • Microsoft Office IA-Connect
  • SAP GUI IA-Connect
  • IA-Connect 세션
  • IA-Connect 사용자 인터페이스 (UI)
  • IA-Connect 웹 브라우저

자격 증명을 가져오는 방법

라이선스를 받고 30일 무료 평가판을 시작하려면 웹 사이트(https://www.ultima.com/IA-Connect/Power-Automate)에 요청을 제출하세요.

평가판 요청이 수신되면 IA-Connect 소프트웨어 설정을 지원하고 평가판 라이선스를 제공하기 위해 제공된 이메일 주소를 통해 연락을 드립니다. 이 평가판은 완전한 기능을 갖춘 평가판이며 평가 기간 동안 사용자 환경 내의 모든 9개 IA-Connect 커넥터에서 800개의 작업을 테스트할 수 있습니다.

커넥터 시작

IA-Connect에 대한 평가판 요청을 제출한 후에는 설치 및 설치를 다루는 IA-Connect 소프트웨어 및 설명서가 포함된 ZIP 파일을 다운로드할 수 있습니다. 또한 필요에 따라 설치 프로세스를 통해 지원 및 지침을 제공하기 위해 연락을 드립니다.

Support

평가 기간 동안 Ultima Labs(IAConnect@ultima.com)에 문의하여 지원 및 지원을 받을 수 있습니다.

IA-Connect 라이선스를 구매하면 Ultima의 영국 기반 TSC(기술 서비스 센터)에서 맞춤형 교육 또는 지원을 위해 사용할 수 있는 지원 토큰을 받게 됩니다.

알려진 문제, 일반적인 오류 및 FAQ

기술 자료에는 알려진 문제, IA-Connect 커넥터를 사용할 때 발생할 수 있는 일반적인 오류 및 질문과 대답을 다루는 여러 문서가 포함되어 있습니다. 이 기능은 액세스할 https://support.ultima.com/ultimalabs 수 있으며 IA-Connect 평가판 및 IA-Connect 라이선스 구매 시 이러한 리소스에 액세스할 수 있는 계정이 제공됩니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
API 키 시큐어스트링 (보안 문자열) 이 API의 API 키 진실
IA-Connect Orchestrator 주소 문자열 HTTP(S) 구성 요소 없이 IA-Connect Orchestrator 주소 지정 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

CSV 텍스트를 컬렉션으로 가져오기

IA-Connect 에이전트가 컬렉션(테이블)으로 실행 중인 컴퓨터에서 CSV 파일을 반환합니다. CSV 파일에 대한 읽기 전용 액세스만 필요합니다.

CSV 파일에 쓰기

IA-Connect 에이전트가 실행 중인 컴퓨터에 CSV 파일을 만듭니다. CSV 파일은 컬렉션(테이블) 또는 JSON 형식의 테이블에서 만들어집니다.

HTTP 파일 다운로드

http(S)를 사용하여 IA-Connect 에이전트가 실행 중인 컴퓨터에 파일을 다운로드합니다.

IA-Connect 다음 홉 사용

다음 홉 세션에서 실행되는 IA-Connect 에이전트에 수신된 모든 이후 명령을 전달할 다음 홉을 사용하도록 설정합니다.

IA-Connect 다음 홉 사용 안 함

다음 홉 에이전트로 전달되는 것이 아니라 해당 명령을 수신하는 에이전트가 이후의 모든 명령을 처리하도록 다음 홉을 사용하지 않도록 설정합니다.

IA-Connect 다음 홉 세션이 연결되기를 기다립니다.

다음 홉 세션이 연결되고 IA-Connect 에이전트가 다음 홉 세션에서 실행될 때까지 기다립니다.

IA-Connect 디렉터 가동 시간 가져오기

이 IA-Connect 디렉터의 작동 시간(예: 디렉터가 실행된 시간)을 초 단위로 반환합니다.

IA-Connect 디렉터 로그 수준 가져오기

현재 IA-Connect 디렉터 로깅 수준을 반환합니다. 로깅 수준은 0에서 4로 설정됩니다. 0을 사용할 수 없습니다. 1은 가장 낮은 로그 수준(및 기본값)입니다. 4는 가장 높은 로그 수준입니다.

IA-Connect 디렉터 로그 수준 설정

IA-Connect 디렉터 로깅 수준을 지정된 값으로 설정합니다. 로깅 수준은 0에서 4로 설정됩니다. 0을 사용할 수 없습니다. 1은 가장 낮은 로그 수준(및 기본값)입니다. 4는 가장 높은 로그 수준입니다.

IA-Connect 디렉터 정보 가져오기

버전 번호와 Director 실행 파일 경로를 포함하여 IA-Connect Director의 속성을 반환합니다.

IA-Connect 라이선스 코드 설정

이전 스타일(7.0 및 7.1) 에이전트 도메인 라이선스를 IA-Connect 에이전트에 업로드합니다.

IA-Connect 라이선스 키 설정

라이선스 키를 사용하여 IA-Connect 에이전트에 라이선스를 부여합니다. 라이선스 문자열 또는 IA-Connect Orchestrator에 보관된 라이선스의 이름일 수 있습니다.

IA-Connect 명령 통계 다시 설정

IA-Connect 에이전트가 현재 세션에서 실행한 명령에 대해 현재 저장된 모든 통계를 다시 설정합니다.

IA-Connect 세션이 이름으로 존재하나요?

지정한 IA-Connect 디렉터 세션이 있는지를 반환합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다. 이 이름은 이전의 '연결' 작업에서 알 수 있습니다.

IA-Connect 에이전트 GUI 맨 위에 설정

IA-Connect 에이전트를 맨 위로 설정합니다. 즉, IA-Connect 에이전트는 항상 화면에 표시되며 다른 애플리케이션 창 뒤에 숨겨질 수 없습니다.

IA-Connect 에이전트 GUI 불투명도 설정

IA-Connect 에이전트의 불투명도를 1(표시)에서 0(투명)으로 설정합니다.

IA-Connect 에이전트 GUI 위치 설정

IA-Connect 에이전트 GUI의 화면 위치를 지정된 위치로 설정합니다.

IA-Connect 에이전트 GUI를 맨 앞으로 가져오기

IA-Connect 에이전트 GUI를 전면에 표시하여 화면에 표시합니다.

IA-Connect 에이전트 닫기

IA-Connect 에이전트를 닫습니다. IA-Connect 에이전트가 실행 중인 사용자 세션에는 영향을 주지 않습니다.

IA-Connect 에이전트 로그 가져오기

현재 IA-Connect 에이전트 로그를 파일로 반환하거나 내용을 읽고 출력 변수에서 반환합니다.

IA-Connect 에이전트 로그 수준 가져오기

현재 IA-Connect 에이전트 로깅 수준을 반환합니다. 로깅 수준은 1에서 4로 설정되며, 1은 가장 낮은 수준이고 4는 가장 높습니다.

IA-Connect 에이전트 로그 수준 설정

IA-Connect 에이전트 로깅 수준을 지정된 값으로 설정합니다(1은 가장 낮은 수준이고 4는 가장 높음).

IA-Connect 에이전트 명령 제한 시간 설정

IA-Connect 에이전트가 실행되는 각 명령에 사용할 명령 시간 제한을 설정합니다.

IA-Connect 에이전트 세션 정보 가져오기

IA-Connect 에이전트 사용자 세션에 대한 정보를 반환합니다.

IA-Connect 에이전트 전역 좌표 구성 가져오기

요소 위치(예: 마우스 검사 중)를 표시하고 마우스 위치를 계산하는 데 사용되는 IA-Connect 에이전트 전역 좌표계 구성의 구성을 검색합니다(예: 전역 마우스 작업을 수행할 때).

IA-Connect 에이전트 전역 좌표 구성 설정

요소 위치(예: 마우스 검사 중)를 표시하고 마우스 위치를 계산하는 데 사용되는 IA-Connect 에이전트 전역 좌표계를 구성합니다(예: 전역 마우스 작업을 수행할 때). 기본값은 최신 기능을 제공하지만 이 작업을 사용하여 이전 버전의 에이전트의 동작으로 되돌리거나 API가 다른 좌표계를 사용하도록 지정할 수 있습니다.

IA-Connect 에이전트 정보 가져오기

버전 번호와 에이전트 실행 파일의 경로를 포함하여 IA-Connect 에이전트의 속성을 반환합니다.

IA-Connect 에이전트 프로세스 수 가져오기

사용자 세션에서 현재 실행 중인 IA-Connect 에이전트의 인스턴스 수를 반환합니다. 이는 IA-Connect 에이전트의 여러 인스턴스가 실행 중인지 감지하는 데 유용합니다.

IA-Connect 에이전트 현재 라이선스 상태 가져오기

IA-Connect 에이전트의 현재 사용이 허가되었는지 여부와 라이선스가 있는 경우 라이선스의 속성을 반환합니다.

INI 파일의 변수 데이터 바꾸기

INI 파일에서 단일 변수를 업데이트합니다.

mouse_event 보정

지정된 픽셀 수만큼 마우스를 이동한 다음 새 마우스 위치를 읽어 mouse_event 메서드를 보정합니다.

Orchestrator 자동화 작업 가져오기

특정 오케스트레이터 자동화 작업을 검색합니다.

Orchestrator 자동화 작업 가져오기

고유한 작업 ID를 제공하여 특정 오케스트레이터 자동화 작업을 검색합니다.

Orchestrator 자동화 작업 삭제

고유한 작업 ID를 제공하여 특정 오케스트레이터 자동화 작업을 삭제합니다.

Orchestrator 자동화 작업 출력 데이터 설정

Orchestrator 자동화 작업에 대한 출력 데이터를 설정합니다. 작업을 완료하고 출력 데이터를 제공하려고 할 때 작업을 만든 프로세스에서 수집하려는 경우에 일반적으로 사용됩니다.

Orchestrator 자동화 작업 할당

선택한 Orchestrator 자동화 작업을 지정된 사용자 또는 그룹에 할당합니다. 이 할당은 이 자동화 작업(예: ServiceNow)과 연결된 원본 시스템에 전달되며, 추가 처리를 위해 다른 사용자 또는 사용자 그룹에 티켓을 전달하는 데 가장 일반적으로 사용됩니다. Orchestrator 자동화 작업이 원본에 연결되지 않은 경우 예외가 발생합니다.

Orchestrator 자동화 작업에 메모 추가

선택한 Orchestrator 자동화 작업에 메모를 추가합니다. 이 메모는 이 자동화 작업(예: ServiceNow)과 연결된 원본 시스템에 전달되며 티켓에 세부 정보를 추가하는 데 가장 일반적으로 사용됩니다. Orchestrator 자동화 작업이 원본에 연결되지 않은 경우 예외가 발생합니다.

Orchestrator 작업자 가용성 상태 가져오기

기본 오케스트레이터 상태를 검색합니다. 이를 사용하여 Orchestrator를 사용할 수 있고 응답하고 있는지 확인할 수 있습니다.

Orchestrator 작업자 가져오기

IA-Connect Orchestrator에 등록된 개별 작업자의 세부 정보 및 라이브 상태를 검색합니다.

Orchestrator 작업자 목록 가져오기

IA-Connect Orchestrator에 등록된 작업자 목록과 해당 라이브 상태를 검색합니다.

Orchestrator 작업자 유지 관리 모드 설정

IA-Connect Orchestrator에 정의된 IA-Connect 작업자를 유지 관리 모드로 전환하거나(따라서 흐름이 작업자에 할당되지 않음) 작업자를 유지 관리 모드에서 제외합니다.

Orchestrator 흐름 통계에서 마지막으로 실패한 작업 가져오기

작업이 실패한 경우 IA-Connect Orchestrator를 통해 작업자에게 전달된 마지막 작업의 세부 정보를 검색합니다. 이 작업은 오류 처리 중에 가장 일반적으로 사용됩니다.

Orchestrator에서 로그인 기록 가져오기

보고 목적으로 IA-Connect Orchestrator 로그인 기록을 반환합니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

Orchestrator에서 작업자 가용성 통계 가져오기

IA-Connect Orchestrator에서 작업자 가용성 통계를 반환합니다. 보고 목적으로 사용됩니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

Orchestrator에서 작업자 할당

IA-Connect Orchestrator에서 작업자를 할당합니다. 태그 또는 작업자 이름(또는 둘 다 또는 둘 다)으로 작업자를 요청할 수 있으므로 필요한 작업자를 보다 정확하게 선택할 수 있습니다. 작업자가 할당되면 흐름에 할당되고 작업 수행으로 보고됩니다. 오케스트레이터는 할당을 수행할 때 여전히 '지원되는 흐름 환경 ID', '지원되는 흐름 이름' 및 '지원되지 않는 흐름 이름'을 고려합니다. 여러 작업자가 검색과 일치하면 일반 부하 분산 규칙이 적용됩니다.

Orchestrator에서 작업자 흐름 사용 열 지도 가져오기

IA-Connect Orchestrator에서 작업자 흐름 사용량 일별 열 지도를 반환합니다. 보고 목적으로 사용됩니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

Orchestrator에서 제네릭 자격 증명 가져오기

IA-Connect Orchestrator에 저장된 제네릭 자격 증명을 검색합니다. 자격 증명은 사용자 이름, 암호, 호스트 이름, URL 및 기타 일반 데이터를 보유할 수 있습니다.

Orchestrator에서 흐름 통계 가져오기

IA-Connect Orchestrator에서 Flow 통계 목록을 반환합니다. 보고 목적으로 사용됩니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

PowerShell 프로세스 실행

PowerShell 프로세스를 시작하고, 디스크에서 기존 스크립트를 실행하거나, 실행할 스크립트의 콘텐츠를 제공합니다. 훨씬 더 강력하며 PowerShell 스크립트에서 출력의 데이터 테이블을 제공하는 'PowerShell 스크립트 실행' 작업을 대신 사용하는 것이 좋습니다. PowerShell 스크립트가 표준 출력 또는 표준 오류로 출력되거나(예: 테이블을 반환하는 대신 Write-Host 사용), PowerShell 7이 필요하거나, 대체 사용자로 Active Directory 작업을 실행 중이며 WinRM을 통한 CredSSP를 사용할 수 없는 경우 이 작업을 사용합니다.

RDS(원격 데스크톱 세션) 시작

RDP 시작 파일을 사용하여 RDS(원격 데스크톱 세션)를 시작합니다.

RDS(원격 데스크톱 세션) 시작 파일 만들기

원격 데스크톱 클라이언트 UI의 자동화를 요구하는 대신 지정된 매개 변수를 사용하여 원격 데스크톱 세션을 자동으로 시작하는 데 사용할 수 있는 RDS(원격 데스크톱 세션) 시작 파일을 만듭니다. RDS 시작 파일의 확장명은 '.rdp'이며 종종 RDP 파일이라고 합니다.

TCP 포트가 응답하고 있는지

네트워크 TCP 포트가 IA-Connect 에이전트의 연결 시도에 응답하는지 여부를 보고합니다. IA-Connect 에이전트가 실행 중인 컴퓨터의 TCP 포트(원격 호스트의 경우 'localhost' 입력) 또는 원격 컴퓨터의 TCP 포트일 수 있습니다. IA-Connect 에이전트가 TCP 포트에 성공적으로 연결되면 TCP 연결이 즉시 닫힙니다.

UnZIP 파일

ZIP 압축을 사용하여 압축된 파일의 압축을 해제합니다.

Web API에 메시지 보내기

웹 API에 메시지를 보내고 응답을 받습니다. 이는 모든 웹 API와 함께 사용할 수 있지만 일반적인 사용은 REST API입니다. IA-Connect 가상 머신(즉, 온-프레미스 리소스에 액세스하기 위해) 또는 Citrix 또는 Microsoft 원격 데스크톱 세션을 통해(예: 격리된 환경에서만 액세스 가능한 API에 액세스하기 위해) 웹 API로 메시지를 보낼 수 있도록 지원합니다.

ZIP에 파일 추가

파일을 압축 보관에 저장하여 파일을 압축합니다.

ZIP에 폴더 추가

폴더의 GP 파일을 ZIP 파일로 저장합니다(압축 보관 파일에 파일 저장).

가장 최근 IA-Connect 세션에 연결

가장 최근에 연결된 IA-Connect 디렉터 세션에 연결합니다(필요에 따라 지정된 형식의 경우). IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

계층 1 IA-Connect 세션에 연결

SOAP 및/또는 REST 메시지를 수신하는 디렉터의 IA-Connect 디렉터 세션에 연결합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

기본 프린터 가져오기

IA-Connect 에이전트 세션에서 사용자의 기본 프린터 이름을 가져옵니다.

기본 프린터 설정

IA-Connect 에이전트 세션에서 사용자의 기본 프린터를 설정합니다.

기존 Orchestrator 자동화 작업 연기

큐에 이미 있는 기존 Orchestrator 작업을 연기합니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이는 일반적으로 기존 작업을 다시 연기하는 데 사용됩니다(즉, 작업이 이전에 지연되었으므로 이제 다시 연기해야 합니다). 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우).

기존 Orchestrator 자동화 작업 연기

큐에 이미 있는 기존 Orchestrator 작업을 연기합니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이는 일반적으로 기존 작업을 다시 연기하는 데 사용됩니다(즉, 작업이 이전에 지연되었으므로 이제 다시 연기해야 합니다). 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우).

다른 모든 IA-Connect 에이전트를 종료합니다.

사용자 세션에서 현재 실행 중인 IA-Connect 에이전트의 다른 인스턴스를 종료합니다. 이렇게 하면 IA-Connect 에이전트의 인스턴스가 하나만 실행됩니다.

다음 Orchestrator 자동화 작업 가져오기

지정된 검색 조건과 일치하는 다음 Orchestrator 자동화 작업을 검색합니다. 지연 날짜에 도달한 '새로 만들기' 및 '지연' 작업만 검색할 수 있습니다. 보류 중인 작업은 검색되지 않습니다.

다음 홉 IA-Connect 디렉터 구성

더블 홉 시나리오에서 다음 홉 디렉터를 구성합니다. 이는 기본 IA-Connect 다음 홉 디렉터 설정이 적합하지 않은 경우에만 필요합니다.

다음 홉 IA-Connect 디렉터 설정 다시 설정

설정된 사용자 지정 IA-Connect Director 설정을 다시 설정하고 기본 설정을 복원합니다.

다음 홉 상태 IA-Connect 가져오기

이 명령을 수신하는 에이전트의 다음 홉 디렉터 상태를 보고합니다. 다음 홉을 사용하는 경우 해당 에이전트는 다음 홉 디렉터를 통해 명령을 다음 홉으로 전달합니다. 다음 홉을 사용하지 않도록 설정하면 해당 에이전트가 명령 자체를 처리합니다(기본값).

대체 IA-Connect 에이전트 실행

파일 위치에서 에이전트 실행 파일을 로드하여 대체 IA-Connect 에이전트(예: 이후 버전)를 실행합니다.

드라이브 목록 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 드라이브 목록을 반환합니다.

디렉터 클라이언트 유형 및 세션 정보 가져오기

계층 1 디렉터가 처리하는 로컬 또는 원격 세션의 세부 정보를 반환합니다.

디렉터리 만들기

IA-Connect 에이전트가 실행 중인 컴퓨터에 디렉터리(폴더)를 만듭니다.

디렉터리 삭제

IA-Connect 에이전트가 실행 중인 컴퓨터에서 디렉터리(폴더)를 삭제합니다.

디렉터리 제거

IA-Connect 에이전트가 실행 중인 컴퓨터에서 디렉터리(폴더)를 제거하여 디렉터리 내에 저장된 모든 파일을 제거합니다.

디렉터리가 존재하나요?

IA-Connect 에이전트가 실행 중인 컴퓨터에 디렉터리(폴더)가 있는지 여부에 대해 true 또는 false를 보고합니다.

디렉터리에 액세스할 수 있나요?

디렉터리(폴더)에 액세스할 수 있는지 여부와 권한이 IA-Connect 에이전트가 있는 컴퓨터에서 디렉터리에 대한 액세스를 제한하는지 여부를 반환합니다.

디렉터에서 보낸 대체 IA-Connect 에이전트 실행

IA-Connect Director에서 대체 에이전트를 업로드한 다음 대체 에이전트 실행 파일을 로드하여 대체 IA-Connect 에이전트(예: 이후 버전)를 실행합니다.

디스크 사용 가능한 공간 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터에서 지정된 디스크의 여유 공간을 반환합니다.

마우스 가운데 단추 아래쪽

IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 누르고 놓지 않습니다. 마우스를 놓려면 마우스 가운데 단추 위로 동작을 사용합니다.

마우스 가운데 단추 위로

IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 놓습니다.

마우스 가운데 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 클릭합니다.

마우스 가운데 홀드

IA-Connect 에이전트 사용자 세션의 마우스 가운데 단추를 지정된 시간(초)으로 유지합니다.

마우스 상대 이동

IA-Connect 에이전트 사용자 세션의 마우스를 현재 위치를 기준으로 지정된 픽셀 수만큼 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

마우스 승수 가져오기

IA-Connect 에이전트 사용자 세션에서 전역 마우스 승수를 검색합니다. 기본값은 (1, 1)이지만 '마우스 승수 설정' 작업으로 변경되었을 수 있습니다.

마우스 승수 설정

IA-Connect 에이전트 사용자 세션에서 전역 마우스 승수를 설정합니다. 원격 데스크톱 크기 조정에 문제가 발생하는 경우 개발 중에 유용할 수 있습니다.

마우스 오른쪽 단추 아래로

IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 누르고 놓지 않습니다. 마우스를 놓려면 마우스 오른쪽 단추 위로 동작을 사용합니다.

마우스 오른쪽 단추 위로

IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 놓습니다.

마우스 오른쪽 단추로 누르기

IA-Connect 에이전트 사용자 세션의 마우스 오른쪽 단추를 지정된 시간(초)으로 유지합니다.

마우스 오른쪽 단추로 좌표

IA-Connect 에이전트 사용자 세션의 지정된 좌표에서 마우스 오른쪽 단추를 지정된 시간(초)으로 유지합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

마우스 오른쪽 단추로 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 클릭합니다.

마우스 왼쪽 단추

IA-Connect 에이전트 사용자 세션의 왼쪽 마우스 단추를 지정된 시간(초)으로 유지합니다.

마우스 왼쪽 단추 아래로

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 누르고 놓지 않습니다. 마우스를 놓려면 마우스 왼쪽 단추 위로 동작을 사용합니다.

마우스 왼쪽 단추 위로

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 놓습니다.

마우스 왼쪽 두 번 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 두 번 클릭합니다.

마우스 왼쪽 좌표

IA-Connect 에이전트 사용자 세션의 지정된 좌표에 있는 왼쪽 마우스 단추를 지정된 시간(초)에 유지합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

마우스 왼쪽 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 클릭합니다.

마우스 이동 메서드 설정

현재 마우스 이동 메서드를 mouse_event 또는 setcursorpos로 설정합니다.

마우스 이동 방법 가져오기

현재 마우스 이동 메서드를 가져옵니다.

마우스 커서 위치 설정

IA-Connect 에이전트 사용자 세션의 마우스 커서를 지정된 위치로 설정합니다. setcursorpos API는 선택한 활성 마우스 이동 API에 관계없이 마우스를 이동하는 데 사용됩니다.

마우스 휠 회전

IA-Connect 에이전트 사용자 세션에서 마우스 휠(양수 또는 음의 노치)을 켭니다.

마우스 흔들기

마우스를 지정된 좌표 수만큼 앞뒤로 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다.

마우스를 좌표로 이동

IA-Connect 에이전트 사용자 세션의 마우스를 지정된 픽셀 좌표로 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

마지막 입력 정보 가져오기

IA-Connect 에이전트 사용자 세션에서 마지막 사용자 입력이 수신된 이후의 시간을 가져옵니다.

모든 IA-Connect 명령 통계 가져오기

IA-Connect 에이전트가 현재 세션에서 실행한 명령에 대해 현재 저장된 모든 통계를 반환합니다.

모든 오케스트레이터 자동화 작업 가져오기

필터와 일치하는 모든 Orchestrator 자동화 작업을 검색합니다.

부모 프로세스 ID 가져오기

지정된 프로세스 ID가 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스에 대한 부모 프로세스의 프로세스 ID를 반환합니다.

사각형 좌표 변환

사각형 픽셀 좌표를 가상에서 실제 또는 물리적 좌표로 변환합니다. 점을 변환하려면 오른쪽=왼쪽 및 아래쪽=위쪽을 설정하기만 하면 됩니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다. 가상 좌표는 DPI 크기 조정됩니다. 모든 디스플레이 디바이스의 기본 디스플레이 크기 조정이 100%경우 실제 좌표와 가상 좌표는 모두 동일합니다.

사용 가능한 IA-Connect 세션 가져오기

IA-Connect 디렉터 세션 목록을 검색합니다(로컬, Microsoft RDP 또는 Citrix ICA와 같이 IA-Connect 에이전트가 실행 중인 세션에 대한 사용 가능한 연결).

사용자 자격 증명에 쓰기

IA-Connect 에이전트 세션의 사용자 프로필에 있는 자격 증명에 사용자 이름과 암호를 기록하여 자격 증명이 없는 경우 해당 자격 증명을 만듭니다. Windows 제어판에서 자격 증명을 볼 수 있습니다.

사용자 자격 증명에서 읽기

IA-Connect 에이전트 세션의 사용자 프로필에 있는 자격 증명에서 사용자 이름과 암호를 읽습니다. Windows 제어판에서 자격 증명을 볼 수 있습니다. 사용자 이름과 암호는 모두 일반 자격 증명에서 검색할 수 있지만 Windows 자격 증명에서 사용자 이름만 검색할 수 있습니다.

사용자 자격 증명을 삭제합니다.

IA-Connect 에이전트 세션에서 사용자 프로필의 자격 증명을 삭제합니다. Windows 제어판에서 자격 증명을 볼 수 있습니다.

새 Orchestrator 자동화 작업 추가

흐름에서 모니터링할 수 있는 큐에 새 Orchestrator 자동화 작업을 추가합니다. 태스크는 즉시 실행할 준비가 되거나 나중에 실행되도록 지연될 수 있습니다.

새 Orchestrator 자동화 작업 추가

새 Orchestrator 자동화 작업을 추가하고 작업 ID를 받습니다. 작업이 외부 폴러 또는 Orchestrator 트리거에 의해 처리되는 경우 특정 작업 이름이 필요합니다. 이 작업은 '새 Orchestrator 자동화 작업 추가'(TasksAddNewTaskOperation)와는 다릅니다. 추측할 수 있는 작업 ID가 아니라 구단화할 수 없는 작업 ID로 응답한다는 점에서 다릅니다.

새 Orchestrator 지연 작업 추가

흐름에서 모니터링할 수 있는 큐에 새 Orchestrator 지연 작업을 추가합니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우).

새 Orchestrator 지연 작업 추가

새 Orchestrator 지연 작업을 추가하고 작업 ID를 받습니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우). 작업이 외부 폴러 또는 Orchestrator 트리거에 의해 처리되는 경우 특정 작업 이름이 필요합니다. 이 작업은 '새 Orchestrator 지연된 작업 추가'(TasksAddNewDeferral)와는 다릅니다. 추측 가능한 작업 ID 대신, 추측할 수 없는 작업 ID로 응답한다는 점에서 다릅니다.

세션 잠금 해제

IA-Connect 에이전트가 실행 중인 세션의 잠금을 해제합니다. 이렇게 하려면 자격 증명 공급자만 컴퓨터의 잠금을 해제할 수 있으므로 세션을 호스트하는 컴퓨터에 IA-Connect Unlocker 자격 증명 공급자를 설치해야 합니다.

세션 활성 유지 중지

IA-Connect 에이전트 사용자 세션이 활성 상태로 유지됩니다.

세션을 활성 상태로 유지

지정된 간격으로 마우스를 이동하여 세션이 유휴 상태가 되지 않도록 하여 IA-Connect 에이전트 사용자 세션을 활성 상태로 유지합니다.

세션이 잠겨 있는지

IA-Connect 에이전트가 실행 중인 세션이 잠겨 있는지 여부를 보고합니다.

스크린샷을 찍습니다.

IA-Connect 에이전트 사용자 세션의 스크린샷을 가져와 Base64로 인코딩된 문자열로 반환합니다.

암호 문자열 확장

IA-Connect 저장된 암호에 대한 참조가 포함된 입력 문자열을 수락하고 저장된 암호로 대체된 참조를 사용하여 해당 문자열을 반환합니다.

암호 생성

템플릿 형식으로 정의된 사전 단어, 숫자, 기호, 문자를 포함하는 암호를 생성합니다.

암호 키 보내기

특히 암호를 입력하기 위해 IA-Connect 에이전트 사용자 세션에 전역 키 누름을 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

암호 키 이벤트 보내기

낮은 수준의 키보드 드라이버를 사용하여 특히 암호를 입력하기 위해 IA-Connect 에이전트 사용자 세션에 전역 키 누름 이벤트를 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

에이전트 메모리에 암호 저장

저장된 암호를 지원하는 모든 작업에서 사용할 수 있는 에이전트 메모리(암호화됨)에 암호를 저장합니다. 암호는 메모리에만 저장되며 에이전트를 닫을 때 손실됩니다.

에이전트 메모리에서 암호 삭제

에이전트 메모리에 저장된 암호를 삭제하거나 에이전트에 저장된 모든 암호를 삭제합니다.

에이전트 스레드 가져오기

에이전트 스레드 목록을 반환합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 일반적으로 에이전트 스레드가 완료되고 해당 데이터가 검색되면 에이전트 스레드가 삭제되고 스레드 목록에 표시되지 않습니다.

에이전트 스레드 삭제

에이전트 스레드 또는 모든 에이전트 스레드를 삭제하여 스레드가 계속 실행 중인 경우 먼저 스레드를 종료(종료, 중단)합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 에이전트 스레드를 모니터링하는 프로세스 또는 흐름에는 '에이전트 스레드 ID가 없습니다.' 오류가 표시됩니다.

에이전트 스레드 종료

에이전트 스레드를 종료(종료, 중단)합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 에이전트 스레드는 삭제되지 않습니다('에이전트 스레드 삭제' 작업을 사용하여 스레드 삭제) 에이전트 스레드를 모니터링하는 프로세스 또는 흐름이 'IA-Connect 에이전트 스레드가 중단되었습니다.' 오류를 수신할 수 있도록 허용합니다.

에이전트 스레드가 성공적으로 완료되기를 기다립니다.

에이전트 스레드가 완료되고 필요에 따라 스레드 출력 데이터를 검색할 때까지 기다립니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 에이전트 스레드가 완료되었지만 실패하면 예외가 발생합니다.

에이전트 스레드의 상태 검색

에이전트 스레드의 상태를 검색하고 필요에 따라 스레드 출력 데이터를 검색합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다.

예외 발생

입력 예외가 비어 있지 않으면 지정된 메시지로 예외를 발생합니다. 이는 흐름(HTTP 400)에서 예외 메시지를 트리거하는 데 유용하며, 이전 작업에 오류가 있는 경우 오류 처리 단계에서 catch됩니다. 이 예외는 IA-Connect Orchestrator 흐름 실행 통계에 기록되지 않습니다.

오케스트레이터 상태 가져오기

기본 오케스트레이터 상태를 검색합니다. 이를 사용하여 Orchestrator를 사용할 수 있고 응답하고 있는지 확인할 수 있습니다.

오케스트레이터 일회성 비밀 만들기

일회성 비밀은 한 번 검색할 수 있는 비밀을 저장할 수 있는 기능을 제공합니다. 일반적으로 타사와 비밀을 공유하는 데 사용됩니다. Orchestrator UI, REST API 또는 흐름에서 일회성 비밀을 만들 수 있습니다.

오케스트레이터 자동화 작업 삭제

지연된 Orchestrator 자동화 작업을 삭제합니다.

오케스트레이터 자동화 작업 상태 변경

선택한 오케스트레이터 자동화 작업 상태 또는 기타 작업 속성을 변경합니다.

오케스트레이터 흐름 통계 결과 업데이트

IA-Connect Orchestrator에서 현재 작업자 흐름에 대한 결과 통계를 업데이트합니다. 일반적으로 보고 목적으로 사용되는 IA-Connect Orchestrator에서 Flow 통계의 최종 결과를 수정하는 데 사용됩니다. 현재 흐름에 대해서만 작동합니다(오케스트레이터는 흐름 실행 ID를 검색합니다). 다른 흐름의 통계는 수정할 수 없습니다.

원격 세션 로그오프

IA-Connect 에이전트가 실행 중인 원격 세션을 로그오프합니다.

원격 세션 연결 끊기

IA-Connect 에이전트가 원격 세션에서 실행 중인 경우 이 작업은 원격 세션의 연결을 끊습니다. 이는 로그오프와 동일하지 않으며 원격 세션이 연결이 끊긴 상태로 실행됩니다. 이 작업은 나중에 원격 세션에 다시 연결하고 새 세션을 시작하는 대신 동일한 상태에서 계속하려는 경우 사용할 수 있습니다. IA-Connect 에이전트가 로컬로 실행되는 경우 이 작업은 세션을 잠급히게 됩니다.

이름별 프로세스 수 가져오기

지정된 프로세스 이름을 가진 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스 수를 반환합니다.

이름으로 IA-Connect 세션 종료

지정된 IA-Connect 디렉터 세션이 있는 경우 종료합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다. 이 이름은 이전의 '연결' 작업에서 알 수 있습니다.

이름으로 IA-Connect 세션에 연결

이름으로 지정된 IA-Connect 디렉터 세션에 연결합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

이름으로 IA-Connect 세션이 닫히기를 기다립니다.

지정된 IA-Connect 디렉터 세션이 닫히기를 기다립니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다. 이 이름은 이전의 '연결' 작업에서 알 수 있습니다.

인덱스별로 IA-Connect 세션에 연결

인덱스로 지정된 IA-Connect 디렉터 세션에 연결합니다(예: 첫 번째 Citrix ICA 세션에 연결). IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

잠금 세션

IA-Connect 에이전트가 실행 중인 세션을 잠깁니다.

저장된 암호 가져오기

이전에 생성되었거나 저장된 암호를 검색합니다.

제네릭 IA-Connect 에이전트 명령 실행

인수를 JSON으로 전달하고 출력 데이터를 JSON으로 반환하는 제네릭 IA-Connect 에이전트 명령을 실행합니다. 디렉터 및 검사기에서 에이전트보다 이전 버전이므로 명령을 이해하지 못하는 경우 에이전트 명령을 실행하는 데 사용됩니다.

좌표 간에 마우스 오른쪽 끌기

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스 오른쪽 단추 끌기를 수행합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

좌표 간에 마우스 왼쪽 끌기

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스 왼쪽 단추를 끕니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

좌표 간에 마우스 이동

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스를 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

좌표 사이에 마우스 가운데 끌기

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스 가운데 단추 끌기를 수행합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

좌표에서 마우스 가운데 고정

지정된 시간(초)동안 IA-Connect 에이전트 사용자 세션의 지정된 좌표에 마우스 가운데 단추를 유지합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

좌표에서 마우스 가운데 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

좌표에서 마우스 오른쪽 단추 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

좌표에서 마우스 왼쪽 두 번 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 두 번 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

좌표에서 마우스 왼쪽 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

좌표에서 픽셀 색 가져오기

지정된 좌표에서 픽셀의 RGB 색을 반환합니다.

컴퓨터 도메인 가져오기

IA-Connect 에이전트 사용자 세션을 실행하는 컴퓨터의 도메인을 반환합니다.

컴퓨터 이름 가져오기

IA-Connect 에이전트 사용자 세션을 실행하는 컴퓨터의 이름을 반환합니다.

클라이언트 호스트 이름 가져오기

IA-Connect Director가 실행 중인 클라이언트의 호스트 이름을 반환합니다.

클라이언트에서 서버로 파일 복사

로컬 컴퓨터(IA-Connect 디렉터 실행)에서 원격 컴퓨터(IA-Connect 에이전트 실행)로 파일을 복사합니다.

클립보드 가져오기

IA-Connect 에이전트 사용자 세션에서 클립보드의 현재 콘텐츠를 가져옵니다.

클립보드 설정

IA-Connect 에이전트 사용자 세션에서 클립보드의 콘텐츠를 설정합니다.

클립보드 지우기

IA-Connect 에이전트 사용자 세션에서 클립보드의 내용을 지웁니다.

클립보드에 파일 복사

지정된 로컬 파일을 IA-Connect 에이전트 사용자 세션의 클립보드에 복사합니다.

키 보내기

전역 키 누름을 IA-Connect 에이전트 사용자 세션으로 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

키 이벤트 보내기

하위 수준 키보드 드라이버를 사용하여 전역 키 누름 이벤트를 IA-Connect 에이전트 사용자 세션으로 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

텍스트 파일 쓰기

IA-Connect 에이전트가 실행 중인 컴퓨터에 텍스트 파일을 만들고 파일에 텍스트를 씁니다.

파일 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 있는 파일 목록(CSV 패턴 목록과 일치)을 반환합니다.

파일 보안 권한 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일에 대해 현재 설정된 사용 권한 목록을 반환합니다.

파일 보안에서 ID 제거

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일에 대한 보안 권한에서 ID(예: 사용자, 그룹 또는 컴퓨터)를 제거합니다.

파일 복사

IA-Connect 에이전트가 실행 중인 컴퓨터에 파일을 복사합니다.

파일 삭제

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일을 삭제합니다.

파일 삭제

IA-Connect 에이전트가 실행 중인 컴퓨터의 패턴과 일치하는 지정된 폴더 내의 파일을 삭제합니다.

파일 이동

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일을 이동합니다.

파일 콘텐츠를 Base64로 가져오기

지정된 파일의 내용을 Base64 형식으로 검색합니다. 이 형식은 API를 통한 전송에 적합하고 원래 텍스트 또는 이진 형식으로 쉽게 다시 변환됩니다.

파일 크기 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일의 크기(바이트)를 반환합니다.

파일에 권한 추가

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일에 권한을 추가합니다.

파일에 소유자 설정

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일 소유자를 설정합니다.

파일에서 모든 텍스트 읽기

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일의 텍스트 내용을 읽습니다.

파일이 존재하나요?

IA-Connect 에이전트가 실행 중인 컴퓨터에 파일이 있는지 여부에 대해 true 또는 false를 보고합니다.

폴더 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 지정된 폴더 내에 있는 모든 하위 폴더를 반환합니다.

폴더 보안 권한 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 현재 설정된 사용 권한 목록을 반환합니다.

폴더 보안 상속 사용

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에서 보안 상속을 사용하도록 설정합니다.

폴더 보안 상속 중단

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에서 보안 상속을 중단합니다.

폴더 보안에서 ID 제거

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 대한 보안 권한에서 ID(예: 사용자, 그룹 또는 컴퓨터)를 제거합니다.

폴더에 사용 권한 추가

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 사용 권한을 추가합니다.

폴더에 소유자 설정

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 소유자를 설정합니다.

프로세스 ID 명령줄 속성 가져오기

지정된 프로세스 ID가 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스에 대한 명령줄 속성을 반환합니다.

프로세스 ID 종료

지정된 프로세스 ID가 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스를 종료합니다. 프로세스 ID는 고유하므로 하나의 프로세스만 ID와 일치할 수 있습니다. 프로세스 ID는 동적이며 애플리케이션을 시작할 때마다 다릅니다.

프로세스 ID별 프로세스 가져오기

지정된 프로세스 ID가 있는 프로세스가 IA-Connect 에이전트 사용자 세션에서 실행되고 있는지 여부를 반환합니다. 프로세스 ID는 고유하므로 하나의 프로세스만 ID와 일치할 수 있습니다. 프로세스 ID는 동적이며 애플리케이션을 시작할 때마다 다릅니다.

프로세스 가져오기

IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스 목록을 반환합니다. 필요에 따라 프로세스 이름을 제공하여 필터링할 수 있습니다.

프로세스 실행

프로세스, 명령 또는 애플리케이션을 시작합니다.

프로세스 종료

지정된 프로세스 이름이 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 모든 프로세스를 종료합니다.

프린터 목록 가져오기

IA-Connect 에이전트 세션에서 사용 가능한 모든 프린터 목록을 반환합니다.

현재 마우스 좌표 가져오기

setcursorpos API를 사용하여 IA-Connect 에이전트 사용자 세션에서 현재 마우스 커서 위치를 가져옵니다.

화면 읽기 프로그램 설정

IA-Connect 에이전트 사용자 세션에서 화면 읽기 프로그램을 사용하거나 사용하지 않도록 설정합니다.

화면 읽기 프로그램을 사용할 수 있는지 확인

IA-Connect 에이전트 사용자 세션에서 화면 읽기 프로그램을 사용하도록 설정했는지 여부를 반환합니다.

화면 해상도 가져오기

IA-Connect 에이전트 사용자 세션의 화면 해상도를 반환합니다. 실제 데스크톱 또는 랩톱에서 실행되는 IA-Connect 로컬 에이전트의 경우 모든 디스플레이 디바이스 및 크기 조정에 대한 정보를 제공합니다. 가상 머신에서 가상 머신이 여러 디스플레이를 표시하도록 구성되지 않은 한 일반적으로 하나의 디스플레이만 보고됩니다(일반적이지 않음). 원격 세션에서는 일반적으로 하나의 가상 디스플레이를 만들기 때문에 해당 디스플레이가 여러 로컬 디스플레이에 걸쳐 있더라도 일반적으로 하나의 디스플레이만 보고됩니다.

화면에 사각형 그리기

화면 좌표 또는 화면 좌표를 보고하는 작업의 출력을 식별하는 데 도움이 되도록 화면에 사각형을 그립니다. 사각형은 5초 후에 자동으로 제거됩니다.

환경 변수 확장

IA-Connect 에이전트 사용자 세션에서 환경 변수(예: %USERPROFILE% 또는 %TEMP%)가 포함된 문자열을 확장합니다.

환경 정보 가져오기

IA-Connect 에이전트 사용자 세션이 실행되는 환경에 대한 정보를 반환합니다.

흐름 결과 JSON에서 실패한 작업 오류 메시지 가져오기

하나 이상의 흐름 결과() 식의 JSON 출력을 역직렬화하고 실패한 작업에서 첫 번째 찾은 오류 메시지를 검색합니다. 오류 메시지는 다양한 형식으로 JSON에 저장할 수 있습니다. 이 작업은 알려진 형식을 처리하고 첫 번째 오류 메시지를 반환합니다.

흐름을 완료로 표시

흐름을 완료로 표시합니다. 그러면 IA-Connect Orchestrator에 할당된 작업자 컴퓨터를 다른 흐름을 처리할 수 있음을 알릴 수 있습니다.

CSV 텍스트를 컬렉션으로 가져오기

IA-Connect 에이전트가 컬렉션(테이블)으로 실행 중인 컴퓨터에서 CSV 파일을 반환합니다. CSV 파일에 대한 읽기 전용 액세스만 필요합니다.

매개 변수

Name 필수 형식 Description
CSV 파일 경로
CSVFilePath True string

CSV 파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

첫 번째 줄은 머리글입니다.
FirstLineIsHeader boolean

CSV 파일의 첫 번째 줄이 머리글 행인가요?

머리글 자르기
TrimHeaders boolean

선행 또는 후행 공백을 제거하기 위해 헤더를 잘라야 하나요?

빈 행 허용
AllowBlankRows boolean

true(기본값)로 설정하면 CSV 데이터의 완전히 빈 행이 허용되고 빈 행으로 반환됩니다. false로 설정하면 반환된 데이터에서 완전히 비어 있는 행이 제거됩니다(파일은 그대로 유지됨).

필요한 경우 열 확장
ExtendColumnsIfRequired boolean

true로 설정하고 일치하는 열 머리글(예: 머리글 행보다 더 많은 셀이 있는 행)이 없는 데이터에 셀이 있는 경우 열 머리글은 이름 Column_N(여기서 N은 열 인덱스)로 자동으로 만들어집니다. false(기본값)로 설정하면 행에 일치하는 열이 없는 데이터가 포함된 경우 예외가 발생합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
CSV 데이터 JSON
CSVDataJSON string

CSV 파일의 내용(JSON 형식)입니다.

CSV 파일에 쓰기

IA-Connect 에이전트가 실행 중인 컴퓨터에 CSV 파일을 만듭니다. CSV 파일은 컬렉션(테이블) 또는 JSON 형식의 테이블에서 만들어집니다.

매개 변수

Name 필수 형식 Description
속성
Properties object
입력 테이블 JSON
InputTableJSON string

CSV 파일에 쓸 데이터 테이블(JSON 형식)입니다.

출력 CSV 파일 경로
CSVFilePath True string

CSV 파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

출력 인코딩
OutputEncoding string

CSV 파일에 쓸 때 사용할 텍스트 인코딩 형식입니다. 지원되는 인코딩은 UTF8, UTF7, 유니코드 및 ASCII입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
WriteCollectionToCSVFileResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

HTTP 파일 다운로드

http(S)를 사용하여 IA-Connect 에이전트가 실행 중인 컴퓨터에 파일을 다운로드합니다.

매개 변수

Name 필수 형식 Description
URL 다운로드
DownloadURL True string

HTTP 또는 HTTPS 다운로드 URL입니다.

파일 경로 저장
SaveFilename string

파일 이름 저장의 전체 경로입니다. 이 필드가 비어 있고 '내용을 문자열로 반환'을 True로 지정한 경우 파일이 컴퓨터에 저장되지 않습니다.

기존 파일 덮어쓰기
OverwriteExistingFile boolean

'파일 경로 저장' 입력에 지정된 이름의 파일이 이미 있는 경우 덮어써야 하나요?

통과 인증
PassthroughAuthentication boolean

사용자의 자격 증명을 웹 서버에 전달해야 하나요? 일반적으로 내부 인트라넷 사이트에만 사용됩니다.

사용자 에이전트
UserAgent string

이렇게 하면 웹 페이지에 보고된 사용자 에이전트를 설정할 수 있습니다. 일반적으로 이 작업은 필요하지 않으며 웹 페이지에 특정 에이전트 문자열이 필요한 경우에만 변경해야 합니다.

Accept
Accept string

이 매개 변수는 지원되는 콘텐츠 형식을 지정합니다. 다운로드하는 콘텐츠에 다른 콘텐츠 형식이 필요한 경우에만 변경해야 합니다.

TLS10 지원
SupportTLS10 boolean

TLS 1.0 암호화 프로토콜을 지원하려면 True로 설정합니다.

TLS11 지원
SupportTLS11 boolean

TLS 1.1 암호화 프로토콜을 지원하려면 True로 설정합니다.

TLS12 지원
SupportTLS12 boolean

TLS 1.2 암호화 프로토콜을 지원하려면 True로 설정합니다.

deflate 자동 압축 해제
AutoDecompressDeflate boolean

일부 웹 콘텐츠는 'deflate' 압축을 사용하여 압축된 상태로 반환됩니다. 이 값을 True로 설정하면 웹 서버에 'deflate'가 지원되며, 이 압축을 사용하여 콘텐츠를 보내면 자동으로 압축이 해제됩니다.

GZip 자동 압축 풀기
AutoDecompressGZIP boolean

일부 웹 콘텐츠는 'GZIP' 압축을 사용하여 압축된 상태로 반환됩니다. 이 값을 True로 설정하면 웹 서버에 'GZIP'가 지원되며, 이 압축을 사용하여 콘텐츠를 보내면 자동으로 압축이 해제됩니다.

콘텐츠를 문자열로 반환
ReturnContentsAsString boolean

파일 내용을 문자열로 반환해야 하나요?

콘텐츠 인코딩 반환
ReturnContentEncoding string

다운로드한 콘텐츠의 인코딩입니다. 이는 '콘텐츠를 문자열로 반환'이 True이고 다운로드한 콘텐츠의 인코딩을 정의하여 올바르게 해석할 수 있는 경우에만 사용됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
파일 콘텐츠 다운로드
DownloadFileContents string

다운로드한 파일의 내용입니다.

IA-Connect 다음 홉 사용

다음 홉 세션에서 실행되는 IA-Connect 에이전트에 수신된 모든 이후 명령을 전달할 다음 홉을 사용하도록 설정합니다.

매개 변수

Name 필수 형식 Description
다음 홉 디렉터 주소
NextHopDirectorAddress string

다음 홉 IA-Connect 디렉터가 '다음 홉 디렉터 주소는 localhost', '다음 홉 디렉터 주소는 호스트 이름', '다음 홉 디렉터 주소는 FQDN' 또는 '다음 홉 디렉터 주소는 파이프로 명명됨' 매개 변수가 true로 설정된 경우 명령을 전달하기 위한 선택적 주소입니다.

다음 홉 디렉터 TCP 포트
NextHopDirectorTCPPort integer

다음 홉 디렉터가 수신 대기 중인 TCP 포트(에이전트가 실행 중인 컴퓨터의 디렉터)입니다.

다음 홉 디렉터는 HTTPS를 사용합니다.
NextHopDirectorUsesHTTPS boolean

다음 홉 디렉터가 HTTPS를 사용하는 경우 True로 설정하거나, 그렇지 않은 경우 false로 설정합니다.

다음 홉 디렉터 주소는 localhost입니다.
NextHopDirectorAddressIsLocalhostname boolean

에이전트를 기준으로 하는 다음 홉 디렉터 주소는 'localhost'입니다.

다음 홉 디렉터 주소는 호스트 이름입니다.
NextHopDirectorAddressIsHostname boolean

다음 홉 디렉터 주소는 에이전트(예: 에이전트 및 디렉터를 실행하는 컴퓨터)를 실행하는 컴퓨터의 호스트 이름입니다.

다음 홉 디렉터 주소는 FQDN입니다.
NextHopDirectorAddressIsFQDN boolean

다음 홉 디렉터 주소는 에이전트를 실행하는 컴퓨터(예: 에이전트 및 디렉터를 실행하는 컴퓨터)의 FQDN(정규화된 도메인 이름)입니다.

세션 ID별 다음 홉 디렉터 TCP 포트 증가
IncrementNextHopDirectorTCPPortBySessionId boolean

다음 홉 디렉터 TCP 포트가 고유한지 확인하려면(동일한 호스트에서 다음 홉을 사용하는 병렬 세션이 여러 개 있는 경우) 세션 ID를 다음 홉 디렉터 TCP 포트에 추가할 수 있습니다.

사용하도록 설정하기 전에 사용 안 함
DisableBeforeEnable boolean

다시 사용하도록 설정하기 전에 이중 홉을 사용하지 않도록 설정해야 하나요(현재 활성화된 경우)? true(기본값)로 설정하면 새 이중 홉 사용 지침이 이전 명령을 대체합니다. false로 설정하면 이중 홉 IA-Connect 에이전트가 지침을 수신하므로 트리플 홉이 활성화됩니다.

다음 홉 디렉터가 실행 중인지 확인
CheckNextHopDirectorIsRunning boolean

다음 홉에는 에이전트와 동일한 컴퓨터에서 실행 중인 IA-Connect 디렉터가 필요합니다. 이 설정이 true이면 에이전트는 설명된 대로 다음 홉 디렉터가 실행 중인지 확인하고 다음 홉 디렉터가 실행되고 있지 않으면 다음 홉을 사용하도록 설정하지 못합니다. 이 설정이 false이면 에이전트는 검사를 수행하지 않고 단순히 다음 홉을 사용하도록 설정합니다.

다음 홉 에이전트가 실행 중인지 확인
CheckNextHopAgentIsRunning boolean

다음 홉에는 에이전트와 동일한 컴퓨터에서 실행 중인 IA-Connect 디렉터와 다음 홉 세션에서 실행 중인 IA-Connect 에이전트가 필요합니다. 이 설정이 true이면 에이전트는 설명된 대로 다음 홉 에이전트가 실행 중인지 확인하고 다음 홉 에이전트가 실행되고 있지 않으면 다음 홉을 사용하도록 설정하지 못합니다. 이 설정이 false이면 에이전트는 검사를 수행하지 않고 단순히 다음 홉을 사용하도록 설정합니다.

다음 홉 디렉터 주소가 파이프로 명명되었습니다.
NextHopDirectorAddressIsNamedPipe boolean

에이전트를 기준으로 하는 다음 홉 디렉터 주소는 TCP/IP 웹 서비스 대신 명명된 파이프를 사용합니다. 이는 첫 번째 홉에서 TCP/IP 포트를 사용하지 않도록 하는 기본값입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
활성 다음 홉 디렉터 주소
ActiveNextHopDirectorAddress string

사용 중인 경우 활성 다음 홉 디렉터의 주소입니다.

활성 다음 홉 디렉터 TCP 포트
ActiveNextHopDirectorTCPPort integer

사용 중인 경우 활성 다음 홉 디렉터의 TCP 포트입니다.

활성 다음 홉 디렉터가 HTTPS를 사용합니다.
ActiveNextHopDirectorUsesHTTPS boolean

활성 다음 홉 디렉터가 HTTPS를 사용하는 경우 true를 반환합니다.

활성 다음 홉 디렉터 URL
ActiveNextHopDirectorURL string

활성 다음 홉 디렉터의 URL입니다.

IA-Connect 다음 홉 사용 안 함

다음 홉 에이전트로 전달되는 것이 아니라 해당 명령을 수신하는 에이전트가 이후의 모든 명령을 처리하도록 다음 홉을 사용하지 않도록 설정합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 다음 홉 세션이 연결되기를 기다립니다.

다음 홉 세션이 연결되고 IA-Connect 에이전트가 다음 홉 세션에서 실행될 때까지 기다립니다.

매개 변수

Name 필수 형식 Description
다음 홉 디렉터 주소
NextHopDirectorAddress string

다음 홉 IA-Connect 디렉터가 '다음 홉 디렉터 주소는 localhost', '다음 홉 디렉터 주소는 호스트 이름', '다음 홉 디렉터 주소는 FQDN' 또는 '다음 홉 디렉터 주소는 파이프로 명명됨' 매개 변수가 true로 설정된 경우 명령을 전달하기 위한 선택적 주소입니다.

다음 홉 디렉터 TCP 포트
NextHopDirectorTCPPort integer

다음 홉 디렉터가 수신 대기 중인 TCP 포트(에이전트가 실행 중인 컴퓨터의 디렉터)입니다.

다음 홉 디렉터는 HTTPS를 사용합니다.
NextHopDirectorUsesHTTPS boolean

다음 홉 디렉터가 HTTPS를 사용하는 경우 True로 설정하거나, 그렇지 않은 경우 false로 설정합니다.

다음 홉 디렉터 주소는 localhost입니다.
NextHopDirectorAddressIsLocalhostname boolean

에이전트를 기준으로 하는 다음 홉 디렉터 주소는 'localhost'입니다.

다음 홉 디렉터 주소는 호스트 이름입니다.
NextHopDirectorAddressIsHostname boolean

다음 홉 디렉터 주소는 에이전트(예: 에이전트 및 디렉터를 실행하는 컴퓨터)를 실행하는 컴퓨터의 호스트 이름입니다.

다음 홉 디렉터 주소는 FQDN입니다.
NextHopDirectorAddressIsFQDN boolean

다음 홉 디렉터 주소는 에이전트를 실행하는 컴퓨터(예: 에이전트 및 디렉터를 실행하는 컴퓨터)의 FQDN(정규화된 도메인 이름)입니다.

세션 ID별 다음 홉 디렉터 TCP 포트 증가
IncrementNextHopDirectorTCPPortBySessionId boolean

다음 홉 디렉터 TCP 포트가 고유한지 확인하려면(동일한 호스트에서 다음 홉을 사용하는 병렬 세션이 여러 개 있는 경우) 세션 ID를 다음 홉 디렉터 TCP 포트에 추가할 수 있습니다.

대기 시간(초)
SecondsToWait double

다음 홉 세션이 연결되기를 기다리는 최대 시간(초)입니다.

다음 홉 디렉터 주소가 파이프로 명명되었습니다.
NextHopDirectorAddressIsNamedPipe boolean

에이전트를 기준으로 하는 다음 홉 디렉터 주소는 TCP/IP 웹 서비스 대신 명명된 파이프를 사용합니다. 이는 첫 번째 홉에서 TCP/IP 포트를 사용하지 않도록 하는 기본값입니다.

기존 다음 홉 사용 안 함
DisableExistingNextHop boolean

다시 사용하도록 설정하기 전에 이중 홉을 사용하지 않도록 설정해야 하나요(현재 활성화된 경우)? true(기본값)로 설정하면 새 이중 홉 사용 지침이 이전 명령을 대체합니다. false로 설정하면 이중 홉 IA-Connect 에이전트가 지침을 수신하므로 트리플 홉이 활성화됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
연결된 다음 홉 세션
NextHopSessionConnected boolean

대기할 최대 시간을 초과하기 전에 연결된 다음 홉 세션이 초과되면 true를 반환합니다.

IA-Connect 디렉터 가동 시간 가져오기

이 IA-Connect 디렉터의 작동 시간(예: 디렉터가 실행된 시간)을 초 단위로 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
디렉터 가동 시간(초)
UpTimeInSeconds integer

IA-Connect 디렉터가 실행된 시간(초)입니다.

IA-Connect 디렉터 로그 수준 가져오기

현재 IA-Connect 디렉터 로깅 수준을 반환합니다. 로깅 수준은 0에서 4로 설정됩니다. 0을 사용할 수 없습니다. 1은 가장 낮은 로그 수준(및 기본값)입니다. 4는 가장 높은 로그 수준입니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
로그 수준
LoggingLevel integer

IA-Connect 디렉터의 현재 로깅 수준입니다.

IA-Connect 디렉터 로그 파일 이름
IAConnectDirectorLogFilename string

IA-Connect 디렉터 로그 파일 이름입니다. 이 값은 파일 이름에 시작 날짜와 시간이 있으므로 각 시작에 대해 고유합니다.

IA-Connect 디렉터 로그 수준 설정

IA-Connect 디렉터 로깅 수준을 지정된 값으로 설정합니다. 로깅 수준은 0에서 4로 설정됩니다. 0을 사용할 수 없습니다. 1은 가장 낮은 로그 수준(및 기본값)입니다. 4는 가장 높은 로그 수준입니다.

매개 변수

Name 필수 형식 Description
로그 수준
LoggingLevel True integer

IA-Connect 디렉터를 설정해야 하는 로깅 수준입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 디렉터 정보 가져오기

버전 번호와 Director 실행 파일 경로를 포함하여 IA-Connect Director의 속성을 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
IA-Connect Director 버전
IAConnectDirectorVersion string

IA-Connect 디렉터의 전체 버전 번호입니다.

DotNet CLR 버전
DotNetCLRVersion string

DotNet CLR(공용 언어 런타임) 버전입니다.

IA-Connect 디렉터가 사용자 이름으로 실행됨
IAConnectDirectorRunAsUsername string

IA-Connect 디렉터가 실행 중인 사용자 세션의 사용자 이름입니다.

IA-Connect Director가 userdomain으로 실행됨
IAConnectDirectorRunAsUserdomain string

IA-Connect 디렉터가 실행 중인 사용자 세션의 사용자 도메인입니다.

IA-Connect 디렉터 경로
IAConnectDirectorPath string

IA-Connect 디렉터 실행 파일의 전체 경로입니다.

IA-Connect 디렉터는 64비트 프로세스입니다.
IAConnectDirectorIs64bitProcess boolean

IA-Connect Director가 64비트 프로세스인 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

IA-Connect 디렉터 릴리스 버전
IAConnectDirectorReleaseVersion string

IA-Connect Director 릴리스 버전(예: 8.0).

IA-Connect 디렉터 로그 파일 이름
IAConnectDirectorLogFilename string

IA-Connect 디렉터 로그 파일 이름입니다. 이 값은 파일 이름에 시작 날짜와 시간이 있으므로 IA-Connect 디렉터의 각 시작에 대해 고유합니다.

IA-Connect 라이선스 코드 설정

이전 스타일(7.0 및 7.1) 에이전트 도메인 라이선스를 IA-Connect 에이전트에 업로드합니다.

매개 변수

Name 필수 형식 Description
고객 NetBIOS 도메인 이름
CustomerNETBIOSDomainName True string

IA-Connect 에이전트가 실행 중인 컴퓨터의 NetBIOS 도메인 이름입니다.

고객 표시 이름
CustomerDisplayName True string

IA-Connect 에이전트의 제목 표시줄에 표시할 고객 이름입니다.

공급업체 이름
VendorName True string

IA-Connect 공급업체 이름입니다.

라이선스 만료 날짜
LicenseExpiryDate True string

IA-Connect 라이선스의 만료 날짜입니다.

활성화 코드
ActivationCode True string

IA-Connect 라이선스에 대한 활성화 코드입니다.

레지스트리에 저장
StoreInRegistry boolean

IA-Connect 라이선스를 레지스트리에 임시로 저장해야 하나요? 이렇게 하면 에이전트가 닫히고 다시 시작되더라도 IA-Connect 에이전트가 사용자 세션 기간 동안 라이선스가 부여됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 라이선스 키 설정

라이선스 키를 사용하여 IA-Connect 에이전트에 라이선스를 부여합니다. 라이선스 문자열 또는 IA-Connect Orchestrator에 보관된 라이선스의 이름일 수 있습니다.

매개 변수

Name 필수 형식 Description
라이선스 키
LicenseString True string

IA-Connect 라이선스 키 문자열 또는 IA-Connect Orchestrator에 보관된 라이선스의 이름입니다(IA-Connect Orchestrator를 통해 IA-Connect 제어하는 경우).

레지스트리에 저장
StoreInRegistry boolean

IA-Connect 라이선스를 레지스트리에 임시로 저장해야 하나요? 이렇게 하면 에이전트가 닫히고 다시 시작되더라도 IA-Connect 에이전트가 사용자 세션 기간 동안 라이선스가 부여됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
라이선스가 만료될 때까지의 일
DaysUntilLicenseExpires integer

IA-Connect 라이선스가 만료될 때까지 남은 일 수입니다.

IA-Connect 명령 통계 다시 설정

IA-Connect 에이전트가 현재 세션에서 실행한 명령에 대해 현재 저장된 모든 통계를 다시 설정합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 세션이 이름으로 존재하나요?

지정한 IA-Connect 디렉터 세션이 있는지를 반환합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다. 이 이름은 이전의 '연결' 작업에서 알 수 있습니다.

매개 변수

Name 필수 형식 Description
IA-Connect 세션 이름
IAConnectSessionName True string

확인할 IA-Connect 세션의 이름입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
IA-Connect 세션이 있음
IAConnectSessionExists boolean

지정된 이름의 세션이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

IA-Connect 에이전트 GUI 맨 위에 설정

IA-Connect 에이전트를 맨 위로 설정합니다. 즉, IA-Connect 에이전트는 항상 화면에 표시되며 다른 애플리케이션 창 뒤에 숨겨질 수 없습니다.

매개 변수

Name 필수 형식 Description
최상위
TopMost boolean

IA-Connect 에이전트를 최상위(true)로 설정해야 하나요? 아니면 최상위 에이전트를 사용하지 않도록 설정해야 하나요(false)?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 에이전트 GUI 불투명도 설정

IA-Connect 에이전트의 불투명도를 1(표시)에서 0(투명)으로 설정합니다.

매개 변수

Name 필수 형식 Description
불투명도
Opacity True double

설정할 불투명도 값으로, 1(표시)에서 0(투명) 사이입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 에이전트 GUI 위치 설정

IA-Connect 에이전트 GUI의 화면 위치를 지정된 위치로 설정합니다.

매개 변수

Name 필수 형식 Description
X
X True integer

에이전트를 픽셀 단위로 설정하는 X 좌표입니다.

Y
Y True integer

에이전트를 픽셀 단위로 설정할 Y 좌표입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 에이전트 GUI를 맨 앞으로 가져오기

IA-Connect 에이전트 GUI를 전면에 표시하여 화면에 표시합니다.

매개 변수

Name 필수 형식 Description
포커스
Focus boolean

IA-Connect 에이전트 GUI를 집중해야 하나요?

전역 왼쪽 마우스 클릭
GlobalLeftMouseClick boolean

에이전트를 맨 앞으로 가져오는 데 전역 왼쪽 마우스 클릭을 사용해야 하나요? 이렇게 하면 운영 체제에서 포커스 메서드를 제한하여 애플리케이션이 전면에 자신을 가져오지 못하게 하는 시나리오에서 전면 이벤트로의 가져오기를 보장합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 에이전트 닫기

IA-Connect 에이전트를 닫습니다. IA-Connect 에이전트가 실행 중인 사용자 세션에는 영향을 주지 않습니다.

매개 변수

Name 필수 형식 Description
대기 시간(초)
SecondsToWait integer

IA-Connect 에이전트가 명령의 완료를 보고할 수 있도록 close 명령을 실행하기 전에 대기하는 시간입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 에이전트 로그 가져오기

현재 IA-Connect 에이전트 로그를 파일로 반환하거나 내용을 읽고 출력 변수에서 반환합니다.

매개 변수

Name 필수 형식 Description
압축
Compress boolean

업로드하는 동안 대체 IA-Connect 에이전트 실행 파일을 압축해야 하나요?

마지막 명령 로그만 반환
ReturnLastCommandOnly boolean

IA-Connect 에이전트 로그를 전체 로그가 아닌 마지막 명령의 결과로 제한해야 하나요?

파일에 로그 저장
SaveLogToFile boolean

IA-Connect 에이전트 로그를 파일로 저장해야 하나요?

데이터 항목에 로그 콘텐츠 배치
PlaceLogContentInDataItem boolean

로그의 내용을 출력 변수에 반환해야 하나요?

로컬 저장 폴더
LocalSaveFolder string

IA-Connect 에이전트 로그인을 저장할 폴더에 대한 파일 경로입니다.

에이전트 로그 파일 이름 사용
UseAgentLogFilename boolean

로그 파일에 에이전트의 로그 파일 이름과 동일한 이름이 지정되어야 하나요? false로 설정하면 '로컬 저장 파일 이름'을 설정하여 파일 이름을 지정할 수 있습니다.

로컬 저장 파일 이름
LocalSaveFilename string

IA-Connect 에이전트 로그에 대한 로컬 저장 파일의 파일 이름입니다. '에이전트 로그 파일 이름 사용'이 false로 설정된 경우에만 사용됩니다.

읽을 최대 바이트
MaxBytesToRead integer

에이전트 로그에서 읽을 최대 바이트 수입니다(끝에서 뒤로). 전체 로그를 검색하려면 0 또는 -1 설정할 수 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
에이전트 로그 콘텐츠
IAConnectAgentLogContentsBase64 string

IA-Connect 에이전트 로그의 내용입니다.

로컬 저장된 로그 파일 이름
IAConnectAgentLogFilenameOnly string

저장된 로그 파일 이름의 경로입니다.

IA-Connect 에이전트 로그 수준 가져오기

현재 IA-Connect 에이전트 로깅 수준을 반환합니다. 로깅 수준은 1에서 4로 설정되며, 1은 가장 낮은 수준이고 4는 가장 높습니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
로그 수준
LoggingLevel integer

IA-Connect 에이전트의 현재 로깅 수준입니다.

IA-Connect 에이전트 로그 파일 이름
IAConnectAgentLogFilename string

IA-Connect 에이전트 로그 파일 이름입니다. 이 값은 파일 이름에 시작 날짜와 시간이 있으므로 IA-Connect 에이전트의 각 시작에 대해 고유합니다.

IA-Connect 에이전트 로그 수준 설정

IA-Connect 에이전트 로깅 수준을 지정된 값으로 설정합니다(1은 가장 낮은 수준이고 4는 가장 높음).

매개 변수

Name 필수 형식 Description
로그 수준
LoggingLevel True integer

IA-Connect 에이전트를 설정해야 하는 로깅 수준입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 에이전트 명령 제한 시간 설정

IA-Connect 에이전트가 실행되는 각 명령에 사용할 명령 시간 제한을 설정합니다.

매개 변수

Name 필수 형식 Description
명령 시간 제한(초)
CommandTimeoutInSeconds True integer

IA-Connect 에이전트에서 사용할 명령 시간 제한입니다. 많은 양의 데이터를 읽거나 쓰는 경우 제한 시간을 늘릴 수 있습니다.

시간 제한 RPA 명령 스레드 종료
TerminateTimedoutRPACommandThreads boolean

시간이 초과된 경우 명령 스레드를 종료해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

IA-Connect 에이전트 세션 정보 가져오기

IA-Connect 에이전트 사용자 세션에 대한 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
세션 ID
SessionId integer

현재 원격 사용자 세션 ID입니다.

세션 유형
SessionType integer

원격 세션의 유형으로, 1(Citrix), 2(RDP) 또는 0(콘솔)입니다.

세션 유형 이름
SessionTypeName string

원격 세션 유형(ICA(Citrix), RDP 또는 콘솔입니다.

IA-Connect 에이전트 전역 좌표 구성 가져오기

요소 위치(예: 마우스 검사 중)를 표시하고 마우스 위치를 계산하는 데 사용되는 IA-Connect 에이전트 전역 좌표계 구성의 구성을 검색합니다(예: 전역 마우스 작업을 수행할 때).

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
다중 모니터 기능
MultiMonitorFunctionality string

IA-Connect 에이전트가 현재 기본 디스플레이 디바이스에서 요소 강조 표시 및 전역 마우스 작업 수행만 지원하도록 구성된 경우 'PrimaryMonitor'를 반환합니다. IA-Connect 에이전트가 모든 모니터의 요소를 강조 표시하면 'MultiMonitor'를 반환합니다(IA-Connect 9.4 이후의 기본값).

마우스 검사 승수 자동 설정
AutoSetMouseInspectionMultiplier boolean

IA-Connect 에이전트가 에이전트 시작 시 기본 디스플레이 디바이스에서 마우스 검사 승수를 자동으로 계산하고 마우스 검사가 수행될 때마다(IA-Connect 9.4 이후의 기본값) true를 반환합니다. IA-Connect 에이전트에서 마우스 검사 승수를 수동으로 설정해야 하는 경우 false를 반환합니다(IA-Connect 9.3 이하에서 사용 가능한 유일한 옵션). 이 옵션은 다중 모니터 모드를 사용하지 않도록 설정한 경우에만 적용됩니다.

전역 마우스 승수 자동 설정
AutoSetGlobalMouseMultiplier boolean

IA-Connect 에이전트가 에이전트 시작 시 기본 디스플레이 디바이스에서 전역 마우스 이동 승수를 자동으로 계산하고 마우스 검사가 수행될 때마다(IA-Connect 9.4 이후의 기본값) true를 반환합니다. IA-Connect 에이전트에서 전역 마우스 이동 승수를 수동으로 설정해야 하는 경우 false를 반환합니다(IA-Connect 9.3 이하에서 사용 가능한 유일한 옵션). 이 옵션은 다중 모니터 모드를 사용하지 않도록 설정한 경우에만 적용됩니다.

마우스 검사 X 승수
MouseInspectionXMultiplier double

현재 가로(X) 마우스 검사 승수입니다(에이전트가 마우스 아래에 있는 내용을 강조 표시하는 경우). 예를 들어 IA-Connect 실제 마우스 X 위치의 절반에 검사 사각형을 표시하는 경우 이 값은 0.5가 됩니다. 승수는 '다중 모니터 기능'을 사용하지 않도록 설정한 경우에만 영향을 줍니다. 승수는 IA-Connect 에이전트가 다중 모니터 인식으로 구성될 때 동적으로 계산되기 때문입니다.

마우스 검사 Y 승수
MouseInspectionYMultiplier double

현재 세로(Y) 마우스 검사 승수입니다(에이전트가 마우스 아래에 있는 내용을 강조 표시하는 경우). 예를 들어 IA-Connect 실제 마우스 Y 위치의 절반에 검사 사각형을 표시하는 경우 이 값은 0.5가 됩니다. 승수는 '다중 모니터 기능'을 사용하지 않도록 설정한 경우에만 영향을 줍니다. 승수는 IA-Connect 에이전트가 다중 모니터 인식으로 구성될 때 동적으로 계산되기 때문입니다.

전역 마우스 X 승수
GlobalMouseXMultiplier double

현재 가로(X) 전역 마우스 이동 승수(에이전트가 마우스를 이동할 때)입니다. 승수는 '다중 모니터 기능'을 사용하지 않도록 설정한 경우에만 영향을 줍니다. 승수는 IA-Connect 에이전트가 다중 모니터 인식으로 구성될 때 동적으로 계산되기 때문입니다.

전역 마우스 Y 승수
GlobalMouseYMultiplier double

현재 세로(Y) 전역 마우스 이동 승수입니다(에이전트가 마우스를 이동할 때). 승수는 '다중 모니터 기능'을 사용하지 않도록 설정한 경우에만 영향을 줍니다. 승수는 IA-Connect 에이전트가 다중 모니터 인식으로 구성될 때 동적으로 계산되기 때문입니다.

전역 마우스 이동 방법
GlobalMouseMoveMethod string

현재 전역 마우스 이동 메서드(mouse_event 또는 setcursorpos)를 반환합니다.

Java 좌표계
JavaCoordinateSystem string

'Virtual'(기본값) 또는 'Physical'(IA-Connect 9.4의 새로운 기능)일 수 있는 현재 Java 좌표계를 반환합니다. 가상 좌표는 DPI 크기 조정되지만 실제 좌표는 픽셀에 직접 매핑됩니다. 이 값은 Java Access Bridge에서 제공하는 좌표계로 설정해야 합니다.

SAP GUI 좌표계
SAPGUICoordinateSystem string

'Virtual' 또는 'Physical'(IA-Connect 9.4의 새로운 기능)일 수 있는 현재 SAP GUI 스크립팅 API 좌표계를 반환합니다. 가상 좌표는 DPI 크기 조정되지만 실제 좌표는 픽셀에 직접 매핑됩니다. 이 값은 SAP GUI 스크립팅 API에서 제공하는 좌표계로 설정해야 합니다.

IA-Connect 에이전트 전역 좌표 구성 설정

요소 위치(예: 마우스 검사 중)를 표시하고 마우스 위치를 계산하는 데 사용되는 IA-Connect 에이전트 전역 좌표계를 구성합니다(예: 전역 마우스 작업을 수행할 때). 기본값은 최신 기능을 제공하지만 이 작업을 사용하여 이전 버전의 에이전트의 동작으로 되돌리거나 API가 다른 좌표계를 사용하도록 지정할 수 있습니다.

매개 변수

Name 필수 형식 Description
다중 모니터 기능
MultiMonitorFunctionality string

기본 디스플레이 전용'(PrimaryMonitor)으로 설정하여 요소를 강조 표시하고 기본 디스플레이 디바이스에서 전역 마우스 작업 수행만 지원하는 이전 동작으로 되돌려집니다(IA-Connect 9.3 이하에서 사용 가능한 유일한 모드). 요소를 강조 표시하고 모든 모니터에서 전역 마우스 작업을 수행하고 각 모니터에서 DPI 크기 조정을 자동으로 검색하려면 '모든 디스플레이'(MultiMonitor)로 설정합니다(IA-Connect 9.4 이후의 기본값). 변경할 수 없도록 '설정 안 됨'(NotSet)으로 설정합니다.

마우스 검사 승수 자동 설정
AutoSetMouseInspectionMultiplier string

에이전트 시작 시 및 마우스 검사가 수행될 때마다 기본 디스플레이 디바이스에서 마우스 검사 승수를 자동으로 계산하려면 '자동'(1)(IA-Connect 9.4 이후의 기본값)으로 설정합니다. 검사 승수를 수동으로 설정해야 하려면 '수동'(0)으로 설정합니다(IA-Connect 9.3 이하에서 사용 가능한 유일한 옵션). 이 옵션을 변경하지 않도록 비워 두거나 'NotSet'으로 설정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

전역 마우스 승수 자동 설정
AutoSetGlobalMouseMultiplier string

에이전트 시작 시 및 마우스 검사가 수행될 때마다 기본 디스플레이 디바이스에서 전역 마우스 이동 승수를 자동으로 계산하려면 '자동'(1)(IA-Connect 9.4 이후의 기본값)으로 설정합니다. 전역 마우스 이동 승수를 수동으로 설정해야 하려면 '수동'(0)으로 설정합니다(IA-Connect 9.3 이하에서 사용 가능한 유일한 옵션). 이 옵션을 변경하지 않도록 비워 두거나 'NotSet'으로 설정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

마우스 검사 X 승수
MouseInspectionXMultiplier double

설정할 가로(X) 마우스 검사 승수입니다(에이전트가 마우스 아래에 있는 내용을 강조 표시하는 경우). 예를 들어 IA-Connect 실제 마우스 X 위치의 절반에 검사 사각형을 표시하는 경우 값을 0.5로 설정합니다. 현재 값을 변경하지 않고 그대로 두려면 0으로 설정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정하고 '마우스 검사 승수 자동 설정'을 사용하지 않도록 설정한 경우에만 적용됩니다.

마우스 검사 Y 승수
MouseInspectionYMultiplier double

설정할 세로(Y) 마우스 검사 승수입니다(에이전트가 마우스 아래에 있는 내용을 강조 표시하는 경우). 예를 들어 IA-Connect 실제 마우스 Y 위치의 절반에 검사 사각형을 표시하는 경우 값을 0.5로 설정합니다. 현재 값을 변경하지 않고 그대로 두려면 0으로 설정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정하고 '마우스 검사 승수 자동 설정'을 사용하지 않도록 설정한 경우에만 적용됩니다.

전역 마우스 X 승수
GlobalMouseXMultiplier double

설정할 가로(X) 전역 마우스 이동 승수입니다(에이전트가 마우스를 이동할 때). 현재 값을 변경하지 않고 그대로 두려면 0으로 설정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

전역 마우스 Y 승수
GlobalMouseYMultiplier double

설정할 세로(Y) 전역 마우스 이동 승수입니다(에이전트가 마우스를 이동할 때). 현재 값을 변경하지 않고 그대로 두려면 0으로 설정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

mouse_event 적용
GlobalMouseMultiplierApplyToMouseEvent boolean

mouse_event 메서드에 전역 마우스 승수 값을 적용할지 여부를 지정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

SetCursorPos에 적용
GlobalMouseMultiplierApplyToSetCursorPos boolean

이 인수는 SetCursorPos 메서드에 전역 마우스 승수 값을 적용할지 여부를 지정합니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

현재 마우스 이동 메서드에 적용
GlobalMouseMultiplierApplyToCurrentMouseMoveMethod boolean

이 인수는 현재 마우스 이동 메서드에 전역 마우스 승수 값을 적용할지 여부를 지정합니다(예: SetCursorPos가 현재 마우스 이동 메서드인 경우 승수는 SetCursorPos에 적용됨). true로 설정하면 'mouse_event 적용' 및 'SetCursorPos에 적용' 입력이 무시됩니다. 이 옵션은 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

Java 좌표계
JavaCoordinateSystem string

Java Access Bridge가 가상(DPI 크기 조정) 좌표를 제공하고 있음을 에이전트에 알리려면 '가상'(IA-Connect 9.3 이하의 기본 및 사용 가능한 유일한 옵션)으로 설정합니다. '물리적'으로 설정하여 Java Access Bridge가 물리적 좌표를 제공하고 있음을 에이전트에 알릴 수 있습니다(픽셀에 직접 매핑됨). 변경할 수 없도록 '설정 안 됨'(NotSet)으로 설정합니다.

SAP GUI 좌표계
SAPGUICoordinateSystem string

SAP GUI 스크립팅 API가 가상(DPI 크기 조정) 좌표를 제공하고 있음을 에이전트에 알리려면 '가상'(IA-Connect 9.3 이하의 기본 및 사용 가능한 유일한 옵션)으로 설정합니다. SAP GUI 스크립팅 API가 물리적 좌표를 제공하고 있음을 에이전트에 알리려면 '물리적'으로 설정합니다(픽셀에 직접 매핑됨). 변경할 수 없도록 '설정 안 됨'(NotSet)으로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
SetAgentGlobalCoordinateConfigurationResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

IA-Connect 에이전트 정보 가져오기

버전 번호와 에이전트 실행 파일의 경로를 포함하여 IA-Connect 에이전트의 속성을 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
IA-Connect 에이전트 버전
IAConnectAgentVersion string

IA-Connect 에이전트의 전체 버전 번호입니다.

DotNet CLR 버전
DotNetCLRVersion string

DotNet CLR(공용 언어 런타임) 버전입니다.

IA-Connect 에이전트가 사용자 이름으로 실행됨
IAConnectAgentRunAsUsername string

IA-Connect 에이전트가 실행 중인 사용자 세션의 사용자 이름입니다.

IA-Connect 에이전트가 userdomain으로 실행됨
IAConnectAgentRunAsUserdomain string

IA-Connect 에이전트가 실행 중인 사용자 세션의 사용자 도메인입니다.

IA-Connect 에이전트 경로
IAConnectAgentPath string

IA-Connect 에이전트 실행 파일의 전체 경로입니다.

IA-Connect 에이전트는 64비트 프로세스입니다.
IAConnectAgentIs64bitProcess boolean

IA-Connect 에이전트가 64비트 프로세스인 경우 true를 반환하고 그렇지 않으면 false를 반환합니다.

IA-Connect 에이전트 릴리스 버전
IAConnectAgentReleaseVersion string

IA-Connect 에이전트 릴리스 버전(예: 8.0).

IA-Connect 에이전트 RPA 명령 시간 제한
IAConnectAgentRPACommandTimeout integer

IA-Connect 에이전트 RPA 명령 시간 제한입니다. 이 기본값은 30초이며 'IA-Connect 에이전트 명령 제한 시간 설정' 작업을 사용하여 설정할 수 있습니다.

IA-Connect 에이전트 로그 파일 이름
IAConnectAgentLogFilename string

IA-Connect 에이전트 로그 파일 이름입니다. 이 값은 파일 이름에 시작 날짜와 시간이 있으므로 IA-Connect 에이전트의 각 시작에 대해 고유합니다.

IA-Connect 에이전트 프로세스 수 가져오기

사용자 세션에서 현재 실행 중인 IA-Connect 에이전트의 인스턴스 수를 반환합니다. 이는 IA-Connect 에이전트의 여러 인스턴스가 실행 중인지 감지하는 데 유용합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프로세스 수
NumberOfProcesses integer

사용자 세션에서 현재 실행 중인 IA-Connect 에이전트 프로세스의 수입니다.

IA-Connect 에이전트 현재 라이선스 상태 가져오기

IA-Connect 에이전트의 현재 사용이 허가되었는지 여부와 라이선스가 있는 경우 라이선스의 속성을 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
라이선스가 부여됨
IsLicensed boolean

IA-Connect 에이전트가 현재 사용이 허가된 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

라이선스 유형
LicenseType string

사용 중인 IA-Connect 라이선스의 유형입니다.

에이전트 도메인 이름
CustomerNETBIOSDomainName string

도메인 이름(IA-Connect 7.0 또는 7.1)으로 라이선스가 부여된 경우 IA-Connect 에이전트가 실행 중인 컴퓨터의 NetBIOS 도메인 이름입니다.

디렉터 호스트 이름
DirectorHostnameCSV string

호스트 이름(post IA-Connect 7.2)에서 사용이 허가된 경우 IA-Connect Director를 설치할 수 있는 컴퓨터의 호스트 이름입니다.

고객 표시 이름
CustomerDisplayName string

IA-Connect 에이전트의 제목 표시줄에 표시할 고객 이름입니다.

공급업체 이름
VendorName string

IA-Connect 공급업체 이름입니다.

라이선스 만료 날짜
LicenseExpiryDate string

IA-Connect 라이선스의 만료 날짜입니다.

라이선스가 만료될 때까지의 일
DaysUntilLicenseExpires integer

IA-Connect 라이선스가 만료될 때까지 남은 일 수입니다.

라이선스 기능
LicenseFeatures string

추가 라이선스 기능( 일반적으로 추가 기능에 대한 액세스 제공)

JML 라이선스인가요?
IsJMLLicense boolean

이 라이선스는 JML 기능에 대한 액세스를 제공합니까?

INI 파일의 변수 데이터 바꾸기

INI 파일에서 단일 변수를 업데이트합니다.

매개 변수

Name 필수 형식 Description
INI 파일 경로
InputFilename True string

INI 파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

출력 INI 파일 경로
OutputFilename string

업데이트된 INI 파일을 대체 파일에 쓰려면 여기에 출력 파일의 전체 경로를 입력합니다. 입력 INI 파일은 수정되지 않습니다. 출력 INI 파일에 변경 내용이 저장됩니다.

INI 검색 섹션
SearchSection string

변경할 변수를 포함하는 섹션의 선택적 이름입니다.

INI 검색 변수 이름
SearchVariable string

업데이트할 변수의 이름입니다.

대체 데이터
ReplaceData string

변수를 업데이트할 대체 데이터입니다.

INI 파일 인코딩
InputFilenameEncoding string

INI 파일 인코딩(유니코드, UTF8, UTF7 또는 ASCII)을 제공하거나 인코딩 값(예: 서유럽의 경우 1252)을 지정합니다.

입력 파일이 없는 경우 새 파일 만들기
CreateNewFileIfNotExists boolean

입력 파일이 없는 경우 새 파일을 만들어야 하나요?

같기 전의 쓰기 공간
WriteSpaceBeforeEquals boolean

등호(= ) 기호 앞에 공백을 작성해야 하나요?

같음 이후의 쓰기 공간
WriteSpaceAfterEquals boolean

등호(= ) 기호 다음에 공백을 작성해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

mouse_event 보정

지정된 픽셀 수만큼 마우스를 이동한 다음 새 마우스 위치를 읽어 mouse_event 메서드를 보정합니다.

매개 변수

Name 필수 형식 Description
보정 크기(픽셀)
CalibrationSizeInPixels integer

보정하기 위해 마우스를 이동할 픽셀 수입니다. 값이 낮을수록 보정의 정확도가 떨어집니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
마우스 X 승수
MouseXMultiplier double

마우스 X 승수 값입니다. 값이 1.0이면 승수를 나타내지 않습니다.

마우스 Y 승수
MouseYMultiplier double

마우스 Y 승수 값입니다. 값이 1.0이면 승수를 나타내지 않습니다.

Orchestrator 자동화 작업 가져오기

특정 오케스트레이터 자동화 작업을 검색합니다.

매개 변수

Name 필수 형식 Description
작업 ID
TaskId True integer

검색할 Orchestrator 작업의 ID입니다.

상태를 다음으로 변경합니다.
StatusChange string

'검색됨'으로 설정된 경우: 작업을 검색할 때 다른 작업이 동일한 작업을 실행하지 못하도록 작업 상태가 '검색됨'으로 변경됩니다. '아무 작업도 수행하지 않음'으로 설정하면 작업 상태가 변경되지 않습니다.

반환

Name 경로 형식 Description
Automation 이름
AutomationName string

검색된 Orchestrator 작업의 이름입니다.

작업 ID
OperationId string

검색된 오케스트레이터 작업의 작업 ID입니다. 이 작업 ID(또는 작업 ID)를 사용하여 나중에 작업을 검색할 수 있습니다. 작업 ID는 타사에서 생성하지 않은 작업의 ID를 추측할 수 있는 기능을 제한하는 고유하고 신뢰할 수 없는 문자열입니다.

지연 날짜 및 시간
DeferralDateTime string

검색된 Orchestrator 작업이 준비되도록 예약된 날짜 및 시간입니다. UTC에서 문자열로 반환됩니다.

저장된 데이터 지연
DeferralStoredData string

작업이 지연될 때 저장된 선택적 데이터입니다. 일반적으로 프로세스/흐름을 계속해야 하는 데이터입니다.

지연 수
DeferralCount integer

이 작업이 지연된 빈도입니다. 이는 일반적으로 지연되지 않은 새 작업의 경우 0이거나 지연된 작업의 경우 1 이상이 됩니다. 지연된 작업이 다시 연기될 때마다 Orchestrator는 이 수를 자동으로 늘입니다.

작업 입력 데이터
TaskInputData string

작업을 만들 때 저장된 선택적 데이터입니다. 일반적으로 프로세스/흐름을 시작하는 데 사용된 데이터이지만 어떤 용도로든 이 필드를 사용할 수 있습니다. JSON 또는 XML 또는 원시 텍스트와 같이 선택한 텍스트 형식으로 서식을 지정할 수 있습니다.

작업 출력 데이터
TaskOutputData string

작업을 처리할 때 자동화에서 저장한 선택적 데이터입니다. JSON 또는 XML 또는 원시 텍스트와 같이 선택한 텍스트 형식으로 서식을 지정할 수 있습니다.

Priority
Priority integer

이 오케스트레이터 작업의 우선 순위 수준입니다(1은 가장 높은 수준임).

Automation 작업 상태
AutomationTaskStatus string

검색된 Orchestrator 작업의 상태입니다.

프로세스 단계
ProcessStage string

지연 후 자동화 프로세스/흐름이 계속되어야 하는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 이는 지연된 프로세스/흐름 내의 조건에서 다음에 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 지연 후에 계속 진행할 때 프로세스/흐름이 'Exchange' 단계에서 계속되도록 하려면 'Exchange' 값을 입력합니다.

받은 날짜 및 시간
ReceivedDateTime string

오케스트레이터가 작업을 처음 받은 날짜와 시간입니다. UTC에서 문자열로 반환됩니다.

지연 날짜까지 분
MinutesUntilDeferralDate integer

이 작업의 지연 날짜(예: 이 작업을 실행할 준비가 된 경우)까지의 시간(분)입니다. 이 작업을 실행할 준비가 되면 분은 0이 됩니다.

보류 중
OnHold boolean

작업이 보류 중인 경우 true로 설정됩니다. 보류 중인 작업은 '다음 오케스트레이터 자동화 작업 가져오기' 작업으로 검색되지 않으므로 일반적인 작업 워크플로에서 처리되지 않습니다.

원본 형식 이름
SourceTypeName string

작업 원본의 이름입니다. '웹 UI'는 UI를 통해 수동으로 입력한 작업을 나타냅니다. 'REST API'는 Orchestrator의 REST API를 통해 만든 작업을 나타냅니다. 'ServiceNow'는 Orchestrator의 내부 'Sources' ServiceNow 통합에서 만든 작업을 나타냅니다.

원본 이름
SourceFriendlyName string

Orchestrator 내부 '원본' 통합(예: ServiceNow)에서 작업을 만든 경우 해당 원본의 이름을 보유합니다.

원본 티켓 ID
SourceTicketId string

Orchestrator 내부 '원본' 통합(예: ServiceNow)에서 작업을 만든 경우 원본 티켓의 ID가 포함됩니다. ServiceNow의 경우 카탈로그 작업 sys_id 유지됩니다.

원본 티켓 하위 ID
SourceTicketSubId string

Orchestrator 내부 '원본' 통합(예: ServiceNow)에서 작업을 만든 경우 원본 티켓의 ID가 포함됩니다. ServiceNow의 경우 요청 항목이 sys_id 유지됩니다.

조직
Organisation string

이 작업이 연결된 조직입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

부서
Department string

이 작업이 연결된 부서입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

Description
Description string

이 작업에 대한 설명입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

태그들
Tags string

이 작업에 할당된 하나 이상의 태그의 선택적 목록입니다. 일반적으로 검색 및 필터링 작업을 분류하는 데 사용됩니다. 대소문자를 구분하지 않습니다. 한 줄당 하나씩.

Orchestrator 자동화 작업 가져오기

고유한 작업 ID를 제공하여 특정 오케스트레이터 자동화 작업을 검색합니다.

매개 변수

Name 필수 형식 Description
작업 ID
OperationId True string

검색할 Orchestrator 작업의 작업 ID입니다.

반환

Name 경로 형식 Description
Automation 이름
AutomationName string

검색된 Orchestrator 작업의 이름입니다.

지연 날짜 및 시간
DeferralDateTime string

검색된 Orchestrator 작업이 준비되도록 예약된 날짜 및 시간입니다. UTC에서 문자열로 반환됩니다.

저장된 데이터 지연
DeferralStoredData string

작업이 지연될 때 저장된 선택적 데이터입니다. 일반적으로 프로세스/흐름을 계속해야 하는 데이터입니다.

지연 수
DeferralCount integer

이 작업이 지연된 빈도입니다. 이는 일반적으로 지연되지 않은 새 작업의 경우 0이거나 지연된 작업의 경우 1 이상이 됩니다. 지연된 작업이 다시 연기될 때마다 Orchestrator는 이 수를 자동으로 늘입니다.

작업 입력 데이터
TaskInputData string

작업을 만들 때 저장된 선택적 데이터입니다. 일반적으로 프로세스/흐름을 시작하는 데 사용된 데이터이지만 어떤 용도로든 이 필드를 사용할 수 있습니다. JSON 또는 XML 또는 원시 텍스트와 같이 선택한 텍스트 형식으로 서식을 지정할 수 있습니다.

작업 출력 데이터
TaskOutputData string

작업을 처리할 때 자동화에서 저장한 선택적 데이터입니다. JSON 또는 XML 또는 원시 텍스트와 같이 선택한 텍스트 형식으로 서식을 지정할 수 있습니다.

Priority
Priority integer

이 오케스트레이터 작업의 우선 순위 수준입니다(1은 가장 높은 수준임).

Automation 작업 상태
AutomationTaskStatus string

검색된 Orchestrator 작업의 상태입니다.

프로세스 단계
ProcessStage string

지연 후 자동화 프로세스/흐름이 계속되어야 하는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 이는 지연된 프로세스/흐름 내의 조건에서 다음에 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 지연 후에 계속 진행할 때 프로세스/흐름이 'Exchange' 단계에서 계속되도록 하려면 'Exchange' 값을 입력합니다.

받은 날짜 및 시간
ReceivedDateTime string

오케스트레이터가 작업을 처음 받은 날짜와 시간입니다. UTC에서 문자열로 반환됩니다.

지연 날짜까지 분
MinutesUntilDeferralDate integer

이 작업의 지연 날짜(예: 이 작업을 실행할 준비가 된 경우)까지의 시간(분)입니다. 이 작업을 실행할 준비가 되면 분은 0이 됩니다.

보류 중
OnHold boolean

작업이 보류 중인 경우 true로 설정됩니다. 보류 중인 작업은 '다음 오케스트레이터 자동화 작업 가져오기' 작업으로 검색되지 않으므로 일반적인 작업 워크플로에서 처리되지 않습니다.

조직
Organisation string

이 작업이 연결된 조직입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

부서
Department string

이 작업이 연결된 부서입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

Description
Description string

이 작업에 대한 설명입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

태그들
Tags string

이 작업에 할당된 하나 이상의 태그의 선택적 목록입니다. 일반적으로 검색 및 필터링 작업을 분류하는 데 사용됩니다. 대소문자를 구분하지 않습니다. 한 줄당 하나씩.

Orchestrator 자동화 작업 삭제

고유한 작업 ID를 제공하여 특정 오케스트레이터 자동화 작업을 삭제합니다.

매개 변수

Name 필수 형식 Description
작업 ID
OperationId True string

삭제할 Orchestrator 작업의 작업 ID입니다.

원본 시스템 업데이트
UpdateSourceSystem boolean

true(기본값)로 설정하고 Orchestrator 작업이 원본 시스템(예: ServiceNow)에 연결된 경우 Orchestrator는 Orchestrator의 원본 시스템 구성에 지정된 모든 작업을 수행합니다(예: 티켓 닫기). false로 설정되거나 태스크가 원본 시스템에 연결되지 않은 경우 작업은 Orchestrator에서만 삭제됩니다.

반환

Name 경로 형식 Description
명령 결과
TasksDeleteTaskOperationResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

Orchestrator 자동화 작업 출력 데이터 설정

Orchestrator 자동화 작업에 대한 출력 데이터를 설정합니다. 작업을 완료하고 출력 데이터를 제공하려고 할 때 작업을 만든 프로세스에서 수집하려는 경우에 일반적으로 사용됩니다.

매개 변수

Name 필수 형식 Description
작업 ID
TaskId True integer

메모를 추가할 Orchestrator 작업의 ID입니다.

작업 출력 데이터
TaskOutputData string

출력 데이터 문자열입니다. JSON 또는 XML 또는 원시 텍스트와 같이 선택한 텍스트 형식으로 서식을 지정할 수 있습니다. 출력 데이터 문자열은 Orchestrator UI에서 보거나 TasksGetTask REST API를 통해 액세스할 수 있습니다.

반환

Name 경로 형식 Description
명령 결과
TasksSetOutputDataResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

Orchestrator 자동화 작업 할당

선택한 Orchestrator 자동화 작업을 지정된 사용자 또는 그룹에 할당합니다. 이 할당은 이 자동화 작업(예: ServiceNow)과 연결된 원본 시스템에 전달되며, 추가 처리를 위해 다른 사용자 또는 사용자 그룹에 티켓을 전달하는 데 가장 일반적으로 사용됩니다. Orchestrator 자동화 작업이 원본에 연결되지 않은 경우 예외가 발생합니다.

매개 변수

Name 필수 형식 Description
작업 ID
TaskId True integer

할당할 Orchestrator 작업의 ID입니다.

사용자 ID에 할당
AssignToUserId string

작업을 할당할 사용자의 ID입니다. 사용자에게 작업을 할당하고 사용자 ID를 알고 있는 경우 이 입력을 사용합니다. 둘 다 아닌 사용자 ID 또는 사용자 이름 입력을 사용하거나 그룹에 할당하는 경우 이 입력을 비워 둡니다.

사용자 이름에 할당
AssignToUserName string

작업을 할당할 사용자의 이름입니다. 사용자에게 작업을 할당하고 사용자 이름을 알고 있는 경우 이 입력을 사용합니다. 둘 다 아닌 사용자 ID 또는 사용자 이름 입력을 사용하거나 그룹에 할당하는 경우 이 입력을 비워 둡니다.

그룹 ID에 할당
AssignToGroupId string

작업을 할당할 그룹의 ID입니다. 그룹에 작업을 할당하고 그룹 ID를 알고 있는 경우 이 입력을 사용합니다. 그룹 ID 또는 그룹 이름 입력을 모두 사용하지 않거나 사용자에게 할당하는 경우 이 입력을 비워 둡니다.

그룹 이름에 할당
AssignToGroupName string

작업을 할당할 그룹의 이름입니다. 그룹에 작업을 할당하고 그룹 이름을 알고 있는 경우 이 입력을 사용합니다. 둘 다 아닌 그룹 ID 또는 그룹 이름 입력을 사용하거나 사용자에게 할당하는 경우 이 입력을 비워 둡니다.

비어 있는 경우 사용자 할당 제거
RemoveUserAssignmentIfBlank boolean

사용자 할당 필드가 비어 있고 이 필드가 true로 설정된 경우 현재 할당된 모든 사용자가 제거되고, 그렇지 않으면 사용자 할당이 변경되지 않은 상태로 유지됩니다.

비어 있는 경우 그룹 할당 제거
RemoveGroupAssignmentIfBlank boolean

그룹 할당 필드가 비어 있고 이 필드가 true로 설정된 경우 현재 할당된 모든 그룹이 제거되고, 그렇지 않으면 그룹 할당이 변경되지 않은 상태로 유지됩니다.

반환

Name 경로 형식 Description
명령 결과
TasksAssignTaskResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

Orchestrator 자동화 작업에 메모 추가

선택한 Orchestrator 자동화 작업에 메모를 추가합니다. 이 메모는 이 자동화 작업(예: ServiceNow)과 연결된 원본 시스템에 전달되며 티켓에 세부 정보를 추가하는 데 가장 일반적으로 사용됩니다. Orchestrator 자동화 작업이 원본에 연결되지 않은 경우 예외가 발생합니다.

매개 변수

Name 필수 형식 Description
작업 ID
TaskId True integer

메모를 추가할 Orchestrator 작업의 ID입니다.

참고 텍스트
NoteText True string

메모 문자 메시지입니다.

메모 유형
NoteType string

원본 시스템에서 다른 메모 유형(예: 작업 메모, 닫기 메모 또는 메모)을 지원하는 경우 여기에 메모 유형을 입력합니다. 원본 시스템에 따라 다르게 해석됩니다. 현재 지원되는 형식은 'WorkNote'(기본값), 'CloseNote', 'Comment'입니다. 메모 유형이 하나뿐이면 'WorkNote'를 입력합니다. 사용자 지정 작업 노트가 있는 경우 '기타'를 입력합니다.

기타 참고 유형
NoteTypeOther string

사용자 지정 메모 유형이 있는 경우 '기타'의 '메모 유형'을 선택하고 이 필드에 사용자 지정 형식을 입력합니다.

반환

Name 경로 형식 Description
명령 결과
TasksAddNoteResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

Orchestrator 작업자 가용성 상태 가져오기

기본 오케스트레이터 상태를 검색합니다. 이를 사용하여 Orchestrator를 사용할 수 있고 응답하고 있는지 확인할 수 있습니다.

반환

Name 경로 형식 Description
총 작업자 수
TotalWorkersCount integer

오케스트레이터에 정의된 IA-Connect 작업자의 수(작업 여부)입니다.

사용 가능한 작업자 수
AvailableWorkersCount integer

오케스트레이터에 정의된 IA-Connect 작업자 수로, 작업에 사용할 수 있습니다. 사용 가능한 것은 현재 흐름(자동화)이 실행되고 있지 않고 유지 관리 모드가 아니라 라이선스가 부여된 응답이라는 것을 의미합니다. 새로 들어오는 작업을 수락하는 데 사용할 수 있는 작업자 수입니다.

사용할 수 없는 작업자 수
UnavailableWorkersCount integer

Orchestrator에 정의된 IA-Connect 작업자 수로, 작업에 사용할 수 없습니다. 이는 총 작업자 수에서 사용 가능한 작업자 수를 뺀 값과 같습니다.

흐름을 실행하는 작업자 수
WorkersRunningFlowsCount integer

흐름(자동화)을 실행하는 Orchestrator에 정의된 IA-Connect 작업자 수입니다. 이 노동자들은 바쁘기 때문에 일할 수 없습니다.

유지 관리 모드의 작업자 수
WorkersInMaintenanceModeCount integer

유지 관리 모드에 있는 Orchestrator에 정의된 IA-Connect 작업자의 수입니다. 이러한 작업자는 새 작업을 수락하지 않도록 수동으로 구성되었으므로 작업에 사용할 수 없습니다.

라이브 작업자 수
LiveWorkersCount integer

응답하는 Orchestrator에 정의된 IA-Connect 작업자 수입니다. 이러한 작업자는 허가되지 않았거나, 주체 모드에서 또는 흐름(자동화)을 실행할 수 있기 때문에 작업에 사용할 수 있거나 사용할 수 없을 수 있습니다.

허가된 작업자 수
LicensedWorkersCount integer

오케스트레이터에 정의된 IA-Connect 작업자 수로, 응답하고 사용이 허가됩니다. Orchestrator는 작업자가 응답하는 경우에만 작업자의 사용이 허가된 상태만 알고 있으므로 사용이 허가된 작업자는 항상 응답합니다(따라서 Orchestrator에 상태를 알릴 수 있습니다). 작업자가 응답을 중지하면 Orchestrator는 더 이상 사용이 허가된 것으로 간주하지 않습니다. 이러한 작업자는 주체 모드 또는 실행 중인 흐름(자동화)에 있을 수 있기 때문에 작업에 사용할 수 있거나 사용할 수 없을 수 있습니다.

Orchestrator 작업자 가져오기

IA-Connect Orchestrator에 등록된 개별 작업자의 세부 정보 및 라이브 상태를 검색합니다.

매개 변수

Name 필수 형식 Description
Search 작업자 ID
SearchWorkerId integer

검색할 작업자의 ID입니다. 특정 ID를 가진 작업자의 세부 정보를 검색하려면 1 이상의 값으로 설정합니다. ID로 작업자를 검색하지 않으려면 0으로 설정합니다.

작업자 이름 검색
SearchWorkerName string

검색할 작업자의 이름입니다. 작업자를 이름으로 검색하지 않으려면 공백 또는 null로 설정합니다.

반환

Name 경로 형식 Description
작업자 ID
WorkerId integer

이 작업자의 내부 Orchestrator ID입니다.

작업자 이름
WorkerName string

이 작업자의 내부 Orchestrator 이름입니다.

작업자 설명
WorkerDescription string

이 작업자에 대한 내부 Orchestrator 설명입니다.

현재 흐름 표시 이름
CurrentFlowDisplayName string

이 작업에서 처리 중인 흐름의 표시 이름이거나 작업자가 유휴 상태이면 비어 있습니다.

작업자 라이브 상태
LiveStatus boolean

True입니다. 작업자가 현재 Orchestrator에 연결되어 있고 설문 조사에 응답하는 경우입니다. 작업자가 연결되지 않은 경우 False입니다.

마지막 연락처 틱
LiveStatusLastContactTicks integer

오케스트레이터가 작업자와 마지막으로 접촉한 시간(틱)입니다. 이는 0001년 1월 1일 자정(UTC) 12:00:00 이후 경과된 100나노초 간격의 수입니다. 이는 일반적인 범용 시간 형식입니다.

마지막 연락처 이후의 시간(초)
SecondsSinceLastContact integer

Orchestrator가 작업자와 마지막으로 접촉한 이후 경과된 시간(초)입니다. 이는 '마지막 접촉 틱'과 동일한 시점을 나타내지만 상대 시간(초)으로 표시됩니다.

유지 관리 모드의 작업자
MaintenanceMode boolean

작업자가 현재 유지 관리 모드인 경우 True입니다. 작업자가 유지 관리 모드가 아닌 경우 False입니다.

작업자 우선 순위
Priority integer

작업자에 할당된 우선 순위를 나타내는 1 이상의 정수 값입니다. 우선 순위 1이 가장 높은 우선 순위입니다. 흐름은 우선 순위가 가장 높은 사용 가능한 작업자에게 전송됩니다. 여러 작업자의 우선 순위가 같을 수 있으며 Orchestrator는 '작업자 부하 분산 방법'('사이트 설정' 참조)을 사용하여 사용 가능한 작업자를 선택합니다.

작업자 시간 제한(초)
TimeoutInSeconds integer

시간이 초과되기 전에 Orchestrator가 IA-Connect Director의 REST API 응답을 대기해야 하는 시간(초)입니다.

작업자가 라이선스가 부여됨
AgentIsLicensed boolean

작업자가 현재 사용이 허가된 경우 True입니다. 작업자가 라이선스가 없는 경우 False입니다. Orchestrator에서 작업자의 라이선스가 있는지 모르는 경우 Null입니다(응답하지 않을 수 있으며 설문 조사에서 라이브 라이선스 업데이트를 제공하지 않는 매우 오래된 에이전트일 수 있음).

에이전트 라이선스 기능
AgentLicenseFeatures string

특정 에이전트 라이선스 기능. 예: 조인자, Mover, Leaver 라이선스에 대한 JML입니다.

작업자를 작업에 사용할 수 있음
IsAvailableForWork boolean

True입니다. 작업자를 작업에 사용할 수 있으면 작업자가 들어오는 작업을 수락할 수 있습니다. 작업자가 아닌 경우 False입니다. 작업에 사용할 수 있는 것은 a) 작업자 상태가 라이브 상태인지, b) 유지 관리 모드의 작업자인지, c) 작업자가 허가되었는지, d) 현재 흐름을 처리하고 있는 작업자인지에 따라 결정됩니다.

작업자 연결 형식 ID
WorkerConnectionTypeId integer

작업자를 Orchestrator에 연결하는 데 사용되는 구성된 작업자 연결 형식의 ID입니다. 'Azure WCF Relay'의 경우 1, 'Azure 하이브리드 연결'의 경우 2, 'Azure VNet(Azure Virtual Network)'의 경우 3, 'Direct'의 경우 4일 수 있습니다.

작업자 연결 유형 이름
WorkerConnectionTypeName string

작업자를 Orchestrator에 연결하는 데 사용되는 구성된 작업자 연결 형식의 이름입니다. AzureWCFRelay, AzureHybridConnection, AzureVNet, Direct일 수 있습니다.

디렉터 REST API URL
DirectorRestApiUrl string

구성된 연결 형식이 하이브리드 연결, VNet 또는 직접인 경우 이 속성에는 HTTP 트래픽이 HTTPS 터널 내에서 암호화되기 때문에(예: 하이브리드 연결 또는 온-프레미스 데이터 게이트웨이) 일반적으로 HTTP인 작업자 REST API URL이 포함됩니다. 구성된 연결 형식이 Azure WCF 릴레이인 경우 이 속성에는 WCF 릴레이 URL이 포함됩니다.

Azure Service Bus 네임스페이스
AzureServiceBusNamespace string

구성된 연결 형식이 Azure WCF Relay인 경우 Azure Service Bus 네임스페이스가 포함됩니다.

Azure WCF 릴레이 이름
AzureWCFRelayName string

구성된 연결 형식이 Azure WCF Relay인 경우 이 속성에는 Azure WCF 릴레이 이름이 포함됩니다.

에이전트 연결 유형 이름
IAConnectAgentConnectionTypeName string

에이전트 연결 형식의 이름입니다. '로컬 에이전트', 'Citrix ICA' 또는 'Microsoft RDP'일 수 있습니다.

다음 홉 디렉터에 연결됨
AttachedToNextHopDirector boolean

Orchestrator에 연결된 디렉터(일반적으로 로컬 에이전트가 호스트하는 디렉터)가 다음 홉 디렉터(일반적으로 Citrix ICA 또는 Microsoft RDP 디렉터)에 작업을 전달하는 경우 이 속성은 True로 설정됩니다. 디렉터가 연결된 에이전트(일반적으로 로컬 에이전트)에 직접 작업을 보내는 경우 이 속성은 False로 설정됩니다.

다음 홉 디렉터 세션 유형
NextHopDirectorSessionType string

Orchestrator에 연결된 디렉터(일반적으로 로컬 에이전트에서 호스트하는 디렉터)가 다음 홉 디렉터(일반적으로 Citrix ICA 또는 Microsoft RDP 디렉터)에 작업을 전달하는 경우 이 속성에는 'Citrix ICA' 또는 'Microsoft RDP'인 연결 형식의 이름이 포함됩니다.

디렉터 버전
DirectorVersion string

REST API 인터페이스를 처리하고 IA-Connect 작업자에서 실행되는 IA-Connect 에이전트에 대해 IA-Connect 검사기를 제공하는 IA-Connect Director의 내부 버전입니다.

에이전트 버전
AgentVersion string

IA-Connect 작업자에서 실행되는 IA-Connect 에이전트의 내부 버전입니다.

디렉터 릴리스 버전
DirectorReleaseVersion double

REST API 인터페이스를 처리하고 IA-Connect 작업자에서 실행되는 IA-Connect 에이전트에 대한 IA-Connect 검사기를 제공하는 IA-Connect Director의 IA-Connect 릴리스 버전입니다.

에이전트 릴리스 버전
AgentReleaseVersion double

IA-Connect 작업자에서 실행되는 IA-Connect 에이전트의 IA-Connect 릴리스 버전입니다.

디렉터 호스트 이름
DirectorHostname string

IA-Connect 디렉터를 호스팅하는 운영 체제의 호스트 이름입니다. 이는 작업자의 호스트 이름이며, 일반적으로 작업자 이름과 동일합니다.

디렉터 NETBIOS 도메인 이름
DirectorNetBIOSDomainName string

IA-Connect 작업자에서 실행되는 IA-Connect 에이전트의 구성 요소인 IA-Connect Director를 호스팅하는 운영 체제의 NETBIOS 도메인 이름입니다. 작업 그룹의 경우 일반적으로 작업자 호스트 이름입니다. Active Directory 도메인의 경우 이 도메인은 NetBIOS 도메인 이름입니다. 예: MYDOMAIN.

디렉터 DNS 도메인 이름
DirectorDNSDomainName string

IA-Connect 작업자에서 실행되는 IA-Connect 에이전트의 구성 요소인 IA-Connect Director를 호스팅하는 운영 체제의 DNS 도메인 이름입니다. 작업 그룹의 경우 일반적으로 비어 있습니다. Active Directory 도메인의 경우 도메인 DNS 이름입니다. 예: mydomain.local.

지원되는 흐름 환경 ID 수
SupportedFlowEnvironmentIdsCount integer

작업자가 지정된 흐름 환경 ID의 흐름만 처리하도록 구성된 경우 이 속성은 목록에 지원되는 흐름 환경 ID의 수를 보유합니다. 작업자가 모든 환경에서 흐름을 처리할 수 있는 경우 이 속성은 0을 보유합니다.

지원되는 흐름 이름 수
SupportedFlowNamesCount integer

작업자가 특정 이름의 흐름만 처리하도록 구성된 경우 이 속성은 목록에서 지원되는 흐름 이름 수를 보유합니다. 작업자가 모든 이름으로 흐름을 처리할 수 있는 경우 이 속성은 0을 보유합니다.

지원되지 않는 흐름 이름 수
UnsupportedFlowNamesCount integer

작업자가 특정 이름의 흐름 처리를 거부하도록 구성된 경우 이 속성은 목록에 지원되지 않는 흐름 이름의 수를 보유합니다. 작업자가 특정 흐름을 거부하도록 구성되지 않은 경우 이 속성은 0을 보유합니다.

작업자 태그 수
WorkerTagsCount integer

작업자가 일부 태그로 구성된 경우 이 속성은 목록의 태그 수를 보유합니다. 작업자에 태그가 없으면 이 속성은 0을 보유합니다.

작업자 필수 태그 수
WorkerMandatoryTagsCount integer

작업자가 일부 필수 태그로 구성된 경우 이 속성은 목록의 필수 태그 수를 보유합니다. 작업자에 필수 태그가 없는 경우 이 속성은 0을 보유합니다.

Orchestrator 작업자 목록 가져오기

IA-Connect Orchestrator에 등록된 작업자 목록과 해당 라이브 상태를 검색합니다.

매개 변수

Name 필수 형식 Description
라이브 작업자만 반환
OnlyReturnLiveWorkers boolean

라이브 작업자(Orchestrator에 적극적으로 연결된 작업자)만 반환하려면 true로 설정합니다.

반환

Name 경로 형식 Description
오케스트레이터 작업자
OrchestratorWorkers array of object

IA-Connect Orchestrator에 등록된 작업자 목록 및 해당 라이브 상태입니다.

아이디
OrchestratorWorkers.Id integer
이름
OrchestratorWorkers.Name string
CurrentFlowDisplayName
OrchestratorWorkers.CurrentFlowDisplayName string
LiveStatus
OrchestratorWorkers.LiveStatus boolean
LiveStatusLastContactTicks
OrchestratorWorkers.LiveStatusLastContactTicks integer
SecondsSinceLastContact
OrchestratorWorkers.SecondsSinceLastContact integer
MaintenanceMode
OrchestratorWorkers.MaintenanceMode boolean
Priority
OrchestratorWorkers.Priority integer
AgentIsLicensed
OrchestratorWorkers.AgentIsLicensed boolean
IsAvailableForWork
OrchestratorWorkers.IsAvailableForWork boolean
작업자 수
NumberOfOrchestratorWorkers integer

응답의 Orchestrator 작업자 수입니다.

Orchestrator 작업자 유지 관리 모드 설정

IA-Connect Orchestrator에 정의된 IA-Connect 작업자를 유지 관리 모드로 전환하거나(따라서 흐름이 작업자에 할당되지 않음) 작업자를 유지 관리 모드에서 제외합니다.

매개 변수

Name 필수 형식 Description
작업자 ID
WorkerId integer

작업자의 ID입니다. 오케스트레이터 내부 정수 값(1 이상)입니다. Orchestrator UI에서 작업자 세부 정보를 보고 브라우저 URL에서 ID를 찾아 작업자의 ID를 확인할 수 있습니다. 이름으로 작업자를 검색하려면 이 값을 0으로 설정하고 '작업자 이름' 필드에 이름을 입력합니다.

작업자 이름
WorkerName string

작업자의 이름입니다. 이로 인해 Orchestrator는 지정된 이름의 작업자에 대한 작업자 목록을 검색합니다. 이름으로 검색할 때 '작업자 ID'를 0으로 설정합니다(작업자 ID 사용 안 함).

유지 관리 모드
MaintenanceMode boolean

유지 관리 모드를 사용하도록 설정하려면 true(기본값)로 설정하므로 흐름이 작업자에 할당되지 않습니다. 유지 관리 모드를 벗어나려면 false로 설정하여 작업자에게 흐름을 할당할 수 있습니다(작업자가 다른 규칙에 의해 거부되지 않는다고 가정).

반환

Name 경로 형식 Description
명령 결과
SetOrchestratorWorkerMaintenanceModeResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

Orchestrator 흐름 통계에서 마지막으로 실패한 작업 가져오기

작업이 실패한 경우 IA-Connect Orchestrator를 통해 작업자에게 전달된 마지막 작업의 세부 정보를 검색합니다. 이 작업은 오류 처리 중에 가장 일반적으로 사용됩니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
흐름 실행에 할당된 작업자
WorkerAllocatedToFlowRun boolean

이 흐름 실행에 할당된 작업자가 있으면 true를 반환하므로 마지막 작업 오류에 대한 정보를 제공할 수 있습니다. 이 흐름 실행에 할당된 작업자가 없으면 false를 반환합니다(하나도 할당되지 않았거나 작업자를 다른 흐름 실행에 사용할 수 있게 되었습니다). 따라서 마지막 오류에 대한 정보를 제공할 수 없습니다.

마지막 작업이 실패했습니다.
LastActionFailed boolean

이 흐름 실행의 마지막 작업(이 흐름 실행에 할당된 작업자에서 실행됨)이 실패한 경우 true를 반환합니다. 이 작업의 다른 출력에는 세부 정보가 포함됩니다. 이 흐름 실행의 마지막 작업이 실패하지 않으면 false를 반환합니다. 다른 출력은 비어 있습니다.

마지막으로 실패한 작업 요청 경로
LastFailedActionRequestPath string

이 흐름 실행의 마지막 작업(이 흐름 실행에 할당된 작업자에서 실행)이 실패하면 이 출력에는 작업 요청 경로가 포함됩니다. 실패한 작업을 확인하는 데 사용할 수 있습니다. 이 흐름 실행의 마지막 작업이 실패하지 않으면 이 값은 비어 있습니다.

마지막으로 실패한 작업 오류 메시지
LastFailedActionErrorMessage string

이 흐름 실행의 마지막 작업(이 흐름 실행에 할당된 작업자에서 실행)이 실패하면 이 출력에 오류 메시지가 포함됩니다. 이 흐름 실행의 마지막 작업이 실패하지 않으면 이 값은 비어 있습니다.

Orchestrator에서 로그인 기록 가져오기

보고 목적으로 IA-Connect Orchestrator 로그인 기록을 반환합니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

매개 변수

Name 필수 형식 Description
마지막 일 수 이내
WithinLastNumberOfDays integer

지정된 일 수 내에 Orchestrator 로그인만 검색하도록 결과를 필터링합니다. 필터링하지 않도록 0으로 설정합니다.

전자 메일 주소
SearchByEmail string

지정된 이메일 주소를 사용하여 Orchestrator 로그인만 검색하도록 결과를 필터링합니다. 전자 메일 주소로 필터링하지 않도록 공백으로 설정합니다.

로그인 기록 시간 시작 창
SearchLoginHistoryTimeStartWindow date-time

지정된 시작 시간 후에 Orchestrator 로그인만 검색하도록 결과를 필터링합니다. 필터링하지 않도록 공백으로 설정합니다. 예를 들어 '2022-01-24T07:00:00'은 2022년 1월 24일에 07.00시간 이후에 모든 Orchestrator 로그인을 반환합니다. 모든 날짜/시간은 UTC(GMT+0)이므로 DateTime 변환 작업을 사용하여 현지 시간을 UTC로 변환할 수 있습니다.

로그인 기록 시간 종료 기간
SearchLoginHistoryTimeEndWindow date-time

지정된 시작 시간 전에 Orchestrator 로그인만 검색하도록 결과를 필터링합니다. 필터링하지 않도록 공백으로 설정합니다. 예: '2022-01-25T07:00:00'은 2022년 1월 25일에 07.00시간 이전에 모든 Orchestrator 로그인을 반환합니다. 모든 날짜/시간은 UTC(GMT+0)이므로 DateTime 변환 작업을 사용하여 현지 시간을 UTC로 변환할 수 있습니다.

반환

Name 경로 형식 Description
오케스트레이터 로그인 기록 JSON
OrchestratorLoginHistoryJSON string

지정된 필터를 충족하는 모든 Orchestrator 로그인 목록(JSON 형식)입니다.

Orchestrator 로그인 수
NumberOfOrchestratorLogins integer

반환된 Orchestrator 로그인 수입니다.

Orchestrator에서 작업자 가용성 통계 가져오기

IA-Connect Orchestrator에서 작업자 가용성 통계를 반환합니다. 보고 목적으로 사용됩니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

매개 변수

Name 필수 형식 Description
마지막 일 수 이내
WithinLastNumberOfDays integer

결과를 필터링하여 마지막으로 지정한 일 수 내에 시작된 결과만 검색합니다. 필터링하지 않도록 0으로 설정합니다.

흐름 이름
SearchFlowName string

지정된 흐름 이름을 가진 결과만 검색하도록 결과를 필터링합니다. 흐름 이름으로 필터링하지 않도록 공백으로 설정합니다.

흐름 시작 시간 시작 시간 창
SearchFlowStartTimeStartWindow date-time

지정된 시작 시간 이후에 시작된 결과만 검색하도록 결과를 필터링합니다. 필터링하지 않도록 공백으로 설정합니다. 예를 들어 '2022-01-24T07:00:00'은 2022년 1월 24일에 07.00시간 이후에 시작된 흐름에 대한 모든 오케스트레이터 흐름 통계를 반환합니다. 모든 날짜/시간은 UTC(GMT+0)이므로 DateTime 변환 작업을 사용하여 현지 시간을 UTC로 변환할 수 있습니다.

반환

Name 경로 형식 Description
작업자 가용성 통계 JSON
WorkerAvailabilityStatsJSON string

JSON 형식의 작업자 가용성 통계 목록입니다.

작업자 가용성 통계 수
NumberOfWorkerAvailabilityStats integer

반환된 작업자 가용성 통계의 수입니다.

Orchestrator에서 작업자 할당

IA-Connect Orchestrator에서 작업자를 할당합니다. 태그 또는 작업자 이름(또는 둘 다 또는 둘 다)으로 작업자를 요청할 수 있으므로 필요한 작업자를 보다 정확하게 선택할 수 있습니다. 작업자가 할당되면 흐름에 할당되고 작업 수행으로 보고됩니다. 오케스트레이터는 할당을 수행할 때 여전히 '지원되는 흐름 환경 ID', '지원되는 흐름 이름' 및 '지원되지 않는 흐름 이름'을 고려합니다. 여러 작업자가 검색과 일치하면 일반 부하 분산 규칙이 적용됩니다.

매개 변수

Name 필수 형식 Description
작업자 태그
WorkerTag string

할당할 작업자의 선택적 태그입니다. 태그를 사용하면 작업자를 그룹으로 분류할 수 있습니다. 태그 이름은 대/소문자를 구분하지 않습니다. 여러 태그를 별도의 줄에 입력하여 지정할 수 있으며, 할당 메커니즘은 해당 태그가 있는 작업자를 고려합니다(하나의 태그만 일치해야 합니다). 와일드카드: 태그*(예: 와일드카드: JML*) 형식을 사용하여 와일드카드 검색을 수행하고 RegEx: TagExpression 형식(예: RegEx: ^JML)을 사용하여 정규식 검색을 수행할 수 있습니다.

작업자 이름
WorkerName string

할당할 작업자의 선택적 이름입니다. 작업자 이름은 대/소문자를 구분하지 않습니다. 여러 작업자를 별도의 줄에 입력하여 지정할 수 있으며 할당 메커니즘은 일치하는 이름을 가진 작업자를 고려합니다. 와일드카드: Name*(예: 와일드카드: vmrpa*) 형식을 사용하여 와일드카드 검색을 수행하고 RegEx: Expression 형식(예: RegEx: ^vmrpa)을 사용하여 정규식 검색을 수행할 수 있습니다.

작업자를 즉시 사용할 수 없는 경우 예외 발생
RaiseExceptionIfWorkerNotImmediatelyAvailable boolean

true로 설정하고 적합한 작업자를 할당할 수 없는 경우 예외가 발생합니다. false(기본값)로 설정하고 적절한 작업자를 할당할 수 없는 경우 Orchestrator는 HTTP 상태 코드 500을 반환하여 '재시도 정책'에 따라 PA 흐름이 대기합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
할당된 작업자 이름
WorkerNameAllocated string

할당된 작업자의 이름입니다. 작업자가 할당되지 않은 경우 비어 있습니다.

Orchestrator에서 작업자 흐름 사용 열 지도 가져오기

IA-Connect Orchestrator에서 작업자 흐름 사용량 일별 열 지도를 반환합니다. 보고 목적으로 사용됩니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

매개 변수

Name 필수 형식 Description
흐름 시작 시간 시작 시간 창
SearchStartDateStartWindow True date-time

지정된 시작 날짜 이후 작업자 흐름 사용 열 지도만 검색하도록 결과를 필터링합니다(시간 구성 요소는 무시됨). 필터링하지 않도록 공백으로 설정합니다. 예: '2022-01-24T00:00:00'은 2022년 1월 24일 이후에 시작된 흐름에 대한 작업자 열 지도를 반환합니다. 모든 날짜/시간은 UTC(GMT+0)이므로 DateTime 변환 작업을 사용하여 현지 시간을 UTC로 변환할 수 있습니다.

흐름 시작 시간 종료 기간
SearchStartDateEndWindow True date-time

지정된 시작 날짜(시간 구성 요소는 무시됨)전에 작업자 흐름 사용 열 지도만 검색하도록 결과를 필터링합니다. 필터링하지 않도록 공백으로 설정합니다. 예를 들어 '2022-01-25T00:00:00'은 2022년 1월 25일 또는 그 이전에 시작된 Flow에 대한 작업자 열 지도를 반환합니다. 모든 날짜/시간은 UTC(GMT+0)이므로 DateTime 변환 작업을 사용하여 현지 시간을 UTC로 변환할 수 있습니다.

UTC에서 표준 시간대 분 오프셋
TimeZoneMinutesOffsetFromUTC integer

일별 열 지도를 정렬하기 위한 UTC의 표준 시간대 오프셋(분)입니다. 예를 들어 60분을 지정하면 일별 열 지도가 01:00 UTC에서 01:00 UTC까지 실행됩니다.

작업자 이름 IA-Connect
WorkerNames string

JSON 또는 CSV 형식으로 열 지도를 반환할 IA-Connect Worker의 이름 목록입니다. 비워 두면 현재 Orchestrator에 알려진 모든 작업자에 대해 열 지도가 생성됩니다. 예: [{"WorkerName": "Worker1"}, {"WorkerName": "Worker2"}](JSON 테이블 형식), ["Worker1", "Worker2"](JSON 배열 형식) 또는 Worker1,Worker2(CSV 형식).

반환

Name 경로 형식 Description
작업자 흐름 사용 열 지도 JSON
WorkerFlowUsageHeatmapJSON string

JSON 형식의 작업자 흐름 사용 열 지도입니다.

작업자 흐름 사용 열 지도 항목 수
NumberOfWorkerFlowUsageHeatmapItems integer

반환된 작업자 흐름 사용 열 지도 항목의 수입니다. 작업자당 일당 하나의 항목입니다.

Orchestrator에서 제네릭 자격 증명 가져오기

IA-Connect Orchestrator에 저장된 제네릭 자격 증명을 검색합니다. 자격 증명은 사용자 이름, 암호, 호스트 이름, URL 및 기타 일반 데이터를 보유할 수 있습니다.

매개 변수

Name 필수 형식 Description
친근한 이름
FriendlyName string

Orchestrator에 저장된 자격 증명의 이름입니다.

일반 텍스트 암호 검색
RetrievePlainTextPassword boolean

이 옵션을 선택하면 Orchestrator 일반 자격 증명 설정 '암호 노출 안 함'이 비활성화된 경우 지정된 Orchestrator 제네릭 자격 증명의 암호가 일반 텍스트로 반환됩니다(암호 검색 허용). 암호를 일반 텍스트로 검색하지 않고 저장 암호를 지원하는 IA-Connect 작업(예: 'UIA 작업에 암호 입력')을 사용하는 것이 좋습니다. 여기서 Orchestrator는 런타임에 작업에 직접 암호를 삽입합니다.

반환

Name 경로 형식 Description
사용자 이름
Username string

제네릭 자격 증명에 보관된 사용자 이름입니다.

일반 텍스트 암호
PlainTextPassword string

일반 텍스트 문자열로 일반 자격 증명에 보관된 암호입니다. 오케스트레이터 암호는 암호화된 상태로 저장되지만 필요한 작업에 전달할 수 있도록 일반 텍스트로 반환됩니다.

호스트 이름
Hostname string

사용되는 경우 제네릭 자격 증명에 보관된 호스트 이름 또는 도메인 이름입니다.

URL
Url string

사용되는 경우 제네릭 자격 증명에 보관된 URL입니다.

제네릭 속성 1
GenericProperty1 string

사용되는 경우 제네릭 자격 증명에 보관된 제네릭 속성입니다. 자격 증명과 연결될 수 있는 데이터를 저장하는 데 사용할 수 있습니다.

제네릭 속성 2
GenericProperty2 string

사용되는 경우 제네릭 자격 증명에 보관된 제네릭 속성입니다. 자격 증명과 연결될 수 있는 데이터를 저장하는 데 사용할 수 있습니다.

제네릭 속성 3
GenericProperty3 string

사용되는 경우 제네릭 자격 증명에 보관된 제네릭 속성입니다. 자격 증명과 연결될 수 있는 데이터를 저장하는 데 사용할 수 있습니다.

Orchestrator에서 흐름 통계 가져오기

IA-Connect Orchestrator에서 Flow 통계 목록을 반환합니다. 보고 목적으로 사용됩니다. 필요에 따라 하나 이상의 필터를 사용하여 반환된 결과를 제한할 수 있습니다.

매개 변수

Name 필수 형식 Description
마지막 일 수 이내
WithinLastNumberOfDays integer

결과를 필터링하여 마지막으로 지정한 일 수 내에 시작된 결과만 검색합니다. 필터링하지 않도록 0으로 설정합니다.

흐름 이름
SearchFlowName string

지정된 흐름 이름을 가진 결과만 검색하도록 결과를 필터링합니다. 흐름 이름으로 필터링하지 않도록 공백으로 설정합니다.

흐름 마지막 작업 결과
SearchFlowLastActionResult boolean

지정한 마지막 작업 결과가 있는 결과만 검색하도록 결과를 필터링합니다. 성공한 흐름만 검색하려면 true로 설정합니다. 실패한 흐름만 검색하려면 false로 설정합니다. Flow 마지막 작업 결과로 필터링하지 않도록 값/빈 값으로 설정하지 마세요.

흐름 시작 시간 시작 시간 창
SearchFlowStartTimeStartWindow date-time

지정된 시작 시간 이후에 시작된 결과만 검색하도록 결과를 필터링합니다. 필터링하지 않도록 공백으로 설정합니다. 예를 들어 '2022-01-24T07:00:00'은 2022년 1월 24일에 07.00시간 이후에 시작된 흐름에 대한 모든 오케스트레이터 흐름 통계를 반환합니다. 모든 날짜/시간은 UTC(GMT+0)이므로 DateTime 변환 작업을 사용하여 현지 시간을 UTC로 변환할 수 있습니다.

흐름 시작 시간 종료 기간
SearchFlowStartTimeEndWindow date-time

지정된 시작 시간 전에 시작된 결과만 검색하도록 결과를 필터링합니다. 필터링하지 않도록 공백으로 설정합니다. 예를 들어 '2022-01-25T07:00:00'은 2022년 1월 25일 07.00시간 이전에 시작된 흐름에 대한 모든 Orchestrator Flow 통계를 반환합니다. 모든 날짜/시간은 UTC(GMT+0)이므로 DateTime 변환 작업을 사용하여 현지 시간을 UTC로 변환할 수 있습니다.

반환

Name 경로 형식 Description
오케스트레이터 흐름 통계 JSON
OrchestratorFlowStatsJSON string

JSON 형식의 모든 오케스트레이터 흐름 통계 목록입니다.

흐름 통계 수
NumberOfOrchestratorFlowStats integer

반환된 흐름 통계의 수입니다.

PowerShell 프로세스 실행

PowerShell 프로세스를 시작하고, 디스크에서 기존 스크립트를 실행하거나, 실행할 스크립트의 콘텐츠를 제공합니다. 훨씬 더 강력하며 PowerShell 스크립트에서 출력의 데이터 테이블을 제공하는 'PowerShell 스크립트 실행' 작업을 대신 사용하는 것이 좋습니다. PowerShell 스크립트가 표준 출력 또는 표준 오류로 출력되거나(예: 테이블을 반환하는 대신 Write-Host 사용), PowerShell 7이 필요하거나, 대체 사용자로 Active Directory 작업을 실행 중이며 WinRM을 통한 CredSSP를 사용할 수 없는 경우 이 작업을 사용합니다.

매개 변수

Name 필수 형식 Description
PowerShell 실행 파일
PowerShellExecutable string

PowerShell 실행 파일의 경로입니다. Windows 경로에 정의된 대로 기본 PowerShell 실행 파일을 실행하려면 'PowerShell.exe'의 기본값으로 둡니다. PowerShell 5.x에는 '%SYSTEMROOT%\system32\WindowsPowerShell\v1.0\PowerShell.exe'을 사용합니다. PowerShell 7에 'C:\Program Files\PowerShell\7\pwsh.exe'을 사용합니다. IA-Connect 에이전트는 경로의 모든 환경 변수를 확장합니다.

PowerShell 스크립트 파일 경로
PowerShellScriptFilePath string

실행할 기존 PowerShell 스크립트의 경로입니다. PowerShell 스크립트는 IA-Connect 에이전트에서 액세스할 수 있어야 합니다(예: 에이전트가 원격 세션에서 실행 중인 경우 스크립트는 원격 시스템에 있거나 원격 시스템에서 액세스할 수 있어야 합니다). 또는 이 입력을 비워 두고 PowerShell 스크립트의 내용을 'PowerShell 스크립트 콘텐츠' 입력에 제공합니다. IA-Connect 에이전트는 경로의 모든 환경 변수를 확장합니다.

PowerShell 스크립트 내용
PowerShellScriptContents string

기존 PowerShell 스크립트에 대한 경로를 제공하는 대신 실행할 PowerShell 스크립트의 내용입니다.

작업 폴더
WorkingDirectory string

PowerShell 스크립트의 작업 폴더/디렉터리입니다. IA-Connect 에이전트는 경로의 모든 환경 변수를 확장합니다.

창 만들기
CreateNoWindow boolean

true(기본값)로 설정하면 PowerShell 스크립트가 보이지 않게 실행됩니다. false로 설정하면 PowerShell 스크립트 창이 표시됩니다. PowerShell 스크립트에서 입력을 묻는 메시지를 표시하고 UIA 및 전역 마우스 및 키보드 작업을 사용하여 상호 작용하려는 경우에 유용할 수 있습니다.

창 스타일
WindowStyle string

PowerShell 스크립트가 눈에 띄게 실행되도록 구성된 경우 창 스타일(일반, 최대화, 최소화 또는 숨김)을 제공합니다.

프로세스 대기
WaitForProcess boolean

IA-Connect 에이전트가 PowerShell 스크립트가 완료되기를 기다려야 하나요? IA-Connect 에이전트가 스크립트에서 출력을 가져올 수 있도록 기본적으로 true로 설정됩니다. fire-and-forget에 대해 false로 설정합니다.

표준 출력 리디렉션
RedirectStandardOutput boolean

true(기본값)로 설정하면 스크립트의 표준 출력이 리디렉션되어 에이전트가 StandardOutput 변수에서 반환할 수 있습니다. 이는 스크립트의 출력을 에이전트(예: Write-Host출력)로 반환하려는 경우에 유용합니다.

리디렉션 표준 오류
RedirectStandardError boolean

true로 설정하면 스크립트의 표준 오류가 리디렉션되어 에이전트가 StandardError 변수에 반환할 수 있습니다.

표준 오류를 출력으로 리디렉션
RedirectStandardErrorToOutput boolean

true로 설정하면 스크립트의 표준 오류가 표준 출력으로 리디렉션되어 단일 출력으로 병합됩니다.

표준 출력 인코딩
StandardOutputEncoding string

표준 출력 인코딩(UTF8, UTF7, UTF16, ASCII 또는 UTF16BE)을 제공합니다.

표준 오류 인코딩
StandardErrorEncoding string

표준 오류 인코딩(UTF8, UTF7, UTF16, ASCII 또는 UTF16BE)을 제공합니다.

RunAs 도메인 이름
RunAsDomain string

사용자로 실행의 도메인입니다. 도메인을 지정하지 않으면 사용자 이름이 username@domainFQDN 형식이어야 합니다.

RunAs 사용자 이름
RunAsUsername string

사용자로 실행의 사용자 이름입니다.

RunAs 암호
RunAsPassword password

사용자로 실행의 암호입니다.

RunAs 로드 사용자 프로필
RunAsLoadUserProfile boolean

실행의 Windows 사용자 프로필을 사용자로 로드해야 하나요?

RunAs elevate
RunAsElevate boolean

PowerShell 스크립트를 관리자 권한으로 실행해야 하나요? 상승 요청을 수락하는 데 매우 어려움이 있을 수 있습니다.

제한 시간(초)
TimeoutInSeconds integer

PowerShell 스크립트가 완료되기를 기다리는 최대 시간(초)입니다.

PowerShell 스크립트 임시 폴더
PowerShellScriptTempFolder string

기본적으로 'PowerShell 스크립트 콘텐츠' 입력에 PowerShell 스크립트를 제공하는 경우 IA-Connect 에이전트는 -File 입력을 통해 '%TEMP%\IA-Connect\TempPowerShell-{Date}-{Time}.ps1', passes it to PowerShell.exe' 파일에 스크립트를 저장하고 스크립트가 완료되면 파일을 삭제합니다. RunAs 사용자가 IA-Connect 에이전트를 실행하는 계정의 프로필에 액세스할 수 없으므로 RunAs 사용자 이름을 사용하는 경우 이 기본 경로가 허용되지 않을 수 있습니다. 이 입력을 사용하여 대체 폴더를 제공합니다. 예: '%SYSTEMDRIVE% emp'. IA-Connect 에이전트는 경로의 모든 환경 변수를 확장합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프로세스 시작됨
ProcessStarted boolean

PowerShell 스크립트 프로세스(PowerShell.exe)가 시작된 경우 true를 반환합니다.

종료 코드
ExitCode integer

PowerShell 스크립트 프로세스(PowerShell.exe) 종료 코드를 반환합니다.

프로세스 시간이 초과됨
ProcessTimedOut boolean

PowerShell 스크립트 프로세스(PowerShell.exe)의 시간이 초과되면 true를 반환합니다.

프로세스 ID
ProcessId integer

시작된 PowerShell 스크립트 프로세스(PowerShell.exe)의 프로세스 ID입니다.

표준 출력
StandardOutput string

표준 출력 내용입니다.

표준 오류
StandardError string

표준 오류 내용입니다.

RDS(원격 데스크톱 세션) 시작

RDP 시작 파일을 사용하여 RDS(원격 데스크톱 세션)를 시작합니다.

매개 변수

Name 필수 형식 Description
RDP 파일 경로
RDPFilePath True string

RDP 파일의 전체 경로입니다('RDS(원격 데스크톱 세션) 시작 파일 만들기' 작업을 사용하여 사전 존재하거나 만들 수 있음).

원격 컴퓨터 신뢰
TrustRemoteComputer boolean

원격 주소(RDP 파일에 설정됨)를 신뢰할 수 있는 주소(Windows 레지스트리)로 표시하려면 true로 설정하며, 주로 디바이스 리디렉션을 위해 RDP 파일을 시작할 때 받을 수 있는 팝업을 제거합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
LaunchRemoteDesktopSessionResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

RDS(원격 데스크톱 세션) 시작 파일 만들기

원격 데스크톱 클라이언트 UI의 자동화를 요구하는 대신 지정된 매개 변수를 사용하여 원격 데스크톱 세션을 자동으로 시작하는 데 사용할 수 있는 RDS(원격 데스크톱 세션) 시작 파일을 만듭니다. RDS 시작 파일의 확장명은 '.rdp'이며 종종 RDP 파일이라고 합니다.

매개 변수

Name 필수 형식 Description
원격 주소
RemoteAddress True string

연결할 원격 시스템의 주소입니다. IP 주소, 호스트 이름 또는 FQDN(정규화된 도메인 이름)일 수 있습니다.

출력 폴더 경로
OutputFolderPath True string

RDP 파일을 저장할 폴더입니다.

RDP 파일 이름
RDPFileName True string

출력 폴더 경로에 만들 RDP 파일의 이름입니다.

이미 있는 경우 RDP 파일 덮어쓰기
OverwriteRDPFileIfAlreadyExists boolean

동일한 폴더/파일 이름을 사용하여 RDP 파일을 자동으로 덮어쓰려면 true로 설정합니다. 폴더/파일 이름이 같은 기존 RDP 파일이 이미 있는 경우 새 RDP 파일을 만들지 않아야 하는 경우 false로 설정합니다.

원격 컴퓨터 신뢰
TrustRemoteComputer boolean

주로 디바이스 리디렉션을 위해 원격 주소를 신뢰할 수 있는 주소로 표시하려면 true로 설정하면 RDP 파일을 시작할 때 받을 수 있는 팝업이 제거됩니다.

자격 증명 저장
StoreCredentials boolean

True로 설정하여 원격 데스크톱 인증 세부 정보를 저장할 사용자 자격 증명을 만듭니다. 이렇게 하면 인증하라는 메시지가 표시되지 않고 원격 데스크톱 시스템에 연결할 수 있습니다.

사용자 이름
UserName string

원격 데스크톱 인증 세부 정보를 보관할 자격 증명을 저장하는 경우 자격 증명에 저장할 사용자 이름을 지정할 수 있습니다.

암호
Password string

원격 데스크톱 인증 세부 정보를 보관할 자격 증명을 저장하는 경우 자격 증명에 저장할 암호를 지정할 수 있습니다.

자격 증명 형식
CredentialType string

원격 데스크톱 인증 세부 정보를 보관할 자격 증명을 저장하는 경우 자격 증명 유형(Windows 또는 제네릭)을 지정할 수 있습니다. RDP 자격 증명을 저장하기 위해 일반적으로 Windows 자격 증명을 만듭니다.

자격 증명 지속성
CredentialPersistence string

원격 데스크톱 인증 세부 정보를 보관하기 위해 자격 증명을 저장하는 경우 자격 증명 지속성을 지정할 수 있습니다. 세션(이 로그인 세션에 대해서만 지속됨), LocalMachine(이 사용자에 대해 세션 간에 지속되며 이 컴퓨터에서만 재부팅됨) 또는 Enterprise(컴퓨터 간에 로밍할 수 있음). RDP 파일을 만들 때 기본값은 '세션'입니다.

프린터 리디렉션
RedirectPrinters boolean

로컬 세션의 프린터를 원격 데스크톱 세션에 매핑해야 하나요? 이 설정은 원격 엔드에서 적용되므로 적용되지 않을 수 있습니다.

모든 드라이브 리디렉션
RedirectAllDrives boolean

로컬 세션의 모든 드라이브 문자(예: C:)를 원격 데스크톱 세션에 매핑해야 하나요? 이 설정은 원격 엔드에서 적용되므로 적용되지 않을 수 있습니다.

클립보드 리디렉션
RedirectClipboard boolean

클립보드를 로컬 및 원격 시스템 간에 공유하여 두 시스템 간에 복사 및 붙여넣기를 허용해야 하나요? 이 설정은 원격 엔드에서 적용되므로 적용되지 않을 수 있습니다.

전체 화면
Fullscreen boolean

원격 데스크톱 세션이 전체 화면이어야 합니다.

데스크톱 너비
DesktopWidth integer

원격 데스크톱 세션이 전체 화면이 아닌 경우 원격 데스크톱 세션의 너비(픽셀)입니다.

데스크톱 높이
DesktopHeight integer

원격 데스크톱 세션이 전체 화면이 아닌 경우 원격 데스크톱 세션의 높이(픽셀)입니다.

다중 모니터 사용
UseMultiMonitor boolean

전체 화면 원격 데스크톱 세션에서 단일 모니터만 사용해야 하는 경우 false로 설정합니다. 전체 화면 원격 데스크톱 세션에서 모든 모니터를 사용해야 하는 경우 true로 설정합니다. 단일 모니터 시스템(따라서 대부분의 가상 머신)에 영향을 주지 않습니다.

세션 색상 깊이
SessionBPP integer

원격 데스크톱 세션의 색상 깊이(BPP(픽셀당 비트)입니다. 숫자가 높을수록 더 많은 색상이 생성됩니다. 지원되는 값은 15, 16, 24, 32입니다.

스마트 크기 조정
SmartSizing boolean

로컬 컴퓨터가 창 크기에 맞게 원격 세션의 내용 크기를 자동으로 조정하려면 true로 설정합니다. 자동으로 크기를 조정하지 않도록 false로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
RDP 파일 경로
RDPFilePath string

생성된 RDP 파일의 전체 경로입니다.

TCP 포트가 응답하고 있는지

네트워크 TCP 포트가 IA-Connect 에이전트의 연결 시도에 응답하는지 여부를 보고합니다. IA-Connect 에이전트가 실행 중인 컴퓨터의 TCP 포트(원격 호스트의 경우 'localhost' 입력) 또는 원격 컴퓨터의 TCP 포트일 수 있습니다. IA-Connect 에이전트가 TCP 포트에 성공적으로 연결되면 TCP 연결이 즉시 닫힙니다.

매개 변수

Name 필수 형식 Description
원격 호스트
RemoteHost True string

연결할 컴퓨터의 IPv4 주소, DNS 주소 또는 호스트 이름입니다. 'localhost'를 입력하여 IA-Connect 에이전트가 실행 중인 컴퓨터에서 TCP 포트를 확인합니다. 예: 192.168.1.10 또는 www.test.com 또는 vm-server19.

TCP 포트
TCPPort True integer

지정된 원격(또는 로컬) 호스트에서 연결할 TCP 포트 번호입니다. TCP 포트는 1 이상 및 65535 이하여야 합니다. 잘 알려진 일반적인 포트의 예로는 80(HTTP), 443(HTTPS), 445(SMB/파일 공유)가 있습니다.

제한 시간(초)
TimeoutInSeconds integer

TCP 연결을 대기할 최대 시간(초)입니다. 기본값은 10초이지만 대부분의 작동 중인 연결은 몇 초(인터넷을 통해) 또는 1초 미만(로컬 네트워크)에 연결되어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
연결된 TCP 포트
TCPPortConnected boolean

TCP 포트가 연결된 경우 true로 설정하거나 TCP 포트를 연결하지 못한 경우 false로 설정합니다.

연결 오류 메시지
ConnectionErrorMessage string

TCP 포트를 연결하지 못한 경우의 오류 메시지입니다. 이는 일반적으로 DNS/이름 조회 오류 또는 시간 제한입니다.

UnZIP 파일

ZIP 압축을 사용하여 압축된 파일의 압축을 해제합니다.

매개 변수

Name 필수 형식 Description
ZIP 파일 경로
ZIPFilename True string

압축을 풀 ZIP 파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

폴더 추출
ExtractFolder string

ZIP을 추출할 폴더의 폴더 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

모든 파일을 단일 폴더로 추출
ExtractAllFilesToSingleFolder boolean

True로 설정하면 ZIP 내의 폴더 구조가 무시되고 모든 파일이 지정된 폴더로 추출됩니다.

파일 정규식 포함
IncludeFilesRegEx string

추출할 파일을 지정할 수 있는 선택적 정규식입니다. 파일 이름만 일치합니다.

파일 정규식 제외
ExcludeFilesRegEx string

추출에서 제외할 파일을 지정할 수 있는 선택적 정규식입니다. 파일 이름만 일치합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
성공적으로 추출된 파일 수
FilesExtractedSuccessfully integer

ZIP에서 성공적으로 추출된 파일 수입니다.

추출하지 못한 파일 수
FilesFailedToExtract integer

ZIP에서 추출하지 못한 파일 수입니다.

제외된 파일 수
FilesExcluded integer

제외된 파일의 수입니다('제외 파일 정규식' 입력을 사용하는 경우).

Web API에 메시지 보내기

웹 API에 메시지를 보내고 응답을 받습니다. 이는 모든 웹 API와 함께 사용할 수 있지만 일반적인 사용은 REST API입니다. IA-Connect 가상 머신(즉, 온-프레미스 리소스에 액세스하기 위해) 또는 Citrix 또는 Microsoft 원격 데스크톱 세션을 통해(예: 격리된 환경에서만 액세스 가능한 API에 액세스하기 위해) 웹 API로 메시지를 보낼 수 있도록 지원합니다.

매개 변수

Name 필수 형식 Description
URL
URL string

메시지를 보낼 API의 전체 URL입니다. 예: https://myapi.remotesystem.com/path/action.

메서드
Method string

사용할 HTTP 메서드입니다. 원격 API에서 예상되는 것과 일치해야 합니다.

제한 시간(초)
TimeoutInSeconds integer

응답을 대기할 시간(초)입니다. HTTP 응답을 받기 전에 시간 제한에 도달하면 예외가 발생합니다.

콘텐츠 형식
ContentType string

메시지 본문에 전송된 데이터의 콘텐츠 형식입니다(있는 경우). 이는 원격 API에서 예상되는 것과 일치해야 합니다. 본문에 JSON 페이로드가 예상되는 REST API를 호출하는 경우 콘텐츠 형식은 애플리케이션/json일 수 있습니다. charset=utf-8.

Accept
Accept string

응답 데이터에 허용되는 형식입니다. 이는 원격 API에서 예상되는 것과 일치해야 합니다. JSON 페이로드를 반환하는 REST API를 호출하는 경우 수락 값은 애플리케이션/json일 수 있습니다. 응답을 수락하려면 .를 입력합니다 /.

메시지 본문
MessageBody string

메시지 본문에 데이터가 있는 웹 API를 호출하는 경우(PUT, POST, PATCH와 공통) 본문의 내용을 이 입력에 입력합니다. REST API를 호출하는 경우 JSON 데이터가 포함될 수 있습니다. JSON 데이터가 필요하지만 전송되는 데이터가 없는 REST API를 호출하는 경우 이 입력을 입력 {} 해야 할 수 있습니다. 기본적으로 UTF-8 인코딩이 사용되지만 '인코딩' 입력을 사용하여 변경할 수 있습니다.

전송 인코딩
TransmitEncoding string

전송된 메시지 본문에 대한 인코딩입니다(있는 경우). UTF 인코딩은 유니코드 데이터를 전송하는 데 사용됩니다. BE는 빅 엔디안입니다.

응답 인코딩
ResponseEncoding string

응답 본문에 있는 응답 데이터의 인코딩입니다(있는 경우). 응답 인코딩이 전송 인코딩과 일치할 가능성이 높습니다. UTF 인코딩은 유니코드 데이터를 전송하는 데 사용됩니다. BE는 빅 엔디안입니다.

버퍼 크기
BufferSize integer

출력 스트림에서 읽은 각 개별의 크기입니다. 수정해야 할 가능성은 매우 낮습니다. 응답의 크기는 제한되지 않습니다. 블록 크기입니다.

재산
Property string
가치
Value string
TLS 1.0 협상
NegotiateTLS10 boolean

HTTPS 및 TLS 1.0 보안을 원격 시스템과 협상해야 하는 경우 true로 설정합니다. 둘 이상의 TLS 보안 수준을 협상할 수 있으며 클라이언트와 원격 시스템 간의 가장 높은 공통 협상 수준이 사용됩니다. 경고: TLS 1.0은 더 이상 사용되지 않으므로 원격 시스템이 더 높은 수준(이전 및 잠재적으로 패치되지 않을 수 있음)을 지원하지 않는 한, 보안 위험을 이해하고 수락하면 안 됩니다.

TLS 1.1 협상
NegotiateTLS11 boolean

HTTPS 및 TLS 1.1 보안을 원격 시스템과 협상해야 하는 경우 true로 설정합니다. 둘 이상의 TLS 보안 수준을 협상할 수 있으며 클라이언트와 원격 시스템 간의 가장 높은 공통 협상 수준이 사용됩니다. 경고: TLS 1.1은 더 이상 사용되지 않으므로 원격 시스템이 더 높은 수준(이전 및 잠재적으로 패치되지 않을 수 있음)을 지원하지 않는 한, 보안 위험을 이해하고 수락하면 안 됩니다.

TLS 1.2 협상
NegotiateTLS12 boolean

HTTPS 및 TLS 1.2 보안을 원격 시스템과 협상해야 하는 경우 true로 설정합니다. 둘 이상의 TLS 보안 수준을 협상할 수 있으며 클라이언트와 원격 시스템 간의 가장 높은 공통 협상 수준이 사용됩니다. TLS 1.2는 최소 권장 보안 수준입니다.

TLS 1.3 협상
NegotiateTLS13 boolean

HTTPS 및 TLS 1.3 보안을 원격 시스템과 협상해야 하는 경우 true로 설정합니다. 둘 이상의 TLS 보안 수준을 협상할 수 있으며 클라이언트와 원격 시스템 간의 가장 높은 공통 협상 수준이 사용됩니다. TLS 1.3은 Windows 11 이상 및 Server 2022 이상에서만 지원됩니다.

살아남기
KeepAlive boolean

keep-alive를 사용하도록 설정해야 하는 경우 true로 설정합니다. 짧은 시간 범위(1분 미만) 내에 동일한 엔드포인트에 여러 API 요청을 수행하므로 성능이 향상되는 경우 TCP 연결을 다시 사용합니다. 단일 API 호출만 하려는 경우 또는 API 호출 사이의 시간이 1분 이상인 경우 false로 설정합니다. 이를 잘못 구성하면 성능에만 영향을 주기 때문에 최소한의 피해가 있습니다.

100 계속 예상
Expect100Continue boolean

POST 요청을 사용하여 많은 양의 데이터를 보내고, 데이터를 보내기 전에 서버가 요청을 수락할지 여부를 확인하려는 경우 true로 설정합니다. False는 서버로 전송되는 패킷 수를 줄여 응답 시간을 단축하므로 대부분의 시나리오에서 가장 잘 작동합니다.

응답 헤더 반환
ReturnResponseHeaders boolean

IA-Connect 에이전트가 응답에서 원격 시스템에서 받은 HTTP 헤더를 반환하도록 하려면 true로 설정합니다. 응답은 JSON 형식입니다. 응답 크기가 증가하기 때문에 정보(예: 반환된 쿠키)에 대한 응답 헤더를 처리하려는 경우에만 이 기능을 사용합니다.

스레드로 실행
RunAsThread boolean

false로 설정하면 IA-Connect 에이전트는 작업을 즉시 실행하고 작업이 완료되면 결과를 반환하지만 작업자/RPA 명령 제한 시간보다 오래 걸리면 실패합니다. true로 설정하면 IA-Connect 에이전트는 이 작업을 에이전트 스레드로 실행하고 완료될 때까지 모니터링합니다. 이렇게 하면 작업자/RPA 명령 제한 시간보다 더 오랫동안 작업을 실행할 수 있습니다.

스레드 대기
WaitForThread boolean

'스레드로 실행'이 true로 설정된 경우에만 사용됩니다. 에이전트 스레드가 완료되기를 기다리려면 이 입력을 true로 설정합니다. 에이전트는 '시간 제한(초)'으로 지정된 기간 동안 대기합니다. 대기를 무시하려면 false로 설정합니다. 에이전트는 백그라운드에서 작업을 계속 수행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 나중에 '에이전트 스레드가 완료되기를 기다립니다.' 작업을 사용하여 에이전트 스레드가 완료되기를 기다렸다가 '스레드 ID에 대한 출력 데이터 검색' 입력을 에이전트 스레드 ID로 설정하여 이 작업을 다시 실행할 수 있습니다.

스레드 ID에 대한 출력 데이터 검색
RetrieveOutputDataFromThreadId integer

이전에 '스레드 대기'를 false로 설정한 경우(에이전트가 백그라운드 스레드에서 대기를 수행하게 됨) 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. 그렇지 않으면 0(기본값)으로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
응답 상태 코드
ResponseStatusCode integer

HTTP 응답 코드입니다. 일반적인 성공적인 응답은 200(OK), 201(생성됨), 202(수락됨)입니다. 3xx 응답 코드는 리디렉션 메시지입니다. 4xx 응답 코드는 클라이언트 오류 메시지입니다(예: 요청에 문제가 있는 경우). 5xx 응답 코드는 서버 오류 메시지입니다. 대신 예외가 발생하므로 4xx 및 5xx 응답 코드는 일반적으로 이 출력에 표시되지 않습니다.

응답 메시지
ResponseMessage string

HTTP 응답 본문의 응답 메시지 내용입니다.

응답 콘텐츠 형식
ResponseContentType string

응답 본문의 콘텐츠 형식( 응답 본문이 있는 경우 및 형식이 제공된 경우)입니다.

응답 헤더 JSON
ResponseHeadersJSON string

입력 '응답 헤더 반환'이 true로 설정된 경우 이 출력에는 JSON 형식의 HTTP 응답 헤더가 포함됩니다. 응답 크기가 증가하기 때문에 정보(예: 반환된 쿠키)에 대한 응답 헤더를 처리하려는 경우에만 이 기능을 사용합니다.

스레드 ID
ThreadId integer

'스레드 대기'를 false로 설정하면(에이전트가 백그라운드 스레드에서 대기를 수행하게 됨) 이 출력에는 작업의 프로세스를 모니터링하고 스레드가 완료되면 나중에 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다.

ZIP에 파일 추가

파일을 압축 보관에 저장하여 파일을 압축합니다.

매개 변수

Name 필수 형식 Description
ZIP에 추가할 원본 파일 경로
SourceFilenameToAddToZIP True string

zip에 추가할 파일의 파일 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

출력 ZIP 파일 경로
OutputZIPFilename True string

ZIP이 출력되어야 하는 파일 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

ZIP의 폴더에 파일 이름 추가
AddFilenameToFolderInZIP string

ZIP 파일의 폴더에 원본 파일을 추가하려면 여기에 폴더 이름을 입력합니다.

ZIP 주석에 추가할 원본 파일 이름
SourceFilenameToAddToZIPComment string

ZIP에 추가된 이 파일에 대한 선택적 주석입니다.

압축
Compress boolean

압축할 때 파일을 압축해야 하나요?

기존 ZIP 파일에 추가
AddToExistingZIPFile boolean

기존 ZIP 파일에 추가하려면 True로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

ZIP에 폴더 추가

폴더의 GP 파일을 ZIP 파일로 저장합니다(압축 보관 파일에 파일 저장).

매개 변수

Name 필수 형식 Description
ZIP에 추가할 원본 폴더
SourceFolderToAddToZIP True string

zip에 추가할 폴더의 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

출력 ZIP 파일 경로
OutputZIPFilename True string

ZIP이 출력되어야 하는 파일 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

ZIP에서 폴더에 파일 추가
AddFilesToFolderInZIP string

ZIP 파일의 폴더에 원본 파일을 추가하려면 여기에 폴더 이름을 입력합니다.

압축
Compress boolean

압축할 때 폴더를 압축해야 하나요?

기존 ZIP 파일에 추가
AddToExistingZIPFile boolean

기존 ZIP 파일에 추가하려면 True로 설정합니다.

하위 폴더 포함
IncludeSubfolders boolean

원본 폴더 내의 하위 폴더도 ZIP에 추가해야 하나요?

파일 정규식 포함
IncludeFilesRegEx string

추출할 파일을 지정할 수 있는 선택적 정규식입니다. 파일 이름만 일치합니다.

파일 정규식 제외
ExcludeFilesRegEx string

추출에서 제외할 파일을 지정할 수 있는 선택적 정규식입니다. 파일 이름만 일치합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
성공적으로 추가된 파일 수
FilesAddedSuccessfully integer

ZIP에 성공적으로 추가된 파일 수입니다.

제외된 파일 수
FilesExcluded integer

제외된 파일의 수입니다('제외 파일 정규식' 입력을 사용하는 경우).

가장 최근 IA-Connect 세션에 연결

가장 최근에 연결된 IA-Connect 디렉터 세션에 연결합니다(필요에 따라 지정된 형식의 경우). IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

매개 변수

Name 필수 형식 Description
IA-Connect 세션 유형 검색
SearchIAConnectSessionType string

검색할 세션 유형(예: 모든 유형의 원격 세션에 대한 '로컬 에이전트', 'Microsoft RDP', 'Citrix ICA' 또는 'Remote')입니다. 세션 유형을 검색하려면 비워 둡니다.

대기 시간(초)
TimeToWaitInSeconds integer

지정된 형식의 세션이 없는 경우(특정 형식이 지정된 경우) IA-Connect 얼마나 기다려야 하나요?

시간이 초과되면 예외 발생
RaiseExceptionIfTimedout boolean

시간 제한 기간이 경과하기 전에 새 세션이 연결되지 않은 경우 IA-Connect 예외가 발생해야 하나요?

가상 채널을 연결해야 합니다.
VirtualChannelMustBeConnected boolean

IA-Connect 디렉터가 세션에 연결할 때 가상 채널이 연결되어 있는지 확인해야 하나요? 이렇게 하면 IA-Connect 에이전트가 지정된 세션에서 실행되고 있습니다.

이전에 볼 수 없는 세션 개수만
OnlyCountSessionsNotSeenBefore boolean

true로 설정하면 이전에 실행한 '세션 IA-Connect 사용 가능 가져오기' 작업(또는 IA-Connect 검사기 보기 세션)에서 볼 수 있는 세션은 인덱스에 계산되지 않습니다. 이렇게 하면 '새' 세션만 계산할 수 있습니다(예: 첫 번째 새 Citrix 세션에 연결).

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
연결된 IA-Connect 세션 이름
AttachedIAConnectSessionName string

연결된 IA-Connect 세션의 이름입니다.

세션에 연결됨
AttachedToSession boolean

IA-Connect 세션에 연결된 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

계층 1 IA-Connect 세션에 연결

SOAP 및/또는 REST 메시지를 수신하는 디렉터의 IA-Connect 디렉터 세션에 연결합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

매개 변수

Name 필수 형식 Description
가상 채널을 연결해야 합니다.
VirtualChannelMustBeConnected boolean

IA-Connect 디렉터가 세션에 연결할 때 가상 채널이 연결되어 있는지 확인해야 하나요? 이렇게 하면 IA-Connect 에이전트가 지정된 세션에서 실행되고 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
연결된 계층 1 IA-Connect 세션 이름
AttachedTier1IAConnectSessionName string

연결된 계층 1 IA-Connect 세션의 이름입니다.

기본 프린터 가져오기

IA-Connect 에이전트 세션에서 사용자의 기본 프린터 이름을 가져옵니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
기본 프린터 이름
DefaultPrinterName string

사용자의 기본 프린터 이름입니다.

기본 프린터 설정

IA-Connect 에이전트 세션에서 사용자의 기본 프린터를 설정합니다.

매개 변수

Name 필수 형식 Description
기본 프린터 이름
DefaultPrinterName True string

사용자의 기본 프린터 이름입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

기존 Orchestrator 자동화 작업 연기

큐에 이미 있는 기존 Orchestrator 작업을 연기합니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이는 일반적으로 기존 작업을 다시 연기하는 데 사용됩니다(즉, 작업이 이전에 지연되었으므로 이제 다시 연기해야 합니다). 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우).

매개 변수

Name 필수 형식 Description
작업 ID
TaskId True integer

연기(또는 다시 연기)할 기존 Orchestrator 자동화 작업의 ID입니다.

지연 시간(분)
DeferralTimeInMinutes integer

자동화 작업이 지연되어야 하는 시간(분)입니다.

저장된 데이터 지연
DeferralStoredData string

이 작업과 함께 저장할 선택적 데이터입니다. 지연에서 계속될 때 프로세스/흐름에 사용할 수 있게 됩니다. 이는 일반적으로 지연 후에 다시 사용할 수 있어야 하는 프로세스/흐름 중에 계산한 데이터를 저장하는 데 사용됩니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

프로세스 단계
ProcessStage string

지연 후 자동화 프로세스/흐름이 계속되어야 하는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 이는 지연된 프로세스/흐름 내의 조건에서 다음에 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 지연 후에 계속 진행할 때 프로세스/흐름이 'Exchange' 단계에서 계속되도록 하려면 'Exchange' 값을 입력합니다.

Priority
Priority integer

이 작업의 우선 순위 수준을 설정합니다(1은 가장 높은 수준임).

작업 보류
TaskOnHold boolean

이 값을 true로 설정하면 작업이 보류되므로 지연 날짜에 도달하더라도 일반적인 작업 워크플로에서 처리되지 않습니다. 나중에 '오케스트레이터 자동화 작업 상태 변경' 작업을 사용하여 '보류 중' 상태를 변경할 수 있습니다.

반환

Name 경로 형식 Description
명령 결과
TasksDeferExistingTaskResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

기존 Orchestrator 자동화 작업 연기

큐에 이미 있는 기존 Orchestrator 작업을 연기합니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이는 일반적으로 기존 작업을 다시 연기하는 데 사용됩니다(즉, 작업이 이전에 지연되었으므로 이제 다시 연기해야 합니다). 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우).

매개 변수

Name 필수 형식 Description
작업 ID
OperationId True string

연기(또는 다시 연기)할 Orchestrator 작업의 작업 ID입니다.

지연 시간(분)
DeferralTimeInMinutes integer

자동화 작업이 지연되어야 하는 시간(분)입니다.

저장된 데이터 지연
DeferralStoredData string

이 작업과 함께 저장할 선택적 데이터입니다. 지연에서 계속될 때 프로세스/흐름에 사용할 수 있게 됩니다. 이는 일반적으로 지연 후에 다시 사용할 수 있어야 하는 프로세스/흐름 중에 계산한 데이터를 저장하는 데 사용됩니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

프로세스 단계
ProcessStage string

지연 후 자동화 프로세스/흐름이 계속되어야 하는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 이는 지연된 프로세스/흐름 내의 조건에서 다음에 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 지연 후에 계속 진행할 때 프로세스/흐름이 'Exchange' 단계에서 계속되도록 하려면 'Exchange' 값을 입력합니다.

Priority
Priority integer

이 작업의 우선 순위 수준을 설정합니다(1은 가장 높은 수준임).

반환

Name 경로 형식 Description
명령 결과
TasksDeferExistingTaskOperationResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

다른 모든 IA-Connect 에이전트를 종료합니다.

사용자 세션에서 현재 실행 중인 IA-Connect 에이전트의 다른 인스턴스를 종료합니다. 이렇게 하면 IA-Connect 에이전트의 인스턴스가 하나만 실행됩니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
사망한 에이전트 수
NumberOfAgentsKilled integer

사망한 IA-Connect 에이전트 프로세스의 수입니다.

종료하지 못한 에이전트 수
NumberOfAgentsFailedToKill integer

종료하지 못한 IA-Connect 에이전트 프로세스의 수입니다.

다음 Orchestrator 자동화 작업 가져오기

지정된 검색 조건과 일치하는 다음 Orchestrator 자동화 작업을 검색합니다. 지연 날짜에 도달한 '새로 만들기' 및 '지연' 작업만 검색할 수 있습니다. 보류 중인 작업은 검색되지 않습니다.

매개 변수

Name 필수 형식 Description
Automation 이름
AutomationName string

이름이 있는 Orchestrator 자동화 작업을 반환하려면 비워 둡니다. 이 자동화 이름으로 작업만 검색할 값을 입력합니다.

Automation 이름
AutomationNames array of string

두 개 이상의 자동화 이름 중 하나와 일치하는 Orchestrator 작업을 반환해야 하는 경우 'Automation 이름' 입력을 입력하는 대신 이 목록에 이름을 입력합니다.

최소 우선 순위 수준
MinimumPriorityLevel integer

지정된 우선 순위 수준 이상이 있는 Orchestrator 자동화 작업만 반환합니다. 예를 들어 2를 설정하면 우선 순위 수준이 1과 2인 작업이 반환됩니다.

상태를 다음으로 변경합니다.
StatusChange string

'검색됨'으로 설정된 경우: 작업을 검색할 때 다른 작업이 동일한 작업을 실행하지 못하도록 작업 상태가 '검색됨'으로 변경됩니다. '아무 작업도 수행하지 않음'으로 설정하면 작업 상태가 변경되지 않습니다.

지연 날짜까지 분
MinutesUntilDeferralDate integer

지정된 시간(분) 내에 실행할 준비가 된 Orchestrator 자동화 작업만 반환합니다. 지금 실행할 준비가 된 자동화 작업만 원하는 경우 0으로 설정합니다.

SLA 무시
IgnoreSLA boolean

작업에 설정된 모든 SLA를 무시하려면 이 값을 true로 설정합니다. 기본적으로 곧 위반될 SLA가 있는 작업은 다른 모든 작업보다 우선합니다.

작업 ID 제외
ExcludeTaskIds array of integer

처리에서 제외할 작업 ID 목록입니다.

반환

Name 경로 형식 Description
검색된 작업
TaskRetrieved boolean

작업이 검색된 경우 true로 설정합니다. 검색 조건과 일치하는 작업이 없는 경우 false로 설정합니다.

작업 ID
TaskId integer

검색된 Orchestrator 자동화 작업의 ID입니다.

작업 ID
OperationId string

검색된 오케스트레이터 작업의 작업 ID입니다. 이 작업 ID(또는 작업 ID)를 사용하여 나중에 작업을 검색할 수 있습니다. 작업 ID는 타사에서 생성하지 않은 작업의 ID를 추측할 수 있는 기능을 제한하는 고유하고 신뢰할 수 없는 문자열입니다.

Automation 이름
AutomationNameOutput string

검색된 자동화 작업의 이름입니다.

지연 날짜 및 시간
DeferralDateTime string

검색된 Orchestrator 작업이 준비되도록 예약된 날짜 및 시간입니다. UTC에서 문자열로 반환됩니다.

저장된 데이터 지연
DeferralStoredData string

작업이 지연될 때 저장된 선택적 데이터입니다. 일반적으로 프로세스/흐름을 계속해야 하는 데이터이지만 어떤 용도로든 이 필드를 사용할 수 있습니다.

지연 수
DeferralCount integer

이 작업이 지연된 빈도입니다. 이는 일반적으로 지연되지 않은 새 작업의 경우 0이거나 지연된 작업의 경우 1 이상이 됩니다. 지연된 작업이 다시 연기될 때마다 Orchestrator는 이 수를 자동으로 늘입니다.

작업 입력 데이터
TaskInputData string

작업을 만들 때 저장된 선택적 데이터입니다. 일반적으로 프로세스/흐름을 시작하는 데 사용된 데이터이지만 어떤 용도로든 이 필드를 사용할 수 있습니다. JSON 또는 XML 또는 원시 텍스트와 같이 선택한 텍스트 형식으로 서식을 지정할 수 있습니다.

작업 출력 데이터
TaskOutputData string

작업을 처리할 때 자동화에서 저장한 선택적 데이터입니다. JSON 또는 XML 또는 원시 텍스트와 같이 선택한 텍스트 형식으로 서식을 지정할 수 있습니다.

Priority
Priority integer

이 오케스트레이터 작업의 우선 순위 수준입니다(1은 가장 높은 수준임).

Automation 작업 상태
AutomationTaskStatus string

검색된 Orchestrator 작업의 상태입니다.

프로세스 단계
ProcessStage string

지연된 프로세스/흐름이 지연 후 계속되어야 하는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 이는 지연된 프로세스/흐름 내의 조건에서 다음에 수행할 단계를 결정하는 데 사용됩니다.

받은 날짜 및 시간
ReceivedDateTime string

오케스트레이터가 작업을 처음 받은 날짜와 시간입니다. UTC에서 문자열로 반환됩니다.

지연 날짜까지 분
MinutesUntilDeferralDateOutput integer

이 작업의 지연 날짜(예: 이 작업을 실행할 준비가 된 경우)까지의 시간(분)입니다. 이 작업을 실행할 준비가 되면 분은 0이 됩니다.

원본 형식 이름
SourceTypeName string

작업 원본의 이름입니다. '웹 UI'는 UI를 통해 수동으로 입력한 작업을 나타냅니다. 'REST API'는 Orchestrator의 REST API를 통해 만든 작업을 나타냅니다. 'ServiceNow'는 Orchestrator의 내부 'Sources' ServiceNow 통합에서 만든 작업을 나타냅니다.

원본 이름
SourceFriendlyName string

Orchestrator 내부 '원본' 통합(예: ServiceNow)에서 작업을 만든 경우 해당 원본의 이름을 보유합니다.

원본 티켓 ID
SourceTicketId string

Orchestrator 내부 '원본' 통합(예: ServiceNow)에서 작업을 만든 경우 원본 티켓의 ID가 포함됩니다. ServiceNow의 경우 카탈로그 작업 sys_id 유지됩니다.

원본 티켓 하위 ID
SourceTicketSubId string

Orchestrator 내부 '원본' 통합(예: ServiceNow)에서 작업을 만든 경우 원본 티켓의 ID가 포함됩니다. ServiceNow의 경우 요청 항목이 sys_id 유지됩니다.

조직
Organisation string

이 작업이 연결된 조직입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

부서
Department string

이 작업이 연결된 부서입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

Description
Description string

이 작업에 대한 설명입니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

태그들
Tags string

이 작업에 할당된 하나 이상의 태그의 선택적 목록입니다. 일반적으로 검색 및 필터링 작업을 분류하는 데 사용됩니다. 대소문자를 구분하지 않습니다. 한 줄당 하나씩.

다음 홉 IA-Connect 디렉터 구성

더블 홉 시나리오에서 다음 홉 디렉터를 구성합니다. 이는 기본 IA-Connect 다음 홉 디렉터 설정이 적합하지 않은 경우에만 필요합니다.

매개 변수

Name 필수 형식 Description
SOAP 사용
SOAPEnabled boolean

다음 홉 디렉터에서 SOAP 인터페이스를 사용하도록 설정해야 하나요?

REST 사용
RESTEnabled boolean

REST 인터페이스를 다음 홉 디렉터에서 사용하도록 설정해야 하나요?

웹 서버 사용
WebServerEnabled boolean

웹 서버(IA-Connect Inspector 호스팅용)를 다음 홉 디렉터에서 사용하도록 설정해야 하나요?

디렉터는 localhost 전용입니다.
DirectorIsLocalhostOnly boolean

디렉터 SOAP 및 REST 인터페이스는 'localhost'에서만 수신해야 하나요? 다른 컴퓨터가 이러한 인터페이스와 통신할 필요가 없으므로 true로 설정해야 합니다.

SOAP TCP 포트
SOAPTCPPort integer

SOAP 인터페이스를 사용하도록 설정한 경우 어떤 TCP 포트를 실행해야 하나요(기본값: 8002)?

REST TCP 포트
RESTTCPPort integer

REST 인터페이스를 사용하도록 설정한 경우 어떤 TCP 포트에서 실행해야 하나요(기본값: 8002)?

SOAP는 HTTPS를 사용합니다.
SOAPUsesHTTPS boolean

SOAP 인터페이스가 HTTP 대신 HTTPS를 사용하고 있나요? True로 설정하면 HTTPS를 용이하게 하려면 첫 번째 홉 컴퓨터에서 인증서가 필요합니다. REST에 사용되는 인증서와 공유할 수 있습니다.

REST는 HTTPS를 사용합니다.
RESTUsesHTTPS boolean

REST 인터페이스가 HTTP 대신 HTTPS를 사용합니까? True로 설정하면 HTTPS를 용이하게 하려면 첫 번째 홉 컴퓨터에서 인증서가 필요합니다. SOAP에 사용되는 인증서와 공유할 수 있습니다.

SessionId별 증분 디렉터 TCP 포트
IncrementDirectorTCPPortBySessionId boolean

디렉터 TCP 포트가 고유한지 확인하려면(동일한 첫 번째 홉 호스트에서 더블 홉을 사용하는 병렬 세션이 여러 개 있는 경우) 첫 번째 홉 세션 ID를 디렉터 TCP 포트에 추가할 수 있습니다. 이는 SOAP 또는 REST가 첫 번째 홉 디렉터에서 사용하도록 설정되어 있고 명명된 파이프가 기본적으로 사용되므로 일반적으로 사용하도록 설정되지 않은 경우에만 필요합니다.

SOAP는 사용자 인증을 사용합니다.
SOAPUsesUserAuthentication boolean

HTTP SOAP TCP 포트에서 사용자 인증을 사용하도록 하려면 True로 설정합니다. 이 설정 방법에 대한 자세한 내용은 IA-Connect 설치 가이드를 참조하세요.

REST는 사용자 인증을 사용합니다.
RESTUsesUserAuthentication boolean

HTTP REST TCP 포트에서 사용자 인증을 사용하도록 하려면 True로 설정합니다. 이 설정 방법에 대한 자세한 내용은 IA-Connect 설치 가이드를 참조하세요.

명령 명명된 파이프 사용
CommandNamedPipeEnabled boolean

첫 번째 홉 에이전트는 명명된 파이프를 사용하여 첫 번째 홉 디렉터와 통신해야 하나요? 이것이 기본 통신 방법입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

다음 홉 IA-Connect 디렉터 설정 다시 설정

설정된 사용자 지정 IA-Connect Director 설정을 다시 설정하고 기본 설정을 복원합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

다음 홉 상태 IA-Connect 가져오기

이 명령을 수신하는 에이전트의 다음 홉 디렉터 상태를 보고합니다. 다음 홉을 사용하는 경우 해당 에이전트는 다음 홉 디렉터를 통해 명령을 다음 홉으로 전달합니다. 다음 홉을 사용하지 않도록 설정하면 해당 에이전트가 명령 자체를 처리합니다(기본값).

매개 변수

Name 필수 형식 Description
다음 홉 디렉터가 실행 중인지 확인
CheckNextHopDirectorIsRunning boolean

다음 홉에는 에이전트와 동일한 컴퓨터에서 실행 중인 IA-Connect 디렉터가 필요합니다. 이 설정이 true이면 에이전트는 설명된 대로 다음 홉 디렉터가 실행 중인지 확인합니다. 이 설정이 false이면 에이전트는 검사를 수행하지 않고 단순히 다음 홉 상태를 확인합니다.

다음 홉 에이전트가 실행 중인지 확인
CheckNextHopAgentIsRunning boolean

다음 홉에는 에이전트와 동일한 컴퓨터에서 실행 중인 IA-Connect 디렉터와 다음 홉 세션에서 실행 중인 IA-Connect 에이전트가 필요합니다. 이 설정이 true이면 에이전트는 설명된 대로 다음 홉 에이전트가 실행 중인지 확인합니다. 이 설정이 false이면 에이전트는 검사를 수행하지 않고 단순히 다음 홉 상태를 확인합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
다음 홉 사용
NextHopEnabled boolean

다음 홉이 현재 사용하도록 설정된 경우 true를 반환합니다.

활성 다음 홉 디렉터 주소
ActiveNextHopDirectorAddress string

사용 중인 경우 활성 다음 홉 디렉터의 주소입니다.

활성 다음 홉 디렉터 TCP 포트
ActiveNextHopDirectorTCPPort integer

사용 중인 경우 활성 다음 홉 디렉터의 TCP 포트입니다.

활성 다음 홉 디렉터가 HTTPS를 사용합니다.
ActiveNextHopDirectorUsesHTTPS boolean

활성 다음 홉 디렉터가 HTTPS를 사용하는 경우 true를 반환합니다.

활성 다음 홉 디렉터가 실행 중입니다.
ActiveNextHopDirectorIsRunning boolean

활성 다음 홉 디렉터가 실행 중이면 true를 반환하고 그렇지 않으면 false를 반환합니다.

활성 다음 홉 디렉터 URL
ActiveNextHopDirectorURL string

활성 다음 홉 디렉터의 URL입니다.

활성 다음 홉 에이전트가 실행 중입니다.
ActiveNextHopAgentIsRunning boolean

활성 다음 홉 에이전트가 실행 중이면 true를 반환하고 그렇지 않으면 false를 반환합니다.

대체 IA-Connect 에이전트 실행

파일 위치에서 에이전트 실행 파일을 로드하여 대체 IA-Connect 에이전트(예: 이후 버전)를 실행합니다.

매개 변수

Name 필수 형식 Description
Filename
Filename True string

실행할 대체 IA-Connect Agent.exe 대한 전체 경로입니다. IA-Connect 에이전트가 현재 실행 중인 세션에서 이 경로에 액세스할 수 있어야 합니다.

Arguments
Arguments string

실행 시 IA-Connect Agent.exe 전달할 선택적 인수입니다.

메모리에 로드
LoadIntoMemory boolean

대체 IA-Connect 에이전트를 메모리에서 실행해야 하나요? true로 설정하면 새 에이전트가 메모리에 로드되고 기존 에이전트의 어셈블리 내에서 실행됩니다. false로 설정하면 새 에이전트가 일반 프로세스로 실행되고 기존 에이전트 EXE가 종료됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

드라이브 목록 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 드라이브 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
드라이브 JSON
DrivesJSON string

IA-Connect 에이전트가 실행 중인 컴퓨터의 드라이브 목록(JSON 형식)입니다.

디렉터 클라이언트 유형 및 세션 정보 가져오기

계층 1 디렉터가 처리하는 로컬 또는 원격 세션의 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
원격 클라이언트 유형
RemoteClientType string

원격 클라이언트 유형('로컬', 'Citrix ICA' 또는 'Microsoft RDP')입니다.

연결된 가상 채널
VirtualChannelConnected boolean

가상 채널이 연결된 경우 디렉터와 에이전트 간에 True입니다.

디렉터 버전
DirectorVersion string

IA-Connect 디렉터 DLL의 버전입니다. 예: 1.67.21.0.

디렉터 릴리스 버전
DirectorReleaseVersion string

IA-Connect Director의 IA-Connect 릴리스 버전입니다. 예: 9.4.

에이전트 버전
AgentVersion string

이 디렉터가 연결된 IA-Connect 에이전트 EXE의 버전입니다. 예: 1.74.21.0.

에이전트 릴리스 버전
AgentReleaseVersion string

이 디렉터가 연결된 IA-Connect 에이전트의 IA-Connect 릴리스 버전입니다. 예: 9.4.

에이전트에 라이선스가 부여됨
AgentIsLicensed boolean

True이면 이 디렉터가 연결된 IA-Connect 에이전트에 라이선스가 부여됩니다. IA-Connect 에이전트에 라이선스가 없는 경우 False입니다. 에이전트 라이선스 상태를 알 수 없는 경우 Null입니다.

에이전트 라이선스 기능
AgentLicenseFeatures string

이 디렉터가 연결된 IA-Connect 에이전트에 할당된 IA-Connect 라이선스 기능의 쉼표로 구분된 목록입니다. 예: JML, DEV.

디렉터 호스트 이름
DirectorHostname string

디렉터가 실행 중인 컴퓨터의 호스트 이름입니다. 예: vmrpa1.

NetBIOS 디렉터 도메인 이름
DirectorNetBIOSDomainName string

디렉터가 실행 중인 컴퓨터의 NetBIOS 도메인 이름입니다. 예: domain1. 컴퓨터가 도메인의 구성원이 아닌 경우 일반적으로 호스트 이름을 반환합니다.

디렉터 DNS 도메인 이름
DirectorDNSDomainName string

디렉터가 실행 중인 컴퓨터의 DNS 도메인 이름입니다. 예: domain1.myorg.local. 컴퓨터가 도메인의 구성원이 아닌 경우 일반적으로 호스트 이름을 반환합니다.

다음 홉 디렉터에 연결
AttachedToNextHopDirector boolean

IA-Connect 세션이 현재 이 디렉터가 연결된 에이전트에 연결된 경우 false로 설정합니다. 디렉터가 모든 작업(예: 연결된)을 다른 디렉터(다른 에이전트에 연결됨)에 전달하는 경우 true로 설정합니다. 예를 들어 이 디렉터가 로컬 에이전트와 통신하는 로컬 디렉터이지만 IA-Connect 세션이 현재 Citrix에 연결된 경우 이 값은 true입니다.

다음 홉 디렉터 세션 유형
NextHopDirectorSessionType string

이 디렉터가 다음 홉 디렉터에 연결된 경우 이 값은 다음 홉 세션 유형을 보유합니다. 예를 들어 이 디렉터가 로컬 에이전트와 통신하는 로컬 디렉터이지만 IA-Connect 세션이 현재 Citrix에 연결된 경우 이 값은 'Citrix ICA'가 되는 반면, '원격 클라이언트 유형' 값은 '로컬'(Citrix에 로컬 디렉터 전달 작업을 나타낸다)입니다.

디렉터리 만들기

IA-Connect 에이전트가 실행 중인 컴퓨터에 디렉터리(폴더)를 만듭니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

이미 있는 경우 오류 발생
ErrorIfAlreadyExists boolean

디렉터리(폴더)가 이미 있는 경우 IA-Connect 오류를 발생시켜야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

디렉터리 삭제

IA-Connect 에이전트가 실행 중인 컴퓨터에서 디렉터리(폴더)를 삭제합니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

재귀
Recursive boolean

디렉터리의 하위 디렉터리(하위 폴더) 및 파일도 삭제해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

디렉터리 제거

IA-Connect 에이전트가 실행 중인 컴퓨터에서 디렉터리(폴더)를 제거하여 디렉터리 내에 저장된 모든 파일을 제거합니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

재귀
Recursive boolean

모든 하위 폴더도 제거해야 하나요?

최상위 수준 삭제
DeleteTopLevel boolean

최상위 폴더도 삭제해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

디렉터리가 존재하나요?

IA-Connect 에이전트가 실행 중인 컴퓨터에 디렉터리(폴더)가 있는지 여부에 대해 true 또는 false를 보고합니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
디렉터리가 있음
DirectoryExists boolean

디렉터리(폴더)가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

디렉터리에 액세스할 수 있나요?

디렉터리(폴더)에 액세스할 수 있는지 여부와 권한이 IA-Connect 에이전트가 있는 컴퓨터에서 디렉터리에 대한 액세스를 제한하는지 여부를 반환합니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
액세스할 수 있는 디렉터리
DirectoryAccessible boolean

디렉터리에 액세스할 수 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

디렉터리 액세스 권한 없음
DirectoryAccessUnauthorised boolean

권한이 액세스를 제한하므로 디렉터리에 액세스할 수 없는 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

디렉터에서 보낸 대체 IA-Connect 에이전트 실행

IA-Connect Director에서 대체 에이전트를 업로드한 다음 대체 에이전트 실행 파일을 로드하여 대체 IA-Connect 에이전트(예: 이후 버전)를 실행합니다.

매개 변수

Name 필수 형식 Description
로컬 파일 이름
LocalFilename True string

IA-Connect 디렉터에서 액세스할 수 있는 대체 IA-Connect Agent.exe 대한 전체 경로입니다.

원격 파일 이름
RemoteFilename string

원격 시스템에서 대체 IA-Connect Agent.exe 복사할 위치의 전체 경로입니다. 지정하지 않으면 임시 파일 이름이 선택됩니다. 대체 IA-Connect 에이전트가 메모리에 로드되는 경우 '메모리에서 실행되는 경우에도 디스크에 저장'을 true로 설정하지 않으면 이 파일이 만들어지지 않습니다(필요하지 않기 때문에). '참조 실행 어셈블리'가 필요한 IA-Connect의 동적 코드 작업(예: 내부 메서드에 액세스하기 위해 IA-Connect)을 사용하려는 경우에만 true로 설정합니다.

압축
Compress boolean

업로드하는 동안 대체 IA-Connect 에이전트 실행 파일을 압축해야 하나요?

Arguments
Arguments string

실행 시 IA-Connect Agent.exe 전달할 선택적 인수입니다.

다운그레이드 허용
PermitDowngrade boolean

이전 버전의 IA-Connect 에이전트를 허용해야 하나요?

버전 검사 건너뛰기
SkipVersionCheck boolean

IA-Connect 에이전트의 버전(기존 및 신규)을 전혀 검사하지 않으면 모든 시나리오(동일한 버전)에서 새 버전이 사용되게 되나요?

메모리에 로드
LoadIntoMemory boolean

대체 IA-Connect 에이전트를 메모리에서 실행해야 하나요? true로 설정하면 새 에이전트가 메모리에 로드되고 기존 에이전트의 어셈블리 내에서 실행됩니다. false로 설정하면 새 에이전트가 일반 프로세스로 실행되고 기존 에이전트 EXE가 종료됩니다.

메모리에서 실행되는 경우에도 디스크에 저장
SaveToDiskEvenIfRunningFromMemory boolean

메모리에서 실행되는 경우에도 대체 IA-Connect 에이전트를 디스크에 저장해야 하나요? '참조 실행 어셈블리'가 필요한 IA-Connect의 동적 코드 작업(예: 내부 메서드에 액세스하기 위해 IA-Connect)을 사용하려는 경우에만 true로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
복사된 대체 파일
AlternativeFileCopied boolean

대체 IA-Connect 에이전트가 사용되었는지 보고합니다.

디스크 사용 가능한 공간 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터에서 지정된 디스크의 여유 공간을 반환합니다.

매개 변수

Name 필수 형식 Description
드라이브 문자
DriveLetter True string

확인할 디스크의 드라이브 문자입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
디스크 사용 가능한 공간 바이트
FreeSpaceBytes integer

사용 가능한 디스크 공간의 양(바이트)입니다.

사용 가능한 디스크 공간 KB
FreeSpaceKB integer

사용 가능한 디스크 공간의 양(킬로바이트)입니다.

사용 가능한 디스크 공간 MB
FreeSpaceMB integer

사용 가능한 디스크 공간의 양(메가바이트)입니다.

사용 가능한 디스크 공간 GB
FreeSpaceGB integer

사용 가능한 디스크 공간의 양(기가바이트)입니다.

마우스 가운데 단추 아래쪽

IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 누르고 놓지 않습니다. 마우스를 놓려면 마우스 가운데 단추 위로 동작을 사용합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 가운데 단추 위로

IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 놓습니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 가운데 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 클릭합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 가운데 홀드

IA-Connect 에이전트 사용자 세션의 마우스 가운데 단추를 지정된 시간(초)으로 유지합니다.

매개 변수

Name 필수 형식 Description
보관할 시간(초)
SecondsToHold True double

마우스 가운데 단추를 누를 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 상대 이동

IA-Connect 에이전트 사용자 세션의 마우스를 현재 위치를 기준으로 지정된 픽셀 수만큼 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

현재 위치에서 시작하여 마우스를 이동할 X 픽셀의 수입니다.

Y 픽셀
YCoord True integer

현재 위치에서 시작하여 마우스를 이동할 Y 픽셀의 수입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 승수 가져오기

IA-Connect 에이전트 사용자 세션에서 전역 마우스 승수를 검색합니다. 기본값은 (1, 1)이지만 '마우스 승수 설정' 작업으로 변경되었을 수 있습니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
X 승수
MouseXMultiplier double

현재 가로(X) 전역 마우스 승수입니다(에이전트가 마우스를 이동할 때). 승수는 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

Y 승수
MouseYMultiplier double

현재 세로(Y) 전역 마우스 승수(에이전트가 마우스를 이동할 때)입니다. 승수는 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

마우스 이동 메서드
MouseMoveMethod string

현재 전역 마우스 이동 메서드(mouse_event 또는 setcursorpos)를 반환합니다.

마우스 승수 설정

IA-Connect 에이전트 사용자 세션에서 전역 마우스 승수를 설정합니다. 원격 데스크톱 크기 조정에 문제가 발생하는 경우 개발 중에 유용할 수 있습니다.

매개 변수

Name 필수 형식 Description
X 승수
MouseXMultiplier double

설정할 가로(X) 전역 마우스 승수입니다(에이전트가 마우스를 이동할 때). 승수는 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

Y 승수
MouseYMultiplier double

설정할 세로(Y) 전역 마우스 승수입니다(에이전트가 마우스를 이동할 때). 승수는 '다중 모니터 기능'을 사용하지 않도록 설정된 경우에만 적용됩니다.

mouse_event 적용
ApplyToMouseEvent boolean

이 인수는 전역 마우스 승수 값을 mouse_event 메서드에 적용할지 여부를 지정합니다.

SetCursorPos에 적용
ApplyToSetCursorPos boolean

이 인수는 SetCursorPos 메서드에 전역 마우스 승수 값을 적용할지 여부를 지정합니다.

현재 마우스 이동 메서드에 적용
ApplyToCurrentMouseMoveMethod boolean

이 인수는 현재 마우스 이동 메서드에 전역 마우스 승수 값을 적용할지 여부를 지정합니다(예: SetCursorPos가 현재 마우스 이동 메서드인 경우 승수는 SetCursorPos에 적용됨). true로 설정하면 'mouse_event 적용' 및 'SetCursorPos에 적용' 입력이 무시됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 오른쪽 단추 아래로

IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 누르고 놓지 않습니다. 마우스를 놓려면 마우스 오른쪽 단추 위로 동작을 사용합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 오른쪽 단추 위로

IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 놓습니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 오른쪽 단추로 누르기

IA-Connect 에이전트 사용자 세션의 마우스 오른쪽 단추를 지정된 시간(초)으로 유지합니다.

매개 변수

Name 필수 형식 Description
보관할 시간(초)
SecondsToHold True double

마우스 오른쪽 단추를 누를 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 오른쪽 단추로 좌표

IA-Connect 에이전트 사용자 세션의 지정된 좌표에서 마우스 오른쪽 단추를 지정된 시간(초)으로 유지합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

Y 좌표 값(픽셀)입니다.

보관할 시간(초)
SecondsToHold True double

마우스 오른쪽 단추를 누를 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 오른쪽 단추로 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 클릭합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 왼쪽 단추

IA-Connect 에이전트 사용자 세션의 왼쪽 마우스 단추를 지정된 시간(초)으로 유지합니다.

매개 변수

Name 필수 형식 Description
보관할 시간(초)
SecondsToHold True double

마우스 왼쪽 단추를 누를 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 왼쪽 단추 아래로

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 누르고 놓지 않습니다. 마우스를 놓려면 마우스 왼쪽 단추 위로 동작을 사용합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 왼쪽 단추 위로

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 놓습니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 왼쪽 두 번 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 두 번 클릭합니다.

매개 변수

Name 필수 형식 Description
지연 시간(밀리초)
DelayInMilliseconds integer

각 클릭 사이의 지연 시간(밀리초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 왼쪽 좌표

IA-Connect 에이전트 사용자 세션의 지정된 좌표에 있는 왼쪽 마우스 단추를 지정된 시간(초)에 유지합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

Y 좌표 값(픽셀)입니다.

보관할 시간(초)
SecondsToHold True double

마우스 왼쪽 단추를 누를 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 왼쪽 클릭

IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 클릭합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 이동 메서드 설정

현재 마우스 이동 메서드를 mouse_event 또는 setcursorpos로 설정합니다.

매개 변수

Name 필수 형식 Description
마우스 이동 메서드 설정
MouseMoveMethod True string

마우스 이동 메서드(mouse_event 또는 setcursorpos)를 제공합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 이동 방법 가져오기

현재 마우스 이동 메서드를 가져옵니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
마우스 이동 메서드
MouseMoveMethod string

현재 마우스 이동 메서드(mouse_event 또는 setcursorpos)를 반환합니다.

마우스 커서 위치 설정

IA-Connect 에이전트 사용자 세션의 마우스 커서를 지정된 위치로 설정합니다. setcursorpos API는 선택한 활성 마우스 이동 API에 관계없이 마우스를 이동하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
X True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
Y True integer

Y 좌표 값(픽셀)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 휠 회전

IA-Connect 에이전트 사용자 세션에서 마우스 휠(양수 또는 음의 노치)을 켭니다.

매개 변수

Name 필수 형식 Description
휠 회전
WheelTurns True integer

수행할 휠 회전 수입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스 흔들기

마우스를 지정된 좌표 수만큼 앞뒤로 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
X 흔들기
XWiggle integer

마우스를 가로로 이동할 픽셀 수입니다.

Y 흔들기
YWiggle integer

마우스를 세로로 이동할 픽셀 수입니다.

흔들기 지연 시간(초)
WiggleDelayInSeconds double

마우스 이동 사이의 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마우스를 좌표로 이동

IA-Connect 에이전트 사용자 세션의 마우스를 지정된 픽셀 좌표로 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

마우스를 이동할 X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

마우스를 이동할 Y 좌표 값(픽셀)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

마지막 입력 정보 가져오기

IA-Connect 에이전트 사용자 세션에서 마지막 사용자 입력이 수신된 이후의 시간을 가져옵니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
마지막 입력 총 시간(초)
LastInputTotalSeconds integer

마지막 입력 이후 경과된 시간(초)입니다.

마지막 입력 총 시간(분)
LastInputTotalMinutes integer

마지막 입력 이후 경과된 시간(분)입니다.

마지막 입력 총 시간
LastInputTotalHours integer

마지막 입력 이후 경과된 시간 수입니다.

모든 IA-Connect 명령 통계 가져오기

IA-Connect 에이전트가 현재 세션에서 실행한 명령에 대해 현재 저장된 모든 통계를 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 통계 JSON
CommandStatsJSON string

현재 세션의 IA-Connect 에이전트가 JSON 형식으로 실행한 명령 목록입니다. 이 목록에는 각 작업의 이름과 실행된 횟수가 포함됩니다.

모든 오케스트레이터 자동화 작업 가져오기

필터와 일치하는 모든 Orchestrator 자동화 작업을 검색합니다.

매개 변수

Name 필수 형식 Description
Automation 이름 필터
AutomationName string

이 자동화 이름으로 작업만 검색할 값을 입력합니다. 이름이 있는 Orchestrator 자동화 작업을 반환하려면 비워 둡니다(즉, 이 필터를 사용하지 않도록 설정).

Automation 작업 상태 필터
AutomationTaskStatus string

자동화 작업을 지정된 자동화 작업 상태로 필터링합니다. 모든 자동화 작업 상태를 반환하려면 필드를 비워 둡니다(즉, 이 필터를 사용하지 않도록 설정).

속성 쿼리로 필터링
FilterByPropertyQuery string

쿼리 문자열을 사용하여 자동화 작업을 필터링합니다. 오케스트레이터 작업 UI의 '속성별 필터링' 입력과 동일합니다. 속성을 필터링하지 않으려면 필드를 비워 둡니다(즉, 이 필터를 사용하지 않도록 설정). 검색 필터는 '속성 조건 값' 형식이어야 합니다. 단일 검색 필터만 지원됩니다(사용하거나 사용할 수 없음). 지원되는 속성은 이름, 조직, 부서, 태그, 스테이지, ticketid입니다. 지원되는 조건은 같음, 포함, 같음, 포함 안 함입니다. 예: 이름이 새 스타터와 같고, 이름에 스타터가 포함되며, Org가 Acme과 같지 않으며, 부서에 판매가 포함됩니다.

지연 날짜까지 분
MinutesUntilDeferralDate integer

지정된 시간(분) 내에 실행할 준비가 된 Orchestrator 자동화 작업만 반환합니다. 지금 실행할 준비가 된 자동화 작업만 원하는 경우 0으로 설정합니다. 지연에 관계없이 작업을 검색하려면 비워 둡니다.

최소 우선 순위 수준
MinimumPriorityLevel integer

지정된 우선 순위 수준 이상이 있는 Orchestrator 자동화 작업만 반환합니다. 예를 들어 2를 설정하면 우선 순위 수준이 1과 2인 작업이 반환됩니다.

지연 날짜 기준 정렬
SortByDeferralDate boolean

지연 날짜 및 시간을 기준으로 정렬된 데이터를 반환하려면 true로 설정합니다. 데이터가 저장되는 순서대로 반환되도록 하려면 false로 설정합니다.

보류 중인 작업 검색
RetrieveOnHoldTasks boolean

true(기본값: 이전 버전과의 호환성)로 설정하면 작업이 보류 중이더라도 검색됩니다. false로 설정하면 보류 중인 작업이 검색되지 않습니다.

건너뛰기
Skip integer

수백 개의 결과를 검색하는 경우 Skip 및 MaxResults를 사용하여 결과 블록을 검색할 수 있습니다. Skip은 블록의 첫 번째 항목을 반환하기 전에 건너뛸 결과 수를 지정합니다. Skip을 0으로 설정하면 시작부터 결과가 반환됩니다.

최대 결과
MaxResults integer

수백 개의 결과를 검색하는 경우 Skip 및 MaxResults를 사용하여 결과 블록을 검색할 수 있습니다. MaxResults는 건너뛰기 입력을 처리한 후 반환할 결과의 최대 개수 또는 모든 결과를 반환할 0을 지정합니다.

작업 데이터 제외
ExcludeTaskData boolean

true로 설정하면 작업 데이터 속성(TaskData, DeferralStoredData, TaskOutputData)이 응답에 반환되지 않습니다. 이렇게 하면 태스크에 저장된 데이터가 많은 경우 응답의 크기를 크게 줄일 수 있습니다.

반환

Name 경로 형식 Description
Automation 작업
AutomationTasks array of object

지정된 검색 조건을 충족하는 모든 Orchestrator 자동화 작업을 포함하는 데이터 세트입니다. Datatable은 일반적인 .NET 데이터 형식이지만 Null을 DbNull로 저장합니다. IA-Connect PowerShell 모듈은 대부분의 DbNull 문자열을 ''로 변환하여 이를 해결합니다. Orchestrator의 날짜/시간 응답은 문자열 형식입니다.

items
AutomationTasks object
자동화 작업 수
NumberOfAutomationTasks integer

반환된 자동화 작업의 수입니다.

부모 프로세스 ID 가져오기

지정된 프로세스 ID가 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스에 대한 부모 프로세스의 프로세스 ID를 반환합니다.

매개 변수

Name 필수 형식 Description
프로세스 ID
ProcessId True integer

자식 프로세스의 프로세스 ID입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
부모 프로세스 ID
ParentProcessId integer

부모 프로세스의 프로세스 ID입니다.

여전히 실행 중인 부모 프로세스
ParentProcessStillRunning boolean

부모 프로세스가 계속 실행 중이고 종료되지 않은 경우 true를 반환합니다.

부모 프로세스 이름
ParentProcessName string

부모 프로세스의 프로세스 이름입니다.

사각형 좌표 변환

사각형 픽셀 좌표를 가상에서 실제 또는 물리적 좌표로 변환합니다. 점을 변환하려면 오른쪽=왼쪽 및 아래쪽=위쪽을 설정하기만 하면 됩니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다. 가상 좌표는 DPI 크기 조정됩니다. 모든 디스플레이 디바이스의 기본 디스플레이 크기 조정이 100%경우 실제 좌표와 가상 좌표는 모두 동일합니다.

매개 변수

Name 필수 형식 Description
사각형 왼쪽 가장자리 화면 픽셀 X 좌표
RectangleLeftPixelXCoord True integer

변환할 사각형의 왼쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

사각형 위쪽 가장자리 화면 픽셀 Y 좌표
RectangleTopPixelYCoord True integer

변환할 사각형의 위쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

사각형 오른쪽 가장자리 화면 픽셀 X 좌표
RectangleRightPixelXCoord True integer

변환할 사각형의 오른쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

사각형 아래쪽 가장자리 화면 픽셀 Y 좌표
RectangleBottomPixelYCoord True integer

변환할 사각형의 아래쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

변환 유형
ConversionType True string

변환 유형: 물리적에서 가상(PhysicalToVirtual 또는 P2V) 또는 가상에서 실제(VirtualToPhysical 또는 V2P)로 변환합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
변환된 사각형 왼쪽 가장자리 화면 픽셀 X 좌표
ConvertedRectangleLeftPixelXCoord integer

변환된 사각형의 왼쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

변환된 사각형 위쪽 가장자리 화면 픽셀 Y 좌표
ConvertedRectangleTopPixelYCoord integer

변환된 사각형의 위쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

변환된 사각형 오른쪽 가장자리 화면 픽셀 X 좌표
ConvertedRectangleRightPixelXCoord integer

변환된 사각형의 오른쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

변환된 사각형 아래쪽 가장자리 화면 픽셀 Y 좌표
ConvertedRectangleBottomPixelYCoord integer

변환된 사각형의 아래쪽 픽셀 가장자리입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

변환된 사각형 너비
ConvertedRectangleWidth integer

변환된 사각형의 너비(픽셀)입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

변환된 사각형 높이
ConvertedRectangleHeight integer

변환된 사각형의 높이(픽셀)입니다. 변환 유형에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

사용 가능한 IA-Connect 세션 가져오기

IA-Connect 디렉터 세션 목록을 검색합니다(로컬, Microsoft RDP 또는 Citrix ICA와 같이 IA-Connect 에이전트가 실행 중인 세션에 대한 사용 가능한 연결).

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
IA-Connect 세션 JSON
IAConnectSessionsJSON string

JSON 형식의 모든 IA-Connect 세션 목록입니다.

IA-Connect 세션 수
NumberOfIAConnectSessions integer

열려 있는 총 IA-Connect 세션 수입니다.

로컬 IA-Connect 세션 수
NumberOfLocalIAConnectSessions integer

열려 있는 로컬 IA-Connect 세션 수입니다.

Citrix ICA IA-Connect 세션 수
NumberOfCitrixICAIAConnectSessions integer

열려 있는 Citrix ICA IA-Connect 세션 수입니다.

Microsoft RDP IA-Connect 세션 수
NumberOfMicrosoftRDPIAConnectSessions integer

열려 있는 Microsoft RDP IA-Connect 세션 수입니다.

사용자 자격 증명에 쓰기

IA-Connect 에이전트 세션의 사용자 프로필에 있는 자격 증명에 사용자 이름과 암호를 기록하여 자격 증명이 없는 경우 해당 자격 증명을 만듭니다. Windows 제어판에서 자격 증명을 볼 수 있습니다.

매개 변수

Name 필수 형식 Description
자격 증명 주소
CredentialAddress True string

자격 증명의 이름/주소입니다.

사용자 이름
UserName True string

자격 증명 사용자 이름입니다.

암호
Password True string

자격 증명 암호입니다.

자격 증명 형식
CredentialType True string

자격 증명 유형: Windows 또는 제네릭입니다.

자격 증명 지속성
CredentialPersistence string

자격 증명 지속성: 세션(이 로그인 세션에 대해서만 지속), LocalMachine(세션 간에 유지되고 이 컴퓨터에서만 다시 부팅됨) 또는 Enterprise(컴퓨터 간에 로밍할 수 있음).

대칭 암호화 키
SymmetricKey string

자격 증명을 암호화하는 데 사용되는 선택적 대칭 암호화 키입니다. 키를 알고 있는 경우에만 이 자격 증명을 검색할 수 있습니다. 제네릭 자격 증명으로만 사용할 수 있습니다.

암호를 식별자로 저장
StorePasswordAsIdentifier string

식별자가 제공되면 저장된 자격 증명을 사용할 수 있는 명령에서 나중에 검색/사용을 위해 이 암호도 에이전트 내부에 암호화되어 저장됩니다. 이러한 암호는 메모리에만 저장되며 에이전트를 닫을 때 손실됩니다. 예: MyExchangePassword.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
CredentialWriteResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

사용자 자격 증명에서 읽기

IA-Connect 에이전트 세션의 사용자 프로필에 있는 자격 증명에서 사용자 이름과 암호를 읽습니다. Windows 제어판에서 자격 증명을 볼 수 있습니다. 사용자 이름과 암호는 모두 일반 자격 증명에서 검색할 수 있지만 Windows 자격 증명에서 사용자 이름만 검색할 수 있습니다.

매개 변수

Name 필수 형식 Description
자격 증명 주소
CredentialAddress True string

자격 증명의 이름/주소입니다.

자격 증명 형식
CredentialType True string

자격 증명 유형: Windows 또는 제네릭입니다.

대칭 암호화 키
SymmetricKey string

자격 증명 암호를 해독하는 데 사용되는 선택적 대칭 암호화 키입니다(자격 증명이 키로 암호화된 경우 사용). Windows 자격 증명의 암호를 검색할 수 없으므로 일반 자격 증명으로만 사용할 수 있습니다.

암호를 식별자로 저장
StorePasswordAsIdentifier string

식별자가 제공되면 저장된 자격 증명을 사용할 수 있는 명령에서 나중에 검색/사용을 위해 검색된 자격 증명 암호가 에이전트 내부에 암호화되어 저장됩니다. 이러한 암호는 메모리에만 저장되며 에이전트를 닫을 때 손실됩니다. Windows 자격 증명의 암호를 검색할 수 없으므로 일반 자격 증명으로만 사용할 수 있습니다. 예: MyExchangePassword.

암호를 반환하지 마세요.
DontReturnPassword boolean

true로 설정하면 자격 증명 암호가 반환되지 않습니다. 이는 추가 명령(예: '식별자로 암호 저장'이 true)에서 사용하기 위해 에이전트 내에 암호를 저장하는 경우에 유용하지만 워크플로 내에서 암호를 실제로 알 필요는 없습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
사용자 이름
UserName string

자격 증명 사용자 이름입니다.

암호
Password string

자격 증명 암호입니다.

사용자 자격 증명을 삭제합니다.

IA-Connect 에이전트 세션에서 사용자 프로필의 자격 증명을 삭제합니다. Windows 제어판에서 자격 증명을 볼 수 있습니다.

매개 변수

Name 필수 형식 Description
자격 증명 주소
CredentialAddress True string

자격 증명의 이름/주소입니다.

자격 증명 형식
CredentialType True string

자격 증명 유형: Windows 또는 제네릭입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
CredentialDeleteResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

새 Orchestrator 자동화 작업 추가

흐름에서 모니터링할 수 있는 큐에 새 Orchestrator 자동화 작업을 추가합니다. 태스크는 즉시 실행할 준비가 되거나 나중에 실행되도록 지연될 수 있습니다.

매개 변수

Name 필수 형식 Description
자동화 이름 설정
SetAutomationName string

흐름 이름을 작업 이름으로 사용하려는 경우 '자동'을 선택하거나 '수동'을 선택하고 'Automation 이름' 필드에 이름을 입력하여 해당 이름을 사용합니다.

Automation 이름
AutomationName string

'자동화 이름 설정' 필드에서 '수동'을 선택한 경우에만 사용됩니다. 나중에 작업을 식별하거나 특정 흐름과 연결하는 데 도움이 되는 친숙한 이름입니다. 여러 태스크는 동일한 자동화 이름을 사용할 수 있습니다. 작업이 외부 폴러 또는 Orchestrator 트리거에 의해 처리되는 경우 특정 작업 이름이 필요합니다.

작업 입력 데이터
TaskInputData string

작업이 시작될 때 사용할 수 있도록 하는 선택적 데이터입니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

프로세스 단계
ProcessStage string

자동화 프로세스/흐름이 시작되는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 프로세스/흐름 내의 조건에서 다음으로 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 프로세스/흐름이 'Exchange' 단계에서 시작되도록 하려면 'Exchange' 값을 입력합니다.

Priority
Priority integer

이 자동화 작업의 우선 순위 수준을 설정합니다(가장 높은 수준인 1).

SLA(분)
SLA integer

SLA에 필요한 시간(분)을 설정합니다. SLA가 없는 경우 이 값을 0으로 설정합니다. 기본적으로 SLA 끝에 가까운 자동화 작업은 다른 작업보다 우선합니다.

작업 보류
TaskOnHold boolean

작업의 '보류 중' 상태를 지정합니다. '보류 중'으로 설정된 작업은 '다음 오케스트레이터 자동화 작업 가져오기' 작업에 의해 검색되지 않으므로 일반적인 작업 워크플로에서 처리되지 않습니다.

조직
Organisation string

필요에 따라 이 작업이 연결된 조직을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

부서
Department string

필요에 따라 이 작업이 연결된 부서를 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

Description
Description string

필요에 따라 이 작업에 대한 설명을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

태그들
Tags string

이 작업에 할당할 하나 이상의 태그의 선택적 목록입니다. 일반적으로 검색 및 필터링 작업을 분류하는 데 사용됩니다. 대소문자를 구분하지 않습니다. 한 줄당 하나씩.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
작업 ID
TaskId integer

생성된 Orchestrator 자동화 작업의 ID입니다. 이 작업 ID는 나중에 작업을 검색하는 데 사용할 수 있습니다.

새 Orchestrator 자동화 작업 추가

새 Orchestrator 자동화 작업을 추가하고 작업 ID를 받습니다. 작업이 외부 폴러 또는 Orchestrator 트리거에 의해 처리되는 경우 특정 작업 이름이 필요합니다. 이 작업은 '새 Orchestrator 자동화 작업 추가'(TasksAddNewTaskOperation)와는 다릅니다. 추측할 수 있는 작업 ID가 아니라 구단화할 수 없는 작업 ID로 응답한다는 점에서 다릅니다.

매개 변수

Name 필수 형식 Description
Automation 이름
AutomationName string

나중에 작업을 식별하거나 특정 흐름과 연결하는 데 도움이 되는 친숙한 이름입니다. 여러 태스크는 동일한 자동화 이름을 사용할 수 있습니다.

작업 입력 데이터
TaskInputData string

작업이 시작될 때 사용할 수 있도록 하는 선택적 데이터입니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

프로세스 단계
ProcessStage string

자동화 프로세스/흐름이 시작되는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 프로세스/흐름 내의 조건에서 다음으로 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 프로세스/흐름이 'Exchange' 단계에서 시작되도록 하려면 'Exchange' 값을 입력합니다.

Priority
Priority integer

이 자동화 작업의 우선 순위 수준을 설정합니다(가장 높은 수준인 1).

SLA(분)
SLA integer

SLA에 필요한 시간(분)을 설정합니다. SLA가 없는 경우 이 값을 0으로 설정합니다. 기본적으로 SLA 끝에 가까운 자동화 작업은 다른 작업보다 우선합니다.

조직
Organisation string

필요에 따라 이 작업이 연결된 조직을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

부서
Department string

필요에 따라 이 작업이 연결된 부서를 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

Description
Description string

필요에 따라 이 작업에 대한 설명을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

태그들
Tags string

이 작업에 할당할 하나 이상의 태그의 선택적 목록입니다. 일반적으로 검색 및 필터링 작업을 분류하는 데 사용됩니다. 대소문자를 구분하지 않습니다. 한 줄당 하나씩.

반환

Name 경로 형식 Description
작업 ID
OperationId string

생성된 Orchestrator 자동화 작업의 작업 ID입니다. 이 작업 ID는 나중에 작업을 검색하는 데 사용할 수 있습니다. 작업 ID는 타사에서 생성하지 않은 작업의 ID를 추측할 수 있는 기능을 제한하는 고유하고 신뢰할 수 없는 문자열입니다.

새 Orchestrator 지연 작업 추가

흐름에서 모니터링할 수 있는 큐에 새 Orchestrator 지연 작업을 추가합니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우).

매개 변수

Name 필수 형식 Description
자동화 이름 설정
SetAutomationName string

흐름 이름을 작업 이름으로 사용하려는 경우 '자동'을 선택하거나 '수동'을 선택하고 'Automation 이름' 필드에 이름을 입력하여 해당 이름을 사용합니다.

Automation 이름
AutomationName string

'자동화 이름 설정' 필드에서 '수동'을 선택한 경우에만 사용됩니다. 나중에 작업을 식별하거나 특정 흐름과 연결하는 데 도움이 되는 친숙한 이름입니다. 여러 태스크는 동일한 자동화 이름을 사용할 수 있습니다.

지연 시간(분)
DeferralTimeInMinutes integer

자동화 작업이 지연되어야 하는 시간(분)입니다.

작업 입력 데이터
TaskInputData string

작업이 시작될 때 사용할 수 있도록 하는 선택적 데이터입니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

저장된 데이터 지연
DeferralStoredData string

이 작업과 함께 저장할 선택적 데이터입니다. 지연에서 계속될 때 프로세스/흐름에 사용할 수 있게 됩니다. 이는 일반적으로 지연 후에 다시 사용할 수 있어야 하는 프로세스/흐름 중에 계산한 데이터를 저장하는 데 사용됩니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

프로세스 단계
ProcessStage string

지연 후 자동화 프로세스/흐름이 계속되어야 하는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 이는 지연된 프로세스/흐름 내의 조건에서 다음에 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 지연 후에 계속 진행할 때 프로세스/흐름이 'Exchange' 단계에서 계속되도록 하려면 'Exchange' 값을 입력합니다.

Priority
Priority integer

이 작업의 우선 순위 수준을 설정합니다(1은 가장 높은 수준임).

작업 보류
TaskOnHold boolean

작업의 '보류 중' 상태를 지정합니다. '보류 중'으로 설정된 작업은 '다음 오케스트레이터 자동화 작업 가져오기' 작업에 의해 검색되지 않으므로 일반적인 작업 워크플로에서 처리되지 않습니다.

조직
Organisation string

필요에 따라 이 작업이 연결된 조직을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

부서
Department string

필요에 따라 이 작업이 연결된 부서를 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

Description
Description string

필요에 따라 이 작업에 대한 설명을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

태그들
Tags string

이 작업에 할당할 하나 이상의 태그의 선택적 목록입니다. 일반적으로 검색 및 필터링 작업을 분류하는 데 사용됩니다. 대소문자를 구분하지 않습니다. 한 줄당 하나씩.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
작업 ID
TaskId integer

생성된 지연 작업의 ID입니다.

새 Orchestrator 지연 작업 추가

새 Orchestrator 지연 작업을 추가하고 작업 ID를 받습니다. 작업은 나중에 지정된 시간으로 연기됩니다. 이 작업을 사용하여 지정된 시간 동안 작업을 일시적으로 일시 중단합니다(예: 무언가를 기다리는 경우). 작업이 외부 폴러 또는 Orchestrator 트리거에 의해 처리되는 경우 특정 작업 이름이 필요합니다. 이 작업은 '새 Orchestrator 지연된 작업 추가'(TasksAddNewDeferral)와는 다릅니다. 추측 가능한 작업 ID 대신, 추측할 수 없는 작업 ID로 응답한다는 점에서 다릅니다.

매개 변수

Name 필수 형식 Description
Automation 이름
AutomationName string

나중에 작업을 식별하거나 특정 흐름과 연결하는 데 도움이 되는 친숙한 이름입니다. 여러 태스크는 동일한 자동화 이름을 사용할 수 있습니다.

지연 시간(분)
DeferralTimeInMinutes integer

자동화 작업이 지연되어야 하는 시간(분)입니다.

작업 입력 데이터
TaskInputData string

작업이 시작될 때 사용할 수 있도록 하는 선택적 데이터입니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

저장된 데이터 지연
DeferralStoredData string

이 작업과 함께 저장할 선택적 데이터입니다. 지연에서 계속될 때 프로세스/흐름에 사용할 수 있게 됩니다. 이는 일반적으로 지연 후에 다시 사용할 수 있어야 하는 프로세스/흐름 중에 계산한 데이터를 저장하는 데 사용됩니다. 모든 형식으로 데이터를 자유롭게 저장할 수 있지만 JSON은 일반적으로 사용되는 형식입니다.

프로세스 단계
ProcessStage string

자동화 프로세스/흐름이 시작되는 지점입니다. 이는 특정 프로세스/흐름에 고유한 선택적 문자열 값입니다. 프로세스/흐름 내의 조건에서 다음으로 수행할 단계를 결정하는 데 사용됩니다. 예를 들어 프로세스/흐름이 'Exchange' 단계에서 시작되도록 하려면 'Exchange' 값을 입력합니다.

Priority
Priority integer

이 자동화 작업의 우선 순위 수준을 설정합니다(가장 높은 수준인 1).

조직
Organisation string

필요에 따라 이 작업이 연결된 조직을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

부서
Department string

필요에 따라 이 작업이 연결된 부서를 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

Description
Description string

필요에 따라 이 작업에 대한 설명을 지정합니다. 일반적으로 작업 검색 및 필터링에 사용됩니다.

태그들
Tags string

이 작업에 할당할 하나 이상의 태그의 선택적 목록입니다. 일반적으로 검색 및 필터링 작업을 분류하는 데 사용됩니다. 대소문자를 구분하지 않습니다. 한 줄당 하나씩.

반환

Name 경로 형식 Description
작업 ID
OperationId string

생성된 Orchestrator 지연 작업의 작업 ID입니다. 이 작업 ID는 나중에 작업을 검색하는 데 사용할 수 있습니다. 작업 ID는 타사에서 생성하지 않은 작업의 ID를 추측할 수 있는 기능을 제한하는 고유하고 신뢰할 수 없는 문자열입니다.

세션 잠금 해제

IA-Connect 에이전트가 실행 중인 세션의 잠금을 해제합니다. 이렇게 하려면 자격 증명 공급자만 컴퓨터의 잠금을 해제할 수 있으므로 세션을 호스트하는 컴퓨터에 IA-Connect Unlocker 자격 증명 공급자를 설치해야 합니다.

매개 변수

Name 필수 형식 Description
암호 잠금 해제
UnlockPassword True string

현재 세션의 잠금을 해제할 암호입니다. 현재 잠긴 세션에 로그인된 계정의 Windows 사용자 암호입니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다.

암호에 저장된 암호가 포함되어 있습니다.
PasswordContainsStoredPassword boolean

암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다.

잠긴 경우 감지
DetectIfLocked True boolean

IA-Connect 에이전트가 세션이 잠겨 있는지 감지하려고 시도하는 경우 true로 설정하고 세션이 잠긴 것으로 검색되지 않으면 이 작업은 아무 작업도 수행하지 않습니다(수행할 작업이 없기 때문에). IA-Connect 세션이 잠겨 있는지 여부를 잘못 감지하고 잠금 해제 시도를 강제하려는 경우에만 false로 설정됩니다(세션이 잠겨 있지 않은 경우 실패).

자격 증명 공급자 검색
DetectCredentialProvider True boolean

IA-Connect 에이전트가 잠금 해제 요청을 보내기 전에 IA-Connect 잠금 해제자 자격 증명 공급자의 존재를 감지하려고 시도하는 경우 IA-Connect 자격 증명 공급자가 있고 실행 중인 경우에만 이 기능을 사용하지 않도록 설정해야 하지만, 어떤 이유로 IA-Connect 에이전트가 검색하지 않습니다.

잠금 해제 대기 시간(초)
SecondsToWaitForUnlock integer

IA-Connect 에이전트가 데스크톱 잠금 해제 상태를 감지하여 데스크톱이 성공적으로 잠금 해제되었다는 증거를 기다리는 시간(초)입니다. 기본적으로 최대 5초입니다. 이 기능을 사용하지 않도록 설정하고 데스크톱이 잠금 해제되었는지 확인하지 않고 계속하려면 0으로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
세션 잠금 해제 수행됨
SessionUnlockPerformed boolean

세션이 잠겨 있고 잠금 해제 작업이 수행된 경우 true로 설정합니다. 세션이 잠겨 있지 않고 '잠긴 경우 검색'이 true로 설정된 경우 false로 설정하면 작업이 수행되지 않습니다.

세션 활성 유지 중지

IA-Connect 에이전트 사용자 세션이 활성 상태로 유지됩니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
StopKeepSessionAliveResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

세션을 활성 상태로 유지

지정된 간격으로 마우스를 이동하여 세션이 유휴 상태가 되지 않도록 하여 IA-Connect 에이전트 사용자 세션을 활성 상태로 유지합니다.

매개 변수

Name 필수 형식 Description
X 흔들기
XWiggle integer

마우스를 가로로 이동할 픽셀 수입니다.

Y 흔들기
YWiggle integer

마우스를 세로로 이동할 픽셀 수입니다.

흔들기 지연 시간(초)
WiggleDelayInSeconds double

흔들 때 마우스 이동 사이의 시간(초)입니다.

유휴 임계값(초)
IdleThresholdInSeconds integer

마우스를 이동하기 전에 마지막 입력 이후 경과해야 하는 시간(초)입니다.

유휴 확인 기간(초)
IdleCheckPeriodInSeconds integer

유휴 임계값이 통과되었는지 확인하기 위해 마지막 입력 시간을 확인하는 간격(초)입니다.

총 유지 런타임(초)
TotalKeepaliveRuntimeInSeconds integer

세션을 활성 상태로 유지할 총 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
KeepSessionAliveResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

세션이 잠겨 있는지

IA-Connect 에이전트가 실행 중인 세션이 잠겨 있는지 여부를 보고합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
세션이 잠겨 있습니다.
SessionIsLocked boolean

IA-Connect 에이전트가 실행 중인 세션이 잠겨 있으면 true로 설정합니다.

스크린샷을 찍습니다.

IA-Connect 에이전트 사용자 세션의 스크린샷을 가져와 Base64로 인코딩된 문자열로 반환합니다.

매개 변수

Name 필수 형식 Description
전체 화면
Fullscreen boolean

스크린샷에 전체 화면이 포함되어야 하나요?

왼쪽 X 픽셀
LeftXPixels integer

전체 화면의 스크린샷을 찍지 않으면 스크린샷이 시작될 X 값(픽셀)입니다. 단일 디스플레이에서 가장 왼쪽 X 픽셀은 0입니다. 다중 모니터 디스플레이에서 가장 왼쪽 X 픽셀은 음수일 수 있습니다(기본으로 표시된 디스플레이와 다른 디스플레이를 기준으로 하는 위치에 따라 다름).

상위 Y 픽셀
TopYPixels integer

전체 화면의 스크린샷을 찍지 않으면 스크린샷이 시작될 위치의 Y 값(픽셀)입니다. 단일 디스플레이에서 최상위 Y 픽셀은 0입니다. 다중 모니터 디스플레이에서 최상위 Y 픽셀은 음수일 수 있습니다(기본으로 표시된 디스플레이와 다른 디스플레이를 기준으로 하는 위치에 따라 다름).

너비 픽셀
WidthPixels integer

전체 화면의 스크린샷을 찍지 않으면 시작 위치에서 스크린샷의 너비입니다.

높이 픽셀
HeightPixels integer

전체 화면의 스크린샷을 찍지 않으면 시작 위치에서 스크린샷의 높이입니다.

이미지 형식
ImageFormat string

이미지 형식(PNG, JPG, BMP 또는 GIF)을 제공합니다.

디스플레이 디바이스 사용
UseDisplayDevice boolean

IA-Connect 에이전트는 디스플레이 디바이스 정보를 고려해야 하나요? 이는 DPI 크기 조정에서 더 잘 작동하며 여러 디스플레이에 대한 지원을 제공합니다.

오류 발생
RaiseExceptionOnError boolean

true를 설정하는 경우: 스크린샷이 실패하면 IA-Connect 에이전트가 예외를 발생합니다(예: 세션이 잠긴 경우). false를 설정하는 경우: 스크린샷이 실패하면 IA-Connect 빈 비트맵을 반환하고 '스크린샷 성공' 및 '스크린샷 오류 메시지' 출력을 채웁니다.

에이전트 숨기기
HideAgent boolean

스크린샷을 가리지 않도록 에이전트를 자동으로 숨기려면 true로 설정합니다(표시되는 경우).

물리적 좌표 사용
UsePhysicalCoordinates boolean

제공된 좌표가 물리적 좌표(DPI 크기 조정이 아니므로 디스플레이의 실제 픽셀과 일치)를 지정하려면 true로 설정합니다. 제공된 좌표가 가상(DPI 크기 조정)되도록 지정하려면 false(기본값)로 설정합니다. UIA, Java 및 웹 작업은 일반적으로 가상 좌표를 사용합니다.

디바이스 ID 표시
DisplayDeviceId integer

이 입력은 '디스플레이 디바이스 사용' 입력이 true로 설정된 경우에만 작동합니다. 모든 모니터를 포함하려면 0(기본값)으로 설정합니다. 기본 모니터만 포함하려면 1로 설정합니다. 관련 보조 모니터만 포함하도록 2 이상으로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
Base64로 화면 이미지
ScreenBitmapBase64 string

Base64로 인코딩된 문자열인 화면 이미지입니다. 제공된 유틸리티 'Base64 to bitmap'을 사용하여 볼 수 있습니다.

스크린샷 성공
ScreenshotSuccessful boolean

스크린샷이 성공하면 true로 설정합니다. 스크린샷이 실패하고 '오류 발생 시 예외 발생'이 false로 설정된 경우 false로 설정합니다. 스크린샷이 실패하고 '오류 발생 시 예외 발생'이 true로 설정된 경우 예외가 발생합니다.

스크린샷 오류 메시지
ScreenshotErrorMessage string

스크린샷이 실패하고 '오류 발생 시 예외 발생'이 false로 설정된 경우 이 출력 필드에 오류 메시지가 표시됩니다. 이는 '오류 발생 후 예외 발생'을 true로 설정하는 대신, 스크린샷을 수행하는 동안 오류가 발생하면 예외가 발생합니다.

암호 문자열 확장

IA-Connect 저장된 암호에 대한 참조가 포함된 입력 문자열을 수락하고 저장된 암호로 대체된 참조를 사용하여 해당 문자열을 반환합니다.

매개 변수

Name 필수 형식 Description
입력 문자열
InputString string

IA-Connect 저장된 암호 식별자를 포함하는 입력 문자열입니다. 예: '새 시작 시작, 새 계정 암호는 {IAConnectPassword:GeneratedPassword}'입니다. 여기서 'GeneratedPassword'는 저장된 IA-Connect 암호의 이름입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
출력 문자열
OutputString string

암호 식별자가 실제 암호로 대체된 입력 문자열을 포함하는 출력 문자열입니다. 예: '새 시작 시작, 새 계정 암호는 Fantastic12Monkeys!'입니다.

암호 생성

템플릿 형식으로 정의된 사전 단어, 숫자, 기호, 문자를 포함하는 암호를 생성합니다.

매개 변수

Name 필수 형식 Description
암호 형식
PasswordFormat True string

기호를 사용하여 설명된 생성된 암호의 형식입니다. 기호 'w'는 사전 단어를 나타내고, 'u'는 대문자로 사전 단어를 나타내고, 'n'은 숫자를 나타내고, 's'는 기호를 나타내고, 'l'은 소문자를 나타내고, 'L'은 대문자를 나타내고, 'z'는 아무것도 나타내지 않습니다(조합에 유용). 예를 들어 wnnwsl은 Pluto35Marmite!b를 생성할 수 있습니다. 숫자 뒤에 두 개 이상의 기호가 중괄호로 묶이면 해당 기호 수의 임의 조합이 생성됩니다. 예를 들어 8(Lln)은 6hP2AxP0 및 4(Lsz)가 S!-A(LssL 기호)를 생성하거나 J$(Lszz 기호)를 생성할 수 있습니다. 작은따옴표 안의 문자는 as-is사용됩니다. 예를 들어 w'--'w'_'nn은 저지-Mountain_64 생성할 수 있습니다.

최소 길이
MinimumLength integer

생성된 암호의 최소 길이입니다. 생성된 암호가 너무 짧으면 길이가 충족될 때까지 추가 사전 단어가 추가됩니다. 최소 길이 요구 사항이 없는 경우 0으로 설정합니다.

일반 텍스트로 반환
ReturnAsPlainText boolean

암호를 일반 텍스트로 반환하려면 true로 설정합니다.

암호를 식별자로 저장
StorePasswordAsIdentifier string

식별자가 제공된 경우 이 암호는 저장된 자격 증명을 사용할 수 있는 명령에서 나중에 검색/사용을 위해 Orchestrator 또는 에이전트('생성 시' 참조) 내에 암호화되어 저장됩니다. 에이전트에서 생성된 경우 이러한 암호는 메모리에만 저장되며 에이전트를 닫을 때 손실됩니다. 예를 들어 MyExchangePassword는 {IAConnectPassword:MyExchangePassword}를 사용하여 검색할 수 있습니다.

지원되는 기호
SupportedSymbols string

기호 's'를 생성된 암호 형식으로 사용할 때 임의로 사용할 기호 목록을 제공할 수 있습니다. 지정하지 않으면 기본 제공 목록이 사용됩니다. 예: !$()*.

고유한 암호 시도
AttemptUniquePasswords boolean

오케스트레이터 또는 에이전트에 대한 true(기본값)로 설정하여 난수 시퀀스가 중복되지 않도록 하므로 생성된 암호가 특정 세션 내에서 가능한 경우 고유해야 합니다. 에이전트에서 생성된 경우 별도의 에이전트 간에 고유 암호가 보장되지 않거나 에이전트가 닫히거나 다시 시작되는 경우 항상 복잡한 암호를 사용하여 암호가 매우 임의적인지 확인해야 합니다(예: wnnws는 wnw보다 임의).

에서 생성
GenerateAt string

암호를 생성할 IA-Connect 구성 요소를 지정합니다.

최소 소문자
MinimumLowercase integer

암호에 있어야 하는 최소 소문자 수입니다. 이렇게 할 수 없는 경우(예: 암호 형식에 l, w 또는 u 기호가 충분하지 않은 경우) 예외가 발생합니다. 최소값은 0으로 설정합니다.

최소 대문자
MinimumUppercase integer

암호에 있어야 하는 최소 대문자 수입니다. 이렇게 할 수 없는 경우(예: 암호 형식에 L, w 또는 u 기호가 충분하지 않은 경우) 예외가 발생합니다. 최소값은 0으로 설정합니다.

최소 숫자
MinimumNumbers integer

암호에 있어야 하는 최소 숫자 수입니다. 이렇게 할 수 없는 경우(예: 암호 형식에 n 기호가 충분하지 않은 경우) 예외가 발생합니다. 최소값은 0으로 설정합니다.

최소 기호
MinimumSymbols integer

암호에 있어야 하는 최소 기호 수입니다. 이렇게 할 수 없는 경우(예: 암호 형식에 기호가 충분하지 않은 경우) 예외가 발생합니다. 최소값은 0으로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
일반 텍스트 암호
PlainTextPassword string

요청된 경우 일반 텍스트로 된 암호입니다. 암호는 SMS 또는 전자 메일(예: )을 통해 전송될 일회성 암호이므로 일반 텍스트로 요청될 수 있으므로 as-is.

암호 키 보내기

특히 암호를 입력하기 위해 IA-Connect 에이전트 사용자 세션에 전역 키 누름을 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

매개 변수

Name 필수 형식 Description
암호
Password True password

IA-Connect 에이전트 사용자 세션에서 시뮬레이션된 키 누름을 사용하여 입력할 암호입니다. 키 코드는 'UI 사용자 가이드'의 '키 보내기 구문'에 설명되어 있습니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다.

간격(밀리초)
Interval integer

각 키 누름 사이의 시간(밀리초)입니다.

기호 해석 안 함
DontInterpretSymbols boolean

암호의 기호를 특수 키로 해석하지 않아야 하나요(예: Shift의 경우 + ^ Ctrl)? 실제 기호를 입력하려는 경우 true로 설정해야 합니다.

암호에 저장된 암호가 포함되어 있습니다.
PasswordContainsStoredPassword boolean

암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

암호 키 이벤트 보내기

낮은 수준의 키보드 드라이버를 사용하여 특히 암호를 입력하기 위해 IA-Connect 에이전트 사용자 세션에 전역 키 누름 이벤트를 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

매개 변수

Name 필수 형식 Description
암호
Password True password

낮은 수준의 키보드 드라이버를 사용하여 IA-Connect 에이전트 사용자 세션에 입력할 암호입니다. 키 코드는 'UI 사용자 가이드'의 '키 이벤트 보내기 구문'에 설명되어 있습니다. '저장된' 암호인 경우 {IAConnectPassword:StoredPasswordIdentifier} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다. Orchestrator 제네릭 자격 증명인 경우 {OrchestratorCredential:FriendlyName} 형식으로 입력하고 '저장된 암호' 입력을 true로 설정합니다.

간격(밀리초)
Interval integer

각 키 누름 이벤트 사이의 시간(밀리초)입니다.

기호 해석 안 함
DontInterpretSymbols boolean

암호의 기호를 특수 키로 해석하지 않아야 하나요(예: Shift의 경우 {SHIFT}, Ctrl의 경우 {CTRL})? 실제 기호를 입력하려는 경우 true로 설정해야 합니다.

암호에 저장된 암호가 포함되어 있습니다.
PasswordContainsStoredPassword boolean

암호가 IA-Connect 저장된 암호 식별자(예: '암호 생성' 작업에서 생성됨) 또는 IA-Connect Orchestrator 일반 자격 증명(예: PA 흐름과 함께 IA-Connect 사용하는 경우)인 경우 true로 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

에이전트 메모리에 암호 저장

저장된 암호를 지원하는 모든 작업에서 사용할 수 있는 에이전트 메모리(암호화됨)에 암호를 저장합니다. 암호는 메모리에만 저장되며 에이전트를 닫을 때 손실됩니다.

매개 변수

Name 필수 형식 Description
식별자
Identifier True string

암호의 고유 식별자입니다. 식별자가 이미 사용 중인 경우 덮어씁니다. 예: SAPGUILogon. 암호는 {IAConnectPassword:Identifier}라는 구를 사용하여 검색됩니다.

암호
Password True password

저장할 암호입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
StorePasswordInAgentMemoryResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

에이전트 메모리에서 암호 삭제

에이전트 메모리에 저장된 암호를 삭제하거나 에이전트에 저장된 모든 암호를 삭제합니다.

매개 변수

Name 필수 형식 Description
모든 암호 삭제
DeleteAllPasswords boolean

에이전트 메모리에 저장된 모든 암호를 삭제하려면 true로 설정합니다. 제공된 식별자와 일치하는 단일 암호를 삭제하려면 false(기본값)로 설정합니다.

식별자
Identifier string

삭제할 암호의 고유 식별자입니다. 예: SAPGUILogon.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
DeletePasswordInAgentMemoryResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

에이전트 스레드 가져오기

에이전트 스레드 목록을 반환합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 일반적으로 에이전트 스레드가 완료되고 해당 데이터가 검색되면 에이전트 스레드가 삭제되고 스레드 목록에 표시되지 않습니다.

매개 변수

Name 필수 형식 Description
정렬 순서
SortOrder string

에이전트 스레드의 출력 목록에 대한 정렬 순서입니다. 지원되는 정렬 순서는 'None', 'ThreadStartTime', 'ThreadStartTime_Desc', 'ThreadEndTime', 'ThreadEndTime_Desc', 'ThreadId', 'ThreadId_Desc', 'ThreadActionName', 'ThreadActionName_Desc', 'ThreadRuntime', 'ThreadRuntime_Desc'입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
에이전트 스레드 수
NumberOfAgentThreads integer

여전히 실행 중이거나 검색에 사용할 수 있는 에이전트 스레드의 수입니다. 일반적으로 에이전트 스레드가 완료되고 해당 데이터가 검색되면 에이전트 스레드가 삭제되고 스레드 목록에 표시되지 않습니다.

에이전트 스레드
AgentThreads array of object

에이전트 스레드 목록 및 사용 가능한 모든 스레드 정보(내부 스레드 데이터 제외)입니다.

ThreadId
AgentThreads.ThreadId integer
IAConnectActionName
AgentThreads.IAConnectActionName string
ThreadStartDateTimeUTC
AgentThreads.ThreadStartDateTimeUTC date-time
ThreadCompletedDateTimeUTC
AgentThreads.ThreadCompletedDateTimeUTC date-time
ThreadRuntimeInSeconds
AgentThreads.ThreadRuntimeInSeconds integer
ThreadStarted
AgentThreads.ThreadStarted boolean
ThreadRunning
AgentThreads.ThreadRunning boolean
ThreadCompleted
AgentThreads.ThreadCompleted boolean
ThreadSuccess
AgentThreads.ThreadSuccess boolean
ThreadStatusMessage
AgentThreads.ThreadStatusMessage string
ThreadErrorMessage
AgentThreads.ThreadErrorMessage string

에이전트 스레드 삭제

에이전트 스레드 또는 모든 에이전트 스레드를 삭제하여 스레드가 계속 실행 중인 경우 먼저 스레드를 종료(종료, 중단)합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 에이전트 스레드를 모니터링하는 프로세스 또는 흐름에는 '에이전트 스레드 ID가 없습니다.' 오류가 표시됩니다.

매개 변수

Name 필수 형식 Description
스레드 ID
ThreadId integer

이전에 에이전트 작업을 스레드로 실행한 경우 스레드 ID를 제공하여 스레드를 종료하고 삭제합니다. 이 스레드 ID는 이전에 스레드로 실행한 작업의 출력으로 제공되었습니다. 지정된 에이전트 스레드 ID가 없으면 예외가 발생합니다.

모든 에이전트 스레드 삭제
DeleteAllAgentThreads boolean

모든 에이전트 스레드를 삭제하려면 true로 설정합니다. '스레드 ID' 입력으로 지정된 단일 에이전트 스레드를 삭제하려면 false(기본값)로 설정합니다.

에이전트 스레드를 삭제하지 못하는 경우 예외 발생
RaiseExceptionIfAgentThreadFailsToDelete boolean

에이전트 스레드를 삭제하지 못하는 경우 예외를 발생하려면 true로 설정합니다. 이 작업을 실행하는 동안 에이전트 스레드가 완료되면 예외가 발생할 수 있습니다(삭제 시점에 더 이상 존재하지 않으므로). 에이전트 스레드를 삭제하는 동안 오류를 무시하려면 false(기본값)로 설정합니다. 출력 '삭제된 에이전트 스레드 수'는 삭제된 에이전트 스레드 수를 보고합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
삭제된 에이전트 스레드 수
NumberOfAgentThreadsDeleted integer

'모든 에이전트 스레드 삭제'가 true이면 이 출력에는 삭제된 에이전트 스레드 수(0 이상)가 포함됩니다. '모든 에이전트 스레드 삭제'가 false이고 에이전트 스레드 ID가 제공된 경우 이 출력은 0 또는 1로 설정됩니다.

에이전트 스레드 종료

에이전트 스레드를 종료(종료, 중단)합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 에이전트 스레드는 삭제되지 않습니다('에이전트 스레드 삭제' 작업을 사용하여 스레드 삭제) 에이전트 스레드를 모니터링하는 프로세스 또는 흐름이 'IA-Connect 에이전트 스레드가 중단되었습니다.' 오류를 수신할 수 있도록 허용합니다.

매개 변수

Name 필수 형식 Description
스레드 ID
ThreadId True integer

이전에 에이전트 작업을 스레드로 실행한 경우 스레드 ID를 제공하여 스레드를 종료합니다(스레드 실행이 영구적으로 중지됨). 이 스레드 ID는 이전에 스레드로 실행한 작업의 출력으로 제공되었습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
KillAgentThreadResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

에이전트 스레드가 성공적으로 완료되기를 기다립니다.

에이전트 스레드가 완료되고 필요에 따라 스레드 출력 데이터를 검색할 때까지 기다립니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다. 에이전트 스레드가 완료되었지만 실패하면 예외가 발생합니다.

매개 변수

Name 필수 형식 Description
스레드 ID
ThreadId True integer

이전에 에이전트 작업을 스레드로 실행한 경우 스레드 ID를 제공하여 스레드의 상태를 검색합니다. 이 스레드 ID는 이전에 스레드로 실행한 작업의 출력으로 제공되었습니다.

스레드를 기다리는 시간(초)
SecondsToWaitForThread True integer

스레드가 완료되기를 기다리는 시간(초)입니다. 이 시간 동안 스레드가 완료되지 않은 경우 예외가 발생합니다('스레드가 완료되지 않은 경우 예외 발생'이 false로 설정되지 않는 한).

스레드 출력 데이터 검색
RetrieveThreadOutputData boolean

스레드 출력 데이터를 JSON 형식으로 검색하려면 true로 설정합니다. 스레드를 만드는 데 사용되는 것과 동일한 작업을 호출하여 스레드 출력 데이터를 검색하는 것이 좋습니다. '스레드 ID의 출력 데이터 검색' 입력을 스레드 ID로 설정하지만, 이 옵션을 사용하면 스레드 출력 데이터를 직접 검색하고 선택적으로 데이터를 삭제하지 않을 수 있습니다.

출력 데이터를 검색한 후 스레드 삭제
ClearOutputDataFromMemoryOnceRead boolean

스레드가 성공적으로 완료되고 출력 데이터가 검색된 경우('스레드 출력 데이터 검색' 입력 참조) 결과가 반환된 후 스레드를 삭제하려면 이 입력을 true로 설정합니다. 그러면 스레드 출력 데이터와 스레드 자체가 삭제되므로 스레드를 다시 쿼리할 수 없습니다.

스레드가 완료되지 않은 경우 예외 발생
RaiseExceptionIfThreadNotCompleted boolean

true로 설정하고 지정된 시간에 스레드가 완료되지 않은 경우 예외가 발생합니다. false로 설정하면 이 작업은 요청된 시간(스레드가 완료될 때까지)까지 기다렸다가 스레드 상태를 보고합니다('스레드 실행 중' 출력 참조). 스레드가 완료되었지만 실패하면 항상 예외가 발생합니다.

스레드 오류가 발생하는 경우 예외 발생
RaiseExceptionIfThreadError boolean

true(기본 동작)로 설정하고 스레드에 오류 조건(스레드가 완료되었지만 성공하지 못함)이 있는 경우 예외가 발생하고 스레드가 삭제됩니다. false로 설정하면 오류는 출력 '스레드 오류 메시지'에 저장되고 스레드는 삭제되지 않습니다(해당하는 경우 '에이전트 스레드 삭제' 작업을 사용하여 스레드를 삭제해야 합니다).

호출당 대기 시간(초)
SecondsToWaitPerCall integer

시간 제한을 방지하기 위해 '스레드를 기다리는 시간(초)'이 더 작은 시간 조각으로 세분화됩니다. 이 선택적 입력을 사용하면 더 작은 시간 조각의 크기를 지정할 수 있습니다. RPA 시간 제한% 80보다 큰 값으로 설정하지 마세요. 또는 시간 제한 오류가 발생할 수 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
스레드가 시작되었습니다.
ThreadStarted boolean

스레드가 시작된 경우 True입니다. 스레드가 아직 시작되지 않은 경우 False입니다. 이는 스레드가 즉시 시작된 이후 문제가 발생했음을 시사합니다. '스레드가 완료되지 않은 경우 예외 발생'이 false로 설정된 경우에만 유용합니다. 그렇지 않으면 지정된 대기 시간에 스레드가 완료되지 않은 경우 예외가 발생합니다.

스레드가 실행 중입니다.
ThreadRunning boolean

스레드가 현재 실행 중인 경우 True입니다. 스레드가 시작되지 않았거나(가능성이 매우 낮음) 스레드가 완료된 경우 False입니다. '스레드가 완료되지 않은 경우 예외 발생'이 false로 설정된 경우에만 유용합니다. 그렇지 않으면 지정된 대기 시간에 스레드가 완료되지 않은 경우 예외가 발생합니다.

스레드가 완료되었습니다.
ThreadCompleted boolean

스레드가 완료된 경우 True입니다. 스레드가 시작되지 않았거나(가능성이 매우 낮음) 스레드가 여전히 실행 중인 경우 False입니다. '스레드가 완료되지 않은 경우 예외 발생'이 false로 설정된 경우에만 유용합니다. 그렇지 않으면 지정된 대기 시간에 스레드가 완료되지 않은 경우 예외가 발생합니다.

스레드 성공
ThreadSuccess boolean

스레드가 성공적으로 완료된 경우 True입니다. 스레드가 시작되지 않은 경우(가능성이 매우 낮음) 스레드가 계속 실행 중이거나 스레드가 실패한 경우 False입니다. '스레드가 완료되지 않은 경우 예외 발생'이 false로 설정된 경우에만 유용합니다. 그렇지 않으면 지정된 대기 시간에 스레드가 완료되지 않은 경우 예외가 발생합니다.

스레드 런타임(초)
ThreadRuntimeInSeconds integer

스레드가 실행된 총 시간(초)입니다.

IA-Connect 작업 이름
IAConnectActionName string

스레드로 실행되는 IA-Connect 에이전트 작업의 내부 이름입니다.

스레드 상태 메시지
ThreadStatusMessage string

스레드의 상태를 설명하는 텍스트 문자열입니다. 이 메시지는 ThreadStarted, ThreadRunning, ThreadCompleted, ThreadSuccess 속성에서 계산됩니다. 이 텍스트 문자열은 언어 독립적입니다(로캘과 일치하도록 변경되지 않음).

스레드 오류 메시지
ThreadErrorMessage string

스레드가 실패한 경우 이 출력에는 오류 메시지가 포함됩니다. '스레드 오류 발생 시 예외 발생'이 false로 설정된 경우에만 유용합니다. 그렇지 않으면 스레드에 오류가 있는 경우 예외가 발생하므로 유용합니다.

스레드 출력 데이터 JSON
ThreadOutputJSON string

'스레드 출력 데이터 검색'이 true로 설정된 경우 이 출력은 원시 스레드 출력 데이터를 JSON 형식으로 보유합니다.

에이전트 스레드의 상태 검색

에이전트 스레드의 상태를 검색하고 필요에 따라 스레드 출력 데이터를 검색합니다. 에이전트 스레드를 사용하여 스레드에서 특정 작업을 실행하여 작업이 RPA 시간 제한보다 긴 시간 동안 실행되거나 다른 작업과 병렬로 실행되도록 할 수 있습니다.

매개 변수

Name 필수 형식 Description
스레드 ID
ThreadId True integer

이전에 에이전트 작업을 스레드로 실행한 경우 스레드 ID를 제공하여 스레드의 상태를 검색합니다. 이 스레드 ID는 이전에 스레드로 실행한 작업의 출력으로 제공되었습니다.

스레드 출력 데이터 검색
RetrieveThreadOutputData boolean

스레드 출력 데이터를 JSON 형식으로 검색하려면 true로 설정합니다. 스레드를 만드는 데 사용되는 것과 동일한 작업을 호출하여 스레드 출력 데이터를 검색하는 것이 좋습니다. '스레드 ID의 출력 데이터 검색' 입력을 스레드 ID로 설정하지만, 이 옵션을 사용하면 스레드 출력 데이터를 직접 검색하고 선택적으로 데이터를 삭제하지 않을 수 있습니다.

출력 데이터를 검색한 후 스레드 삭제
ClearOutputDataFromMemoryOnceRead boolean

스레드가 성공적으로 완료되고 출력 데이터가 검색된 경우('스레드 출력 데이터 검색' 입력 참조) 결과가 반환된 후 스레드를 삭제하려면 이 입력을 true로 설정합니다. 그러면 스레드 출력 데이터와 스레드 자체가 삭제되므로 스레드를 다시 쿼리할 수 없습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
스레드가 시작되었습니다.
ThreadStarted boolean

스레드가 시작된 경우 True입니다. 스레드가 아직 시작되지 않은 경우 False입니다. 이는 스레드가 즉시 시작된 이후 문제가 발생했음을 시사합니다.

스레드가 실행 중입니다.
ThreadRunning boolean

스레드가 현재 실행 중인 경우 True입니다. 스레드가 시작되지 않았거나(가능성이 매우 낮음) 스레드가 완료된 경우 False입니다.

스레드가 완료되었습니다.
ThreadCompleted boolean

스레드가 완료된 경우 True입니다. 스레드가 시작되지 않았거나(가능성이 매우 낮음) 스레드가 여전히 실행 중인 경우 False입니다.

스레드 성공
ThreadSuccess boolean

스레드가 성공적으로 완료된 경우 True입니다. 스레드가 시작되지 않은 경우(가능성이 매우 낮음) 스레드가 계속 실행 중이거나 스레드가 실패한 경우 False입니다.

스레드 런타임(초)
ThreadRuntimeInSeconds integer

스레드가 실행된 총 시간(초)입니다.

IA-Connect 작업 이름
IAConnectActionName string

스레드로 실행되는 IA-Connect 에이전트 작업의 내부 이름입니다.

스레드 상태 메시지
ThreadStatusMessage string

스레드의 상태를 설명하는 텍스트 문자열입니다. 이 메시지는 ThreadStarted, ThreadRunning, ThreadCompleted, ThreadSuccess 속성에서 계산됩니다. 이 텍스트 문자열은 언어 독립적입니다(로캘과 일치하도록 변경되지 않음).

스레드 오류 메시지
ThreadErrorMessage string

스레드가 실패한 경우 이 출력에는 오류 메시지가 포함됩니다.

스레드 출력 데이터 JSON
ThreadOutputJSON string

'스레드 출력 데이터 검색'이 true로 설정된 경우 이 출력은 원시 스레드 출력 데이터를 JSON 형식으로 보유합니다.

예외 발생

입력 예외가 비어 있지 않으면 지정된 메시지로 예외를 발생합니다. 이는 흐름(HTTP 400)에서 예외 메시지를 트리거하는 데 유용하며, 이전 작업에 오류가 있는 경우 오류 처리 단계에서 catch됩니다. 이 예외는 IA-Connect Orchestrator 흐름 실행 통계에 기록되지 않습니다.

매개 변수

Name 필수 형식 Description
입력 예외
InputException string

이 입력 예외가 빈 문자열이 아니면 제공된 '예외 메시지'와 함께 예외가 발생합니다. 이 입력 예외가 비어 있으면 이 작업은 아무 작업도 수행하지 않습니다.

예외 메시지
ExceptionMessage string

발생할 예외 메시지입니다.

반환

Name 경로 형식 Description
명령 결과
RaiseExceptionResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

오케스트레이터 상태 가져오기

기본 오케스트레이터 상태를 검색합니다. 이를 사용하여 Orchestrator를 사용할 수 있고 응답하고 있는지 확인할 수 있습니다.

반환

Name 경로 형식 Description
오케스트레이터 버전
OrchestratorVersion string

Orchestrator 소프트웨어 버전입니다.

오케스트레이터 시작 오류
NumberOfStartupErrors integer

Orchestrator 시작 오류 수입니다.

오케스트레이터 작동 시간(초)
UptimeInSeconds integer

Orchestrator가 실행된 시간(초)입니다.

오케스트레이터 일회성 비밀 만들기

일회성 비밀은 한 번 검색할 수 있는 비밀을 저장할 수 있는 기능을 제공합니다. 일반적으로 타사와 비밀을 공유하는 데 사용됩니다. Orchestrator UI, REST API 또는 흐름에서 일회성 비밀을 만들 수 있습니다.

매개 변수

Name 필수 형식 Description
친근한 이름
FriendlyName True string

이 이름은 이 일회성 비밀을 식별하는 데만 사용되는 설명이 포함된 이름입니다. 이 이름의 유일한 목적은 Orchestrator UI의 비밀 목록에서 보는 것입니다.

암호 값
SecretValue password

일회성 URL을 통해 공유하고 사용할 수 있도록 하려는 일회성 비밀 값입니다.

검색 구 1
RetrievalPhrase1 password

고유 URL을 통해 일회성 비밀을 검색하는 데 필요한 구입니다. 비워 두면 검색 구가 필요하지 않습니다. 검색 단계는 대/소문자를 구분합니다.

검색 구 2
RetrievalPhrase2 password

고유 URL을 통해 일회성 비밀을 검색하는 데 필요한 두 번째 구입니다. 비워 두면 검색 구가 필요하지 않습니다. 검색 단계는 대/소문자를 구분합니다.

삭제 전 최대 검색
MaximumRetrievalsBeforeDeletion integer

오케스트레이터에서 삭제되기 전에 이 일회성 비밀을 몇 번이나 검색할 수 있나요? 기본적으로 이 값은 1(일회성)로 설정됩니다. 여러 사람이 이 비밀에 액세스해야 하는 경우에만 더 높은 값으로 설정합니다.

비밀에 시작 날짜가 있습니다.
SecretHasAStartDate boolean

특정 날짜 및 시간까지 비밀을 검색에 사용할 수 없으면 사용하도록 설정합니다.

비밀 시작 날짜 및 시간
SecretStartDateTime date-time

이 비밀을 검색할 수 있는 날짜 및 시간입니다. 날짜 및 시간은 dd/MM/yyyy HH:mm 형식으로 입력되고 UTC/GMT+0으로 저장 및 처리됩니다. 예: '2022-01-24T07:00:00'은 2022년 1월 24일에 07.00시간 UTC(GMT+0) 이전에 일회성 비밀이 검색되지 않도록 합니다(404가 수신됨). 또는 '비밀 시작 시간까지의 시간' 입력을 사용합니다. 이 입력을 사용하는 경우 '비밀에 시작 날짜가 있습니다.'를 true로 설정해야 합니다. 그렇지 않으면 입력이 무시됩니다.

비밀 시작 시간까지의 시간
HoursUntilSecretStartTime integer

이 비밀을 검색할 수 있을 때까지의 시간 수입니다. 또는 '비밀 시작 날짜 및 시간' 입력을 사용합니다. 이 입력을 사용하는 경우 '비밀에 시작 날짜가 있습니다.'를 true로 설정해야 합니다.

비밀에 만료 날짜가 있습니다.
SecretHasAnExpiryDate boolean

검색 여부에 관계없이 일정 기간 후에 비밀이 자동으로 삭제되어야 하는 경우 사용하도록 설정합니다.

비밀 만료 날짜 및 시간
SecretExpiryDateTime date-time

검색 여부에 관계없이 이 비밀이 자동으로 삭제되는 날짜 및 시간입니다. 날짜 및 시간은 yyyy-MM-ddTHH:mm:ss 형식으로 입력되고 UTC/GMT+0으로 저장 및 처리됩니다. 예: '2022-01-24T07:00:00'은 2022년 1월 24일에 07.00시간 UTC(GMT+0)로 일회성 비밀을 삭제합니다. 또는 '비밀이 만료될 때까지 시간' 입력을 사용합니다. 이 입력을 사용하는 경우 '비밀에 만료 날짜가 있습니다.'를 true로 설정해야 합니다. 그렇지 않으면 입력이 무시됩니다.

비밀이 만료될 때까지의 시간
HoursUntilSecretExpiry integer

검색 여부에 관계없이 이 비밀이 자동으로 삭제될 때까지의 시간입니다. 또는 '비밀 만료 날짜 및 시간' 입력을 사용합니다. 이 입력을 사용하는 경우 '비밀에 만료 날짜가 있습니다.'를 true로 설정해야 합니다.

반환

Name 경로 형식 Description
검색 URL
RetrievalURL string

일회성 비밀을 검색하는 데 사용되는 일회성 URL입니다.

검색 ID
RetrievalId string

고유 검색 ID입니다. 이 일회성 URL은 이 고유 ID에서 빌드됩니다. 이 ID는 사용자 지정 시나리오에서 고유한 URL을 생성해야 하는 경우에 유용할 수 있습니다.

오케스트레이터 자동화 작업 삭제

지연된 Orchestrator 자동화 작업을 삭제합니다.

매개 변수

Name 필수 형식 Description
작업 ID
TaskId True integer

삭제할 Orchestrator 자동화 작업의 ID입니다.

원본 시스템 업데이트
UpdateSourceSystem boolean

true(기본값)로 설정하고 Orchestrator 작업이 원본 시스템(예: ServiceNow)에 연결된 경우 Orchestrator는 Orchestrator의 원본 시스템 구성에 지정된 모든 작업을 수행합니다(예: 티켓 닫기). false로 설정되거나 태스크가 원본 시스템에 연결되지 않은 경우 작업은 Orchestrator에서만 삭제됩니다.

반환

Name 경로 형식 Description
명령 결과
TasksDeleteTaskResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

오케스트레이터 자동화 작업 상태 변경

선택한 오케스트레이터 자동화 작업 상태 또는 기타 작업 속성을 변경합니다.

매개 변수

Name 필수 형식 Description
작업 ID
TaskId True integer

수정할 Orchestrator 작업의 ID입니다.

Automation 작업 새 상태
AutomationTaskStatus string

지정한 자동화 작업의 새 작업 상태이거나 기존 작업의 상태를 변경하지 않으려면 비워 둡니다. 기존 작업을 연기하려면 '기존 오케스트레이터 자동화 작업 연기' 작업을 대신 사용합니다.

작업 보류
TaskOnHold boolean

작업의 '보류 중' 상태를 지정합니다. 새 작업 또는 지연된 작업만 보류할 수 있으므로 다른 작업 상태를 보류하려고 하면 예외가 발생합니다.

작업 입력 데이터 지우기
EraseTaskInputData boolean

이 값을 true로 설정하면 작업 입력 데이터가 지워집니다. 이는 일반적으로 원시 데이터가 더 이상 필요하지 않으므로 완료되거나 실패한 작업에 대한 스토리지 공간을 저장하는 데 사용됩니다.

지연 저장된 데이터 지우기
EraseDeferralStoredData boolean

이 값을 true로 설정하면 지연 저장된 데이터가 지워집니다. 이는 일반적으로 원시 데이터가 더 이상 필요하지 않으므로 완료되거나 실패한 작업에 대한 스토리지 공간을 저장하는 데 사용됩니다.

원본 시스템 업데이트
UpdateSourceSystem boolean

이 값을 true로 설정하고 Orchestrator 작업이 원본 시스템(예: ServiceNow)에 연결된 경우 Orchestrator는 Orchestrator의 원본 시스템 구성에 지정된 모든 작업을 수행합니다(예: 티켓 닫기).

작업 종료 이유
TaskClosureReason string

작업에 저장될 '완료됨' 또는 '실패' 작업에 대해 작업 종료 이유를 제공합니다. 또한 Orchestrator 작업이 원본 시스템(예: ServiceNow)에 연결된 경우 상태를 변경하고 '원본 시스템 업데이트'를 true로 설정하면 그 이유도 원본 시스템에 전달됩니다(예: ServiceNow 작업 정보). 완료되거나 실패한 작업만 닫기 이유가 있을 수 있으므로 다른 작업 상태에 대해 닫기 이유를 설정하려고 하면 예외가 발생합니다.

반환

Name 경로 형식 Description
명령 결과
TasksChangeTaskStatusResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

오케스트레이터 흐름 통계 결과 업데이트

IA-Connect Orchestrator에서 현재 작업자 흐름에 대한 결과 통계를 업데이트합니다. 일반적으로 보고 목적으로 사용되는 IA-Connect Orchestrator에서 Flow 통계의 최종 결과를 수정하는 데 사용됩니다. 현재 흐름에 대해서만 작동합니다(오케스트레이터는 흐름 실행 ID를 검색합니다). 다른 흐름의 통계는 수정할 수 없습니다.

매개 변수

Name 필수 형식 Description
흐름 마지막 작업 성공
FlowLastActionSuccess boolean

오케스트레이터 흐름 통계의 마지막 작업이 성공하도록 지정하려면 true로 설정합니다. 오케스트레이터 흐름 통계의 마지막 동작이 실패임을 지정하려면 false로 설정합니다. 흐름 마지막 작업 상태를 업데이트하지 않으려면 이 필드를 비워 둡니다(예: 마지막 작업 코드만 업데이트하려는 경우).

흐름 마지막 작업 오류 메시지
FlowLastActionErrorMessage string

Flow 마지막 작업이 실패했음을 지정하는 경우 여기에 오류 메시지를 제공합니다.

흐름 마지막 작업 코드
FlowLastActionCode integer

Flow 통계에 할당할 선택적 코드입니다. 일반적으로 시스템 및 비즈니스 예외를 구분하기 위해 오류 코드로 사용되지만 성공 코드로 사용할 수 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
UpdateOrchestratorFlowStatsResultResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

원격 세션 로그오프

IA-Connect 에이전트가 실행 중인 원격 세션을 로그오프합니다.

매개 변수

Name 필수 형식 Description
대기 시간(초)
SecondsToWait integer

IA-Connect 에이전트가 명령의 완료를 보고할 수 있도록 운영 체제에 로그오프 명령을 실행한 후 대기하는 시간입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

원격 세션 연결 끊기

IA-Connect 에이전트가 원격 세션에서 실행 중인 경우 이 작업은 원격 세션의 연결을 끊습니다. 이는 로그오프와 동일하지 않으며 원격 세션이 연결이 끊긴 상태로 실행됩니다. 이 작업은 나중에 원격 세션에 다시 연결하고 새 세션을 시작하는 대신 동일한 상태에서 계속하려는 경우 사용할 수 있습니다. IA-Connect 에이전트가 로컬로 실행되는 경우 이 작업은 세션을 잠급히게 됩니다.

매개 변수

Name 필수 형식 Description
대기 시간(초)
SecondsToWait integer

IA-Connect 에이전트가 원격 세션에서만 발생하는 연락처를 잃기 전에 명령의 완료를 보고할 수 있도록 운영 체제에 연결 끊기 명령을 실행하기 전에 대기하는 시간입니다.

로컬 에이전트의 연결을 끊지 마세요.
DoNotDisconnectIfLocalAgent boolean

true로 설정하고 IA-Connect 에이전트가 로컬 세션(즉, 작업자에서 직접)에서 실행되는 경우 이 작업은 자동으로 무시됩니다. 로컬 에이전트 연결을 끊으면 세션이 잠기므로 세션이 잠금 해제될 때까지 RPA 함수가 제한되기 때문에 유용합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

이름별 프로세스 수 가져오기

지정된 프로세스 이름을 가진 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스 수를 반환합니다.

매개 변수

Name 필수 형식 Description
프로세스 이름
ProcessName True string

프로세스 이름입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프로세스 수
NumberOfProcesses integer

제공된 프로세스 이름과 일치하는 프로세스 수입니다.

이름으로 IA-Connect 세션 종료

지정된 IA-Connect 디렉터 세션이 있는 경우 종료합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다. 이 이름은 이전의 '연결' 작업에서 알 수 있습니다.

매개 변수

Name 필수 형식 Description
IA-Connect 세션 이름
IAConnectSessionName True string

죽일 IA-Connect 세션의 이름입니다.

성공에 대한 계층 1 IA-Connect 세션에 연결
AttachToTier1IAConnectSessionOnSuccess boolean

세션이 성공적으로 닫힌 경우 IA-Connect 계층 1 IA-Connect 세션(SOAP 및/또는 REST 메시지를 수신하는 디렉터의 IA-Connect 디렉터 세션)에 다시 연결해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
IA-Connect 세션이 종료됨
IAConnectSessionKilled boolean

지정된 이름의 세션이 종료된 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

연결된 계층 1 IA-Connect 세션 이름
AttachedTier1IAConnectSessionName string

연결된 계층 1 IA-Connect 세션의 이름입니다.

이름으로 IA-Connect 세션에 연결

이름으로 지정된 IA-Connect 디렉터 세션에 연결합니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

매개 변수

Name 필수 형식 Description
IA-Connect 세션 이름
IAConnectSessionName True string

연결할 IA-Connect 세션의 이름입니다.

가상 채널을 연결해야 합니다.
VirtualChannelMustBeConnected boolean

IA-Connect 디렉터가 세션에 연결할 때 가상 채널이 연결되어 있는지 확인해야 하나요? 이렇게 하면 IA-Connect 에이전트가 지정된 세션에서 실행되고 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

이름으로 IA-Connect 세션이 닫히기를 기다립니다.

지정된 IA-Connect 디렉터 세션이 닫히기를 기다립니다. IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다. 이 이름은 이전의 '연결' 작업에서 알 수 있습니다.

매개 변수

Name 필수 형식 Description
IA-Connect 세션 이름
IAConnectSessionName True string

확인할 IA-Connect 세션의 이름입니다.

대기 시간(초)
TimeToWaitInSeconds integer

지정된 형식의 세션이 없는 경우(특정 형식이 지정된 경우) IA-Connect 얼마나 기다려야 하나요?

시간이 초과되면 예외 발생
RaiseExceptionIfTimedout boolean

시간 제한 기간이 경과하기 전에 새 세션이 연결되지 않은 경우 IA-Connect 예외가 발생해야 하나요?

성공에 대한 계층 1 IA-Connect 세션에 연결
AttachToTier1IAConnectSessionOnSuccess boolean

세션이 성공적으로 닫힌 경우 IA-Connect 계층 1 IA-Connect 세션(SOAP 및/또는 REST 메시지를 수신하는 디렉터의 IA-Connect 디렉터 세션)에 다시 연결해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
세션 종료 IA-Connect
IAConnectSessionClosed boolean

지정된 이름의 세션이 닫혀 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

연결된 계층 1 IA-Connect 세션 이름
AttachedTier1IAConnectSessionName string

연결된 계층 1 IA-Connect 세션의 이름입니다.

인덱스별로 IA-Connect 세션에 연결

인덱스로 지정된 IA-Connect 디렉터 세션에 연결합니다(예: 첫 번째 Citrix ICA 세션에 연결). IA-Connect 에이전트에 대한 명령이 전송되는 세션입니다.

매개 변수

Name 필수 형식 Description
IA-Connect 세션 유형 검색
SearchIAConnectSessionType string

검색할 세션 유형(예: 모든 유형의 원격 세션에 대한 '로컬 에이전트', 'Microsoft RDP', 'Citrix ICA' 또는 'Remote')입니다. 세션 유형을 검색하려면 비워 둡니다.

IA-Connect 세션 인덱스 검색
SearchIAConnectSessionIndex integer

연결할 세션의 인덱스(예: 첫 번째 일치하는 세션 형식의 경우 1, 두 번째 일치 세션 형식의 경우 2)입니다.

대기 시간(초)
TimeToWaitInSeconds integer

지정된 인덱스가 있는 세션이 없으면 IA-Connect 얼마나 기다려야 하나요?

시간이 초과되면 예외 발생
RaiseExceptionIfTimedout boolean

시간 제한 기간이 경과하기 전에 새 세션이 연결되지 않은 경우 IA-Connect 예외가 발생해야 하나요?

가상 채널을 연결해야 합니다.
VirtualChannelMustBeConnected boolean

IA-Connect 디렉터가 세션에 연결할 때 가상 채널이 연결되어 있는지 확인해야 하나요? 이렇게 하면 IA-Connect 에이전트가 지정된 세션에서 실행되고 있습니다.

이전에 볼 수 없는 세션 개수만
OnlyCountSessionsNotSeenBefore boolean

true로 설정하면 이전에 실행한 '세션 IA-Connect 사용 가능 가져오기' 작업(또는 IA-Connect 검사기 보기 세션)에서 볼 수 있는 세션은 인덱스에 계산되지 않습니다. 이렇게 하면 '새' 세션만 계산할 수 있습니다(예: 첫 번째 새 Citrix 세션에 연결).

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
연결된 IA-Connect 세션 이름
AttachedIAConnectSessionName string

연결된 IA-Connect 세션의 이름입니다.

세션에 연결됨
AttachedToSession boolean

IA-Connect 세션에 연결된 경우 true를 반환하고, 그렇지 않으면 false를 반환합니다.

잠금 세션

IA-Connect 에이전트가 실행 중인 세션을 잠깁니다.

매개 변수

Name 필수 형식 Description
작업 시간(분) 비활성 후 잠금
LockAfterMinutesOfActionInactivity integer

0보다 큰 값으로 설정하면 에이전트가 즉시 잠기지 않고 지정된 작업 시간(에이전트가 작업을 수신하지 않음)이 지나면 잠깁니다. 이렇게 하면 연속 실행 중인 흐름이 많을 때 에이전트가 지속적으로 잠금 해제 및 잠금 해제되지 않습니다. 즉시 잠그려면 0으로 설정합니다. 기본값은 5분입니다.

잠금 후 대기하는 시간(초)
SecondsToWaitAfterLock integer

잠금 후 지정된 시간(초)을 기다립니다. 이렇게 하면 세션이 완전히 잠글 수 있습니다. 이는 잠금 해제 직후 잠금 해제 이벤트(즉, 다른 세션 시작)가 발생할 수 있는 경우에 일반적으로 사용되며, 이전 세션이 여전히 잠겨 있는 경우 실패할 수 있습니다. '작업 시간(분) 비활성 후 잠금'이 0(즉시 잠금 발생)으로 설정된 경우에만 사용됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
LockSessionResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

저장된 암호 가져오기

이전에 생성되었거나 저장된 암호를 검색합니다.

매개 변수

Name 필수 형식 Description
암호 식별자
PasswordIdentifier string

저장된 암호의 식별자입니다. 이러한 암호는 메모리에만 저장되며 에이전트를 닫을 때 손실됩니다. 예: MyExchangePassword.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
일반 텍스트 암호
PlainTextPassword string

일반 텍스트의 암호입니다. 암호가 SMS 또는 전자 메일(예: )을 통해 전송될 일회성 암호이므로 as-is확인해야 하는 경우 일반 텍스트로 암호가 필요할 수 있습니다.

제네릭 IA-Connect 에이전트 명령 실행

인수를 JSON으로 전달하고 출력 데이터를 JSON으로 반환하는 제네릭 IA-Connect 에이전트 명령을 실행합니다. 디렉터 및 검사기에서 에이전트보다 이전 버전이므로 명령을 이해하지 못하는 경우 에이전트 명령을 실행하는 데 사용됩니다.

매개 변수

Name 필수 형식 Description
IA-Connect 에이전트 명령 이름
CommandName True string

IA-Connect 에이전트 명령의 내부 이름입니다. 명령 이름 목록은 'GetAgentActionsInClass' 작업에서 제공할 수 있습니다.

입력 JSON
InputJSON string

JSON 형식의 IA-Connect 에이전트 명령에 대한 입력입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
출력 JSON
OutputJSON string

IA-Connect 에이전트 명령의 출력(JSON 형식)입니다.

좌표 간에 마우스 오른쪽 끌기

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스 오른쪽 단추 끌기를 수행합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

매개 변수

Name 필수 형식 Description
X 픽셀 시작
StartXCoord True integer

시작 X 좌표 값(픽셀)입니다.

Y 픽셀 시작
StartYCoord True integer

시작 Y 좌표 값(픽셀)입니다.

X 픽셀 끝
EndXCoord True integer

끝 X 좌표 값(픽셀)입니다.

끝 Y 픽셀
EndYCoord True integer

끝 Y 좌표 값(픽셀)입니다.

단계 수
NumberOfSteps integer

끌기 동작을 구분해야 하는 단계 수입니다.

총 시간(초)
TotalTimeInSeconds double

끌기 작업이 처음부터 끝까지 수행해야 하는 총 시간입니다.

최대 이동 픽셀 지터
MaximumMovementPixelJitter integer

끌기 작업을 수행하는 동안의 최대 픽셀 지터입니다. 값이 1 이상이면 이동 지터를 사용할 수 있습니다. 지터는 각 단계에서 매끄럽게 처리되어 이동이 급증하지 않도록 합니다. 이 입력 값은 지터가 특정 지점에 있을 수 있는 최대값을 제어하여 마우스가 경로에서 벗어날 수 있는 정도를 제한합니다. 값이 높을수록 끌기 동작이 더 적게 '매끄럽게' 표시됩니다. 각 지점의 지터는 이전 지터 값에서 -2 2(기본적으로) 사이에서만 벗어날 수 있으므로 최대값을 설정한 값에 관계없이 가능한 최대 지터는 2 x NumberOfSteps입니다.

최대 끝 픽셀 지터
MaximumEndPixelJitter integer

끌기 동작의 끝에 있는 최대 픽셀 지터입니다. 값이 높을수록 끝 좌표에 도달할 때 끌기의 정확도가 떨어지게 됩니다.

최대 이동 픽셀 지터 델타
MaximumMovementPixelJitterDelta integer

마우스 이동 지터를 사용하는 경우(최대 이동 픽셀 지터가 1 이상) 각 지점의 최대 지터가 이전 지점에서 벗어날 수 있습니다. 지터가 부드러운지 확인하는 데 사용됩니다. 값이 클수록 부드러움이 줄어듭니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표 간에 마우스 왼쪽 끌기

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스 왼쪽 단추를 끕니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

매개 변수

Name 필수 형식 Description
X 픽셀 시작
StartXCoord True integer

시작 X 좌표 값(픽셀)입니다.

Y 픽셀 시작
StartYCoord True integer

시작 Y 좌표 값(픽셀)입니다.

X 픽셀 끝
EndXCoord True integer

끝 X 좌표 값(픽셀)입니다.

끝 Y 픽셀
EndYCoord True integer

끝 Y 좌표 값(픽셀)입니다.

단계 수
NumberOfSteps integer

끌기 동작을 구분해야 하는 단계 수입니다.

총 시간(초)
TotalTimeInSeconds double

끌기 작업이 처음부터 끝까지 수행해야 하는 총 시간입니다.

최대 이동 픽셀 지터
MaximumMovementPixelJitter integer

끌기 작업을 수행하는 동안의 최대 픽셀 지터입니다. 값이 1 이상이면 이동 지터를 사용할 수 있습니다. 지터는 각 단계에서 매끄럽게 처리되어 이동이 급증하지 않도록 합니다. 이 입력 값은 지터가 특정 지점에 있을 수 있는 최대값을 제어하여 마우스가 경로에서 벗어날 수 있는 정도를 제한합니다. 값이 높을수록 끌기 동작이 더 적게 '매끄럽게' 표시됩니다. 각 지점의 지터는 이전 지터 값에서 -2 2(기본적으로) 사이에서만 벗어날 수 있으므로 최대값을 설정한 값에 관계없이 가능한 최대 지터는 2 x NumberOfSteps입니다.

최대 끝 픽셀 지터
MaximumEndPixelJitter integer

끌기 동작의 끝에 있는 최대 픽셀 지터입니다. 값이 높을수록 끝 좌표에 도달할 때 끌기의 정확도가 떨어지게 됩니다.

최대 이동 픽셀 지터 델타
MaximumMovementPixelJitterDelta integer

마우스 이동 지터를 사용하는 경우(최대 이동 픽셀 지터가 1 이상) 각 지점의 최대 지터가 이전 지점에서 벗어날 수 있습니다. 지터가 부드러운지 확인하는 데 사용됩니다. 값이 클수록 부드러움이 줄어듭니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표 간에 마우스 이동

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스를 이동합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

매개 변수

Name 필수 형식 Description
X 픽셀 시작
StartXCoord True integer

시작 X 좌표 값(픽셀)입니다.

Y 픽셀 시작
StartYCoord True integer

시작 Y 좌표 값(픽셀)입니다.

X 픽셀 끝
EndXCoord True integer

끝 X 좌표 값(픽셀)입니다.

끝 Y 픽셀
EndYCoord True integer

끝 Y 좌표 값(픽셀)입니다.

단계 수
NumberOfSteps integer

이동 동작을 세분화해야 하는 단계 수입니다.

총 시간(초)
TotalTimeInSeconds double

이동 동작이 처음부터 끝까지 수행해야 하는 총 시간입니다.

최대 이동 픽셀 지터
MaximumMovementPixelJitter integer

끌기 작업을 수행하는 동안의 최대 픽셀 지터입니다. 값이 1 이상이면 이동 지터를 사용할 수 있습니다. 지터는 각 단계에서 매끄럽게 처리되어 이동이 급증하지 않도록 합니다. 이 입력 값은 지터가 특정 지점에 있을 수 있는 최대값을 제어하여 마우스가 경로에서 벗어날 수 있는 정도를 제한합니다. 값이 높을수록 끌기 동작이 더 적게 '매끄럽게' 표시됩니다. 각 지점의 지터는 이전 지터 값에서 -2 2(기본적으로) 사이에서만 벗어날 수 있으므로 최대값을 설정한 값에 관계없이 가능한 최대 지터는 2 x NumberOfSteps입니다.

최대 끝 픽셀 지터
MaximumEndPixelJitter integer

끌기 동작의 끝에 있는 최대 픽셀 지터입니다. 값이 높을수록 끝 좌표에 도달할 때 끌기의 정확도가 떨어지게 됩니다.

최대 이동 픽셀 지터 델타
MaximumMovementPixelJitterDelta integer

마우스 이동 지터를 사용하는 경우(최대 이동 픽셀 지터가 1 이상) 각 지점의 최대 지터가 이전 지점에서 벗어날 수 있습니다. 지터가 부드러운지 확인하는 데 사용됩니다. 값이 클수록 부드러움이 줄어듭니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표 사이에 마우스 가운데 끌기

IA-Connect 에이전트 사용자 세션에서 지정된 두 좌표 간에 마우스 가운데 단추 끌기를 수행합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다. 선택적 지터는 마우스 움직임에서 지원되어 인간의 손 움직임과 더 유사하게 만듭니다.

매개 변수

Name 필수 형식 Description
X 픽셀 시작
StartXCoord True integer

시작 X 좌표 값(픽셀)입니다.

Y 픽셀 시작
StartYCoord True integer

시작 Y 좌표 값(픽셀)입니다.

X 픽셀 끝
EndXCoord True integer

끝 X 좌표 값(픽셀)입니다.

끝 Y 픽셀
EndYCoord True integer

끝 Y 좌표 값(픽셀)입니다.

단계 수
NumberOfSteps integer

끌기 동작을 구분해야 하는 단계 수입니다.

총 시간(초)
TotalTimeInSeconds double

끌기 작업이 처음부터 끝까지 수행해야 하는 총 시간입니다.

최대 이동 픽셀 지터
MaximumMovementPixelJitter integer

끌기 작업을 수행하는 동안의 최대 픽셀 지터입니다. 값이 1 이상이면 이동 지터를 사용할 수 있습니다. 지터는 각 단계에서 매끄럽게 처리되어 이동이 급증하지 않도록 합니다. 이 입력 값은 지터가 특정 지점에 있을 수 있는 최대값을 제어하여 마우스가 경로에서 벗어날 수 있는 정도를 제한합니다. 값이 높을수록 끌기 동작이 더 적게 '매끄럽게' 표시됩니다. 각 지점의 지터는 이전 지터 값에서 -2 2(기본적으로) 사이에서만 벗어날 수 있으므로 최대값을 설정한 값에 관계없이 가능한 최대 지터는 2 x NumberOfSteps입니다.

최대 끝 픽셀 지터
MaximumEndPixelJitter integer

끌기 동작의 끝에 있는 최대 픽셀 지터입니다. 값이 높을수록 끝 좌표에 도달할 때 끌기의 정확도가 떨어지게 됩니다.

최대 이동 픽셀 지터 델타
MaximumMovementPixelJitterDelta integer

마우스 이동 지터를 사용하는 경우(최대 이동 픽셀 지터가 1 이상) 각 지점의 최대 지터가 이전 지점에서 벗어날 수 있습니다. 지터가 부드러운지 확인하는 데 사용됩니다. 값이 클수록 부드러움이 줄어듭니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표에서 마우스 가운데 고정

지정된 시간(초)동안 IA-Connect 에이전트 사용자 세션의 지정된 좌표에 마우스 가운데 단추를 유지합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

Y 좌표 값(픽셀)입니다.

보관할 시간(초)
SecondsToHold True double

마우스 가운데 단추를 누를 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표에서 마우스 가운데 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 가운데 단추를 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

Y 좌표 값(픽셀)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표에서 마우스 오른쪽 단추 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 오른쪽 단추를 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

Y 좌표 값(픽셀)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표에서 마우스 왼쪽 두 번 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 두 번 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

Y 좌표 값(픽셀)입니다.

지연 시간(밀리초)
DelayInMilliseconds integer

각 클릭 사이의 지연 시간(밀리초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표에서 마우스 왼쪽 클릭

지정된 좌표의 IA-Connect 에이전트 사용자 세션에서 마우스 왼쪽 단추를 클릭합니다. 현재 활성 마우스 이동 API(mouse_event 또는 setcursorpos)는 마우스를 이동하는 데 사용됩니다. DPI 크기 조정 및 여러 디스플레이는 좌표를 계산할 때 고려됩니다.

매개 변수

Name 필수 형식 Description
X 픽셀
XCoord True integer

X 좌표 값(픽셀)입니다.

Y 픽셀
YCoord True integer

Y 좌표 값(픽셀)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

좌표에서 픽셀 색 가져오기

지정된 좌표에서 픽셀의 RGB 색을 반환합니다.

매개 변수

Name 필수 형식 Description
왼쪽 X 픽셀
LeftXPixels True integer

읽을 픽셀의 X 위치입니다. 단일 디스플레이에서 가장 왼쪽 X 픽셀은 0입니다. 다중 모니터 디스플레이에서 가장 왼쪽 X 픽셀은 음수일 수 있습니다(기본으로 표시된 디스플레이와 다른 디스플레이를 기준으로 하는 위치에 따라 다름).

상위 Y 픽셀
TopYPixels True integer

읽을 픽셀의 Y 위치입니다. 단일 디스플레이에서 최상위 Y 픽셀은 0입니다. 다중 모니터 디스플레이에서 최상위 Y 픽셀은 음수일 수 있습니다(기본으로 표시된 디스플레이와 다른 디스플레이를 기준으로 하는 위치에 따라 다름).

에이전트 숨기기
HideAgent boolean

에이전트를 자동으로 숨기려면 true로 설정하여(표시되는 경우) 읽는 픽셀이 가려지지 않도록 합니다.

물리적 좌표 사용
UsePhysicalCoordinates boolean

제공된 좌표가 물리적 좌표(DPI 크기 조정이 아니므로 디스플레이의 실제 픽셀과 일치)를 지정하려면 true로 설정합니다. 제공된 좌표가 가상(DPI 크기 조정)되도록 지정하려면 false(기본값)로 설정합니다. UIA, Java 및 웹 작업은 일반적으로 가상 좌표를 사용합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
빨간색 값
RedValue integer

픽셀의 빨간색 값을 0(빨강 없음)에서 255(전체 빨강)로 반환합니다.

녹색 값
GreenValue integer

픽셀의 녹색 값을 0(녹색 없음)에서 255(전체 녹색)로 반환합니다.

파란색 값
BlueValue integer

픽셀의 파란색 값을 0(파란색 없음)에서 255(전체 파란색)로 반환합니다.

알파 값
AlphaValue integer

픽셀의 알파 값을 0(완전히 투명)에서 255(완전히 불투명)로 반환합니다.

RRGGBB 16진수 값
RRGGBBHexValue string

픽셀의 RRGGBB 16진수 값을 반환합니다. 예를 들어 FF0000은 빨강, 00FF00은 전체 녹색, 0000FF는 파랑, 000000은 검은색, FFFFFF는 전체 흰색입니다.

AARRGGBB 16진수 값
AARRGGBBHexValue string

RRGGBB와 동일하지만 16진수 알파 값이 시작 부분에 포함된 픽셀의 AARRGGBB 16진수 값을 반환합니다. 완전히 불투명한 픽셀(가장 일반적인 픽셀)의 경우 FFRRGGBB 값을 보유합니다. 예를 들어 FFFF0000 완전히 불투명한 전체 빨간색입니다.

컴퓨터 도메인 가져오기

IA-Connect 에이전트 사용자 세션을 실행하는 컴퓨터의 도메인을 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
도메인 이름
DomainName string

IA-Connect 에이전트 사용자 세션을 실행하는 컴퓨터의 NetBIOS 도메인 이름입니다.

DNS 도메인 이름
DNSDomainName string

IA-Connect 에이전트 사용자 세션을 실행하는 컴퓨터의 DNS 도메인 이름입니다.

컴퓨터 이름 가져오기

IA-Connect 에이전트 사용자 세션을 실행하는 컴퓨터의 이름을 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
컴퓨터 이름
MachineName string

IA-Connect 에이전트 사용자 세션을 실행하는 컴퓨터의 이름입니다.

클라이언트 호스트 이름 가져오기

IA-Connect Director가 실행 중인 클라이언트의 호스트 이름을 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
클라이언트 호스트 이름
ClientHostname string

IA-Connect Director가 실행 중인 클라이언트의 호스트 이름입니다.

클라이언트에서 서버로 파일 복사

로컬 컴퓨터(IA-Connect 디렉터 실행)에서 원격 컴퓨터(IA-Connect 에이전트 실행)로 파일을 복사합니다.

매개 변수

Name 필수 형식 Description
클라이언트 파일 경로
ClientFilePath True string

IA-Connect 디렉터를 실행하는 로컬 컴퓨터에서 파일을 복사할 파일 경로입니다.

서버 파일 경로
ServerFilePath True string

파일을 복사할 파일 경로입니다(IA-Connect 에이전트를 실행하는 컴퓨터에서).

압축
Compress boolean

복사할 때 파일을 압축해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

클립보드 가져오기

IA-Connect 에이전트 사용자 세션에서 클립보드의 현재 콘텐츠를 가져옵니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
클립보드 데이터
ClipboardData string

클립보드 내에 포함된 데이터입니다.

클립보드 설정

IA-Connect 에이전트 사용자 세션에서 클립보드의 콘텐츠를 설정합니다.

매개 변수

Name 필수 형식 Description
새 클립보드 데이터
NewClipboardData string

클립보드에 설정할 데이터입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

클립보드 지우기

IA-Connect 에이전트 사용자 세션에서 클립보드의 내용을 지웁니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

클립보드에 파일 복사

지정된 로컬 파일을 IA-Connect 에이전트 사용자 세션의 클립보드에 복사합니다.

매개 변수

Name 필수 형식 Description
파일 이름
Filepath True string

클립보드에 복사할 로컬 파일의 파일 경로입니다.

자르기
Cut boolean

true로 설정하면 파일을 복사하는 대신 잘라냅니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
CopyFileToClipboardResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

키 보내기

전역 키 누름을 IA-Connect 에이전트 사용자 세션으로 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

매개 변수

Name 필수 형식 Description
문자 메시지
Text True string

IA-Connect 에이전트 사용자 세션에서 시뮬레이션할 키를 누릅니다. 키 코드는 'UI 사용자 가이드'의 '키 보내기 구문'에 설명되어 있습니다. 영숫자를 입력하려면 텍스트 as-is입력하기만 하면 됩니다. Ctrl+C를 누르는 예제: ^c. Alt+F: %f키를 누르는 예제입니다.

간격(밀리초)
Interval integer

각 키 누름 사이의 시간(밀리초)입니다.

암호인가요?
IsPassword boolean

입력이 암호 값인가요? 그렇다면 대체 '암호 키 보내기' 작업을 사용해야 합니다.

기호 해석 안 함
DontInterpretSymbols boolean

텍스트의 기호를 특수 키(예: Shift의 경우 + Ctrl의 경우 ^)로 해석하지 않아야 하나요? 실제 기호를 입력하려는 경우 true로 설정해야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

키 이벤트 보내기

하위 수준 키보드 드라이버를 사용하여 전역 키 누름 이벤트를 IA-Connect 에이전트 사용자 세션으로 보냅니다. 이렇게 하면 키보드에서 해당 키를 누르는 사용자가 시뮬레이트됩니다. 대상 Window 요소에 포커스가 있거나 잘못된 애플리케이션에서 키 프레스를 받거나 무시할 수 있는지 확인합니다.

매개 변수

Name 필수 형식 Description
문자 메시지
Text True string

키가 낮은 수준의 키보드 드라이버를 사용하여 IA-Connect 에이전트 사용자 세션에 입력되도록 누릅니다. 키 코드는 'UI 사용자 가이드'의 '키 이벤트 보내기 구문'에 설명되어 있습니다. 이스케이프를 누르고 놓는 예제: {Escape}. 데스크톱을 표시하기 위해 Win+D를 누르는 예제(왼쪽 Windows 키 압축 풀기, d 키를 누르고 놓기, 왼쪽 Windows 키 해제): <{LWin}d>{LWin}. Ctrl+C를 누르는 예제(왼쪽 컨트롤의 압축을 풀고, c를 누르고, 왼쪽 컨트롤을 놓습니다.): <{Ctrl}c>{Ctrl}. 우울한 키를 해제하거나 우울한 상태로 유지됩니다(예: 한정자 키를 디프레스하는 데 사용하는 < 경우 해제하는 데 사용 > ).

간격(밀리초)
Interval integer

각 키 누름 이벤트 사이의 시간(밀리초)입니다.

암호인가요?
IsPassword boolean

입력이 암호 값인가요? 그렇다면 대체 '암호 키 이벤트 보내기' 작업을 사용해야 합니다.

기호 해석 안 함
DontInterpretSymbols boolean

텍스트의 기호를 특수 키로 해석하지 않아야 하나요(예: Shift의 경우 {SHIFT}, Ctrl의 경우 {CTRL})? 실제 기호를 입력하려는 경우 true로 설정해야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

텍스트 파일 쓰기

IA-Connect 에이전트가 실행 중인 컴퓨터에 텍스트 파일을 만들고 파일에 텍스트를 씁니다.

매개 변수

Name 필수 형식 Description
파일 경로
Filename True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

쓸 텍스트
TextToWrite string

파일에 쓸 텍스트 내용입니다.

기존 파일 추가
AppendExistingFile boolean

파일이 이미 있는 경우 쓸 새 텍스트를 기존 파일의 끝에 추가해야 하나요?

인코딩
Encoding string

파일 인코딩(유니코드, UTF8, UTF7 또는 ASCII)을 제공하거나 기본값(UTF8)을 비워 둡니다.

필요한 경우 폴더 만들기
CreateFolderIfRequired boolean

'파일 경로' 매개 변수에 제공된 파일을 저장할 폴더가 없는 경우 이 폴더를 만들어야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

파일 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 있는 파일 목록(CSV 패턴 목록과 일치)을 반환합니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

패턴 CSV
PatternsCSV True string

일치하는 파일 패턴의 쉼표로 구분된 목록입니다 (예: 모든 파일의 경우 ) 또는 '.txt,.docx'(.txt 또는 .docx 확장자를 사용하는 파일의 경우 ).

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
파일 JSON
FilesJSON string

폴더에 포함된 파일 목록(JSON 형식)입니다.

성공적으로 읽은 파일 수
NumberOfFilesReadSuccessfully integer

성공적으로 읽은 파일 수입니다.

읽지 못한 파일 수
NumberOfFilesFailedToRead integer

읽을 수 없는 파일 수입니다.

파일 보안 권한 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일에 대해 현재 설정된 사용 권한 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
파일 경로
FilePath True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
보안 권한 JSON
SecurityPermissionsJSON string

현재 지정된 파일에 대해 JSON 형식으로 설정된 권한입니다.

파일 보안에서 ID 제거

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일에 대한 보안 권한에서 ID(예: 사용자, 그룹 또는 컴퓨터)를 제거합니다.

매개 변수

Name 필수 형식 Description
파일 경로
FilePath True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

제거할 ID
IdentityToRemove True string

제거할 사용자 또는 그룹의 ID입니다. 'username', 'DOMAIN\username' 또는 'username@domainfqdn' 형식일 수 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
사용 권한이 제거되었습니다.
PermissionWasRemoved boolean

사용 권한이 성공적으로 제거된 경우 true를 반환합니다.

파일 복사

IA-Connect 에이전트가 실행 중인 컴퓨터에 파일을 복사합니다.

매개 변수

Name 필수 형식 Description
원본 파일 경로
SourceFilePath True string

원본 파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

대상 파일 경로
DestFilePath True string

파일을 복사해야 하는 대상의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

파일 삭제

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일을 삭제합니다.

매개 변수

Name 필수 형식 Description
파일 경로
Filename True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

파일 삭제

IA-Connect 에이전트가 실행 중인 컴퓨터의 패턴과 일치하는 지정된 폴더 내의 파일을 삭제합니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

패턴
Pattern string

삭제할 파일과 일치하는 패턴(예: 모든 파일의 경우 ) 또는 확장 .txt 파일의 경우 *.txt.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
삭제된 파일 수
NumberOfFilesDeleted integer

성공적으로 삭제된 파일 수입니다.

삭제하지 못한 파일 수
NumberOfFilesFailedToDelete integer

삭제할 수 없는 파일 수입니다.

파일 이동

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일을 이동합니다.

매개 변수

Name 필수 형식 Description
원본 파일 경로
SourceFilePath True string

원본 파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

대상 파일 경로
DestFilePath True string

파일을 이동해야 하는 대상의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

파일 콘텐츠를 Base64로 가져오기

지정된 파일의 내용을 Base64 형식으로 검색합니다. 이 형식은 API를 통한 전송에 적합하고 원래 텍스트 또는 이진 형식으로 쉽게 다시 변환됩니다.

매개 변수

Name 필수 형식 Description
파일 경로
FilePath True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

압축
Compress boolean

Base64로 변환하기 전에 파일 내용을 GZip 압축으로 true로 설정합니다. 파일은 그대로 유지되고 모든 작업은 메모리에서 수행됩니다. 이 기능은 Base64를 검색한 후(원래 파일 콘텐츠 텍스트 또는 이진 데이터로 다시 디코딩할 때) 파일 콘텐츠를 GUnzip할 수 있는 경우에만 유용합니다. Base64를 입력으로 수락하고 GUnzip 기능이 없는 작업에 직접 Base64를 전달하는 경우 false로 설정합니다.

최대 파일 크기
MaxFileSize integer

파일 콘텐츠를 검색하는 대신 예외가 발생하는 파일의 최대 크기입니다. 이렇게 하면 에이전트가 거대한 파일을 검색하라는 요청을 받은 상황을 방지할 수 있으며, 이로 인해 궁극적으로 작업 시간이 초과됩니다. 파일 크기 검사를 사용하지 않도록 설정하려면 -1 설정합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
Base64로 파일 내용
FileContentsAsBase64 string

Base64 형식의 파일 내용입니다.

파일 크기 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일의 크기(바이트)를 반환합니다.

매개 변수

Name 필수 형식 Description
파일 경로
Filename True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
파일 크기
FileSize integer

파일의 크기(바이트)입니다.

파일에 권한 추가

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일에 권한을 추가합니다.

매개 변수

Name 필수 형식 Description
파일 경로
FilePath True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

아이덴티티
Identity True string

사용 권한을 할당할 사용자 또는 그룹의 ID입니다. 'username', 'DOMAIN\username' 또는 'username@domainfqdn' 형식일 수 있습니다.

허가
Permission True string

할당할 권한(읽기, ReadAndExecute, 수정 또는 FullControl)을 제공하거나 기본값(읽기)에 대해 비워 둡니다.

Deny
Deny boolean

사용 권한이 거부되나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

파일에 소유자 설정

IA-Connect 에이전트가 실행 중인 컴퓨터의 파일 소유자를 설정합니다.

매개 변수

Name 필수 형식 Description
파일 경로
FilePath True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

사용자 ID
UserIdentity True string

소유권을 할당할 사용자의 ID입니다. 'username', 'DOMAIN\username' 또는 'username@domainfqdn' 형식일 수 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

파일에서 모든 텍스트 읽기

IA-Connect 에이전트가 실행 중인 컴퓨터에서 파일의 텍스트 내용을 읽습니다.

매개 변수

Name 필수 형식 Description
파일 경로
Filename True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
파일 텍스트 내용
FileTextContents string

파일의 텍스트 내용입니다.

파일이 존재하나요?

IA-Connect 에이전트가 실행 중인 컴퓨터에 파일이 있는지 여부에 대해 true 또는 false를 보고합니다.

매개 변수

Name 필수 형식 Description
파일 경로
Filename True string

파일의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
파일이 있음
FileExists boolean

파일이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

폴더 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 지정된 폴더 내에 있는 모든 하위 폴더를 반환합니다.

매개 변수

Name 필수 형식 Description
디렉터리 경로
DirectoryPath True string

디렉터리(폴더)의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
폴더 JSON
FoldersJSON string

폴더에 포함된 하위 폴더 목록(JSON 형식)입니다.

성공적으로 읽은 폴더 수
NumberOfFoldersReadSuccessfully integer

성공적으로 읽은 하위 폴더의 수입니다.

읽지 못한 폴더 수
NumberOfFoldersFailedToRead integer

읽을 수 없는 하위 폴더의 수입니다.

폴더 보안 권한 가져오기

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 현재 설정된 사용 권한 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
폴더 경로
FolderPath True string

폴더의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
보안 권한 JSON
SecurityPermissionsJSON string

현재 지정된 폴더에 대해 JSON 형식으로 설정된 권한입니다.

폴더 보안 상속 사용

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에서 보안 상속을 사용하도록 설정합니다.

매개 변수

Name 필수 형식 Description
폴더 경로
FolderPath True string

폴더의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

폴더 보안 상속 중단

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에서 보안 상속을 중단합니다.

매개 변수

Name 필수 형식 Description
폴더 경로
FolderPath True string

폴더의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

상속된 개체를 명시적 변환
ConvertInheritedToExplicit boolean

현재 상속된 사용 권한을 명시적 권한으로 변환해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

폴더 보안에서 ID 제거

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 대한 보안 권한에서 ID(예: 사용자, 그룹 또는 컴퓨터)를 제거합니다.

매개 변수

Name 필수 형식 Description
폴더 경로
FolderPath True string

폴더의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

제거할 ID
IdentityToRemove True string

제거할 사용자 또는 그룹의 ID입니다. 'username', 'DOMAIN\username' 또는 'username@domainfqdn' 형식일 수 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
사용 권한이 제거되었습니다.
PermissionWasRemoved boolean

사용 권한이 성공적으로 제거된 경우 true를 반환합니다.

폴더에 사용 권한 추가

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 사용 권한을 추가합니다.

매개 변수

Name 필수 형식 Description
폴더 경로
FolderPath True string

폴더의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

아이덴티티
Identity True string

사용 권한을 할당할 ID(예: 사용자, 그룹 또는 컴퓨터)입니다. 'username', 'DOMAIN\username' 또는 'username@domainfqdn' 형식일 수 있습니다.

허가
Permission True string

할당할 권한(읽기, ReadAndExecute, 수정 또는 FullControl)을 제공하거나 기본값(읽기)에 대해 비워 둡니다.

폴더에 적용
ApplyToFolder boolean

폴더 자체에 사용 권한이 적용되어야 하나요?

하위 폴더에 적용
ApplyToSubFolders boolean

권한이 하위 폴더로 전파되어야 하나요?

파일에 적용
ApplyToFiles boolean

폴더 내의 파일에 사용 권한이 적용되어야 하나요?

Deny
Deny boolean

사용 권한이 거부되나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

폴더에 소유자 설정

IA-Connect 에이전트가 실행 중인 컴퓨터의 폴더에 소유자를 설정합니다.

매개 변수

Name 필수 형식 Description
폴더 경로
FolderPath True string

폴더의 전체 경로입니다. IA-Connect 에이전트가 실행 중인 세션에서 액세스할 수 있어야 합니다.

사용자 ID
UserIdentity True string

소유권을 할당할 사용자의 ID입니다. 'username', 'DOMAIN\username' 또는 'username@domainfqdn' 형식일 수 있습니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

프로세스 ID 명령줄 속성 가져오기

지정된 프로세스 ID가 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스에 대한 명령줄 속성을 반환합니다.

매개 변수

Name 필수 형식 Description
프로세스 ID
ProcessId True integer

명령줄 속성을 검색할 프로세스의 프로세스 ID입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프로세스 명령줄
ProcessCommandLine string

프로세스에 대한 명령줄 속성입니다.

프로세스 인수
ProcessArguments string

프로세스를 시작할 때 사용된 인수입니다.

현재 작업 디렉터리 처리
ProcessCurrentWorkingDirectory string

프로세스 현재 작업 디렉터리입니다.

프로세스 이미지 경로 이름
ProcessImagePathName string

프로세스를 시작한 실행 파일의 경로입니다.

프로세스 ID 종료

지정된 프로세스 ID가 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스를 종료합니다. 프로세스 ID는 고유하므로 하나의 프로세스만 ID와 일치할 수 있습니다. 프로세스 ID는 동적이며 애플리케이션을 시작할 때마다 다릅니다.

매개 변수

Name 필수 형식 Description
프로세스 ID
ProcessID True integer

종료할 프로세스의 프로세스 ID입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
종료된 프로세스 수
NumberOfProcessesKilled integer

사망한 프로세스의 수입니다.

프로세스 ID별 프로세스 가져오기

지정된 프로세스 ID가 있는 프로세스가 IA-Connect 에이전트 사용자 세션에서 실행되고 있는지 여부를 반환합니다. 프로세스 ID는 고유하므로 하나의 프로세스만 ID와 일치할 수 있습니다. 프로세스 ID는 동적이며 애플리케이션을 시작할 때마다 다릅니다.

매개 변수

Name 필수 형식 Description
프로세스 ID
ProcessId True integer

가져올 프로세스의 프로세스 ID입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프로세스 실행
ProcessRunning boolean

제공된 프로세스 ID가 있는 프로세스가 발견되면 true를 반환합니다.

프로세스 가져오기

IA-Connect 에이전트 사용자 세션에서 실행 중인 프로세스 목록을 반환합니다. 필요에 따라 프로세스 이름을 제공하여 필터링할 수 있습니다.

매개 변수

Name 필수 형식 Description
프로세스 이름
ProcessName string

프로세스 이름에 대한 선택적 필터입니다.

프로세스 명령줄 가져오기
GetProcessCommandLine boolean

true로 설정하면 프로세스 명령줄 세부 정보가 반환됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프로세스 수
NumberOfProcesses integer

사용자 세션에서 실행 중인 프로세스 수입니다.

프로세스 JSON
ProcessesJSON string

사용자 세션에서 JSON 형식으로 실행되는 프로세스 목록입니다.

프로세스 실행

프로세스, 명령 또는 애플리케이션을 시작합니다.

매개 변수

Name 필수 형식 Description
프로세스 이름
ProcessName True string

실행할 프로세스입니다. 예: notepad.exe 또는 C:\windows\system32\notepad.exe. IA-Connect 에이전트는 경로의 모든 환경 변수를 확장합니다.

Arguments
Arguments string

애플리케이션을 시작할 때 사용할 명령줄 인수입니다.

작업 폴더
WorkingDirectory string

프로세스의 작업 폴더/디렉터리입니다. IA-Connect 에이전트는 경로의 모든 환경 변수를 확장합니다.

셸 실행 사용
UseShellExecute boolean

운영 체제 셸을 사용하여 프로세스를 시작해야 하나요?

창 만들기
CreateNoWindow boolean

프로세스를 창 없이 시작해야 하나요?

창 스타일
WindowStyle string

창 스타일(일반, 최대화, 최소화 또는 숨김)을 제공합니다.

프로세스 대기
WaitForProcess boolean

프로세스가 완료되기를 기다려야 하나요? 이 작업은 계속하기 전에 완료해야 하는 프로그램 또는 스크립트를 실행할 때만 사용될 수 있습니다.

표준 출력 리디렉션
RedirectStandardOutput boolean

표준 출력을 리디렉션해야 하나요?

리디렉션 표준 오류
RedirectStandardError boolean

표준 오류를 리디렉션해야 하나요?

표준 오류를 출력으로 리디렉션
RedirectStandardErrorToOutput boolean

표준 오류를 출력으로 리디렉션해야 하나요?

표준 출력 인코딩
StandardOutputEncoding string

표준 출력 인코딩(UTF8, UTF7, UTF16, ASCII 또는 UTF16BE)을 제공합니다.

표준 오류 인코딩
StandardErrorEncoding string

표준 오류 인코딩(UTF8, UTF7, UTF16, ASCII 또는 UTF16BE)을 제공합니다.

RunAs 도메인 이름
RunAsDomain string

사용자로 실행의 도메인입니다. 도메인을 지정하지 않으면 사용자 이름이 username@domainFQDN 형식이어야 합니다.

RunAs 사용자 이름
RunAsUsername string

사용자로 실행의 사용자 이름입니다.

RunAs 암호
RunAsPassword password

사용자로 실행의 암호입니다.

RunAs 로드 사용자 프로필
RunAsLoadUserProfile boolean

실행의 Windows 사용자 프로필을 사용자로 로드해야 하나요?

RunAs elevate
RunAsElevate boolean

프로세스가 관리자 권한으로 실행되어야 하나요?

제한 시간(초)
TimeoutInSeconds integer

프로세스가 완료되기를 기다리는 최대 시간(초)입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프로세스 시작됨
ProcessStarted boolean

프로세스가 시작된 경우 true를 반환합니다.

종료 코드
ExitCode integer

프로세스 종료 코드를 반환합니다.

프로세스 시간이 초과됨
ProcessTimedOut boolean

프로세스 시간이 초과되면 true를 반환합니다.

프로세스 ID
ProcessId integer

시작된 프로세스의 프로세스 ID입니다.

표준 출력
StandardOutput string

표준 출력 내용입니다.

표준 오류
StandardError string

표준 오류 내용입니다.

프로세스 종료

지정된 프로세스 이름이 있는 IA-Connect 에이전트 사용자 세션에서 실행 중인 모든 프로세스를 종료합니다.

매개 변수

Name 필수 형식 Description
프로세스 이름
ProcessName True string

죽일 과정입니다. 예: 메모장.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
종료된 프로세스 수
NumberOfProcessesKilled integer

사망한 프로세스의 수입니다.

프린터 목록 가져오기

IA-Connect 에이전트 세션에서 사용 가능한 모든 프린터 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
로컬 프린터 나열
ListLocalPrinters boolean

로컬 프린터를 반환해야 하나요?

네트워크 프린터 나열
ListNetworkPrinters boolean

네트워크 프린터를 반환해야 하나요?

자세한 정보 반환
ReturnDetailedInformation boolean

각 프린터의 위치, 포트 이름, 드라이버 이름 및 상태와 같은 자세한 정보를 반환해야 하나요?

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
프린터 JSON
PrintersJSON string

JSON 형식으로 찾은 모든 프린터 목록입니다.

프린터 수
NumberOfPrinters integer

발견된 프린터의 수입니다.

현재 마우스 좌표 가져오기

setcursorpos API를 사용하여 IA-Connect 에이전트 사용자 세션에서 현재 마우스 커서 위치를 가져옵니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
X 픽셀
X integer

X 좌표 값(픽셀)입니다.

Y 픽셀
Y integer

Y 좌표 값(픽셀)입니다.

화면 읽기 프로그램 설정

IA-Connect 에이전트 사용자 세션에서 화면 읽기 프로그램을 사용하거나 사용하지 않도록 설정합니다.

매개 변수

Name 필수 형식 Description
화면 읽기 프로그램 사용
EnableScreenReader boolean

true로 설정하면 화면 읽기 프로그램이 활성화됩니다. false로 설정하면 화면 읽기 프로그램이 비활성화됩니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

화면 읽기 프로그램을 사용할 수 있는지 확인

IA-Connect 에이전트 사용자 세션에서 화면 읽기 프로그램을 사용하도록 설정했는지 여부를 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
화면 읽기 프로그램 사용
ScreenReaderEnabled boolean

화면 읽기 프로그램을 사용하도록 설정한 경우 true를 반환합니다.

화면 해상도 가져오기

IA-Connect 에이전트 사용자 세션의 화면 해상도를 반환합니다. 실제 데스크톱 또는 랩톱에서 실행되는 IA-Connect 로컬 에이전트의 경우 모든 디스플레이 디바이스 및 크기 조정에 대한 정보를 제공합니다. 가상 머신에서 가상 머신이 여러 디스플레이를 표시하도록 구성되지 않은 한 일반적으로 하나의 디스플레이만 보고됩니다(일반적이지 않음). 원격 세션에서는 일반적으로 하나의 가상 디스플레이를 만들기 때문에 해당 디스플레이가 여러 로컬 디스플레이에 걸쳐 있더라도 일반적으로 하나의 디스플레이만 보고됩니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
가로 해상도
HorizontalResolution integer

기본 화면의 가로 물리적 해상도입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

세로 해상도
VerticalResolution integer

기본 화면의 세로 물리적 해상도입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

화면 수
NumberOfScreens integer

이 세션의 화면 수입니다.

두 번째 가로 해상도 표시
SecondDisplayHorizontalResolution integer

감지된 경우 두 번째 화면의 가로 물리적 해상도입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

두 번째 디스플레이 세로 해상도
SecondDisplayVerticalResolution integer

두 번째 화면의 세로 물리적 해상도(감지된 경우)입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

세 번째 디스플레이 가로 해상도
ThirdDisplayHorizontalResolution integer

세 번째 화면의 가로 물리적 해상도(감지된 경우)입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

세 번째 디스플레이 세로 해상도
ThirdDisplayVerticalResolution integer

세 번째 화면의 세로 물리적 해상도(감지된 경우)입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

네 번째 가로 해상도 표시
FourthDisplayHorizontalResolution integer

감지된 경우 네 번째 화면의 가로 물리적 해상도입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

네 번째 디스플레이 세로 해상도
FourthDisplayVerticalResolution integer

감지된 경우 네 번째 화면의 세로 물리적 해상도입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

가상 화면 왼쪽 가장자리 픽셀
VirtualScreenLeftEdgePixels integer

전체 가상 디스플레이의 왼쪽 가장자리(검색된 모든 디스플레이)입니다. 가상 좌표는 DPI 크기 조정됩니다.

가상 화면 위쪽 가장자리 픽셀
VirtualScreenTopEdgePixels integer

전체 가상 디스플레이의 위쪽 가장자리(검색된 모든 디스플레이)입니다. 가상 좌표는 DPI 크기 조정됩니다.

가상 화면 너비 픽셀
VirtualScreenWidthPixels integer

전체 가상 디스플레이의 너비입니다(검색된 모든 디스플레이). 가상 좌표는 DPI 크기 조정됩니다.

가상 화면 높이 픽셀
VirtualScreenHeightPixels integer

전체 가상 디스플레이의 높이입니다(검색된 모든 디스플레이). 가상 좌표는 DPI 크기 조정됩니다.

기본 디스플레이 크기 조정
PrimaryDisplayScaling double

기본 디스플레이의 DPI 크기 조정 승수를 10진수로 지정합니다. 예를 들어 100% 1.0으로 반환되고 125% 1.25로 반환됩니다.

두 번째 디스플레이 크기 조정
SecondDisplayScaling double

두 번째 디스플레이의 DPI 크기 조정 승수를 10진수로 표시합니다. 예를 들어 100% 1.0으로 반환되고 125% 1.25로 반환됩니다.

세 번째 디스플레이 크기 조정
ThirdDisplayScaling double

세 번째 디스플레이의 DPI 크기 조정 승수는 10진수입니다. 예를 들어 100% 1.0으로 반환되고 125% 1.25로 반환됩니다.

네 번째 디스플레이 크기 조정
FourthDisplayScaling double

네 번째 디스플레이의 DPI 크기 조정 승수를 10진수로 표시합니다. 예를 들어 100% 1.0으로 반환되고 125% 1.25로 반환됩니다.

실제 화면 왼쪽 가장자리 픽셀
PhysicalScreenLeftEdgePixels integer

전체 실제 디스플레이의 왼쪽 가장자리(검색된 모든 디스플레이)입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

실제 화면 위쪽 가장자리 픽셀
PhysicalScreenTopEdgePixels integer

전체 실제 디스플레이의 위쪽 가장자리(검색된 모든 디스플레이)입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

실제 화면 너비 픽셀
PhysicalScreenWidthPixels integer

전체 실제 디스플레이의 너비입니다(검색된 모든 디스플레이). 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

실제 화면 높이 픽셀
PhysicalScreenHeightPixels integer

전체 물리적 디스플레이의 높이입니다(검색된 모든 디스플레이). 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

기본 디스플레이 왼쪽 가장자리 픽셀
PrimaryDisplayLeftEdgePixels integer

기본 디스플레이의 왼쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

기본 디스플레이 위쪽 가장자리 픽셀
PrimaryDisplayTopEdgePixels integer

기본 디스플레이의 위쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

왼쪽 가장자리 픽셀 두 번째 표시
SecondDisplayLeftEdgePixels integer

감지된 경우 두 번째 디스플레이의 왼쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

두 번째 디스플레이 위쪽 가장자리 픽셀
SecondDisplayTopEdgePixels integer

감지된 경우 두 번째 디스플레이의 위쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

세 번째 디스플레이 왼쪽 가장자리 픽셀
ThirdDisplayLeftEdgePixels integer

검색된 경우 세 번째 디스플레이의 왼쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

세 번째 디스플레이 위쪽 가장자리 픽셀
ThirdDisplayTopEdgePixels integer

검색된 경우 세 번째 디스플레이의 위쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

왼쪽 가장자리 픽셀 네 번째 표시
FourthDisplayLeftEdgePixels integer

검색된 경우 네 번째 디스플레이의 왼쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

네 번째 디스플레이 위쪽 가장자리 픽셀
FourthDisplayTopEdgePixels integer

검색된 경우 네 번째 디스플레이의 위쪽 실제 가장자리입니다. 물리적 좌표는 모니터의 픽셀에 직접 매핑됩니다.

화면에 사각형 그리기

화면 좌표 또는 화면 좌표를 보고하는 작업의 출력을 식별하는 데 도움이 되도록 화면에 사각형을 그립니다. 사각형은 5초 후에 자동으로 제거됩니다.

매개 변수

Name 필수 형식 Description
사각형 왼쪽 가장자리 화면 픽셀 X 좌표
RectangleLeftPixelXCoord True integer

표시할 사각형의 왼쪽 픽셀 가장자리입니다. '좌표는 물리적'입력에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

사각형 오른쪽 가장자리 화면 픽셀 X 좌표
RectangleRightPixelXCoord True integer

표시할 사각형의 오른쪽 픽셀 가장자리입니다. '좌표는 물리적'입력에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

사각형 위쪽 가장자리 화면 픽셀 Y 좌표
RectangleTopPixelYCoord True integer

표시할 사각형의 위쪽 픽셀 가장자리입니다. '좌표는 물리적'입력에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

사각형 아래쪽 가장자리 화면 픽셀 Y 좌표
RectangleBottomPixelYCoord True integer

표시할 사각형의 아래쪽 픽셀 가장자리입니다. '좌표는 물리적'입력에 따라 가상 또는 물리적 픽셀에 있을 수 있습니다.

펜 색상
PenColour string

그릴 사각형의 색(예: 빨간색, 녹색, 파란색, 노란색, 자주색 또는 주황색) 또는 문자열 16진수 코드(예: #FF0000)입니다.

펜 두께 픽셀
PenThicknessPixels integer

강조 사각형 테두리의 두께(픽셀)입니다.

표시할 시간(초)
SecondsToDisplay integer

사각형을 표시할 시간(초)입니다.

좌표는 물리적입니다.
CoordinatesArePhysical boolean

제공되는 좌표가 실제 화면 좌표인 경우 true로 설정합니다. 제공 중인 좌표가 가상인 경우 false로 설정합니다. 기본 디스플레이 크기 조정이%100이면 실제 좌표와 가상 좌표가 모두 동일합니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
명령 결과
DrawRectangleOnScreenResult boolean

명령의 결과(성공 또는 실패)입니다.

오류 메시지
ErrorMessage string

명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다.

환경 변수 확장

IA-Connect 에이전트 사용자 세션에서 환경 변수(예: %USERPROFILE% 또는 %TEMP%)가 포함된 문자열을 확장합니다.

매개 변수

Name 필수 형식 Description
입력 문자열
InputString True string

환경 변수를 포함하는 입력 문자열입니다.

워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
출력 문자열
OutputString string

환경 변수가 확장된 문자열입니다.

환경 정보 가져오기

IA-Connect 에이전트 사용자 세션이 실행되는 환경에 대한 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()

반환

Name 경로 형식 Description
OS 주 버전
OSVersionMajor integer

운영 체제 주 버전입니다.

OS 부 버전
OSVersionMinor integer

운영 체제 부 버전입니다.

OS 빌드 버전
OSVersionBuild integer

운영 체제 빌드 버전입니다.

OS는 64비트입니다.
OSIs64Bit boolean

운영 체제가 64비트이면 true를 반환합니다.

프로세서 수
ProcessorCount integer

프로세서 수입니다.

총 실제 RAM(MB)
TotalPhysicalRAMInMB integer

실제 RAM의 양(MB)입니다.

총 가상 RAM(MB)
TotalVirtualRAMInMB integer

가상 RAM의 양(MB)입니다.

사용 가능한 실제 RAM(MB)
AvailablePhysicalRAMInMB integer

현재 사용할 수 있는 실제 RAM의 양(MB)입니다.

사용 가능한 가상 RAM(MB)
AvailableVirtualRAMInMB integer

현재 사용할 수 있는 가상 RAM의 양(MB)입니다.

OS 전체 이름
OSFullName string

운영 체제 전체 이름(예: Microsoft Windows Server 2019 Standard)입니다.

설치된 UI 문화권 이름
InstalledUICultureName string

운영 체제와 함께 설치된 사용자 인터페이스 언어(예: en-US.)

현재 UI 문화권 이름
CurrentUICultureName string

기본 사용자 인터페이스 언어(예: en-US.)

현재 문화권 이름
CurrentCultureName string

기본 사용자 로캘(예: en-GB.

흐름 결과 JSON에서 실패한 작업 오류 메시지 가져오기

하나 이상의 흐름 결과() 식의 JSON 출력을 역직렬화하고 실패한 작업에서 첫 번째 찾은 오류 메시지를 검색합니다. 오류 메시지는 다양한 형식으로 JSON에 저장할 수 있습니다. 이 작업은 알려진 형식을 처리하고 첫 번째 오류 메시지를 반환합니다.

매개 변수

Name 필수 형식 Description
흐름 결과 JSON
PowerAutomateResultJSON True array of string

하나 이상의 흐름 결과() 식의 출력을 포함해야 하는 JSON의 배열입니다. 단일 흐름 결과() 식의 출력만 처리하는 경우 첫 번째 배열 항목에 입력하기만 하면 됩니다.

검색 상태
SearchStatus string

오류 메시지가 포함된 작업의 상태입니다. 'Failed'의 기본값과 다른 상태를 검색하는 경우에만 변경해야 합니다.

반환

Name 경로 형식 Description
작업 오류 메시지
ActionErrorMessage string

결과 JSON에서 추출된 작업 오류 메시지를 반환합니다. 오류 메시지를 찾지 못하면 빈 값이 반환됩니다.

작업 이름
ActionName string

오류 메시지와 연결된 작업의 이름을 반환합니다.

작업 코드
ActionCode string

오류 메시지와 연결된 작업의 결과 코드를 반환합니다.

흐름을 완료로 표시

흐름을 완료로 표시합니다. 그러면 IA-Connect Orchestrator에 할당된 작업자 컴퓨터를 다른 흐름을 처리할 수 있음을 알릴 수 있습니다.

매개 변수

Name 필수 형식 Description
워크플로
Workflow True string

여기에 다음 식을 추가합니다. workflow()