Adobe Workfront Planning API 기본 사항

마지막 업데이트: 2026년 5월 12일

주제:
Workfront Planning

작성 대상:

User
Admin

IMPORTANT

이 문서의 정보는 Adobe Workfront의 추가 기능인 Adobe Workfront Planning을 참조합니다.

Workfront Planning에 액세스하기 위한 요구 사항 목록은 Adobe Workfront Planning 액세스 개요를 참조하십시오.

Workfront Planning에 대한 일반적인 정보는 Adobe Workfront Planning 시작을 참조하십시오.

Adobe Workfront Planning API의 목표는 HTTP를 통해 작동하는 REST 풀 아키텍처를 도입하여 Planning과의 통합 구축을 간소화하는 것입니다. 이 문서에서는 사용자가 REST 및 JSON 응답에 익숙하다고 가정하고 Planning API의 접근 방식에 대해 설명합니다.

Workfront Planning 스키마에 익숙하면 통합 목적으로 Workfront Planning에서 데이터를 가져오는 데 사용할 수 있는 데이터베이스 관계를 이해하는 데 도움이 됩니다.

Workfront 사용자 정의 양식의 외부 조회 필드에서 계획 API를 호출할 수 있습니다.

외부 조회 필드에 대한 자세한 내용은 사용자 정의 양식의 외부 조회 필드 예제를 참조하십시오.

NOTE

Planning API를 사용하는 경우 모든 사용자 관련 정보는 Workfront 사용자 ID가 아닌 Adobe Identity Management System(IMS) 사용자 ID를 사용하여 반환됩니다.

자세한 내용은 Adobe Admin Console에서 사용자 관리를 참조하십시오.

Workfront Planning API 버전

버전 1 - 2024년 7월에 릴리스됨

자세한 내용은 이 문서의 Workfront Planning API 버전 1 섹션을 참조하십시오.

Workfront Planning API 버전 1

Workfront Planning API 버전 1은 2024년 7월에 릴리스되었습니다.

다음 섹션에서는 Workfront API 버전 1에서 사용할 수 있는 기능에 대해 설명합니다.

별도로 지정하지 않는 한 모든 향후 API 버전에는 동일한 기능이 포함됩니다.

작업

개체는 고유한 URI에 HTTP 요청을 전송하여 조작됩니다. 수행할 작업은 HTTP 메서드에서 지정합니다.

표준 HTTP 메서드는 다음 작업에 해당합니다.

GET - ID별로 개체를 검색하고 쿼리별로 모든 개체를 검색합니다.
POST - 새 개체를 삽입합니다.
PUT - 기존 개체를 편집합니다.
DELETE - 개체를 삭제합니다.

각 작업에 대한 자세한 내용과 예제는 Workfront Planning API 개발자 설명서를 참조하십시오.

필드 유형 및 필드 유형과 함께 사용되는 검색 수정자

필드가 있는 수정자 및 필터를 사용하여 결과에 반환될 데이터를 제어할 수 있습니다.

검색 수정자 사용

Workfront Planning은 다음 검색 수정자를 지원합니다.

한정자

예

설명

가능한 값

$contains

"fieldId": { "$contains": "product" }

필드 값에 필터가 포함된 레코드를 반환합니다.

"새 제품 출시"

$doesNotContain

"fieldId": { "$doesNotContain": "product" }

필드 값에 필터가 포함되지 않은 레코드를 반환합니다.

"새 론치"

$is

"fieldId" : { "$is": "new product launch" }
"fieldId" : { "new product launch" }

필드 값이 필터와 정확히 일치하는 레코드를 반환합니다.

"새 제품 출시"

$isNot

"fieldId": { "$isNot": "product" }

필드 값이 필터와 정확히 일치하지 않는 레코드를 반환합니다.

"새 제품 출시"

$isEmpty

"fieldId": "$isEmpty"
"fieldId": { "$isEmpty": null }

필드 값이 비어 있는 레코드를 반환합니다.

""
null

$isNotEmpty

"fieldId": "$isNotEmpty"
"fieldId": { "$isNotEmpty": null }

필드 값이 비어 있지 않은 레코드를 반환합니다.

"새 제품 출시"

$greaterThan

"fieldId": { "$greaterThan": 10 }

필드 값이 필터보다 큰 레코드를 반환합니다.

$greaterThanOrEqual

"fieldId": { "$greaterThanOrEqual": 10 }

필드 값이 필터보다 크거나 같은 레코드를 반환합니다.

$lessThan

"fieldId": { "$lessThan": 10 }

