Eine Datei aus einem Metafeld für eine Bestellung oder einen Kunden anhängen
Viele Apps speichern eine Datei zur Bestellung oder zum Kunden: eine Rechnung oder einen Lieferschein im PDF-Format aus einer Rechnungsstellungs-App, ein Zertifikat oder einen unterzeichneten Vertrag. Shopify speichert diese Datei in einem Metafeld, entweder als Datei in Ihren „Shopify-Dateien“ oder als Link zu der Datei. Diese App kann diese Datei an die E-Mail anhängen, die ein Shopify Flow versendet, ohne dass Sie etwas manuell hochladen oder verlinken müssen.
So funktioniert es
- Eine andere App (oder Sie selbst) schreibt die Datei oder einen Link zu dieser Datei in ein Metafeld der Bestellung oder des Kunden. In Ihrem Shopify-Adminbereich finden Sie dies unter „Einstellungen“ > „Benutzerdefinierte Daten“ > „Bestellungen“ (oder „Kunden“): eine Definition vom Typ „Datei“, „URL“ oder ein Textfeld, in das eine App einen Link einträgt.
- In einem E-Mail-Layout fügen Sie einen Anhang hinzu, wählen „Metafeld“ als Quelle aus und wählen anschließend die entsprechende Definition aus. Die Auswahlliste zeigt an, was die einzelnen Elemente enthalten: eine Datei, einen Link oder eine Liste aus beidem.
- In Shopify Flow verfügt der Schritt „Transaktions-E-Mail senden“ bzw. „Marketing-E-Mail senden“ über ein Feld „Bestellung“ und ein Feld „Kunde“. Flow füllt diese Felder anhand des Triggers aus, sodass ein durch „Bestellung erstellt“ gestarteter Workflow bereits weiß, um welche Bestellung es sich handelt.
- Wenn die E-Mail versendet wird, liest die App dieses Metafeld der jeweiligen Bestellung oder des jeweiligen Kunden aus, lädt die Datei herunter (entweder aus Ihren „Shopify-Dateien“ oder über den Link) und fügt sie als Anhang hinzu. Bei einem Listen-Metafeld werden alle Einträge als Anhang hinzugefügt.
Im Layout wird lediglich das Metafeld benannt. Aus dem Workflow geht hervor, um welche Bestellung oder welchen Kunden es sich handelt, sodass ein einziges Layout für alle Bestellungen ausreicht.
Dateien und Links
| Das Metafeld enthält | Definitionstyp | Was die App leistet |
|---|---|---|
| Eine Datei von Shopify | Datei, Liste der Dateien | Folgt dem Verweis auf die Datei in Ihren Dateien und lädt diese herunter |
| Ein Link | URL, Liste von URLs oder ein Textfeld | Lädt die Datei über diesen Link herunter. Es funktionieren ausschließlich https://-Links; ein Link, der keine Antwort liefert oder auf etwas anderes als eine PDF-, Bild-, CSV- oder Textdatei verweist, führt zu einem Fehlschlag des Versands mit folgender Begründung: |
In jedem Fall wird die Größe beim Versenden der E-Mail überprüft, nicht im Editor; daher werden Anhänge aus Metafelder nicht zur Gesamtzahl der Anhänge im Editor hinzugerechnet.
Richten Sie es ein
Rich-Text- und HTML-Layouts
Klicken Sie in der Registerkarte „Anhänge“ am unteren Rand des Editors auf „Aus Metafeld hinzufügen“. Wählen Sie „Bestellung“ oder „Kunde“ und anschließend die Definition aus. In der Zeile werden der Name der Definition, ihr Inhalt und ihr namespace.key angezeigt; mit „Ändern“ wählen Sie eine andere aus.
Visuelle Layouts
Fügen Sie einen Anhangsblock hinzu (oder öffnen Sie einen) und stellen Sie dessen Quelle auf „Metafeld“ um. Wenn Sie „Metafeld“ auswählen, wird derselbe Auswahldialog geöffnet.
Die Erlaubnis
Die App wird ohne Zugriff auf Ihre Shop-Daten installiert. Wenn Sie zum ersten Mal ein Metafeld für eine Bestellung oder einen Kunden auswählen, fordert der Selektor Sie auf, die Berechtigung zum Lesen der Metafelder dieser Ressource sowie der Dateien, auf die diese verweisen, zu erteilen. Shopify zeigt einen eigenen Einwilligungsdialog an; nach dem Klicken auf „Aktualisieren“ wird die Liste der Definitionen geladen.
Sie können jede Berechtigung jederzeit auf der Seite „Berechtigungen“ der App einsehen und widerrufen. Der Widerruf einer Berechtigung führt dazu, dass jede E-Mail, die eine Datei aus einem solchen Metafeld enthält, fehlschlägt, bis die Berechtigung erneut erteilt wird. Was die einzelnen Berechtigungen beinhalten und was nicht, finden Sie unter Berechtigungen: Welche Daten die App aus Ihrem Shop auslesen darf.
Dateiname
Standardmäßig behält der Anhang den Namen der Datei bei: den Namen in Ihren „Shopify-Dateien“ oder den letzten Teil des Links. Das Feld „Dateiname“ überschreibt diesen Namen und unterstützt Liquid, zum Beispiel invoice-{{ variables.order_name }}.pdf. Wenn ein Metafeld mehrere Einträge enthält, wird an die Überschreibung für den zweiten und alle folgenden Einträge -2 bzw. -3 angehängt.
Wenn das Metafeld leer ist
Die App, die die Datei schreibt, wird oft erst einige Sekunden nach dem Trigger ausgeführt, sodass das Metafeld zum Zeitpunkt der Ausführung des E-Mail-Schritts möglicherweise noch leer ist. Was dann geschieht, hängt vom Kontrollkästchen „Optional“ des Anhangs ab:
| Optional | Verhalten |
|---|---|
| Aus (Standard) | Die E-Mail wurde noch nicht versendet. Die App weist Shopify Flow an, den Schritt erneut auszuführen, und Shopify Flow versendet sie wenig später erneut; die E-Mail wird versendet, sobald die Datei vorliegt. |
| Am | Die E-Mail wird ohne diesen Anhang versendet. |
Lassen Sie diese Option bei einer Rechnung, die unbedingt vorhanden sein muss, deaktiviert. Aktivieren Sie sie bei einer Datei, die nur bei einigen Bestellungen vorhanden ist.
Anforderungen und Einschränkungen
- Für den Shopify Flow-Schritt muss das Feld „Bestellung“ oder „Kunde“ festgelegt werden. Schritte, die vor dieser Version hinzugefügt wurden, verfügen noch nicht über diese Felder: Löschen Sie den Schritt im Shopify Flow-Editor und fügen Sie ihn erneut hinzu.
- Dateien mit einer Größe von jeweils bis zu 10 MB; PDF-, Bild-, CSV-, Nur-Text- und Kalenderdateien. Videos und 3D-Modelle werden übersprungen.
- Links müssen mit
https://beginnen und ohne Anmeldung aufrufbar sein. Ein Link, der zu einer Nicht-HTTPS-Adresse oder in ein privates Netzwerk weiterleitet, wird abgelehnt. - Bestellungen der letzten 60 Tage. Über Shopify können Apps lediglich die letzten Bestellungen abrufen. Bei einem Workflow, der auf einer älteren Bestellung basiert, schlägt der Versand mit einer eindeutigen Meldung fehl.
- Microsoft 365 lehnt Nachrichten ab, deren Anhänge insgesamt mehr als 4 MB groß sind; siehe Anhänge und Bilder.
Was Sie im Fach Geschichte sehen
Jedes Ergebnis wird auf der Seite „Verlauf“ angezeigt. Ein Schritt ohne Bestellung, eine widerrufene Berechtigung, eine Bestellung, die Shopify nicht finden kann, ein Link, der nicht reagiert, oder eine Datei, die das zulässige Limit überschreitet, wird als „Fehlgeschlagen“ protokolliert, zusammen mit dem Grund und den erforderlichen Änderungen. Ein leeres Metafeld mit deaktivierter Option „Optional“ stellt keinen Fehler dar: Shopify Flow zeigt die Wiederholungsversuche an, und der Versand wird angezeigt, sobald die Datei vorliegt. Bei einem „Erneuten Versand“ aus dem Verlauf wird derselbe Auftrag oder Kunde erneut gelesen.
Probieren Sie es aus
Die Funktion „Test-E-Mail senden“ im Layout-Editor kann auf keine Bestellung und keinen Kunden zurückgreifen, daher wird die E-Mail ohne Anhänge aus den Metafelder versendet. Um den Anhang zu testen, führen Sie den Workflow in „Flow“ für eine Bestellung aus, die die Datei bereits enthält, oder nutzen Sie den Test „In einem Shopify Flow ausführen“ mit einer solchen Bestellung.
Verwandte Themen
- Berechtigungen: Welche Daten die App aus Ihrem Shop auslesen darf - Was die optionalen Berechtigungen beinhalten und wie man sie widerrufen kann.
- Anhänge und Bilder - Hochgeladene Anhänge, „Anhang“ vs. „Link“-Modus und Dateigrößen.
- Daten aus Shopify Flow übergeben - die Schrittfelder und Variablen.
- Hintergrund und Fehlerbehebung - das Auslesen einer fehlgeschlagenen Übertragung.