개요

Net 라이브러리에서 제공하는 기능을 이용해 웹 페이지 화면을 제어할 수 있습니다.
Windows가 제공하는 UI 자동화 기술로 화면에 있는 UI 객체를 식별한 후, 사용자가 지정한 대상 UI 객체를 찾아 지정한 동작을 수행합니다.

Net 라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.

브라우저 실행 및 종료: OpenBrowser, CloseBrowser
메일 송수신(POP3, IMAP, SMTP): SendMail, ReceiveMail, DownloadMailAttachment, SendRequest
SSH(Secure Shell) : OpenSSH, SendCommandSSH, CloseSSH

Net 라이브러리에 대한 샘플을 디자이너 혹은 윈도우 탐색기를 이용하여 참조할 수 있습니다.

• 디자이너 경로: 메뉴 > 도움말 > 샘플 > Sample > Net

• 윈도 탐색기 경로: C:\Users\user\AppData\Roaming\Brity RPA Designer\samples\Net

[Net 샘플 프로젝트명과 관련 라이브러리]

• Mail Transfer: SendMail, ReceiveMail, DownloadMailAttachment

• Manager Browser: CloseBrowser, CloseBrowser

• Other Samples: SendRequest

공통 속성

TARGET

실행 타깃에 대한 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Maximize	토글버튼	N	-	Y	브라우저 창 크기를 최대화할지 선택합니다.

CONNECTION

메일 서버 접속과 관련된 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Host Name	문자	Y	-	Y	메일 서버(SMTP)의 호스트명을 입력합니다.
Port	문자	Y	-	Y	메일 서버 포트를 입력합니다.
ID	문자	Y	-	N	발신자 메일 계정을 입력합니다.
Password	문자	Y	-	N	발신자 메일 계정의 비밀번호를 입력합니다. Secure로 설정하여 암호화할 것을 권장합니다.
Use SSL	토글버튼	Y	-	N	SSL 사용 여부를 설정합니다.

MAIL

메일 작성 및 조회와 관련된 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Number	변수	Y	-	N	다운로드할 첨부파일의 번호를 지정합니다.
Sender	문자	Y	-	Y	발신자의 메일 주소를 입력합니다.
Receivers	문자	Y	-	Y	수신자의 메일 주소를 입력합니다.
CCs	문자	N	-	Y	참조자의 메일 주소를 입력합니다.
BCCs	문자	N	-	Y	비밀참조자의 메일 주소를 입력합니다.
Subject	문자	Y	-	Y	메일 제목을 입력합니다.
Body	문자	N	-	Y	메일 본문을 입력합니다.
Max Count	숫자	N	개수	N	조회할 메일의 최대 개수를 입력합니다.
Start No.	숫자	N	-	N	조회할 메일의 시작 번호를 입력합니다.
With Contents	토글버튼	N	-	N	반환 결과에 메일의 내용(본문, 첨부)를 포함할 것인지 선택합니다.
Ignore HTML Tag	토글버튼	N	-	Y	본문 내용 중에서 HTML 태그 부분은 제외할지 선택합니다.
Ignore Body Attachments	토글버튼	N	-	Y	반환되는 정보 중에서 본문에 있는 첨부는 무시할지 선택합니다.
Recent First	토글버튼	N	-	Y	최근 메일을 먼저 조회할지 선택합니다.
Check Undered List	토글버튼	N	-	N	시작/종료 시간 검사 시, 예약발송 메일과 같이 정렬되지 않는 메일을 추가로 검사할지 선택합니다.
Attachments	문자	N	-	Y	SendMail 액티비티: 첨부 파일의 경로를 입력합니다. DownloadMailAttachment 액티비티: 다운로드할 첨부 파일명을 입력합니다.
Download	문자	N	-	Y	다운로드할 경로를 지정합니다.
File Size(MB)	숫자	N	MB	N	보내는 첨부 파일의 최대 용량을 설정합니다. 설정 시 첨부 파일의 용량이 설정 용량보다 큰 경우 에러로 처리됩니다.
IsHtml	토글버튼	N	-	N	메일 본문 HTML 여부를 선택합니다.

