Migrer fra Order Printer-appen til Shopify Order Printer

Hvis du har tilpassede skabeloner i den ældre Order Printer-app, skal du migrere dine skabeloner til Shopify Order Printer-appen.

Hvis du vil migrere dine skabeloner, kan du kopiere dine eksisterende skabeloner til Shopify Order Printer-appen. Implementering i den nye Shopify Order Printer-app er dog en smule forskellig fra implementering i den ældre Order Printer-app. Dette betyder, at nogle af dine eksisterende skabeloner muligvis ikke vil virke først, og at du skal foretage justeringer af skabelonernes kode.

Du skal erstatte de ældre variabler med de nye variabler for at få dine skabeloner til at fungere i den nye app. Hvis du f.eks. bruger variablen date, skal du erstatte den med variablen created_at.

På denne side kan du finde en liste over de variabler, du muligvis skal erstatte med nye variabler i Shopify Order Printer-appen.

Overvejelser i forbindelse med migrering af eksisterende skabeloner

Gennemgå følgende overvejelser, inden du migrerer dine eksisterende skabeloner til Shopify Order Printer-appen:

Sådan migrerer du eksisterende skabeloner til Shopify Order Printer-appen

Hvis du har eksisterende skabeloner fra den ældre Order Printer-app, kan du importere dem til Shopify Order Printer-appen . Du kan ikke importere udvalgte skabeloner. Du kan kun importere alle dine skabeloner samtidigt.

Trin:

  1. Gå til Indstillinger > Apps og salgskanaler i Shopify-administratoren.

  2. Klik på Order Printer.

  3. Klik på Åbn app.

  4. Klik på Skabeloner.

  5. Klik på Importér.

  6. Klik på Importér i dialogboksen.

  7. Se efter, om dine skabeloner bruger nogle af de ældre variabler, og erstat dem derefter med de nye variabler.

  8. Se en forhåndsvisning af dine skabeloner og kontrollér, at skabelonerne vises korrekt.

  9. Valgfrit: Udskriv testdokumenter.

Sådan bruger du ordrevariabler i Shopify Order Printer-appen

Ordrevariabler bruges på en anden måde i Shopify Order Printer-appen. Du skal tilføje order.-præfikset for at kunne tilgå ordrevariabler. Du skal f.eks. bruge order.billing_address for at kunne tilgå variablen 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 varelinjevariablen, kan du bruge line_items eller order.line_items.

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

Variabelkortlægning

Shopify Order Printer-appen bruger andre variabler end den ældre Order Printer-app. Hvis dine eksisterende skabeloner bruger nogle af de variabler, der er angivet i dette afsnit, skal du erstatte de gamle variabler med nye variabler.

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

Ordrevariabler

Ordrevariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
line_items
  • Refunderede varelinjer er ikke inkluderet i variablen line_items. Gennemgå de følgende detaljer:
    • 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" %}
    • Hvis du vil, kan du føje de refunderede varelinjer til kollektionen line_items. 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 sikre dig, at du medtager filtret | uniq for at undgå duplikering af de refunderede varelinjer.
  • Varelinjer for drikkepenge er ikke inkluderet i variablen line_items. Gennemgå de følgende detaljer:
    • Du kan få adgang til varelinjer for drikkepenge ved hjælp af variablen tip_line_items.
    • Du kan føje tip_line_items til kollektionen line_items, hvis du vil. Gennemgå følgende eksempel.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • Du kan efterligne den gamle Order Printer-kollektion line_items ved at bruge 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_cardBrug betalingsoplysninger baseret på hver transaktion fra ordren med variablen transactions.<each>.payment_details .
current_shipping_priceshipping_price
datoBrug variablen created_at. Brug filteret date til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }}.
gateways unique_gateways eller transactions.<each>.gateway
order_currencyvaluta
processed_atBrug variablen created_at. Den indeholder værdien af order.processed_at fra GraphQL API'en, og det betyder det faktiske tidspunkt, hvor ordren behandles, i stedet for det tidspunkt, hvor ordren importeres til Shopify. Det er det samme som order.processed_at fra den ældre Order Printer-app. Du kan bruge filteret date til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

Filtrer order.transactions efter statussen type i Liquid-syntaksen med where eller med looping og en if indeni. Gennemgå følgende eksempel.

{% 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 order.transactions efter statussen type i Liquid-syntaksen med where eller med looping og en if indeni, som i det følgende eksempel.
{% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_lineshipping_methods | first
shipping_linesshipping_methods
show_line_item_taxes tax_lines.size > 0. Du kan definere den som en variabel i begyndelsen af skabelonen og referere til den flere gange som i det 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 ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
fulfillable_quantityquantity - successfully_fulfilled_quantity
klargjortquantity == successfully_fulfilled_quantity
navntitel
product_titleproduct.title
unit_discountquantity ? line_level_total_discount / quantity : 0
variant_titlevariant.title
vægtgram

Klargøringsvariabler

klargøringsvariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
datocreated_at

Butiksvariabler

Shop-variabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
ejeraccount_owner.name
adresseshop.address.address1
adresse2shop.address.address2
byshop.address.city
landshop.address.country
country_codeshop.address.country_code
landsdelshop.address.province
province_codeshop.address.province_code
postnummershop.address.zip

Adressevariabler

Adressevariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
breddegradHvis variablen address blev refereret fra attributten location, er både breddegrad og længdegrad tilgængelige i selve location-objektet.
længdegradHvis variablen address blev refereret fra attributten location, er både breddegrad og længdegrad tilgængelige i selve location-objektet.

Refusionsvariabler

Refusionsvariabel
Variabel i den ældre Order Printer-appVariabel i den nye Shopify Order Printer-app
datoBrug 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_pricepris
prisoriginal_price

Transaktionsvariabler

Følgende transaktionsvariabler blev 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
gramvægt

Metafeltvariabler

For at få 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 metafeltdefinitioner.

I stedet for variablen product.metafields.manufacturerid.value kan du for eksempel bruge variablen product.metafields.custom.manufacturerid.

Du kan identificere værdier for Navneområder for hvert metafelt ved at se siden Tilpassede data i din Shopify-administrator. Metafeltdefinitioner grupperes efter de objekter, de henviser til, f.eks. produkter, varianter eller ordrer.

Filtrerkortlægning

Filtrerkortlægning
Filternavn i den ældre Order Printer-appFilternavn i den nye Shopify Order Printer-app
files_urlfile_url
payment_method og payment_methods Brug feltet transaction.gateway_display_name i ordretransaktioner. Betalingsmetoder kategoriseres ikke længere i specifikke typer, som f.eks. {kreditkort, debetkort, bankoverførsel}. Den ældre Order Printer-app registrerede kun en mindre del af de betalingsgateways, der fungerer på nuværende tidspunkt, til disse kategorier. Udbydere af betalingsgateways administrerer de typer betalingsmetoder, som kunderne bruger, på deres side.
Kan du ikke finde de svar, du leder efter? Vi er her for at hjælpe.