Workflow Transactional EmailWorkflow Transactional Email
Vedhæft en fil fra en ordre eller et kundemetafelt

Vedhæft en fil fra en ordre eller et kundemetafelt

Kopier side

Vedhæft automatisk en fil fra et ordre- eller kundemetafelt til e-mails sendt via Shopify Flow. Se opsætning, tilladelser og begrænsninger.

Mange apps gemmer en fil i forbindelse med en ordre eller en kunde: en faktura eller en pakkeseddel i PDF-format fra en faktureringsapp, et certifikat eller en underskrevet kontrakt. »Shopify« gemmer den i et metafelt, enten som en fil i dine Shopify-filer eller som et link til filen. Denne app kan vedhæfte den pågældende fil til den e-mail, som en Shopify Flow-arbejdsgang sender, uden at du behøver at uploade eller linke noget manuelt.

Sådan fungerer det

  1. En anden app (eller dig selv) skriver filen - eller et link til den - ind i et metafelt i ordren eller kundedataene. I din Shopify-administrationspanel finder du dette under Indstillinger > Brugerdefinerede data > Ordrer (eller Kunder): en definition af typen Fil, URL eller et tekstfelt, hvor en app skriver et link ind.
  2. I et e-mail-layout tilføjer du en vedhæftet fil og vælger »Metafelt« som kilde, hvorefter du vælger den pågældende definition. I vælgeren vises det, hvad de enkelte indeholder: en fil, et link eller en liste over begge dele.
  3. I »Shopify Flow« indeholder trinnet »Send transaktions-e-mail« eller »Send markedsførings-e-mail« felterne »Ordre« og »Kunde«. Flow udfylder disse felter ud fra udløseren, så et workflow, der startes af »Ordre oprettet«, allerede ved, hvilken ordre der er tale om.
  4. Når e-mailen sendes, læser appen det pågældende metafelt for den pågældende ordre eller kunde, henter filen (fra dine »Shopify-filer« eller via linket) og vedhæfter den. Et liste-metafelt vedhæfter alle poster.

I layoutet angives kun navnet på metafeltet. Det er arbejdsgangen, der angiver, hvilken ordre eller hvilken kunde der er tale om, så ét layout dækker alle ordrer.

Et nyligt tilføjet trin »Send transaktions-e-mail« i Shopify Flow, hvor feltet »Order« er indstillet til »order.id« og feltet »Customer« til »order.customer.id«, placeret over felterne »Til«, »CC« og »BCC«
Trinnet i »Shopify Flow«: »Ordre« og »Kunde« udfyldes fra udløseren, her en ordre-arbejdsgang. Et trin, der er tilføjet før version 1.17, indeholder ikke disse felter; slet det og tilføj det igen.
Metafeltet indeholder Definitionstype Hvad appen kan
En fil fra »Shopify« Fil, Liste over filer Følger henvisningen til filen i din mappe »Filer« og henter den
Et link URL, liste over URL’er eller et tekstfelt Henter filen fra det pågældende link. Kun links af typen https:// fungerer; et link, der ikke reagerer eller peger på noget andet end en PDF-, billed-, CSV- eller tekstfil, medfører, at afsendelsen mislykkes med følgende årsag

Uanset hvad kontrolleres størrelsen, når e-mailen sendes, ikke i redigeringsprogrammet, så vedhæftede filer fra metafelter tæller ikke med i redigeringsprogrammets samlede antal vedhæftede filer.

Konfigurer det

Rich Text- og HTML-layouter

Klik på »Tilføj fra metafelt« på fanen »Vedhæftede filer« nederst i redigeringsvinduet. Vælg »Ordre« eller »Kunde« og derefter definitionen. Rækken viser definitionens navn, hvad den indeholder, og dens namespace.key; klik på »Skift« for at vælge en anden.

Fanen »Vedhæftede filer« i et rich text-layout med knapperne »Tilføj vedhæftet fil«, »Tilføj fra URL« og »Tilføj fra metafelt«
Fanen »Vedhæftede filer« i et rich text- eller HTML-layout: »Tilføj fra metafelt« ved siden af knapperne til upload og URL.

Visuelle layout

Indsæt en vedhæftningsblok (eller åbn en), og skift dens kilde til »Metafelt«. Når du vælger »metafelt«, åbnes den samme vælger.

En vedhæftningsblok i den visuelle builder, hvor kilden er skiftet til Metafelt, knappen »Vælg metafelt«, overskrivning af filnavn og afkrydsningsfeltet »Valgfrit«
Vedhæftningsblokken med Metafelt som kilde: Vælg definitionen, ændr filnavnet, og afgør, om et tomt metafelt skal forhindre, at e-mailen sendes.
Dialogboksen »Vedhæft en fil fra et metafelt«, hvor »Ordre« er valgt som ressource, og definitionerne »Faktura-PDF (fil)« og »Faktura-URL (link)« vises under et søgefelt
Vælgeren: Først »Ordre« eller »Kunde«, derefter definitionerne af den pågældende ressource, hver med angivelse af indholdet. PDF-filen med fakturaen er valgt.
Vælg-blokken efter valg af metafeltet: Faktura-PDF, Fil, Ordre custom.invoice_pdf, knappen »Rediger metafelt«, overskrivning af filnavn og afkrydsningsfeltet »Valgfrit«
Blokken efter valget: definitionens navn, dens indhold og dens navneplads.key. Vælg et andet metafelt.