REST

Rest API와 관련된 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Method	콤보박스	N	-	Y	호출할 방식을 선택합니다. ※ 호출 방식 종류 - GET, POST, PUT, DEL
Content Type	콤보박스	N	-	Y	호출할 내용 유형을 선택합니다. ※ 유형 종류 - Text, text/plain, application/json, application/xml, multipart/form-data
URL	문자	Y	-	N	호출할 주소를 입력합니다.
Authorization	문자	N	-	N	API Key를 입력합니다.
Headers	문자	N	-	N	Header 정보를 입력합니다.
Body	문자	N	-	N	Body 정보를 입력합니다.

MORE OPTION

MORE OPTION
속성	유형	필수여부	단위	자동입력여부	설명
On Error	콤보박스	N	-	N	오류 발생 시 처리 방법을 선택합니다. - Ignore: 해당 오류를 무시하고 진행합니다. - Retry: 해당 작업을 1회 재시도합니다. - Goto: 해당 액티비티가 실패한 경우 지정한 액티비티로 이동하여 시나리오를 수행합니다. - _Event: 프로젝트 내에 작성된 이벤트를 선택합니다.
GotoStep Relative Position	숫자	N	-	N	해당 액티비티를 기준으로 이동할 액티비티를 선택합니다. Ctrl + F 를 통해 액티비티 번호를 확인 후 [해당 액티비티 번호] - [대상 액티비티 번호] 값을 입력합니다. (기본값: 0)
GotoStep Retry Count	콤보박스	N	-	N	해당 액티비티가 실패한 경우 지정된 횟수만큼 이동을 반복합니다. (기본값: 1)

DESCRIPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Description	문자	N	-	N	해당 액티비티 카드에 대한 설명을 추가합니다. Description이 입력되면 플로우차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다.

OpenBrowser

개요

인터넷 익스플로러를 실행합니다. URL을 입력하면 해당 URL로 접속합니다.
실행이 완료되면 브라우저의 ID를 반환합니다. 반환된 ID는 다른 액티비티 카드에서 사용할 수 있습니다.

사용 절차

URL에 접속할 웹 페이지의 URL을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Browser ID	변수	Y	-	Y	실행된 브라우저의 ID를 저장할 변수를 입력합니다. (기본값: RESULT)
N	URL	변수	Y	-	N	브라우저를 열고 이동하고자 하는 웹 페이지 URL을 입력합니다.
N	WaitTime(Sec)	숫자	N	sec	Y	브라우저가 실행되어 화면에 나타날 때까지의 대기시간을 설정합니다. (기본값: 10)
Y	TARGET	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

인터넷 익스플로러 브라우저를 실행하여 "www.google.com"에 접속하고, 반환받은 브라우저 ID는 'RESULT' 변수에 저장합니다. 3초 후 해당 인터넷 익스플로러를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Net > Manage Browser > P_OpenBrowser_Test

사용된 변수

RESULT = 실행된 브라우저를 할당할 변수

사용된 속성

[Output] Browser ID = RESULT
URL = 'www.google.com'
WaitTime(Sec) = 10

특이 사항

브라우저는 대부분 하나의 ID를 가지지만, 팝업 창이 열리는 등의 경우에는 여러 개의 ID를 가질 수 있습니다.

브라우저의 ID는 OpenApp 액티비티의 PID와는 달리 앱 화면의 ID이므로 CloseApp 액티비티에서는 사용할 수 없습니다

연관/유사 액티비티

CloseBrowser

개요

선택한 ID에 해당하는 브라우저를 종료합니다. OpenBrowser 액티비티를 통해 반환된 ID를 저장해야 사용할 수 있습니다.

사용 절차

