Tuotujen Order Printer -mallien ongelmien vianmääritys

Kun siirrät mallisi vanhasta Order Printer -sovelluksesta uuteen Shopify Order Printer -sovellukseen, Liquid-muuttujasi päivitetään uuden sovelluksen kanssa yhteensopivuuden varmistamiseksi. Harvinaisissa tapauksissa saatat joutua tekemään tuotujen mallien vianmäärityksen.

Jos tuodut mallit eivät tulostu oikein, sinun on ehkä muokattava mallisi koodia manuaalisesti uudessa Shopify Order Printer -sovelluksessa. Tutustu seuraaviin yleisimpiin syihin, joiden vuoksi mallien tuonti ei välttämättä onnistu oikein:

Mallit sisältävät mukautettua CSS:ää
Mallit sisältävät metakenttiä
Liquid-muuttujat eivät ehkä päivity oikein

Tällä sivulla on yksityiskohtaisia tietoja mahdollisten ongelmien vianmäärityksestä, kun tuot mukautettuja mallejasi uuteen Shopify Order Printer -sovellukseen.

Tällä sivulla

Yleisten CSS-ulkoasumukautusten päivittäminen

Jos siirtämissäsi malleissa on mukautettua CSS:ää, sinun on ehkä päivitettävä mallien CSS-koodi manuaalisesti, jotta ulkoasuelementit, kuten kuvat, mukautetut fontit, logot tai viivakoodit, näkyvät oikein.

Metakenttämuuttujien päivittäminen

Jotta voit käyttää metakenttää, sinun on määritettävä sen nimiavaruus, eikä sinun tarvitse lisätä muuttujaan .value-osaa. Lue lisää metakenttämääritelmistä.

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

Voit tunnistaa kunkin metakentän nimiavaruusarvot Shopifyn ohjausnäkymäsi Mukautetut tiedot -sivulta. Metakenttämääritelmät on ryhmitelty niiden objektien mukaan, joihin ne viittaavat, kuten tuotteet, versiot tai tilaukset.

Yleisten Liquid-muuttujien päivittäminen

Useimmissa tapauksissa Liquid-muuttujasi päivittyvät automaattisesti siirron aikana. Jos mallejasi ei kuitenkaan siirretä oikein ja käytät joitakin tässä osiossa luetelluista muuttujista, sinun on ehkä korvattava vanhat muuttujat uusilla manuaalisesti. Shopify Order Printer -sovellus käyttää eri muuttujia kuin vanha Order Printer -sovellus.

Jos esimerkiksi käytät date-muuttujaa, sinun on korvattava se created_at-muuttujalla.

Tilausmuuttujat

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

Seuraavat yleisesti käytetyt tilausmuuttujat 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ää muotoa line_items tai order.line_items.

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

Tilausmuuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`line_items`	Palautetut rivikohdat eivät sisälly `line_items` -muuttujaan. Tarkastele seuraavia tietoja: Pääset hyvitettyihin rivikohtiin `refunds.<each>.refund_line_items`-muuttujan avulla. Katso seuraava esimerkki. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` Voit halutessasi yhdistää 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 %}` Varmista, että sisällytät `\| uniq` -suodattimen, jotta vältät palautettujen rivikohtien kopioitumisen. Juomaraharivikohdat eivät sisälly `line_items` -muuttujaan. Tarkastele seuraavia tietoja: Pääset käsiksi juomaraharivikohtiin `tip_line_items`-muuttujalla. Voit halutessasi lisätä `tip_line_items`-kohteet `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 Printerin `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 kunkin maksutapahtuman maksutietoja `transactions.<each>.payment_details`-muuttujan avulla.
`current_shipping_price`	`shipping_price`
`date`	Käytä `created_at`-muuttujaa. Käytä `date`-suodatinta aikaleiman muotoiluun, esimerkiksi `{{ order.created_at \| date: "%B %e, %Y" }}`.
`gateways`	`unique_gateways` tai `transactions.<each>.gateway`
`order_currency`	`currency`
`processed_at`	Käytä `created_at`-muuttujaa. Se sisältää GraphQL API:n arvon `order.processed_at`, ja se tarkoittaa tilauksen todellista käsittelyaikaa sen ajan sijaan, jolloin tilaus tuodaan Shopifyhin. Se on sama kuin vanhan Order Printer -sovelluksen `order.processed_at`. Voit muotoilla aikaleiman `date`-suodattimella, esimerkiksi seuraavasti: `{{ order.created_at \| date: "%B %e, %Y" }}`.
`payment_transactions`	Suodata `order.transactions` `kind`-tilan mukaan Liquid-syntaksilla käyttämällä where-suodatinta tai silmukkaa ja `if`-lausetta. 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" %} Maksutapahtuman tunnus: {{ transaction.id }} Laji: {{ transaction.kind }} Summa: {{ 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 `order.transactions` `kind`-tilan osalta Liquid-syntaksissa käyttämällä where-suodatinta tai silmukkaa ja sen sisäistä `if`-lausetta, kuten seuraavassa esimerkissä. `{% 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`. Voit määrittää sen muuttujaksi mallin alussa ja viitata siihen useita kertoja, 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`

