Fejlfinding af problemer med dine importerede Order Printer-skabeloner

Når du migrerer dine skabeloner fra den ældre app Order Printer til den nye app Shopify Order Printer, opdateres dine Liquid-variabler for at sikre kompatibilitet med den nye app. I sjældne tilfælde kan det være nødvendigt at finde og rette fejl i dine importerede skabeloner.

Hvis dine importerede skabeloner ikke udskrives korrekt, kan du være nødt til at redigere din skabelons kode manuelt i den nye app Shopify Order Printer. Gennemgå følgende mest almindelige årsager til, at skabeloner muligvis ikke importeres korrekt:

  • Skabeloner inkluderer tilpasset CSS
  • Skabeloner indeholder metafelter
  • Liquid-variabler opdateres muligvis ikke korrekt

På denne side kan du finde detaljerede oplysninger om, hvordan du finder og retter potentielle fejl ved import af dine tilpassede skabeloner til den nye app Shopify Order Printer.

Opdatering af almindelige CSS-designtilpasninger

Hvis de skabeloner, du overfører, indeholder tilpasset CSS, skal du muligvis opdatere CSS-koden i dine skabeloner manuelt for at få designelementer som billeder, tilpassede skrifttyper, logoer eller stregkoder vist korrekt.

Opdatering af metafeltvariabler

Hvis du vil have adgang til et metafelt, skal du angive metafeltets navneområde, og du behøver ikke at føje .value til variablen. Få mere at vide om definitioner af metafelter.

I stedet for variablen product.metafields.custom.manufacturerid.value skal du f.eks. bruge variablen product.metafields.custom.manufacturerid.

Du kan finde navneområdeværdier for hvert metafelt på siden Tilpassede data i din Shopify-administrator. Definitioner af metafelter grupperes efter de objekter, de henviser til, som f.eks. produkter, varianter eller ordrer.

Opdatering af almindelige Liquid-variabler

I de fleste tilfælde opdateres dine Liquid-variabler automatisk under migreringsprocessen. Men hvis dine skabeloner ikke migreres korrekt, og du bruger en af de variabler, der er angivet i dette afsnit, skal du muligvis udskifte dine gamle variabler med nye variabler manuelt. Shopify Order Printer-appen bruger andre variabler end den ældre Order Printer-app.

Hvis du f.eks. bruger variablen date, skal du erstatte den med variablen created_at.

Ordrevariabler

Ordrevariabler bruges anderledes i Shopify Order Printer-appen. Hvis du vil have adgang til ordrevariabler, skal du tilføje præfikset order.. Hvis du f.eks. vil have adgang til variablen billing_address, skal du bruge order.billing_address.

Følgende almindeligt anvendte ordrevariabler er tilgængelige uden præfikset order.:

  • line_items
  • tax_lines
  • fulfillments
  • transactions
  • refunds
  • shipping_methods
  • customer

Hvis du f.eks. vil have adgang til variablen for varelinjer, kan du bruge line_items eller order.line_items.

Du kan også oprette dine egne aliasser til din skabelon. Du kan f.eks. bruge Liquid-syntaksen {% assign fulfillments_count = order.fulfillments | size %} og derefter henvise til den ved hjælp af {{ fulfillments_count }} i din kode.

Ordrevariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
line_items
  • Refunderede varelinjer er ikke inkluderet i line_items variablen. Gennemgå følgende oplysninger:
    • Du kan få adgang til refunderede varelinjer ved hjælp af variablen refunds.<each>.refund_line_items. Gennemgå følgende eksempel.
      {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %}
    • Du kan føje de refunderede varelinjer til samlingen line_items, hvis du ønsker det. Gennemgå følgende eksempel.
      {% 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 %}
    • Du bør sørge for at inkludere filteret | uniq for at undgå duplikering af de refunderede varelinjer.
  • Varelinjer for drikkepenge er ikke inkluderet i line_items variablen. Gennemgå følgende oplysninger:
    • Du kan få adgang til varelinjer for drikkepenge ved hjælp af variablen tip_line_items.
    • Du kan føje tip_line_items til samlingen line_items, hvis du ønsker det. Gennemgå følgende eksempel.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • Du kan bruge følgende kodeeksempel til at efterligne samlingen line_items fra den ældre Order Printer.
    {% 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_cardBrug betalingsoplysninger baseret på hver transaktion fra ordren med variablen transactions.<each>.payment_details.
current_shipping_priceshipping_price
dateBrug variablen created_at. Brug filteret date til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }}.
gatewaysunique_gateways eller transactions.<each>.gateway
order_currencycurrency
processed_atBrug variablen created_at. Den indeholder værdien af order.processed_at fra GraphQL API'en og angiver det faktiske tidspunkt, hvor ordren behandles, i stedet for det tidspunkt, hvor ordren importeres til Shopify. Den er den samme som order.processed_at fra den ældre Order Printer-app. Du kan bruge date-filtret til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