[Input] Browser ID에 종료할 브라우저의 ID(OpenBrowser 액티비티를 통해 반환된 ID)를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Browser ID	변수	Y	-	Y	종료할 브라우저의 ID가 저장된 변수를 입력합니다.
N	ForceAll	토글버튼	Y	-	Y	브라우저 상태와 상관없이 강제 종료할지 선택합니다. True(On)로 설정하면 브라우저의 상태와 상관없이 강제 종료합니다. False(Off)로 설정하면 닫기 명령을 한 번만 전달합니다. 이 경우 브라우저의 상태에 따라 종료되지 않을 수 있습니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

인터넷 익스플로러를 실행하면서 www.google.com에 접속하고, 반환 받은 브라우저 ID는 'RESULT'에 저장합니다. 3초 후 브라우저 ID에 해당하는 인터넷 익스플로러를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Net > Manage Browser > P_CloseBrowser_Test

사용된 변수

RESULT = 실행된 브라우저의 ID를 지정할 변수

사용된 속성

[Input] Browser ID = RESULT
ForceAll = False

연관/유사 액티비티

OpenBrowser

CloseIETab

개요

입력된 조건에 해당하는 Edge 브라우저의 탭을 종료합니다.

사용 절차

Tab Title, Tab Index에 종료할 탭 정보를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Title Search Type	콤보박스	N	-	Y	탭 이름 검색 방식을 선택합니다.
N	Tab Title	문자열	N	-	N	종료 할 탭 이름을 입력합니다.
N	Tab Index	숫자	Y	-	Y	종료 할 탭 번호를 입력합니다. 탭 번호는 좌측을 기준으로 1부터 시작됩니다. LAST_TAB 은 가장 우측에 있는 탭을 의미합니다.
N	Timeout(Sec)	숫자	Y	-	Y	대상 탭을 찾는 시간을 초 단위로 입력합니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

Edge 브라우저를 통해 naver.com, google.co.kr에 접속하고 탭 이름, 탭 인덱스를 통해 각 탭을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Net > Manage Browser > P_CloseIETab_Test

사용된 속성

Tab Title = 'nav'
Tab Index = 1

SendMail

개요

SMTP (Simple Mail Transfer Protocol, 간이 전자 우편 전송 프로토콜)을 이용하여 메일을 보냅니다.

사용 절차

대상 메일 서비스가 SMTP를 제공해야 하며, 디자이너/봇과 해당 서비스 간 방화벽이 열려 있어야 합니다.

CONNECTION 그룹 속성에 메일 서버(SMTP) 호스트명, 포트 번호, 발신자 메일 서비스 ID/비밀번호 등을 설정하세세요.
MAIL 그룹 속성에 발신자/수신자/참조자/비밀참조자의 메일 주소, 메일 제목, 본문, 첨부 파일 경로 등을 설정하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Host Name	변수	Y	-	N	메일 서버(SMTP) 호스트명을 입력합니다. (대상 메일서비스에서 제공한 정보)
N	Port	숫자	Y	-	N	메일 서버 포트를 입력합니다. (대상 메일서비스에서 제공한 정보)
N	ID	변수	Y	-	N	발신자 메일 서비스 ID를 입력합니다.
N	Password	변수	Y	-	N	발신자 메일 서비스 비밀번호를 입력합니다. - Normal: 입력한 비밀번호가 일반 텍스트로 저장됩니다. - Credential : 입력할 비밀번호로 Credential 유형의 공용리소스를 사용합니다. - Secure: 입력한 비밀번호가 암호화되어 저장됩니다.
N	Use SSL	토글버튼	Y	-	Y	SSL 사용 여부를 설정합니다. (대상 메일 서비스에서 제공한 정보)
N	Sender	변수	Y	-	N	발신자 메일 주소를 입력합니다.
N	Receivers	변수	Y	-	N	수신자 메일 주소를 입력합니다. 세미콜론(;)으로 구분하여 주소를 여러 개 입력할 수 있습니다.
N	CCs	변수	N	-	N	참조자 메일 주소를 입력합니다. 세미콜론(;)으로 구분하여 주소를 여러 개 입력할 수 있습니다.
N	BCCs	변수	N	-	N	비밀참조자 메일 주소를 입력합니다. 세미콜론(;)으로 구분하여 주소를 여러 개 입력할 수 있습니다.
N	Subject	변수	Y	-	N	메일 제목을 입력합니다.
N	Body	변수	N	-	N	메일 본문을 입력합니다.
N	Attachments	변수	N	-	N	첨부파일 경로를 입력합니다. 세미콜론(;)으로 구분하여 경로를 여러 개 입력할 수 있습니다.
N	File Size (MB)	숫자	N	MB	N	보내는 첨부 파일의 최대 용량을 설정합니다. 수행 시 첨부 파일의 용량이 설정 용량보다 큰 경우 에러로 처리됩니다.
N	isHtml	토글버튼	Y	-	Y	메일 본문이 HTML 포맷으로 작성되었는지 여부를 선택합니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

