사용자 정의 양식의 외부 조회 필드 예

사용자 정의 양식을 엽니다.

화면 왼쪽에서 외부 조회 ​를 찾아 캔버스의 섹션으로 끕니다.

필드의 레이블 및 이름 ​을(를) 입력하십시오.

필드의 형식 ​을(를) 선택하십시오.

기본 API URL 필드에 API 호출을 입력합니다.

• 사용자 정의 양식이 있는 동일한 Workfront 인스턴스를 참조하려면 URL에 $$HOST를 사용하십시오.
• 다른 필드의 쿼리를 기준으로 결과를 필터링하려면 $$QUERY를 추가합니다.

예
$$HOST/attask/api/v15.0/project/search?status={DE:StatusQuery}&$$QUERY

이 조회 필드가 API에서 참조하는 필드에 대한 종속성 ​을 검토하십시오.

종속성 필드는 개체의 세부 정보 페이지에 있는 사용자 지정 필드나 기본 필드일 수 있습니다.

이 예제에서는 {DE:StatusQuery}이(가) StatusQuery 사용자 지정 필드의 값으로 바뀝니다.

HTTP 메서드 ​를 선택하십시오.

대부분 Get ​일 수 있습니다.

API 호출 결과를 가져오려면 JSON 경로 ​를 입력하십시오.

예
$.data[*].name

적용 ​을 클릭합니다.

사용자 정의 양식을 Workfront 개체(이 예에서는 프로젝트)에 추가하면 다음과 유사하게 표시됩니다.

사용자 정의 양식을 엽니다.

화면 왼쪽에서 외부 조회 ​를 찾아 캔버스의 섹션으로 끕니다.

필드의 레이블 및 이름 ​을(를) 입력하십시오.

필드의 형식 ​을(를) 선택하십시오.

기본 API URL 필드에 API URL 호출을 입력합니다.

예
$$HOST/attask/api/v18.0/PORT/search?ID={portfolioID}&fields=parameterValues

이 조회 필드가 API에서 참조하는 필드에 대한 종속성 ​을 검토하십시오.

종속성 필드는 개체의 세부 정보 페이지에 있는 사용자 지정 필드나 기본 필드일 수 있습니다.

HTTP 메서드 ​를 선택하십시오.

대부분 Get ​일 수 있습니다.

API 호출 결과를 가져오려면 JSON 경로 ​를 입력하십시오.

예
$.data[*].parameterValues.["DE:Combo Colors"]

• "parameterValues"는 현재 있는 개체에 대한 Workfront의 모든 사용자 지정 필드를 참조합니다.
• 이 예에서 "DE:Combo Colors"는 검색할 값이 포함된 특정 사용자 지정 필드입니다.

적용 ​을 클릭합니다.

사용자 정의 양식을 Workfront 개체에 추가하면 "콤보 색상" 필드의 모든 값이 외부 조회 필드 드롭다운에 표시됩니다.

사용자 정의 양식을 엽니다.

화면 왼쪽에서 외부 조회 ​를 찾아 캔버스의 섹션으로 끕니다.

필드의 레이블 및 이름 ​을(를) 입력하십시오.

필드의 형식 ​을(를) 선택하십시오.

기본 API URL 필드에 API URL 호출을 입력합니다.

• $$QUERY를 추가하여 최종 사용자에 대한 쿼리 필터링을 구현할 수 있습니다.

예
모든 국가 목록: https://api.first.org/data/v1/countries

사용자가 드롭다운 필드에서 국가를 검색할 수 있도록 허용합니다. https://api.first.org/data/v1/countries?q=$$QUERY

사용자가 https://api.first.org/data/v1/countries?region={DE:Region}&q=$$QUERY 지역에서 국가를 검색할 수 있도록 허용합니다.

• 사용 가능한 영역은 Workfront의 별도 사용자 정의 필드에 정의됩니다.
• 사용자가 양식에서 지역을 선택하면 외부 조회 필드에 해당 지역의 국가(API에서 지역이 정의된 국가)만 표시됩니다. 선택한 영역에서 국가를 검색할 수도 있습니다.

이 조회 필드가 API에서 참조하는 필드에 대한 종속성 ​을 검토하십시오.

종속성 필드는 개체의 세부 정보 페이지에 있는 사용자 지정 필드나 기본 필드일 수 있습니다.

이 예제에서는 {DE:Region}이(가) Region 사용자 지정 필드의 값으로 바뀝니다.

HTTP 메서드 ​를 선택하십시오.

대부분 Get ​일 수 있습니다.

API 호출 결과를 가져오려면 JSON 경로 ​를 입력하십시오.

이 옵션을 사용하면 API URL에서 반환되는 JSON에서 데이터를 추출할 수 있습니다. JSON 내에서 드롭다운 옵션에 표시할 값을 선택하는 데 사용됩니다.

예
$.data[*].country

(선택 사항) 헤더 추가 ​를 클릭하고 API를 사용한 인증에 필요한 키-값 쌍을 입력하거나 붙여 넣습니다.

(선택 사항) 사용자가 드롭다운에서 둘 이상의 값을 선택할 수 있도록 하려면 다중 선택 드롭다운 ​을 선택합니다.

적용 ​을 클릭합니다.

사용자 정의 양식을 Workfront 개체(이 예에서는 프로젝트)에 추가하면 다음과 유사하게 표시됩니다.