필드 값이 필터보다 작은 레코드를 반환합니다.

$lessThanOrEqual

"fieldId": { "$lessThanOrEqual": 10 }

필드 값이 필터보다 작거나 같은 레코드 반환

5
9
- 10

$isAfter

"fieldId": { "$isAfter": "2024-05-14T20:00:00.000Z" }

필드 값이 필터 뒤에 있는 레코드를 반환합니다.

"2024-05-15T20:00:00.000Z"

$isBefore

"fieldId": { "$isBefore": "2024-05-14T20:00:00.000Z" }

필드 값이 필터 앞에 있는 레코드를 반환합니다.

"2024-05-12T20:00:00.000Z"

$isBetween

"fieldId": { "$isBetween": ["2024-05-10T20:00:00.000Z", "2024-05-15T20:00:00.000Z"] }

필드 값이 필터 사이에 있는 레코드를 반환합니다.

"2024-05-12T20:00:00.000Z"
"2024-05-14T20:00:00.000Z"

$isNotBetween

"fieldId": { "$isNotBetween": ["2024-05-10T20:00:00.000Z", "2024-05-15T20:00:00.000Z"] }

필드 값이 필터 사이에 없는 레코드를 반환합니다.

"2024-05-09T20:00:00.000Z"
"2024-05-17T20:00:00.000Z"

$isAnyOf

"fieldId": { "$isAnyOf": ["active", "completed"] }

필드 값이 필터 중 하나인 레코드를 반환합니다.

"active"
"완료됨"

$isNoneOf

"fieldId": { "$isNoneOf": ["active", "completed"] }

필드 값이 필터가 아닌 레코드를 반환합니다.

"완료됨"
"수정됨"

$hasAnyOf

"fieldId": { "$hasAnyOf": ["active", "completed"] }

필드 값에 필터가 있는 레코드를 반환합니다.

["active", "fixed"]
["수정됨", "완료됨", "완료됨"]

$hasAllOf

"fieldId": { "$hasAllOf": ["active", "completed"] }

필드 값에 모든 필터가 있는 레코드를 반환합니다.

["active", "completed"]
["active", "completed", "finished"]

$hasNoneOf

"fieldId": { "$hasNoneOf": ["active", "completed"] }

필드 값에 필터가 없는 레코드를 반환합니다.

["수정됨", "완료됨"]

$isExactly

"fieldId": { "$isExactly": ["active", "completed"] }

필드 값이 정확히 필터인 레코드를 반환합니다.

["active", "completed"]

필드 유형

다음은 지원되는 필드 유형 목록과 각 필드 유형에 사용할 수 있는 검색 수정자 목록입니다

필드 유형

지원되는 검색 수정자

텍스트

$contains, $doesNotContain, $is, $isNot, $isEmpty, $isNotEmpty

긴 텍스트

$contains, $doesNotContain, $is, $isNot, $isEmpty, $isNotEmpty

번호

$is, $isNot, $greaterThan, $greaterThanOrEqual, $lessThan, $lessThanOrEqual, $isEmpty, $isNotEmpty

백분율

$is, $isNot, $greaterThan, $greaterThanOrEqual, $lessThan, $lessThanOrEqual, $isEmpty, $isNotEmpty

통화

$is, $isNot, $greaterThan, $greaterThanOrEqual, $lessThan, $lessThanOrEqual, $isEmpty, $isNotEmpty

일자

$is, $isNot, $isAfter, $isBefore, $isBetween, $isNotBetween, $isNotEmpty, $isNotEmpty

단일 선택

$is, $isNot, $isAnyOf, $isNoneOf, $isEmpty, $isNotEmpty

다중 선택

$hasAnyOf, $hasAllOf, $isExactly, $hasNoneOf, $isEmpty, $isNotEmpty

부울

$is

사용자

$hasAnyOf, $hasAllOf, $isExactly, $hasNoneOf, $isEmpty, $isNotEmpty

공식

$contains, $doesNotContain, $is, $isNot, $isEmpty, $isNotEmpty

url

$contains, $doesNotContain, $is, $isNot, $isEmpty, $isNotEmpty

작성자

$is, $isNot, $isAnyOf, $isNoneOf

생성 시간

$is, $isNot, $isAfter, $isBefore, $isBetween, $isNotBetween

업데이트한 사람

$is, $isNot, $isAnyOf, $isNoneOf, $isEmpty, $isNotEmpty

업데이트 시간

$is, $isNot, $isAfter, $isBefore, $isBetween, $isNotBetween, $isNotEmpty, $isNotEmpty