SMTP 서버(v7smtp.samsung.com)에서 "SendMailTest"라는 제목을 가진 메일을 발송합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Net > Mail Transfer > P_SendMail_Test

사용된 변수

Global.ResourcesDir = 메일 첨부 파일의 경로가 할당된 변수

사용된 속성

Host Name = 'v7smtp.samsung.com'
Port = 25
ID = 'sender_id'
Password = 'Enter Password'
Use SSL = False
Sender = 'sender_id@samsung.com'
Receivers = 'receiver1_id@samsung.com;receiver2_id@samsung.com'
Subject = 'SendMailTest'
Body = 'SendMailTest'
Attachments = Global.ResourcesDir + 'IPA Test_AttachFile.txt'
File Size = 20
isHtml = False

연관/유사 액티비티

ReceiveMail

개요

메일을 받아서 변수로 저장합니다.

사용 절차

대상 메일 서비스가 POP3 또는 IMAP를 제공해야 하며, 디자이너/봇과 해당 서비스간 방화벽이 열려 있어야 합니다.

CONNECTION 그룹 속성에 메일 서버 호스트명, 포트 번호, 발신자 메일 서비스 ID/비밀번호 등을 설정하세세요.
MAIL 그룹 속성에 메일을 읽어오는 조건(발송 시간, 발신자, 메일 제목, 본문, 첨부 등)을 설정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Mails	1차원배열	object (Mail)	조건에 해당되는 메일 정보를 반환합니다.	[ {'Number' : 1, 'ID' : 'XXX@samsung.com', 'Subject' : 'Title', ...}, ... ]

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Host Name	변수	Y	-	N	메일 서버 호스트명을 입력합니다.(대상 메일 서비스에서 제공한 정보)
N	Protocol	콤보박스	Y	-	Y	메일 서버의 프로토콜을 선택합니다.
N	Port	숫자	Y	-	N	메일 서버 포트를 입력합니다. (대상 메일 서비스에서 제공한 정보)
N	ID	문자	Y	-	N	수신자 메일 서비스 ID를 입력합니다.
N	Password	문자	Y	-	N	수신자 메일 서비스 비밀번호를 입력합니다. - Normal: 입력한 비밀번호가 일반 텍스트로 저장됩니다. - Credential : 입력할 비밀번호로 Credential 유형의 공용리소스를 사용합니다. - Secure: 입력한 비밀번호가 암호화되어 저장됩니다.
N	Use SSL	토글버튼	N	-	Y	SSL 사용 여부를 설정합니다. (대상 메일서비스에서 제공한 정보)
N	Begin Time	변수	N	-	Y	입력된 시간 이후에 발송된 메일을 수신합니다.
N	End Time	변수	N	-	Y	입력된 시간 이전에 발송된 메일을 수신합니다. 비어 있는 경우 현재 시간까지 조회합니다.
N	Sender	변수	N	-	N	검색할 발신자 메일 주소를 입력합니다.
N	Subject	변수	N	-	N	입력한 텍스트를 포함한 제목의 메일을 검색합니다.
N	Max Count	숫자	N	-	N	조회할 메일의 최대 개수를 입력합니다. 0이면 모든 메일을 검색합니다.
N	Start No.	숫자	N	-	N	조회할 메일의 시작 번호를 입력합니다. 음수인 경우, 값은 무시되며, 모든 메일을 대상으로 합니다.
N	Body	변수	N	-	N	메일 본문에 입력한 텍스트를 포함한 메일을 검색합니다.
N	Attachments	변수	N	-	N	메일의 첨부 파일에 입력한 첨부파일 중 하나 이상을 포함한 메일을 검색합니다.
N	With Contents	토글버튼	N	-	Y	반환 결과에 메일의 내용(본문, 첨부)을 포함할 것인지를 결정합니다. 내용을 확인할 필요가 없는 경우 설정을 False(Off)로 하면 작업 수행 속도를 높일 수 있습니다.
N	Ignore HTML Tag	토글버튼	N	-	Y	본문 내용 중에서 HTML 태그 부분은 제외할지 선택합니다.
N	Ignore Body Attachments	토글버튼	N	-	Y	반환되는 정보 중에서 본문에 있는 첨부는 무시할지 선택합니다.
N	Recent First	토글버튼	N	-	Y	최근 메일을 먼저 조회할지 선택합니다.
N	Check Undered List	토글버튼	N	-	Y	시작/종료 시간 검사 시, 예약 발송 메일과 같이 정렬되지 않는 메일을 추가로 검사할지 선택합니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

