Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

REST Web Service package

  • 업데이트: 12/01/2020
    • Automation 360 v.x
    • 구축
    • RPA 작업 영역

REST Web Service package

API에 요청을 보내고 응답을 받으려면 메소드(DELETE, GET, PATCH, POST, 또는 PUT)로 REST Web Service package 내의 actions을 이용합니다.

REST Web Service actions을 이용한 작업

REST 요청을 보내고 응답을 받으려면 다음 정보를 제공합니다. 모든 메소드에 모든 매개변수가 필요한 것은 아닙니다.
  • URI: API 리소스에 대한 고유 주소.
  • 인증 모드: 지원되는 인증 모드에는 세 가지가 있습니다.
    • 기본: 텍스트 문자열을 기본 인증에 이용할 수 있습니다.
    • 로그인한 AD 사용자: 관련 API에 액세스할 권한이 있는 AD(Active Directory) 사용자는 AD를 통해 인증됩니다. 요청에는 자격증명이 필요하지 않습니다.
    • Windows NTLM(NT LAN 관리자) 인증(AD 사용자): 클라이언트가 자신의 사용자 이름과 비밀번호를 암호화된 자격증명 또는 일반 텍스트로 제공할 수 있게 해주는 질문/응답 인증 방법입니다. Automation Anywhere Credential Vault에 저장된 자격증명을 이용하는 것을 권장합니다.
  • 헤더: 모든 메소드에 헤더가 필요한 것은 아닙니다. 헤더는 요청과 연결된 메타데이터를 나타냅니다.
    주: 요청에서 API 키를 이용하려면 헤더 이름 필드에 api_key를 입력하고 필드에 키 값을 입력합니다.
  • 실패 응답 캡처: 성공/확인 응답을 제외하고 실패 응답을 캡처하려면 확인란을 선택합니다. 실패 응답 세부정보는 응답 본문에 캡처됩니다.
  • 콘텐츠 유형: 헤더에 콘텐츠 유형이 포함된 경우, 클라이언트와 서버 간의 콘텐츠 협상을 정의합니다. REST Web Service actions은 다음 콘텐츠 유형을 지원합니다.
    • 애플리케이션/json
    • 애플리케이션/xml
    • 텍스트/일반
    • 텍스트/html
    • 텍스트/xml
  • 출력 변수: 응답 출력은 사전 변수에 캡처됩니다. 사전 변수는 키-값 쌍입니다. 응답 헤더 이름을 키로 이용하여 헤더 값을 반환하거나 ‘본문’을 키로 이용하여 응답 본문을 반환합니다.
    주: 값이 있는 응답 키는 사전 변수에서 REST API의 응답 상태를 표시하는 데 이용할 수 있습니다.
    API 리소스의 헤더 이름 목록을 가져오려면 다음 단계를 수행합니다.
    1. REST Web Service action 뒤에 Loop action를 삽입합니다.
    2. 사전 안의 각 키에 대해 반복자를 선택합니다.
    3. 사전 변수 필드에서 REST Web Service action 출력을 포함하는 변수를 선택합니다.
    4. 각 키의 값을 $prompt-assignment$에 지정합니다.
    5. Log To File action을 삽입합니다.
    6. 헤더 이름 목록을 유지할 텍스트 파일의 파일 경로를 제공합니다.
    7. 로그할 텍스트 입력 필드에 $prompt-assignment$를 삽입합니다.
    8. 기존 파일 덮어쓰기 옵션을 선택합니다.
    9. 저장을 클릭합니다.

      bot을 실행하면 API 리소스에서 선택한 파일로 헤더 이름을 인쇄합니다.

안전하게 값 전달

지원되는 다음 action 필드에서 locker, 자격증명 및 속성을 지정하여 Credential Vault에서 웹 서비스로 값을 안전하게 전달할 수 있습니다.
  • URI
  • 맞춤형 헤더
  • 본문: 애플리케이션/x-www-form-urlencoded 콘텐츠 유형의 경우 매개변수 추가를 클릭하여 Credential Vault에서 값을 선택합니다.

    다른 모든 콘텐츠 유형의 경우, 매개변수로 자격증명 선택 옵션을 선택하고 픽(Pick)을 클릭합니다.

REST Web Service package 내의 Actions

Action 설명
Delete 메소드 URI에 의해 식별된 리소스를 제거합니다.
Get 메소드 URI에 포함된 매개변수로 식별된 정보를 검색합니다. 모든 매개변수는 URI의 일부로 전달되므로, GET 메소드에 대한 콘텐츠 유형이 없습니다.

GET 메소드의 한계와 특징은 다음과 같습니다.

  • URI 길이는 2,048자로 제한됩니다.
  • 모든 매개변수는 URI로 전달됩니다.
  • GET 메소드는 URI에 있는 데이터를 노출시키므로 POST 메소드보다 덜 안전합니다.
  • GET은 어떤 데이터도 변경하지 않기 때문에 권한 부여에 관계없이 모든 사용자가 사용에 안전합니다.
Patch 메소드 URI에 의해 식별된 리소스를 수정합니다.
Post 메소드 URI에 새 리소스를 만듭니다.
  • 파라미터는 요청 본문에서 전달됩니다.
  • 요청 본문의 길이에는 제한이 없습니다.
Put 메소드 URI 또는 본문에 전달된 매개변수를 기반으로 리소스를 업데이트하거나 대체합니다.

프록시 지원

기기가 프록시로 구성된 경우, 이 package로부터의 모든 아웃바운드 요청은 프록시 서버를 통해 라우팅됩니다. 프록시를 사용하여 Bot agent를 기기에 연결를 참고하십시오.

피드백을 보내주십시오