Mallien siirtäminen Order Printer ‑sovelluksesta Shopify Order Printeriin

Tämä sivu on tulostettu Jul 26, 2024. Nykyinen versio on osoitteessa https://help.shopify.com/fi/manual/orders/printing-orders/shopify-order-printer/migration.

Jos sinulla on mukautettuja malleja vanhassa Order Printer ‑sovelluksessa, sinun on siirrettävä mallisi Shopify Order Printer ‑sovellukseen.

Voit siirtää mallit tuomalla nykyiset mallisi Shopify Order Printer ‑sovellukseen Uudella Shopify Order Printer ‑sovellus kuitenkin poikkeaa Order Printer ‑sovelluksesta hieman. Tämä tarkoittaa, että kaikki olemassa olevat mallisi eivät välttämättä toimi aluksi, ja saatat joutua tekemään joitakin muutoksia mallin koodiin.

Jotta mallit toimivat uudessa sovelluksessa, sinun täytyy korvata vanhat muuttujat uusilla muuttujilla. Jos esimerkiksi käytät date-muuttujaa, sinun täytyy korvata se created_at-muuttujalla.

Tältä sivulta löydät luettelon muuttujista, jotka sinun on ehkä korvattava uusilla muuttujilla Shopify Order Printer ‑sovelluksessa.

Tällä sivulla

Huomioitavaa mallien siirtämisessä

Ennen kuin siirrät mallit Shopify Order Printer ‑sovellukseen, tarkista seuraavat seikat:

Mallien siirtäminen Shopify Order Printer ‑sovellukseen

Jos sinulla on jo malleja vanhasta Order Printer -sovelluksesta, voit tuoda ne Shopify Order Printer -sovellukseen. Et voi tuoda valittuja malleja. Voit tuoda vain kaikki mallisi kerralla.

Vaiheet:

  1. Klikkaa Shopify adminissa Asetukset > Sovellukset ja myyntikanavat.
  2. Klikkaa Order Printer.

  3. Klikkaa Avaa sovellus.

  4. Klikkaa Mallit.

  5. Klikkaa Tuo.

  6. Klikkaa valintaikkunassa Tuo.

  7. Tarkista, käyttääkö mallisi jotain vanhoista muuttujista, ja korvaa ne sitten uusilla muuttujilla.

  8. Esikatsele malleja ja varmista, että mallit näkyvät oikein.

  9. Valinnainen: Tulosta testiasiakirjoja.

Tilausmuuttujien käyttäminen Shopify Order Printer ‑sovelluksessa

Tilausmuuttujia käytetään Shopify Order Printer ‑sovelluksessa eri tavalla. Jotta voit käyttää tilausmuuttujia, sinun on lisättävä order.-etuliite. Jos haluat esimerkiksi käyttää billing_address-muuttujaa, sinun on käytettävä koodia order.billing_address.

Seuraavat yleisesti käytetyt tilausten muuttujat ovat käytettävissä ilman order.-etuliitettä:

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

Jos esimerkiksi haluat käyttää rivikohtien muuttujaa, voit käyttää line_items- tai order.line_items-koodia.

Voit myös luoda mallin omia aliaksia. Voit esimerkiksi käyttää Liquid-syntaksia {% assign fulfillments_count = order.fulfillments | size %} ja viitata siihen käyttämällä koodissasi syntaksia {{ fulfillments_count }}.

Muuttujien kartta

Shopify Order Printer ‑sovellus käyttää vanhasta Order Printer ‑sovelluksesta poikkeavia muuttujia. Jos olemassa olevissa malleissa käytetään mitä tahansa tässä osiossa lueteltuja muuttujia, sinun on korvattava vanhat muuttujat uusilla muuttujilla.

Jos esimerkiksi käytät date-muuttujaa, sinun täytyy korvata se created_at-muuttujalla.

Tilauksen muuttujat

