터미널 에뮬레이션 작업
Power Automate는 터미널 에뮬레이션 작업을 통해 터미널 에뮬레이터와의 통합을 제공합니다. 이러한 작업을 통해 터미널 및 메인프레임을 처리하고 커서 이동, 텍스트 설정 및 가져오기, 키 전송과 같은 작업을 수행할 수 있습니다.
터미널 작업을 배포하기 전에 터미널 세션 열기 작업을 사용해 설치된 공급자와의 새 연결을 엽니다.
중요
터미널 세션에 연결하기 전에 실제 터미널 세션이 이미 컴퓨터에서 열려 있는지 확인하세요.
컴퓨터에 마이크로 포커스 리플렉션을 설치한 경우 해당 옵션을 작업의 공급자 매개 변수에서 선택하고 필요한 구성을 채웁니다.
다른 공급자를 설치한 경우 대부분의 터미널 에뮬레이션 공급자와 함께 작동하는 HLLAPI를 선택합니다.
사용 중인 공급자에 따라 설치 폴더에 있는 적절한 HLLAPI DLL 파일을 선택합니다. 다음 목록에서 일부 인기 있는 터미널 에뮬레이션 공급자의 HLLAPI DLL 파일 이름을 볼 수 있습니다.
- RocketSoftware BlueZone: ehlapi64.dll
- IBM 개인 커뮤니케이션: EHLAPI32.dll
- 마이크로포커스 룸바: System/ehlapi32.Dll
- 사이벨레소프트 z스코프: zHllap32.dll
노트
Windows HLLAPI DLL(WinHLLAPI)은 현재 지원되지 않습니다.
터미널 세션을 열고 원하는 모든 작업을 완료한 후 터미널 세션 닫기 작업을 사용하여 연결을 종료합니다. 연결을 닫지 않으면 일부 공급자는 소프트웨어나 연결을 다시 시작하지 않고는 이미 열려 있는 세션에 다시 연결할 수 없도록 합니다.
터미널 세션 열기
새 터미널 세션을 엽니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Provider | 해당 없음 | 마이크로 포커스 리플렉션, HLLAPI | 마이크로 포커스 리플렉션 | 사용할 터미널 에뮬레이션 |
| HLLAPI DLL path | 아니요 | 파일 | 공급자의 HLLAPI DLL입니다. RocketSoftware BlueZone 기본 이름: 'ehlapi64.dll'. IBM Personal Communications 기본 이름: 'EHLAPI32.dll'. MicroFocus Rumba 기본 경로: 'System/ehlapi32.Dll'. Cybelesoft zScope 기본 이름: 'zHllap32.dll'. 설치 폴더에 HLLAPI DLL을 제공하는 다른 공급자. | |
| Installation path | 아니요 | 폴더 | 사용자 파일 시스템의 공급자 응용 프로그램의 설치 경로 | |
| Configuration | 해당 없음 | 기존 프로필, 연결 지정 | 기존 프로필 | 미리 구성된 터미널 에뮬레이션 연결이 포함된 파일을 선택하려면 '기존 프로필'을 선택하십시오. 연결 유형, 호스트 주소 및 포트를 지정하려면 '연결 지정'을 선택하십시오. |
| Session name | 아니요 | 텍스트 값 | 연결할 세션 이름. HLLAPI 짧은 이름이며 호스트 세션에 대한 고유 식별자입니다. 터미널 에뮬레이터의 구성 설정에서 찾을 수 있습니다. | |
| Host type | 해당 없음 | IBM 3270, IBM 5250 | IBM 3270 | 연결의 호스트 유형 |
| 프로필 | 아니요 | 파일 | 사전 구성된 연결을 포함하는 파일 | |
| 호스트 주소 | 아니요 | 텍스트 값 | 연결할 호스트 주소 | |
| Port | 아니요 | 숫자 값 | 이 연결에 대해 사용될 포트 | |
| Attach to running session | 해당 없음 | 부울 값 | False | 현재 실행 열린 또는 실행 중인 터미널 세션에 첨부 여부 지정 |
변수 생성됨
| 인수 | Type | 설명 |
|---|---|---|
| TerminalSession | Terminal session | 이후 터미널 에뮬레이션 명령과 함께 사용할 특정 터미널 세션 |
예외
| 예외 | 설명 |
|---|---|
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
| 프로필 오류 | 프로필 오류 |
터미널 세션 닫기
열린 터미널 세션을 닫습니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Terminal session to close | 아니요 | Terminal session | 이전에 열린 터미널 세션 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 | 설명 |
|---|---|
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
터미널 세션에서 커서 이동
지정 위치에서 터미널 커서를 이동합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Terminal session | 아니요 | 터미널 세션 | 작업할 터미널 세션 | |
| Row | 아니요 | 숫자 값 | 화면 커서의 세로 위치 | |
| Column | 아니요 | 숫자 값 | 화면 커서의 가로 위치 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 | 설명 |
|---|---|
| 화면 위치이 경계를 넘었음 | 화면 위치이 경계를 넘었음을 나타냄 |
| 위치 명령이 에뮬레이터에 지원되지 않음 | 사용된 위치 명령이 에뮬레이터에서 지원되지 않음을 나타냄 |
| 이 세션 유형에 대해서 작업을 이용할 수 없음 | 이 세션 유형에 대해서 작업을 이용할 수 없음을 나타냄 |
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
터미널 세션에서 텍스트 가져오기
터미널 세션에서 텍스트를 가져옵니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Terminal session | 아니요 | 터미널 세션 | 작업할 터미널 세션 | |
| Get text from | 해당 없음 | 필드, 전체 화면, 커서 위치, 특정 위치 | 필드 | 텍스트를 가져올 위치 |
| Get field by | 해당 없음 | 레이블, 색인, 위치 | Label | 필드를 검색할 방법 지정 |
| Label | 아니요 | 텍스트 값 | 검색할 필드의 레이블 | |
| Index | 아니요 | 숫자 값 | 검색할 필드의 색인 | |
| Text length | 아니요 | 숫자 값 | 검색할 텍스트의 길이 | |
| Row | 아니요 | 숫자 값 | 화면 필드의 세로 위치 | |
| Column | 아니요 | 숫자 값 | 화면 필드의 가로 위치 |
변수 생성됨
| 인수 | Type | 설명 |
|---|---|---|
| TerminalText | 텍스트 값 | 터미널 세션에서 검색된 텍스트 |
예외
| 예외 | 설명 |
|---|---|
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
| 필드 색인 경계 벗어남 | 필드 색인이 경계를 넘었음을 나타냄 |
| 필드 레이블을 찾을 수 없음 | 필드 레이블이 없음을 나타냄 |
| 화면 위치이 경계를 넘었음 | 화면 위치이 경계를 넘었음을 나타냄 |
| 주어진 위치에 필드를 찾을 수 없음 | 주어진 위치에 필드가 없음을 나타냄 |
| 터미널 화면 서식 없음 | 터미널 화면이 서식이 없음을 나타냄 |
| 위치 명령이 에뮬레이터에 지원되지 않음 | 사용된 위치 명령이 에뮬레이터에서 지원되지 않음을 나타냄 |
| 이 세션 유형에 대해서 작업을 이용할 수 없음 | 이 세션 유형에 대해서 작업을 이용할 수 없음을 나타냄 |
터미널 세션에서 텍스트 설정
터미널 세션에 텍스트를 설정합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Terminal session | 아니요 | Terminal session | 작업할 터미널 세션 | |
| 문자 | 아니요 | 직접 암호화 입력 또는 Text value | 지정 위치에 설정할 텍스트 | |
| Set text | 사용 불가 | 커서 위치, 필드 | 필드 | 텍스트를 설정할 위치 |
| Get field by | 해당 없음 | 레이블, 색인, 위치 | Label | 필드를 검색할 방법 지정 |
| Label | 아니요 | 텍스트 값 | 검색할 필드의 레이블 | |
| Index | 아니요 | 숫자 값 | 화면 필드의 색인 | |
| Row | 아니요 | 숫자 값 | 화면 필드의 세로 위치 | |
| Column | 아니요 | 숫자 값 | 화면 필드의 가로 위치 | |
| Treat @ character as literal | 사용 불가 | 부울 값 | False | '@' 문자를 문자 그대로 보내려면 이 확인란을 선택합니다. 특수 문자로 보내려면 이 옵션을 비활성화된 상태로 둡니다. |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 | 설명 |
|---|---|
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
| 필드 색인 경계 벗어남 | 필드 색인이 경계를 넘었음을 나타냄 |
| 필드 레이블을 찾을 수 없음 | 필드 레이블이 없음을 나타냄 |
| 화면 위치이 경계를 넘었음 | 화면 위치이 경계를 넘었음을 나타냄 |
| 주어진 위치에 필드를 찾을 수 없음 | 주어진 위치에 필드가 없음을 나타냄 |
| 터미널 화면 서식 없음 | 터미널 화면이 서식이 없음을 나타냄 |
| 위치 명령이 에뮬레이터에 지원되지 않음 | 사용된 위치 명령이 에뮬레이터에서 지원되지 않음을 나타냄 |
| 이 세션 유형에 대해서 작업을 이용할 수 없음 | 이 세션 유형에 대해서 작업을 이용할 수 없음을 나타냄 |
| 입력 텍스트가 거부되었음 | 입력 텍스트가 거부되었음을 나타냄 |
터미널 세션에 키 보내기
터미널 세션에 컨트롤 키를 보냅니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Terminal session | 아니요 | 터미널 세션 | 작업할 터미널 세션 | |
| Control key | 해당 없음 | 전송, Alt 커서, 주의, 백 스페이스, 뒤로 탭, 블록 토글, 중단, 취소, 중앙, 지우기, 통신 지우기, 디스플레이 지우기, 줄 지우기, 페이지 지우기, 파티션 지우기, 쉼표, 명령줄, 명령 창, 작성, Ctrl+F1, Ctrl+F2, Ctrl+F3, Ctrl+F4, Ctrl+F5, Ctrl+F6, Ctrl+F7, Ctrl+F8, Ctrl+F9, Ctrl+F10, Ctrl+F11, Ctrl+F12, Ctrl+Shift+F1, Ctrl+Shift+F2, Ctrl+Shift+F3, Ctrl+Shift+F4, Ctrl+Shift+F5, Ctrl+Shift+F6, Ctrl+Shift+F7, Ctrl+Shift+F8, Ctrl+Shift+F9, Ctrl+Shift+F10, Ctrl+Shift+F11, Ctrl+Shift+F12, 커서 깜박임, 커서 선택, 10 진수, 삭제, 문자 삭제, 줄 삭제, 단어 삭제, 파괴적인 백 스페이스, 연결 끊기, 수행, 아래로, 아래로 더블, Dup, 중복, 스크립트 편집, 키 끝, 필드 끝, EOF 지우기, EOL 지우기, EOP 지우기, 입력 지우기, 이스케이프, ExtGr, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, F16, F17, F18, F19, F20, F21, F22, F23, F24, F25, F26, F27, F28, F29, F30, F31, F32, F33, F34, F35, F36, F37, F38, F39, F40, F41, F42, F43, F44, F45, F46, F47, F48, 필드 구분 기호, 필드 종료, 필드 표시, 필드 마이너스, 필드 플러스, 찾기, 하드 리셋, 도움말, Hex, Hex 00, Hex 01, Hex 02, Hex 03, Hex 04, Hex 05, Hex 06, Hex 07, Hex 08, Hex 09, Hex 0A, Hex 0B, Hex 0C, Hex 0D, Hex 0E, Hex 0F, Hex 10, Hex 11, Hex 12, Hex 13, Hex 14, Hex 15, Hex 16, Hex 17, Hex 18, Hex 19, Hex 1A, Hex 1B, Hex 1C, Hex 1D, Hex 1E, Hex 1F, Hex 7F, 홀드, 홀드 클리어, 홀드 세트, 홈, 홈 다운, 홈 업, 삽입, 문자 삽입, 여기에 삽입, 라인 삽입, 삽입 모드, 유효하지 않은 키, KeyPad0, KeyPad1, KeyPad2, KeyPad3, KeyPad4, KeyPad5, KeyPad6, KeyPad7, KeyPad8, KeyPad9, 왼쪽, 왼쪽 더블, 줄 바꿈, 빼기, 모니터 토글, 새 줄, 다음 페이지, 다음 화면, 다음 단어, Nul, NumLock, PA1, PA2, PA3, 페이지, 페이지 다운, 페이지 업, 팬 왼쪽, 오른쪽, 파티션 점프, PF1, PF2, PF3, PF4, Plus Cr, 이전 단어, PrevPage, PrevScreen, 인쇄, 인쇄, 인쇄 줄, 인쇄 Msg, 프런트 화면, 제거, 바꾸기, 리셋, 리턴, 리저브 필드, 오른쪽, 오른쪽 더블, 롤 다운, 롤업, Rile 라인, 실행 스크립트, 아래로 스크롤, 스크롤 왼쪽 스크롤, 스크롤, 선택, 보내기, 답장 보내기, 삭제 보내기, 회선 보내기, 메시지 보내기, Shift+Backspace, Shift+Delete, Shift+Down, Shift+F1, Shift+F2, Shift+F3, Shift+F4, Shift+F5, Shift+F6, Shift+F7, Shift+F8, Shift+F9, Shift+F10, Shift+F11, Shift+F12, Shift+F13, Shift+F14, Shift+F15, Shift F16, Shift+F17, Shift+F18, Shift+F19, Shift+F20, Shift+Home, Shift+Insert, Shift+Left, Shift+Print screen, Shift+Right, Shift+Up, 소프트 리셋, 시스템 요청, Tab, Tek 확대 / 축소, 용어 다음 페이지, 용어 이전 페이지, 테스트, 텍스트 지원 굵게 시작, 텍스트 지원 시작 밑줄, 텍스트 지원 시작 밑줄, 텍스트 지원 페이지 하단, 텍스트 지원 캐리어 리턴, 텍스트 지원 센터, 텍스트 지원 끝 굵게, 텍스트 지원 줄 끝, 텍스트 절반 인덱스 아래로 지원, 텍스트 절반 인덱스 위로, 텍스트 지원 삽입 기호, 텍스트 지원 다음 중지, 텍스트 지원 다음 텍스트 열, 텍스트 지원 페이지 끝, 텍스트 지원 필수 공간, 텍스트 지원 필수 탭, 텍스트 지원 중지, 텍스트 지원 텍스트 탭 진행, 텍스트 지원 페이지 상단 e, 텍스트 지원 단어 밑줄, 추적 토글, Udk 10, Udk 6, Udk 7, Udk 8, Udk 9, Udk 11, Udk 12, Udk 13, Udk 14, Udk 15, Udk 16, Udk 17, Udk 18, Udk 19, Udk 20, Up, Up 더블 | 수신 | 세션에 제출할 키 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 | 설명 |
|---|---|
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
| 키 지원 안 됨 | 키가 지원되지 않음을 나타냄 |
터미널 세션에서 텍스트 대기
터미널 세션에서 특정 텍스트가 나타날 때까지 대기합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Terminal session | 아니요 | 터미널 세션 | 이전에 열린 터미널 세션 | |
| Text to wait for | 아니요 | 텍스트 값 | 터미널 화면 또는 지정된 필드에서 나타나기를 대기할 정규식 또는 텍스트 | |
| Regular expression | 해당 없음 | 부울 값 | False | 일반 텍스트 대신 정규식을 기다릴지 여부 지정 |
| Wait for text location | 해당 없음 | 화면, 필드 | 화면 | 텍스트가 나타나기를 대기할 위치 |
| Get field by | 해당 없음 | 레이블, 색인, 위치 | Label | 필드를 검색할 방법 지정 |
| Label | 아니요 | 텍스트 값 | 검색할 필드의 레이블 | |
| Index | 아니요 | 숫자 값 | 검색할 필드의 색인 | |
| Row | 아니요 | 숫자 값 | 화면 필드의 세로 위치 | |
| Column | 아니요 | 숫자 값 | 화면 필드의 가로 위치 | |
| Timeout | 네 | 숫자 값 | 12 | 대기할 최대 시간 |
노트
Power Automate의 정규식 엔진은 .NET입니다. 정규식에 대한 자세한 내용을 보려면 정규식 언어 - 빠른 참조로 이동하세요.
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 | 설명 |
|---|---|
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
| 필드 색인 경계 벗어남 | 필드 색인이 경계를 넘었음을 나타냄 |
| 필드 레이블을 찾을 수 없음 | 필드 레이블이 없음을 나타냄 |
| 화면 위치이 경계를 넘었음 | 화면 위치이 경계를 넘었음을 나타냄 |
| 주어진 위치에 필드를 찾을 수 없음 | 주어진 위치에 필드가 없음을 나타냄 |
| 터미널 화면 서식 없음 | 터미널 화면이 서식이 없음을 나타냄 |
| 위치 명령이 에뮬레이터에 지원되지 않음 | 사용된 위치 명령이 에뮬레이터에서 지원되지 않음을 나타냄 |
| 이 세션 유형에 대해서 작업을 이용할 수 없음 | 이 세션 유형에 대해서 작업을 이용할 수 없음을 나타냄 |
| 시간 제한 만료됨 | 시간 제한이 만료되었음을 나타냄 |
터미널 세션에서 텍스트 검색
터미널 세션에서 특정 텍스트의 모든 항목을 검색합니다.
입력 매개 변수
| 인수 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| Terminal session | 아니요 | Terminal session | 이전에 열린 터미널 세션 | |
| 검색할 텍스트 | 아니요 | 텍스트 값 | 터미널 화면에서 검색할 텍스트 또는 정규식 | |
| Regular expression | 사용 불가 | 부울 값 | False | 일반 텍스트 대신 정규식을 검색할지 여부 지정 |
| 열 크기 | 아니요 | 숫자 값 | 80 | 터미널 화면의 열 수 |
노트
Power Automate의 정규식 엔진은 .NET입니다. 정규식에 대한 자세한 내용을 보려면 정규식 언어 - 빠른 참조로 이동하세요.
변수 생성됨
| 인수 | Type | 설명 |
|---|---|---|
| FindResults | 데이터 테이블 | 터미널 세션 화면에서 검색된 검색 결과 |
예외
| 예외 | 설명 |
|---|---|
| 에뮬레이터와 연결하는 동안 오류 발생 | 에뮬레이터를 연결하는 동안 문제가 발생했음을 나타냄 |
| 텍스트를 찾을 수 없음 | 검색하는 텍스트를 찾을 수 없음을 나타냄 |
| 잘못된 regex 식 | 사용된 정규식이 유효하지 않음을 나타냄 |