Filtrer i order.transactions efter statussen kind i Liquid-syntaksen med where eller ved at bruge et loop med en if-betingelse. Se følgende eksempler.

{% 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" %} Transaktions-id: {{ transaction.id }} Type: {{ transaction.kind }} Beløb: {{ 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_transactionsFiltrer gennem order.transactions for kind-statussen i Liquid-syntaksen med where, eller med en løkke med if indeni, ligesom i følgende eksempel.
{% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_lineshipping_methods | first
shipping_linesshipping_methods
show_line_item_taxestax_lines.size > 0. Du kan definere den som en variabel i begyndelsen af skabelonen og henvise til den flere gange ligesom i følgende eksempel.
{% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}
total_taxtax_price
total_paidnet_payment

Linjepostvariabler

Linjepostvariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
fulfillable_quantityquantity - successfully_fulfilled_quantity
fulfilledquantity == successfully_fulfilled_quantity
nametitle
product_titleproduct.title
unit_discountquantity ? line_level_total_discount / quantity : 0
variant_titlevariant.title
weightgrams

Klargøringsvariabler

Klargøringsvariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
datecreated_at

Butiksvariabler

Butiksvariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
owneraccount_owner.name
addressshop.address.address1
address2shop.address.address2
cityshop.address.city
countryshop.address.country
country_codeshop.address.country_code
provinceshop.address.province
province_codeshop.address.province_code
zipshop.address.zip

Adressevariabler

Adressevariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
latitudeHvis der blev henvist til variablen address fra attributten location, er breddegrad og længdegrad tilgængelige på selve location-objektet.
longitudeHvis der blev henvist til variablen address fra attributten location, er breddegrad og længdegrad tilgængelige på selve location-objektet.

Refusionsvariabler

Refusionsvariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
dateBrug variablen created_at. Brug filteret date til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }}.

ShippingLine-variabler

ShippingLine-variabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
current_priceprice
priceoriginal_price

Transaktionsvariabler

Følgende transaktionsvariabler er blevet fjernet og kan ikke erstattes i Shopify Order Printer-appen:

  • authorization
  • message
  • test

Variantvariabler

Variantvariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
gramsweight

Metafeltvariabler

For at få adgang til et metafelt skal du angive metafeltets Namespace, og du behøver ikke at føje .value til variablen. Få mere at vide om definitioner af metafelter.

I stedet for variablen product.metafields.manufacturerid.value skal du f.eks. bruge variablen product.metafields.custom.manufacturerid.

Du kan identificere Namespace-værdier for hvert metafelt på siden Brugerdefinerede data i din Shopify-administrator. Definitioner af metafelter er grupperet efter de objekter, de henviser til, f.eks. produkter, varianter eller ordrer.

Tilknytning af filtre

Tilknytning af filtre
Filternavn i den ældre Order Printer-appFilternavn i den nye Shopify Order Printer-app
files_urlfile_url
payment_method og payment_methodsBrug feltet transaction.gateway_display_name i ordretransaktioner. Betalingsmetoder er ikke længere inddelt i specifikke typer, såsom {kreditkort, debetkort, bankoverførsel}. Den ældre Order Printer-app knyttede kun en lille delmængde af de aktive betalingsgateways til disse kategorier. Udbydere af betalingsgateways administrerer selv de typer af betalingsmetoder, som kunderne bruger.