Start No. 속성은 메일 Protocol 속성 값에 따라 다른 의미로 동작하게 됩니다.

• Protocol 이 POP3 인 경우,

수신된 메일 객체의 내부 속성인 Number 값에 대한 비교 기준으로 사용됩니다. Number 객체 속성 값은 최신 메일일 수록 더 큰 값이 부여됩니다.

> Recent First 속성 값이 활성화된 경우, 전체 메일 중 Number 객체 속성 값이 Start No. 속성 값 이하의 메일 객체들만이 결과 메일 후보 군으로 사용됩니다. 이 경우, 높은 우선 순위를 의도한 최신 메일들일 수록 Number 객체 속성 값이 크므로 Start No. 값이 너무 작은 경우, 최종 결과 메일들이 추출되지 않을 수 있습니다.

> Recent First 속성 값이 비활성화된 경우, 전체 메일 중 Number 객체 속성 값이 Start No. 속성 값 이상의 메일 객체들만이 결과 메일 후보 군으로 사용됩니다. 이 경우, 높은 우선 순위를 의도한 과거 메일들일 수록 Number 객체 속성 값이 작으므로 Start No. 값이 너무 큰 경우, 최종 결과 메일들이 추출되지 않을 수 있습니다.

• Protocol 이 IMAP 인 경우,

수신된 메일들의 전체 목록에서, 추출할 대상 메일들의 범위를 지정하기 위한 시작 순번으로 사용됩니다.

> Recent First 속성 값이 활성화된 경우, 전체 메일에서 최신 메일들 중 Start No. 값 개수 만큼의 메일은 결과 대상 후보에서 제외됩니다.

> Recent First 속성 값이 비활성화된 경우, 전체 메일에서 과거 메일들 중 Start No. 값 개수 만큼의 메일은 결과 대상 후보에서 제외됩니다.

활용 예시

SendMailTest라는 제목의 메일을 최대 2건까지 읽어옵니다. 이 때 본문과 첨부를 읽어 오지만, 태그와 본문에 포함된 첨부는 제외하고, 최근 메일부터 읽어와 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Net > Mail Transfer > P_ReceiveMail_Test

사용된 변수

receiveMailList = 읽어온 메일 정보를 저장할 변수

사용된 속성

Host Name = 'v7pop3.samsung.com'
Protocol = POP3
Port = 995
ID = 'sender_id'
Password = 'Enter Password'
Use SSL = True
Subject = 'SendMailTest'
Max Count = 2
With Contents = True
Ignore HTML Tag = True
Ignore Body Attachments = True
Recent First = True
Check Unordered List = False

연관/유사 액티비티

SendMail, DownloadMailAttachment

DownloadMailAttachment

개요

메일의 첨부파일을 저장합니다.

사용 절차

ReceiveMail로 메일 객체를 먼저 읽어야 합니다.