Tilausrivin muuttujat

Tilausrivin muuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`fulfilled`	`quantity == successfully_fulfilled_quantity`
`name`	`title`
`product_title`	`product.title`
`unit_discount`	`quantity ? line_level_total_discount / quantity : 0`
`variant_title`	`variant.title`
`weight`	`grams`

Tilauksen täyttämisen muuttujat

Tilauksen täyttämisen muuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`date`	`created_at`

Kaupan muuttujat

Kaupan muuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`owner`	`account_owner.name`
`address`	`shop.address.address1`
`address2`	`shop.address.address2`
`city`	`shop.address.city`
`country`	`shop.address.country`
`country_code`	`shop.address.country_code`
`province`	`shop.address.province`
`province_code`	`shop.address.province_code`
`zip`	`shop.address.zip`

Osoitemuuttujat

Osoitemuuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`latitude`	Jos `address`-muuttujaan viitattiin `location`-attribuutista, leveys- ja pituusaste ovat saatavilla itse `location`-objektissa.
`longitude`	Jos `address`-muuttujaan viitattiin `location`-attribuutista, leveys- ja pituusaste ovat saatavilla itse `location`-objektissa.

Maksunpalautuksen muuttujat

Maksunpalautuksen muuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`date`	Käytä `created_at`-muuttujaa. Käytä `date`-suodatinta aikaleiman muotoiluun, esimerkiksi `{{ order.created_at \| date: "%B %e, %Y" }}`.

Toimitusrivin muuttujat

Toimitusrivin muuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`current_price`	`price`
`price`	`original_price`

Maksutapahtuman muuttujat

Seuraavat maksutapahtumamuuttujat on poistettu, eikä niitä voi korvata Shopify Order Printer -sovelluksessa:

authorization
message
test

Version muuttujat

Version muuttuja
Muuttuja vanhassa Order Printer -sovelluksessa	Muuttuja uudessa Shopify Order Printer -sovelluksessa
`grams`	`weight`

Metakentän muuttujat

Jotta voit käyttää metakenttää, sinun on määritettävä metakentän Namespace, eikä sinun tarvitse lisätä .value-arvoa muuttujaan. Lue lisää metakenttämääritelmistä.

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

Voit tunnistaa kunkin metakentän Namespace-arvot Shopifyn ohjausnäkymän Mukautetut tiedot -sivulta. Metakenttämääritelmät on ryhmitelty niiden objektien mukaan, joihin ne viittaavat, kuten tuotteet, versiot tai tilaukset.

Suodattimien vastaavuus

Suodattimien vastaavuus
Suodattimen nimi vanhassa Order Printer -sovelluksessa	Suodattimen nimi uudessa Shopify Order Printer -sovelluksessa
`files_url`	`file_url`
`payment_method` ja `payment_methods`	Käytä tilauksen maksutapahtumissa transaction.gateway_display_name -kenttää. Maksutapoja ei enää luokitella tietyntyyppisiksi, kuten `{luottokortti, pankkikortti, pankkisiirto}`. Vanha Order Printer -sovellus yhdisti vain pienen osan nykyisin toimivista maksuportaaleista näihin luokkiin. Maksuportaalipalveluntarjoajat hallinnoivat asiakkaiden käyttämien maksutapojen tyyppejä.