インポートしたOrder Printerテンプレートに関する問題のトラブルシューティング

従来のOrder Printerアプリから新しいShopifyOrder Printerアプリにテンプレートを移行すると、新しいアプリとの互換性を確保するためにLiquid変数が更新されます。まれに、インポートしたテンプレートのトラブルシューティングが必要になることがあります。

インポートしたテンプレートが正しく印刷されない場合は、新しいShopify Order Printerアプリでテンプレートのコードを手動で編集する必要が生じる場合があります。テンプレートが正しくインポートされない最も一般的な理由は、以下のとおりです。

テンプレートにカスタムCSSが含まれている
テンプレートにメタフィールドが含まれている
Liquid変数が正しく更新されない可能性がある

このページでは、カスタムテンプレートを新しいShopify Order Printerアプリにインポートする際に、発生する可能性のある問題をトラブルシューティングする方法について詳しく説明します。

共通CSSデザインカスタマイズを更新する

移行するテンプレートにカスタムCSSが含まれている場合、画像、カスタムフォント、ロゴ、バーコードなどのデザイン要素を正しく表示するために、テンプレート内のCSSコードを手動で更新する必要がある場合があります。

メタフィールド変数を更新する

メタフィールドにアクセスするには、メタフィールドのネームスペースを指定する必要がありますが、変数に.valueを追加する必要はありません。メタフィールドの定義について詳しくはこちらをご覧ください。

たとえば、product.metafields.custom.manufacturerid.value 変数の代わりに product.metafields.custom.manufacturerid 変数を使用します。

各メタフィールドのネームスペース値を識別するには、管理画面の [カスタムデータ] ページを参照してください。メタフィールドの定義は、商品、バリエーション、注文など、参照するオブジェクトによってグループ化されます。

共通Liquid変数を更新する

ほとんどの場合、Liquid変数は移行プロセス中に自動的に更新されます。ただし、テンプレートが正しく移行されず、このセクションにリストされている変数のいずれかを使用している場合は、古い変数を新しい変数に手動で置き換える必要がある場合があります。Shopify Order Printerアプリは、従来のOrder Printerアプリとは異なる変数を使用します。

たとえば、date変数を使用している場合、created_at変数に置き換える必要があります。

注文変数

Shopify Order Printerアプリでの注文変数の使用方法は異なります。注文変数にアクセスするには、order.のプリフィックスを追加する必要があります。たとえば、billing_address変数にアクセスするには、order.billing_addressを使用する必要があります。

以下のよく使われる注文変数は、order.のプリフィックスなしでアクセスできます。

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

たとえば、項目変数にアクセスする場合は、line_itemsまたはorder.line_itemsを使用できます。

テンプレートに使用する独自のエイリアスを作成することもできます。たとえば、{% assign fulfillments_count = order.fulfillments | size %}のLiquid構文を使用し、コード内の{{ fulfillments_count }}を使用して参照することができます。

