Résoudre les problèmes de vos modèles importés Order Printer

Lorsque vous migrez vos modèles de l’ancienne application Order Printer vers la nouvelle application Shopify Order Printer, vos variables Liquid sont mises à jour pour assurer la compatibilité avec la nouvelle application. Dans de rares cas, vous pourriez avoir besoin de résoudre des problèmes survenus avec vos modèles importés.

Si vos modèles importés ne s’impriment pas correctement, vous devrez peut-être modifier manuellement le code des modèles dans la nouvelle application Shopify Order Printer. Consultez les différentes raisons pouvant expliquer les problèmes d’importation des modèles :

Les modèles incluent des CSS personnalisées
Les modèles contiennent des champs méta
Les variables Liquid ne sont peut-être pas mises à jour correctement

Sur cette page, vous trouverez des informations détaillées sur la façon de résoudre les problèmes potentiels lors de l’importation de vos modèles personnalisés vers la nouvelle application Shopify Order Printer.

Sur cette page

Mettre à jour les personnalisations de présentation des CSS courantes

Si les modèles que vous transférez incluent des CSS personnalisées, vous devrez peut-être mettre à jour manuellement le code CSS dans vos modèles pour afficher correctement les éléments de présentation, tels que les images, les polices personnalisées, les logos ou les codes-barres.

Mettre à jour les variables des champs méta

Pour accéder à un champ méta, vous devez spécifier l’espace de nom du champ méta et vous n’avez pas besoin d’ajouter .value à la variable. En savoir plus sur les définitions de champ méta.

Par exemple, au lieu de la variable product.metafields.custom.manufacturerid.value, utilisez la variable product.metafields.custom.manufacturerid.

Pour identifier les valeurs de nom d’espace pour chaque champ méta, consultez la page Données personnalisées de votre interface administrateur Shopify. Les définitions de champ méta sont regroupées en fonction des objets auxquels elles se réfèrent, tels que des produits, des variantes ou des commandes.

Mettre à jour les variables Liquid courantes

Dans la plupart des cas, vos variables Liquid seront automatiquement mises à jour lors du processus de migration. Cependant, si vos modèles ne migrent pas correctement et que vous utilisez l’une des variables répertoriées dans cette section, vous devrez peut-être remplacer manuellement vos anciennes variables par de nouvelles variables. L’application Shopify Order Printer utilise des variables différentes de celles de l’ancienne application Order Printer.

Par exemple, si vous utilisez la variable date, vous devez la remplacer par la variable created_at.

Variables de commande

Les variables de commande sont utilisées différemment dans l’application Shopify Order Printer. Pour accéder aux variables de commande, vous devez ajouter le préfixe order.. Par exemple, pour accéder à la variable billing_address, vous devez utiliser order.billing_address.

Les variables de commande couramment utilisés suivantes sont accessibles sans le préfixe order. :

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Par exemple, si vous souhaitez accéder à la variable des rubriques, vous pouvez utiliser line_items ou order.line_items.

Vous pouvez également créer vos propres alias pour votre modèle. Par exemple, vous pouvez utiliser la syntaxe Liquid {% assign fulfillments_count = order.fulfillments | size %}, puis la référencer en utilisant {{ fulfillments_count }} dans votre code.