Tilladelsen

Appen installeres uden adgang til dine butiksdata. Første gang du vælger en ordre eller et kundemetafelt, beder vælgeren om tilladelse til at læse den pågældende ressourcens metafelter og de filer, de henviser til. Shopify viser sin egen samtykkedialog; efter »Opdater« indlæses listen over definitioner.

Du kan til enhver tid gennemgå og tilbagekalde alle tilladelser på appens side »Tilladelser«. Hvis du tilbagekalder en tilladelse, vil alle e-mails, der indeholder en vedhæftet fil fra et sådant metafelt, mislykkes, indtil tilladelsen gives igen. Hvad de enkelte tilladelser dækker, og hvad de ikke dækker, kan du læse på Tilladelser: Hvad appen har adgang til i din butik.

Siden »Tilladelser«, hvor »Ordrer« og »Filer« vises som »Bevilget« med knapperne »Tilbagekald«, og »Kunder« og »Rabatter« vises som »Ikke bevilget« med knapperne »Bevilg«, hver med deres respektive anvendelsesområde
Siden »Tilladelser«: hver valgfri tilladelse med sit anvendelsesområde, uanset om den er tildelt eller ej, samt en knap til at tildele eller tilbagekalde den. Her blev »Ordrer« og »Filer« tildelt via vælgeren.

Filnavn

Som standard beholder vedhæftningen filens eget navn: navnet i dine »Shopify-filer« eller den sidste del af linket. Feltet »Filnavn« tilsidesætter dette og supporterer Liquid, f.eks. invoice-{{ variables.order_name }}.pdf. Når et liste-metafelt indeholder flere poster, tilføjes -2 og -3 til den tilsidesatte betegnelse for den anden og de efterfølgende poster.

Når metafeltet er tomt

Den app, der skriver filen, kører ofte et par sekunder efter udløseren, så i det øjeblik e-mail-trinnet udføres, kan metafeltet stadig være tomt. Hvad der så sker, afhænger af afkrydsningsfeltet »Valgfrit« for vedhæftningen:

Valgfrit Adfærd
Fra (standard) E-mailen er endnu ikke sendt. Appen beder Shopify Flow om at gentage trinnet, og Shopify Flow sender den igen lidt senere; e-mailen sendes, så snart filen er tilgængelig.
Den E-mailen sendes uden denne vedhæftede fil.

Lad feltet være tomt for en faktura, hvor det skal være med. Udfyld det for en fil, som kun nogle ordrer har.

Krav og begrænsninger

  • I Shopify Flow-trinnet skal feltet »Ordre« eller »Kunde« udfyldes. Trin, der blev tilføjet før denne udgivelse, har endnu ikke disse felter: Slet trinnet i Shopify Flow-editoren, og tilføj det igen.
  • Filer på op til 10 MB hver; PDF-, billed-, CSV-, almindelig tekst- og kalenderfiler. Videoer og 3D-modeller springes over.
  • Links skal begynde med https:// og være tilgængelige uden login. Et link, der omdirigerer til en adresse, der ikke er https, eller til et privat netværk, afvises.
  • Ordrer fra de seneste 60 dage. Shopify tillader kun, at apps læser de seneste ordrer. Hvis man forsøger at udføre en arbejdsgang på en ældre ordre, mislykkes afsendelsen med en tydelig fejlmeddelelse.
  • Microsoft 365 afviser meddelelser med vedhæftede filer, der samlet set fylder mere end 4 MB; se Vedhæftede filer og billeder.

Hvad man ser i faget Historie

Alle resultater vises på siden »Historik«. Et trin uden en ordre, en tilbagekaldt tilladelse, en ordre, som Shopify ikke kan finde, et link, der ikke reagerer, eller en fil, der overskrider grænsen, registreres som »Mislykket« med angivelse af årsagen og hvad der skal ændres. Et tomt metafelt med "Valgfrit" slået fra er ikke en fejl: Shopify Flow viser forsøgene, og afsendelsen vises, så snart filen er til stede. En "Genafsend" fra "Historik" henter den samme ordre eller kunde igen.

En historikbegivenhed for en e-mail med returvejledning, hvor anmodningsdataene indeholder ordre-id’et for den ordre, som fakturaen stammer fra
En e-mail med en vedhæftet fil fra et metafelt i Historik: Anmodningsdataene registrerer, hvilken ordre der blev læst, så en genudsendelse læser den igen.

Prøv det

Funktionen »Send test-e-mail« i layoutredigeringsværktøjet har ingen ordre eller kunde at hente oplysninger fra, så den sender e-mailen uden vedhæftede metafeltfiler. For at teste vedhæftningen skal du køre arbejdsgangen i Shopify Flow på en ordre, der allerede indeholder filen, eller bruge testen »Kør på en Shopify Flow« med en sådan ordre.

Relateret