注文変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`line_items`	返金済みの項目は、`line_items`変数に含まれません。以下の詳細を確認してください。 `refunds.<each>.refund_line_items`変数を使用して、返金済みの項目にアクセスできます。次の例を確認してください。 `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` 必要であれば、返金済みの項目を`line_items`コレクションに結合することができます。次の例を確認してください。 `{% assign refunded_line_items = order.refunds \| map: "refund_line_items" \| map: "line_item" %}{% assign line_items_with_refunded = order.line_items \| concat: refunded_line_items \| uniq %}` 返金済みの項目が重複しないように `\| uniq` フィルターをチェックしてください。チップ項目は `line_items` 変数に含まれません。以下の詳細を確認してください。 `tip_line_items`変数を使用してチップ項目にアクセスできます。必要であれば、`tip_line_items`を`line_items`コレクションに結合することができます。次の例を確認してください。 `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` 従来のOrder Printer `line_items`コレクションを模倣するには、以下のコード例を使用します。 `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %} {% assign all_line_items = order.line_items \| concat: refunded_line_items \| concat: order.tip_line_items \| uniq %} {% for line_item in all_line_items %} ... {% endfor %}`
`credit_card`	`transactions.<each>.payment_details`変数を伴う注文の各取引に基づく決済の詳細を使用します。
`current_shipping_price`	`shipping_price`
`date`	`created_at`変数を使用します。`date`フィルターを使用して、タイムスタンプの書式を設定できます (例：`{{ order.created_at \| date: "%B %e, %Y" }}`)。
`サービス`	`unique_gateways`、または`transactions.<each>.gateway`
`order_currency`	`currency`
`processed_at`	`created_at`変数を使用します。GraphQL APIの`order.processed_at`の値が保持されます。つまり、注文がShopifyにインポートされた時間ではなく、注文が処理された実際の時間を意味します。これは従来のOrder Printerアプリの`order.processed_at`と同じです。`date`絞り込みを使用して、タイムスタンプの書式を設定できます (例：`{{ order.created_at \| date: "%B %e, %Y" }}`)。
`payment_transactions`	`order.transactions`を`kind`ステータスについて絞り込むには、Liquid構文でwhereを使用するか、ループ内で`if`を使用します。次の例を確認してください。 `{% assign sale_transactions = order.transactions \| where: "kind", "sale" %} {% assign capture_transactions = order.transactions \| where: "kind", "capture" %} {% for transaction in transactions %} {% if transaction.kind == "sale" or transaction.kind == "capture" %} Transaction ID: {{ transaction.id }} Kind: {{ transaction.kind }} Amount: {{ transaction.amount \| money }} {% endif %} {% endfor %}` `{% assign sale_transactions = order.transactions \| where: "kind", "sale" %} {% assign capture_transactions = order.transactions \| where: "kind", "capture" %} {% assign payment_transactions = sale_transactions \| concat: capture_transactions %}`
`refund_transactions`	`order.transactions`を`kind`ステータスについて絞り込むには、以下の例のように、Liquid構文でwhereを使用するか、ループ内で`if`を使用します。 `{% assign refund_transactions = order.transactions \| where: "kind", "refund" %}`
`shipping_line`	`shipping_methods \| first`
`shipping_lines`	`shipping_methods`
`show_line_item_taxes`	`tax_lines.size > 0`。テンプレートの先頭で変数として定義し、次の例のように複数回参照することができます。 `{% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}`
`total_tax`	`tax_price`
`total_paid`	`net_payment`

LineItem変数

LineItem変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`発送済`	`quantity == successfully_fulfilled_quantity`
`name`	`title`
`商品_タイトル`	`product.title`
`unit_discount`	`quantity？line_level_total_discount / quantity : 0`
`バリエーション_タイトル`	`variant.title`
`重量`	`グラム`

フルフィルメント変数

フルフィルメント変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`date`	`created_at`

ショップ変数

shop変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`オーナー`	`account_owner.name`
`住所`	`shop.address.address.address1`
`address2`	`shop.address.address.address2`
`city`	`shop.address.city`
`国`	`shop.address.country`
`country_code`	`shop.address.country_code`
`province`	`shop.address.province`
`province_code`	`shop.address.province_code`
`zip`	`shop.address.zip`

住所変数

住所変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`緯度`	`address`変数が`location`属性から参照された場合、緯度と経度は`location`オブジェクト自体で利用できます。
`経度`	`address`変数が`location`属性から参照された場合、緯度と経度は`location`オブジェクト自体で利用できます。

返金変数

返金変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`date`	`created_at`変数を使用します。`date`フィルターを使用して、タイムスタンプの書式を設定できます (例：`{{ order.created_at \| date: "%B %e, %Y" }}`)。

ShippingLineの変数

ShippingLineの変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`current_price`	`price`
`price`	`original_price`

取引変数

以下の取引変数は削除されたため、Shopify Order Printerアプリで置き換えることはできません。

authorization
message
test

バリエーションの変数

バリエーションの変数
従来のOrder Printerアプリの変数	新しいShopify Order Printerアプリの変数
`グラム`	`重量`

メタフィールド変数

メタフィールドにアクセスするには、メタフィールドのネームスペースを指定する必要がありますが、変数に.valueを追加する必要はありません。メタフィールドの定義について詳しくはこちらをご覧ください。

たとえば、product.metafields.manufacturerid.value変数の代わりにproduct.metafields.custom.manufacturerid変数を使用します。

各メタフィールドのネームスペース値を識別するには、管理画面のカスタムデータページを参照してください。メタフィールドの定義は、商品、バリエーション、注文など、参照するオブジェクトによってグループ化されます。

マッピングを絞り込む

マッピングを絞り込む
従来のOrder Printerアプリで名前を絞り込む	新しいShopify Order Printerアプリで名前を絞り込む
`files_url`	`file_url`
`payment_method`と`payment_methods`	注文取引でtransaction.gateway_display_nameフィールドを使用します。決済方法は、`クレジットカード、デビットカード、銀行振込`のような特定のタイプに分類されなくなりました。従来のOrder Printerアプリでは、現在機能している決済ゲートウェイサービスのごく一部のみを、これらのカテゴリーにマッピングしていました。決済ゲートウェイサービスプロバイダーでは、お客様が使用する決済方法の種類を自社側で管理しています。