Automation Anywhere 설명서 읽기 및 검토

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

API 요청 본문의 필터

  • 업데이트: 9/21/2020
    • Automation 360 v.x
    • 관리
    • RPA 작업 영역
    • API 문서

API 요청 본문의 필터

필터링은 API 요청을 처리하기 위한 기본 조건부 쿼리 및 페이지 제어 기능을 제공합니다. 필터링에는 조건, 정렬 및 페이지 매김 매개변수의 세 가지 기본 구성요소가 있습니다.

다음은 Automation Anywhere API에서 이용되는 JSON 필터링 구조를 나타냅니다.
{
  "filter": {
    "operator": "NONE",
    "operands": [
      null
    ],
    "field": "string",
    "value": "string"
  },
  "sort": [
    {
      "field": "string",
      "direction": "asc"
    }
  ],
  "page": {
    "offset": 0,
    "length": 0
  }
}
이 JSON 객체의 가장 기본적인 부분은 필터 배열입니다.

필터 이해

기본 필터
필터는 단일 조건을 검색하거나 논리적 피연산자 ANDOR로 묶을 수 있습니다. 필터링은 단일 필드에 대한 간단한 조건부 평가가 될 수 있습니다. 필터에 이용되는 연산자, 필드 값은 해당 연산자가 이용되는 API에 따라 다릅니다.
주: 꺽쇠 괄호 < > 안의 값에는 모든 잠재적 값의 목록이 포함되어 있습니다. 각 매개변수에 대해 하나의 값만 있어야 합니다.
단일 매개변수 필터
{
  "filter": {
    "operator": "<NONE, lt, le, eq, ne, ge, gt, substring, and, or, not>",
    "field": "string",
    "value": "string"
  }
}
2개 매개변수 필터
{
  "filter": {
    "operator": "<and, or>",
    "operands": [
      {
        "operator": "<NONE, lt, le, eq, ne, ge, gt, substring, and, or, not>",
        "field": "string",
        "value": "string"
      },
      {
        "operator": "<NONE, lt, le, eq, ne, ge, gt, substring, and, or, not>",
        "field": "string",
        "value": "string"
      }
    ]
  }
}
페이지
"page":{ 
    "offset":0,
    "length":0
}
페이지 규칙 매개변수
  • 오프셋:

    유형: 정수

    필터가 평가를 시작하는 테이블의 행 수를 나타내는 숫자 값입니다.

  • 길이

    유형: 정수

    결과의 단일 페이지에 반환되는 줄 수입니다.

정렬
 "sort": [
    {
      "field": "string",
      "direction": "<asc, desc>"
    }
  • 필드: 결과를 필터링할 기준 필드입니다. 지원되는 필터링 가능한 필드여야 합니다. 필터링 가능한 필드는 API에 따라 다릅니다.
  • 방향

    유형: 열거 [ desc, asc ]

    • asc = 오름차순(최소값에서 최대값으로, 0에서 9, A에서 Z)
    • desc = 내림차순(최대값에서 최소값으로, 9에서 0까지, Z에서 A로)

API 필터 예시

사용자 관리 필터 예시
이 예시 필터는 사용자 관리 API 필드와 매개변수를 기반으로 합니다. 이 필터는 사용자의 로그인 이름인 사용자 이름과, 사용자의 실제 이름인 이름을 검색합니다.
리포지토리 관리 필터 예제
이 예제 필터는 리포지토리 관리 API 필드와 매개변수를 기반으로 합니다. 이 필터 예제는 bot 상태 및 이름을 검색합니다.
마이그레이션 목록 결과 필터 예시
이 예시 필터는 마이그레이션 API 필드와 매개변수를 토대로 한 것입니다. 이 필터는 이름에 특정 문자열이 포함되어 있고, 두 날짜 사이에 시작되거나 업데이트된 마이그레이션을 검색합니다.
피드백을 보내주십시오