Tilauksen muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
line_items
  • Hyvitettyjä rivikohtia ei sisällytetä line_items-muuttujaan. Tarkista seuraavat tiedot:
    • Voit käyttää hyvitettyjä rivikohtia refunds.<each>.refund_line_items -muuttujan avulla. Katso seuraava esimerkki.
      {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %}
    • Voit halutessasi liittää hyvitetyt rivikohdat line_items-kokoelmaan. Katso seuraava esimerkki.
      {% 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 %}
    • Muista sisällyttää | uniq -suodatin välttääksesi kopion luonnin hyvitetyistä rivikohdista.
  • Tippauksen rivikohtia ei sisällytetä line_items-muuttujaan. Tarkista seuraavat tiedot:
    • Voit käyttää tippauksen rivikohtia tip_line_items-muuttujan avulla.
    • Voit halutessasi liittää tip_line_items-muuttujan line_items-kokoelmaan. Katso seuraava esimerkki.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • Jos haluat jäljitellä vanhaa Order Printer line_items -kokoelmaa, voit käyttää seuraavaa esimerkkikoodia.
    {% 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 Käytä tilauksen kuhunkin tapahtumaan perustuvia maksutietoja transactions.<each>.payment_details -muuttujan avulla.
current_shipping_price shipping_price
päivämäärä Käytä created_at-muuttujaa. Muotoile aikaleima date-suodattimella, esimerkiksi {{ order.created_at | date: "%B %e, %Y" }}.
portaalit unique_gateways tai transactions.<each>.gateway
order_currency valuutta
processed_at Käytä created_at-muuttujaa. Sillä on arvo order.processed_at GraphQL API:stä, ja se tarkoittaa todellista ajankohtaa, jolloin tilausta käsitellään, eikä ajankohtaa, jolloin tilaus tuodaan Shopifyhin. Se on sama kuin order.processed_at vanhassa Order Printer -sovelluksessa. Voit muotoilla aikaleiman date-suodattimella, esimerkiksi {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

Suodata kohdan order.transactions läpi where-Liquid-syntaksin tyyppi-tilan hakemiseksi tai if-syntaksin sisältävän silmukan hakemiseksi. Katso seuraavat esimerkit.

{% 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" %} Tapahtumatunnus: {{ transaction.id }} Tyyppi: {{ transaction.kind }} Määrä: {{ 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 Suodata kohdan order.transactions läpi where-Liquid-syntaksin tyyppi-tilan hakemiseksi tai if-syntaksin sisältävän silmukan hakemiseksi seuraavan esimerkin mukaisesti.
{% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_lines shipping_methods | first
shipping_lines shipping_methods
show_line_item_taxes tax_lines.size > 0. Voit määrittää sen mallin alussa muuttujaksi ja viitata siihen useaan kertaan, kuten seuraavassa esimerkissä.
{% 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-muuttujat

Lineitem-muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
fulfillable_quantity quantity - successfully_fulfilled_quantity
jaeltu quantity == successfully_fulfilled_quantity
nimi otsikko
product_title product.title
unit_discount quantity ? line_level_total_discount / quantity : 0
variant_title variant.title
weight grammat

Tilauksen käsittelyyn sen saamisesta asiakkaalle toimittamiseen liittyvät muuttujat

tilauksen täyttämisen muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
päivämäärä created_at

Kauppaan liittyvät muuttujat

Kaupan muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
omistaja account_owner.name
osoite shop.address.address1
address2 shop.address.address2
city shop.address.city
maa shop.address.country
country_code shop.address.country_code
province shop.address.province
province_code shop.address.province_code
postinumero shop.address.zip

Osoitemuuttujat

Osoitemuuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
leveysaste Jos muuttujaan address viitataan location-määritteessä, leveys- ja pituusaste ovat käytettävissä suoraan location-objektissa.
pituusaste Jos muuttujaan address viitataan location-määritteessä, leveys- ja pituusaste ovat käytettävissä suoraan location-objektissa.

Maksun palauttamiseen liittyvät muuttujat

Hyvitykseen liittyvä muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
päivämäärä Käytä created_at-muuttujaa. Muotoile aikaleima date-suodattimella, esimerkiksi {{ order.created_at | date: "%B %e, %Y" }}.

ShippingLine-muuttujat

ShippingLine-muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
current_price hinta
hinta original_price

Tapahtumamuuttujat

Seuraavat tapahtumamuuttujat on poistettu, eikä niitä voi korvata Shopify Order Printer ‑sovelluksessa:

  • authorization
  • message
  • test

Versioiden muuttujat

version muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
grammat weight

Metakenttämuuttujat

Jotta voit käyttää metakenttää, sinun on määritettävä metakentän Nimiavaruus, mutta sinun ei tarvitse lisätä .value-arvoa muuttujaan. Lisätietoja metakenttämääritelmistä.

Käytä product.metafields.manufacturerid.value-muuttujan sijaan esimerkiksi product.metafields.custom.manufacturerid -muuttujaa.

Jos haluat tunnistaa kunkin metakentän Nimiavaruuden arvot, katso Shopify Adminin Mukautetut tiedot -sivua. Metakenttämääritelmät ryhmitellään niiden objektien mukaan, joihin ne viittaavat, kuten tuotteet, versiot tai tilaukset.

Suodatinten kartta

Suodatinten kartta
Suodattimen nimi vanhassa Order Printer -sovelluksessa Suodattimen nimi uudessa Shopify Order Printer -sovelluksessa
files_url file_url
payment_method ja payment_methods Käytä transaction.gateway_display_name ‑kenttää tilaustapahtumille. Maksutapoja ei enää luokitella eri tyyppeihin, kuten {luottokortti, maksukortti, pankkisiirto}. Vanha Order Printer ‑sovellus kartoitti vain pienen alajoukon tällä hetkellä toimivia maksuportaaleja näihin luokkiin. Maksuportaalien tarjoajien on hallinnoitava asiakkaiden käyttämiä maksutapoja omalta puoleltaan.

Valmiina aloittamaan Shopifyssa?

Kokeile ilmaiseksi