Number에 ReceiveMail 액티비티 카드를 사용해 검색해 온 메일(배열변수) 내용 중 다운로드할 첨부 파일의 번호를 입력하세요.
Attachments에 다운로드할 첨부 파일의 이름을 입력하세요.
Download에 첨부 파일을 다운로드할 경로를 입력하세요.
Ignore Body Attachments에서 본문에 있는 첨부는 무시할지, 또는 포함해서 다운로드할지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Number	변수	Y	-	Y	다운로드할 첨부 파일의 번호를 입력합니다.
N	Attachments	변수	N	-	N	다운로드할 첨부 파일의 이름을 입력합니다. 이 속성에 값 설정 시 속도가 느려질 수 있습니다.
N	Download	변수	Y	-	Y	다운로드 경로를 입력합니다.
N	Ignore Body Attachment	토글버튼	Y	-	Y	반환되는 정보 중에서 본문에 있는 첨부 파일은 무시할지 선택합니다. -True(On): 본문의 첨부 파일을 수신에서 제외 -False(Off) : 본문의 첨부 파일을 포함해서 수신
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

SendMailTest를 포함한 제목의 메일을 최대 2건까지 읽어 옵니다. 이후 본문에 포함된 첨부 파일은 제외하고, 'IPA Test_AttachFile.txt' 라는 이름의 파일을 Global.ProjectDir/Download/ 폴더에 저장합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Net > Mail Transfer > P_DownloadMailAttachment_Test

사용된 변수

receiveMail = 다운로드할 첨부파일의 번호를 지정하는 변수
receiveMailList = 수신된 메일 정보를 저장할 변수

사용된 속성

Number = this.receiveMail.Number
Attachments = 'IPA Test_AttachFile.txt'
Download = Global.ProjectDir + 'Downloads'
Ignore Body Attachments = True
Subject = 'SendMailTest'
Max Count = 2

연관/유사 액티비티

ReceiveMail

SendRequest

개요

REST API를 호출합니다.

사용 절차

상대측과의 API 규약이 먼저 정의되어야 하고, 방화벽 차단 등의 문제가 없어야 합니다.

[Output] Response에 호출 결과를 저장할 변수를 입력하세요.
REST 그룹 속성에 정의된 규약에 따라 API 호출 정보(호출 방식, 호출 내용 유형, 호출 주소, API key, 헤더 및 바디 정보)를 설정하세요. 실행 후 상대측에서 반환된 결과로 후속 처리를 합니다.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Response	object	Dictionary<string, object>	REST API 호출 결과를 반환합니다.	{ 'StatusCode' : 'OK', 'Content' : '(호출 결과)', 'Header' : '(Header 내용)' }

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Method	콤보박스	Y	-	Y	호출할 방식을 선택합니다. ※ 타입 종류 - GET, POST, PUT, DEL
N	ContentType	콤보박스	Y	-	Y	호출할 내용 유형을 선택합니다. ※ 유형 종류 - Text, text/plain, application/json, application/xml, multipart/form-data
N	URL	문자	Y	-	Y	호출할 주소를 입력합니다.
N	Authorization	문자	N	-	N	API Key를 입력합니다.
N	Headers	문자	N	-	N	Header 정보를 key와 value로 나누어 입력합니다. 혹은 직접 입력을 선택하여 json 형식의 문자열로 입력합니다.
N	Body	문자	N	-	N	Body 정보를 입력합니다.
N	FormData	문자	Y	-	N	form-data 정보를 key와 value로 나누어 입력합니다. 혹은 직접 입력을 선택하여 json 형식의 문자열로 입력합니다. FormData 속성은 ContentType 을 multipart/form-data 로 선택하는 경우 표시됩니다.
N	Timeout	숫자	Y	-	Y	호출한 요청에 대한 최대 대기 시간을 초 단위로 지정합니다.
N	Continuos	토글버튼	N	-	Y	세션 유지 여부를 설정합니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	카드 속성	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

