여러 메타 객체 항목 가져오기
여러 메타 객체 항목 가져오기 작업을 사용하면 선택적 쿼리를 기반으로 스토어에서 메타 객체 항목 목록을 검색할 수 있습니다. 자세한 내용은 메타 객체 문서를 참조하세요.
구성
필드
여러 메타 객체 항목 가져오기 작업에는 메타 객체 정의를 지정하기 위한 드롭다운과 쿼리 작성에 사용되는 다음 필드가 포함됩니다.
필드 | 설명 |
---|---|
데이터 정렬 기준 | 필수 항목입니다. 검색 쿼리에서 반환된 데이터를 정렬하는 기준이 되는 매개변수입니다. |
최대 결과 수 | 필수. 선택한 검색 쿼리로 반환될 수 있는 최대 결과 수입니다. 한 때에 100개까지 반품할 수 있습니다. |
쿼리 | 필수. 일반 쿼리 중에서 선택하거나 고급을 선택하여 직접 만듭니다. |
쿼리 문자열
email
필드 값이 주문의 이메일 주소와 일치하는 경우 여러 메타 객체 항목을 가져오기 위한 쿼리 예시는 다음과 같습니다.
{{fields.email}}:"{{order.email}}"
마지막 날 업데이트된 여러 메타 객체 항목을 가져오기 위한 쿼리 예시는 다음과 같습니다.
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
updated_at
변수는 메타 객체 쿼리에 사용할 수 있는 필터입니다. 여러 번 사용하거나 다른 변수와 조합하여 사용할 수 있습니다. scheduledAt
Liquid 변수는 예약된 시간 트리거를 사용한 워크플로에서 사용할 수 있습니다. date_minus
Liquid 태그는 날짜에서 시간을 추출할 수 있는 특별한 Flow 태그입니다.
데이터를 쿼리할 때는 다음 사항이 도움이 됩니다.
- 사용 가능한 메타 객체 필터 목록
- 필드 값으로 메타 객체를 쿼리하려면 메타 객체 필터링이 활성화되어 있어야 하며, 이는 Shopify 관리자의 사용자 지정 데이터 옵션에서 활성화할 수 있습니다. - 쿼리는 특정 구문을 따라야 합니다.
- 쿼리 필드 값이 항상 문서화되지는 않습니다.일부 경우에는 API 문서를 확인하여 값을 찾을 수 있습니다. 또는 필터링할 때 관리자의 URL에서 필드 값을 찾을 수 있는 경우도 많습니다. 예를 들어 주문 쿼리 값을 찾으려면 관리자의 주문 페이지를 필터링하고 URL을 확인합니다.
- Shopify GraphiQL 앱을 사용해서 매장에서 쿼리를 실행하거나 테스트할 수 있습니다.
- 쿼리가 실패할 때 발생하는 결과에 주의하세요. 아무 것도 반환하지 않는 대신 API가 모든 결과를 반환하는 경우가 많습니다.
반환된 데이터
모든 데이터 가져오기 작업은 0~100개 사이의 리소스 목록을 반환합니다. 사용 사례에 따라 여러 방법으로 이 데이터를 사용할 수 있습니다.
- 각 항목에 대해 태그를 추가하는 것과 같이 각 목록 항목을 개별적으로 처리해야 하는 경우 For each 작업을 사용할 수 있습니다.
- 반환된 결과 수 계산과 같이 데이터를 집계해야 하는 경우 Count 또는 Sum 작업을 사용할 수 있습니다.
- 모든 품목이 포함된 이메일 전송과 같이 목록 출력이 필요한 경우 후속 작업에서 직접 반환된 데이터를 사용할 수 있습니다.
이 작업을 수행하는 단계에서 반환된 데이터에 액세스하려면 메타 객체 항목 목록인 여러 메타 객체 항목 가져오기라는 변수를 사용합니다. 조건 및 작업 모두에서 이 변수를 사용할 수 있습니다. 예를 들어 다음과 같은 내부 이메일 전송 작업에서 메타 개체 항목에 대한 키-값 쌍 목록을 전송할 수 있습니다.
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% endfor %}
트리거
예약된 시간 트리거를 포함한 모든 워크플로에서 이 작업을 사용할 수 있습니다. 예약된 시간 트리거를 사용하면 이벤트의 결과가 아닌 지정한 시간에 따라 워크플로가 시작됩니다. 그러면 스토어나 앱에서 워크플로를 시작하는 이벤트가 없기 때문에 자동으로 포함되는 데이터도 없습니다.