Feilsøking av problemer med importerte Order Printer-maler

Når du migrerer malene fra den eldre Order Printer-appen til den nye Shopify Order Printer-appen, oppdateres liquid-variablene dine for å sikre kompatibilitet med den nye appen. I sjeldne tilfeller kan det hende du må feilsøke de importerte malene.

Hvis de importerte malene ikke skrives ut riktig, kan det hende du må redigere malkoden manuelt i den nye Shopify Order Printer-appen. Se gjennom følgende vanligste årsaker til at maler kanskje ikke importeres riktig:

  • Maler inkluderer tilpasset CSS
  • Maler inneholder metafelt
  • Liquid-variabler blir kanskje ikke oppdatert riktig

På denne siden finner du detaljert informasjon om hvordan du feilsøker potensielle problemer når du importerer de egendefinerte malene dine til den nye Shopify Order Printer-appen.

Oppdatere vanlige CSS-designtilpasninger

Hvis malene du overfører inkluderer tilpasset CSS, må du kanskje oppdatere CSS-koden i malene manuelt for å vise designelementer som bilder, tilpassede skrifttyper, logoer eller strekkoder på riktig måte.

Oppdatere metafelt-variabler

For å få tilgang til et metafelt må du angi metafeltets navnefelt, og du trenger ikke å legge til .value i variabelen. Finn ut mer om metafelt-definisjoner.

I stedet for variabelen product.metafields.custom.manufacturerid.value, kan du for eksempel bruke variabelen product.metafields.custom.manufacturerid.

For å identifisere navnefeltverdier for hvert metafelt kan du se siden Egendefinerte data i Shopify-administratorpanelet. Metafelt-definisjoner er gruppert etter objektene de henviser til, som produkter, varianter eller bestillinger.

Oppdatere vanlige Liquid-variabler

I de fleste tilfeller oppdateres Liquid-variablene dine automatisk under migreringsprosessen. Hvis malene dine imidlertid ikke migreres riktig og du bruker noen av variablene som er oppført i denne delen, må du kanskje erstatte de gamle variablene med nye variabler manuelt. Shopify Order Printer-appen bruker andre variabler enn den eldre Order Printer-appen.

Hvis du for eksempel bruker date-variabelen, må du erstatte den med created_at-variabelen.

Bestillingsvariabler

Bestillingsvariabler brukes annerledes i Shopify Order Printer-appen. For å få tilgang til bestillingsvariabler må du legge til prefikset order.. For å få tilgang til billing_address-variabelen må du for eksempel bruke order.billing_address.

Følgende vanlige bestillingsvariabler er tilgjengelige uten prefikset order.:

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

Hvis du for eksempel vil ha tilgang til line_items-variabelen, kan du bruke line_items eller order.line_items.

Du kan også lage egne aliaser for malen din. Du kan for eksempel bruke Liquid-syntaksen {% assign fulfillments_count = order.fulfillments | size %} og deretter henvise til den ved å bruke {{ fulfillments_count }} i koden.

Bestillingsvariabel
Variabel i den eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
line_items
  • Refunderte poster er ikke inkludert i line_items -variabelen. Se gjennom følgende detaljer:
    • Du får tilgang til refunderte poster med variabelen refunds.<each>.refund_line_items. Se gjennom følgende eksempel.
      {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %}
    • Du kan slå sammen de refunderte postene med line_items-samlingen hvis du vil. Se gjennom 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 du inkluderer | uniq-filteret for å unngå duplisering av de refunderte postene.
  • Tips-poster er ikke inkludert i line_items -variabelen. Se gjennom følgende detaljer:
    • Du får tilgang til tips-poster med variabelen tip_line_items.
    • Du kan slå sammen tip_line_items med line_items-samlingen hvis du vil. Se gjennom følgende eksempel.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • For å etterligne den eldre line_items-samlingen i Order Printer kan du bruke følgende eksempelkode.
    {% 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_cardBruk betalingsinformasjon basert på hver enkelt transaksjon fra bestillingen med variabelen transactions.<each>.payment_details.
current_shipping_priceshipping_price
dateBruk created_at-variabelen. Bruk date-filteret til å formatere tidsstempelet, for eksempel med {{ order.created_at | date: "%B %e, %Y" }}.
gatewaysunique_gateways eller transactions.<each>.gateway
order_currencycurrency
processed_atBruk created_at-variabelen. Den inneholder verdien til order.processed_at fra GraphQL API, og angir det faktiske tidspunktet bestillingen blir behandlet, i stedet for tidspunktet bestillingen ble importert til Shopify. Den er den samme som order.processed_at fra den eldre Order Printer-appen. Du kan bruke date-filteret til å formatere tidsstempelet, for eksempel med {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

Filtrer gjennom order.transactions for kind-statusen i Liquid-syntaksen med where, eller med en løkke og en if på innsiden. Se gjennom 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" %} 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_transactionsFiltrer gjennom order.transactions etter kind-statusen i Liquid-syntaksen med where, eller med en løkke og en if på innsiden, som 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 begynnelsen av malen og referere til den flere ganger, som 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

LineItem-variabler

LineItem-variabel
Variabel i den eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
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

Distribusjonsvariabler

distribusjonsvariabel
Variabel i den eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
datecreated_at

Shop-variabler

Shop-variabel
Variabel i den eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
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 eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
latitudeHvis variablen address ble referert fra attributtet location, er breddegrad og lengdegrad tilgjengelig på selve objektet location.
longitudeHvis variablen address ble referert fra attributtet location, er breddegrad og lengdegrad tilgjengelig på selve objektet location.

Refusjonsvariabler

Refusjonsvariabel
Variabel i den eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
dateBruk created_at-variabelen. Bruk date-filteret til å formatere tidsstempelet, for eksempel med {{ order.created_at | date: "%B %e, %Y" }}.

ShippingLine-variabler

ShippingLine-variabel
Variabel i den eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
current_priceprice
priceoriginal_price

Transaksjonsvariabler

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

  • authorization
  • message
  • test

Variantvariabler

variantvariabel
Variabel i den eldre Order Printer-appenVariabel i den nye Shopify Order Printer-appen
gramsweight

Metafeltvariabler

For å få tilgang til et metafelt må du spesifisere metafeltets navneområde, og du trenger ikke å legge til .value i variabelen. Finn ut mer om metafelt-definisjoner.

Bruk for eksempel variabelen product.metafields.custom.manufacturerid i stedet for variabelen product.metafields.manufacturerid.value.

Du finner navneområde-verdier for hvert metafelt på siden Egendefinerte data i Shopify-administrator. Metafelt-definisjoner er gruppert etter objektene de refererer til, som for eksempel produkter, varianter eller bestillinger.

Filtertilordning

Filtertilordning
Filternavn i den eldre Order Printer-appenFilternavn i den nye Shopify Order Printer-appen
files_urlfile_url
payment_method og payment_methodsBruk feltet transaction.gateway_display_name på bestillingstransaksjoner. Betalingsmåter kategoriseres ikke lenger i bestemte typer, som {kredittkort, debetkort, bankoverføring}. Den eldre Order Printer-appen tilordnet bare et lite delsett av de nåværende fungerende betalingsgatewayene til disse kategoriene. Leverandører av betalingsgatewayer administrerer hvilke typer betalingsmåter som brukes av kunder på sin side.