Automation Anywhere 설명서 읽기 및 검토

Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

REST Web Service package

  • 업데이트: 2022/07/26
    • Automation 360 v.x
    • 구축
    • RPA Workspace

REST Web Service package

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

REST Web Service actions을 이용한 작업

REST 요청을 보내고 응답을 받으려면 다음 정보를 제공합니다. 모든 메소드에 모든 매개변수가 필요한 것은 아닙니다.
  • URI 입력: API 리소스에 대한 고유 주소.
  • 인증 모드: 지원되는 인증 모드에는 세 가지가 있습니다.
    • 인증 없음: 서버에 액세스하기 위해 인증이 필요하지 않은 엔드포인트에 액세스하려면 이 옵션을 사용합니다.
    • 기본: 기본은 사용자를 인증하는 가장 간단한 방법입니다. 이 옵션을 선택한 경우 사용자 이름비밀번호를 입력합니다. 이 기술에서는 사용자 이름비밀번호를 base64 인코딩한 표현과 함께 Authorization이라는 헤더를 사용합니다.
    • 로그인한 AD 사용자: 관련 API에 액세스할 권한이 있는 AD(Active Directory) 사용자는 AD를 통해 인증됩니다. 요청에는 자격증명이 필요하지 않습니다.
    • Windows NTLM(NT LAN 관리자) 인증(AD 사용자): 클라이언트가 자신의 사용자 이름과 비밀번호를 암호화된 자격증명 또는 일반 텍스트로 제공할 수 있게 해주는 질문/응답 인증 방법입니다. Automation Anywhere Credential Vault에 저장된 자격증명을 이용하는 것을 권장합니다.
  • 헤더: 모든 메소드에 헤더가 필요한 것은 아닙니다. 헤더는 요청과 연결된 메타데이터를 나타냅니다.
  • 콘텐츠 유형: 헤더에 콘텐츠 유형이 포함된 경우, 클라이언트와 서버 간의 콘텐츠 협상을 정의합니다. REST Web Service actions은 다음과 같은 파일 형식을 지원합니다.
    • application/x-www-form-urlencoded: URL의 매개변수를 인코딩합니다.
    • JSON (application/json): JSON 요청 본문을 입력합니다.
    • XML (application/xml): XML 요청 본문을 입력합니다.
    • Text (text/plain)
    • XML (text/xml)
    • HTML (text/html)
    • multipart/form-data: 대부분의 경우 서버에 파일을 업로드하기 위해 2진 데이터를 전송합니다.
  • 대체 추가: REST 요청 본문에 변수를 입력할 수 있습니다. 변수는 데이터의 상징적 표현이며, 필요할 때마다 수동으로 입력하지 않고도 변수를 통해 값에 액세스할 수 있습니다. 예를 들어 다음 REST 본문 요청을 생각해 보십시오.
    {
       "name":"{{name}}",
       "email":"{{email}}",
       "status":"Active"
    }
    위의 요청 본문에서 대체 추가를 클릭하고 필요한 값을 추가하여 이중 중괄호로 묶인 변수를 바꿀 수 있습니다.
  • 고급 옵션:
    • 실패 응답 캡처: 성공/확인 응답을 제외하고 실패 응답을 캡처하려면 확인란을 선택합니다. 실패 응답 세부정보는 응답 본문에 캡처됩니다.
    • https를 사용할 때 안전하지 않은 연결 허용: https를 사용할 때 안전하지 않은 연결을 허용하려면 확인란을 선택합니다.
  • 작업이 완료될 때까지 대기: REST 요청을 보내고 응답을 받을 때 타임아웃 값을 설정할 수 있습니다. POST, PUT, DELETE, PATCH 및 GET과 같은 actions을 수행할 때 작업이 완료될 때까지 대기 필드에서 대기 시간(밀리초)을 지정할 수 있습니다. 기본적으로 대기 시간은 60,000밀리초입니다.
  • 출력 변수 응답 출력은 사전 변수에 캡처됩니다. 사전 변수는 키-값 쌍입니다. 응답 헤더 이름을 키로 이용하여 헤더 값을 반환하거나 ‘본문’을 키로 이용하여 응답 본문을 반환합니다.
    주: 값이 있는 응답 키는 사전 변수에서 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
  • 사용자 지정 헤더
  • 본문: application/x-www-form-urlencoded 콘텐츠 유형의 경우 매개변수 추가를 클릭하여 Credential Vault에서 값을 선택합니다.

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

REST Web Service package 내의 Actions

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

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

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

프록시 지원

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

피드백을 보내주십시오