Variable de commande
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`line_items`	Les rubriques remboursées ne sont pas incluses à la variable `line_items`. Vérifiez les détails suivants : Vous pouvez accéder aux rubriques remboursées en utilisant la variable `refunds.<each>.refund_line_items` . Prenons l’exemple suivant. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` Si vous le souhaitez, vous pouvez joindre les rubriques remboursées à la collection `line_items`. Prenons l’exemple suivant. `{% 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 %}` Assurez-vous d’inclure le filtre `\| uniq` afin d’éviter la duplication des rubriques remboursées. Les rubriques pourboire ne sont pas incluses à la variable `line_items`. Vérifiez les détails suivants : Vous pouvez accéder aux rubriques pourboire en utilisant la variable `tip_line_items`. Vous pouvez joindre `tip_line_items` à la collection `line_items`, si vous le souhaitez. Prenons l’exemple suivant. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` Pour imiter l’ancienne collection `line_items` d’Order Printer, vous pouvez utiliser l’exemple de code suivant. `{% 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`	Utilisez les détails de paiement en fonction de chaque transaction de la commande avec la variable `transactions.<each>.payment_details` .
`current_shipping_price`	`shipping_price`
`date`	Utilisez la variable `created_at`. Utilisez le filtre `date` pour formater l’horodatage, par exemple avec `{{ order.created_at \| date: "%B %e, %Y" }}`.
`passerelles`	`unique_gateways` ou `transactions.<each>.gateway`
`order_currency`	`devise`
`processed_at`	Utilisez la variable `created_at`. Elle détient la valeur `order.processed_at` de l’API GraphQL, qui signifie l’heure actuelle à laquelle la commande est traitée, au lieu de l’heure à laquelle elle est importée dans Shopify. Elle est identique à `order.processed_at` de l’ancienne application Order Printer. Vous pouvez utiliser le filtre `date` pour formater l’horodatage, par exemple avec des `{{ order.created_at \| date: "%B %e, %Y" }}`.
`payment_transactions`	Filtrez avec `order.transactions` pour l’état `kind` dans la syntaxe Liquid avec where, ou avec une boucle et `if` à l’intérieur, comme avec l’exemple suivant. Prenons les exemples suivants. `{% 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" %} ID de transaction : {{ transaction.id }} Type : {{ transaction.kind }} Montant : {{ 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`	Filtrez avec `order.transactions` pour l’état `kind` dans la syntaxe Liquid avec where, ou avec une boucle et `if` à l’intérieur, comme avec l’exemple suivant. `{% 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`. Vous pouvez le définir comme variable au début du modèle et y faire référence plusieurs fois, comme avec l’exemple suivant. `{% 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`

Variables LineItem

Variable LineItem
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`fulfillable_quantity`	`quantity – successfully_fulfilled_quantity`
`traité`	`quantity == successfully_fulfilled_quantity`
`nom`	`title`
`product_title`	`product.title`
`unit_discount`	`quantité ? line_level_total_discount / quantité : 0`
`variant_title`	`variant.title`
`poids`	`grams`

Variables de traitement

variable de traitement
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`date`	`creation_le`

Variables Boutique

Variable Shop
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`propriétaire`	`account_owner.name`
`adresse`	`shop.address.address1`
`address2`	`shop.address.address2`
`city`	`shop.address.city`
`Pays`	`shop.address.country`
`country_code`	`shop.address.country_code`
`province`	`shop.address.province`
`province_code`	`shop.address.province_code`
`code postal`	`shop.address.zip`

Variables de l’adresse

Variable de l’adresse
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`latitude`	Si la variable `address` a été référencée à partir de l’attribut `location`, la latitude et la longitude sont disponibles sur l’objet `location` lui–même.
`longitude`	Si la variable `address` a été référencée à partir de l’attribut `location`, la latitude et la longitude sont disponibles sur l’objet `location` lui–même.

Variables de remboursement

Variable de remboursement
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`date`	Utilisez la variable `created_at`. Utilisez le filtre `date` pour formater l’horodatage, par exemple avec `{{ order.created_at \| date: "%B %e, %Y" }}`.

Variables ShippingLine

Variable ShippingLine
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`current_price`	`prix`
`prix`	`original_price`

Variables de transaction

Les variables de transaction suivantes ont été supprimées et ne peuvent pas être remplacées dans l’application Shopify Order Printer :

authorization
message
test

Variables de variantes

variable de variante
Variable dans l’ancienne application Order Printer	Variable dans la nouvelle application Shopify Order Printer
`grams`	`poids`

Variables de champ méta

Pour accéder à un champ méta, vous devez spécifier l’espace de nom du champ méta et vous n’avez pas besoin d’ajouter la .value à la variable. En savoir plus sur les définitions de champ méta.

Par exemple, au lieu de la variableproduct.metafields.manufacturerid.value, utilisez la variableproduct.metafields.custom.manufacturerid.

Pour identifier les valeurs Nom d’espace pour chaque champ méta, consultez la page Données personnalisées de votre interface administrateur Shopify. Les définitions de champ méta sont regroupées en fonction des objets auxquels elles se réfèrent, tels que des produits, des variantes ou des commandes.

Filtrer le mappage

Filtrer le mappage
Filtrer le nom dans l’ancienne application Order Printer	Filtrer le nom dans la nouvelle application Shopify Order Printer
`files_url`	`file_url`
`payment_method` et `payment_methods`	Utilisez le champ transaction.gateway_display_name sur les transactions de commande. Les moyens de paiement ne sont plus classés en catégories spécifiques, telles que `{ carte de crédit, carte de débit, virement bancaire}`. L’ancienne application Order Printer ne mappait à ces catégories qu’un petit sous-ensemble de passerelles de paiement actuellement en service. Les fournisseurs de passerelles de paiement gèrent de leur côté les types de moyens de paiement utilisés par les clients.