회사 데이터 가져오기

회사 데이터를 사용하는 워크플로에서는 회사 데이터 가져오기 작업을 사용하여 스토어에서 회사 정보를 검색할 수 있습니다.

구성

필드

회사 데이터 가져오기 작업에는 쿼리를 빌드하는 데 사용되는 다음 필드가 포함됩니다.

쿼리 문자열

다음은 지난 하루 동안 업데이트된 회사를 가져오는 예시 쿼리입니다.

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at 변수는 회사 쿼리에서 사용할 수 있는 필터이며 여러 번 사용하거나 다른 변수와 조합할 수 있습니다. scheduledAt Liquid 변수는 예약 시간 트리거를 사용한 워크플로에서 사용할 수 있습니다. date_minus Liquid 태그는 날짜에서 시간을 뺄 수 있는 특수한 Flow 태그입니다.

데이터를 쿼리할 때 다음 사항을 알아두면 유용합니다.

• 사용 가능한 회사 필터 목록
• 쿼리는 특정 구문을 따라야 합니다.
• 쿼리 필드 값이 항상 문서화되어 있지는 않습니다. 경우에 따라 API 문서를 확인하여 값을 찾을 수 있습니다. 또는 관리자에서 필터링할 때 URL에서 필드 값을 찾는 방법도 자주 사용됩니다. 예를 들어, 일부 주문 쿼리 값을 찾으려면 관리자에서 주문 페이지를 필터링한 다음 URL을 확인하십시오.
• Shopify GraphiQL 앱을 사용하여 스토어에서 쿼리를 실행하거나 테스트할 수 있습니다.
• 쿼리가 실패할 경우 발생하는 상황에 유의하십시오. API는 종종 결과가 없는 대신 모든 결과를 반환합니다.

반환된 데이터

모든 데이터 가져오기 작업은 0~100개의 리소스 목록을 반환합니다. 사용 사례에 따라 이 데이터를 다양한 방식으로 사용할 수 있습니다.

• 각각에 태그를 추가하는 등 각 목록 항목을 개별적으로 처리해야 하는 경우 For each 작업을 사용할 수 있습니다.
• 반환된 결과의 개수를 세는 등 데이터를 집계해야 하는 경우 개수 세기 또는 합계 작업을 사용할 수 있습니다.
• 모든 품목이 포함된 이메일을 보내는 등 목록을 출력해야 하는 경우 후속 작업에서 반환된 데이터를 직접 사용할 수 있습니다.

이 작업 다음에 오는 단계에서 반환된 데이터에 액세스하려면 회사 목록인 회사 데이터 가져오기라는 이름의 변수를 사용하세요. 이 변수는 조건과 작업 모두에서 사용할 수 있습니다. 예를 들어 다음과 같이 내부 이메일 보내기 작업에서 회사 목록을 보낼 수 있습니다.

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

트리거

이 작업은 예약 시간 트리거를 포함한 모든 워크플로에서 사용할 수 있습니다. 예약 시간 트리거를 사용하는 워크플로에서는 이벤트의 결과가 아니라 지정한 시간에 워크플로가 시작됩니다. 스토어 또는 앱에서 워크플로를 시작하는 특정 이벤트가 없으므로 자동으로 포함되는 데이터는 없습니다.

API 참조

• 회사 리소스
• 회사 쿼리 필터