참조

$hasAnyOf, $hasAllOf, $isExactly, $hasNoneOf, $isEmpty, $isNotEmpty

조회

연결된 필드에 따라 다릅니다.

“And” 및 “Or” 문 사용

API 호출에서는 $and" 및 “$or” 문으로 결합된 여러 기준을 기반으로 하는 필터를 가질 수 있습니다

{
  "recordTypeId": "recordTypeId",
  "offset": "integer",
  "limit": "integer",
  "filters": [
    {
      "$or": [
        {
          "launch_date": {
            "$isBetween": [
              "2024-03-31T20:00:00.000Z",
              "2024-04-01T20:00:00.000Z"
            ]
          }
        },
        {
          "$and": [
            {
              "launch_date": {
                "$isBetween": [
                  "2024-03-31T20:00:00.000Z",
                  "2024-04-01T20:00:00.000Z"
                ]
              }
            },
            {
              "status": "active"
            }
          ]
        },
        {
          "$and": [
            {
              "launch_date": {
                "$isBetween": [
                  "2024-04-15T00:00:00.000Z",
                  "2024-04-16T00:00:00.000Z"
                ]
              }
            },
            {
              "status": "planned"
            }
          ]
        }
      ]
    }
  ]
}

필드 요청 매개 변수 사용

필드 요청 매개 변수를 사용하여 반환해야 하는 특정 필드의 쉼표로 구분된 목록을 지정할 수 있습니다. 이 필드 이름은 대소문자를 구분합니다.

예: 요청

/v1/records/search?attributes=data,createdBy

{
    "records": [
        {
            "id": "Rc6527ecb35df57c441d92ba00",
            "createdBy": "61a9cc0500002f9fdaa7a6f824f557e1",
            "createdAt": null,
            "updatedBy": null,
            "updatedAt": null,
            "customerId": null,
            "imsOrgId": null,
            "recordTypeId": null,
            "data": {
                "F666c0b58b6fee61a2ea6ea81": [
                    {
                        "externalId": null,
                        "id": "Rc665728ff95730b58bc757b13",
                        "value": null
                    },
..

다음과 유사한 응답을 반환합니다.

{
    "priority": 2,
    "name": "first task",
    "ID": "4c7c08fa0000002ff924e298ee148df4",
    "plannedStartDate": "2010-08-30T09:00:00:000-0600"
}

API에서 쿼리 결과 정렬

다음 내용을 API 호출에 추가하면 필드를 기준으로 결과를 정렬할 수 있습니다.

/v1/records/search

요청 본문:

{
    "recordTypeId": "Rt6527ecb25df57c441d92b9fa",
    "filters": [],
    "sorting": [
        {
            "fieldId": "F6527ecb25df57c441d92b9fc",
            "direction": "asc"
        },
        {
            "fieldId": "F658afcbd4a0273c67c346fd5",
            "direction": "desc"
        }
    ],
    "limit": 500,
    "offset": 0,
    "rowOrderViewId": "V6527ecb75df57c441d92ba03",
    "groupingFieldIds": []
}

쿼리 제한 및 페이지 매김된 응답

기본적으로 Planning API 요청은 목록의 시작 부분부터 500개의 결과를 반환합니다. 결과 수에 대한 기본 제한을 무시하려면 요청에 limit 매개 변수를 사용하고 다른 수(최대 2000개 결과)로 설정할 수 있습니다.

요청에 offset 매개 변수를 추가하여 대용량 데이터 세트에 대해 페이지 번호를 매긴 응답을 사용하는 것이 좋습니다. 페이지 매김된 응답을 사용하면 반환되어야 하는 첫 번째 결과의 위치를 지정할 수 있습니다.

예를 들어 결과 2001-4000을 반환하려는 경우 다음 요청을 사용할 수 있습니다. 이 예에서는 2001번째 결과부터 활성 상태인 2000개의 레코드를 반환합니다.

POST /v1/records/search

요청 본문:

{
    "recordTypeId": "recordTypeId",
    "offset": "2001",
    "limit": "2000",
    "filters": [
        { "status": "active" }
    ]
}

결과에 페이지가 올바르게 매겨졌는지 확인하려면 정렬 매개 변수를 사용하십시오. 이렇게 하면 결과를 같은 순서로 반환할 수 있으므로 페이지 매김이 반복되거나 결과를 건너뛰지 않습니다.

정렬에 대한 자세한 내용은 이 문서에서 API에서 쿼리 결과 정렬을(를) 참조하십시오.

recommendation-more-help

workfront-help-quicksilver