REST API를 호출('http://httpbin.org/get'을 호출)하여 리턴된 결과를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 학습> 샘플 실행하기> Sample > Net > Send Request > P_SendRequest_Test_Win10_Web

사용된 변수

RESULT: 호출 결과를 저장할 변수

사용된 속성

[Output] Response = RESULT
Method = GET
ContentType = Text
URL = 'http://httpbin.org/get'
Headers = '{\"sample_key\":\"sample_value\"}'
Continuous = False

OpenSSH

개요

SSH(Secure Shell)을 통해 서버에 연결합니다.

사용 절차

[Output] Connection에 연결 정보를 저장할 변수를 입력하세요.
Host에 연결할 대상 IP를 입력하세요.
Id, Password에 연결할 계정 정보를 입력하세요.
Port에 연결할 포트를 입력하세요.

카드 속성

카드속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Connection	변수	Y	-	Y	연결 정보를 저장할 변수를 입력합니다.
N	Host	문자열	Y	-	N	연결 대상 IP 주소를 입력합니다.
N	Id	문자열	Y	-	N	연결 시 사용하는 계정 아이디를 입력합니다.
N	Port	숫자	Y	-	N	연결 시 사용할 포트를 입력합니다.
N	Password	문자열	Y	-	N	연결시 사용하는 계정 비밀번호를 입력합니다. - Normal: 입력한 비밀번호가 일반 텍스트로 저장됩니다. - Credential : 입력할 비밀번호로 Credential 유형의 공용리소스를 사용합니다. - Secure: 입력한 비밀번호가 암호화되어 저장됩니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

OpenSSH를 통해서 원격으로 서버와 통신이 가능합니다. 서버 주소, 아이디, 패스워드, 포트번호를 입력합니다.

Excel_NewExcel_1K

연관/유사 액티비티

SendCommandSSH, CloseSSH

SendCommandSSH

개요

SSH 연결을 통해 서버에 명령어를 전달합니다.

사용 절차

서버를 OpenSSH로 먼저 연결해야 합니다.

[Output] Result에 명령어를 전달한 결과를 저장할 변수를 입력하세요.
[Input] Connection에 SSH 연결 정보를 저장한 변수를 입력하세요.
Command에 전달하고자 하는 명령어를 입력하세요.
Timeout(Sec)에 응답을 대기할 시간을 입력하세요.

카드속성

카드속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Result	변수	Y	-	N	전달된 명령어의 결과를 저장하기 위한 변수를 입력합니다.
N	[Input] Connection	변수	Y	-	Y	명령어를 전달하기 위한 연결 정보를 입력합니다. 연결 정보는 OpenSSH 액티비티 카드의 [Output] Connection에 지정한 값입니다.
N	Command	문자열	Y	-	Y	전달할 명령어를 입력합니다.
N	Timeout(Sec)	숫자	N	초	Y	응답을 대기할 대기 시간을 입력합니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

SendCommandSSH에 연결된 SSH 핸들값을 입력하고 명령어를 입력합니다 원격지 서버와 통신하여 결과를 전달합니다.

Excel_NewExcel_1K

연관/유사 액티비티

OpenSSH, CloseSSH

CloseSSH

개요

OpenSSH를 통해 연결된 서버의 연결을 종료합니다.

사용절차

서버를 OpenSSH로 먼저 연결해야 합니다.

[Input] Connection에 SSH 연결 정보를 저장한 변수를 입력하세요.

카드속성

카드속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Connection	변수	Y	-	Y	연결을 종료할 SSH 연결 정보가 저장된 변수를 지정합니다. 연결 정보는 OpenSSH 액티비티 카드의 [Output] Connection에 지정한 값입니다.
Y	MORE OPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Net 라이브러리의 공통 속성입니다.

활용 예시

SSH 통신을 종료하기 위해서는 반드시 CloseSSH를 호출하고 종료를 하여야 합니다. CloseSSH의 입력값은 Open시에 리턴받은 핸들 아이디를 입력합니다.

Excel_NewExcel_1K

연관/유사 액티비티

OpenSSH, SendCommandSSH