注文またはお客様のメタフィールドからファイルを添付する

多くのアプリでは、注文やお客様に関連するファイル（請求書アプリからの請求書や梱包明細書のPDF、証明書、署名済みの契約書など）が保存されます。「Shopify」は、これらのファイルをメタフィールドに保存します。保存形式は、Shopifyの「ファイル」内のファイル、またはファイルへのリンクのいずれかとなります。このアプリを使えば、手動でファイルをアップロードしたりリンクを設定したりすることなく、Shopify Flowワークフローが送信するメールにそのファイルを添付することができます。

仕組みについて

別のアプリ（あるいはあなた自身）が、そのファイル、またはそのファイルへのリンクを、注文やお客様のメタフィールドに書き込みます。Shopifyの管理画面では、「設定」＞「カスタムデータ」＞「注文」（または**「お客様**」）の項目に、ファイル型、URL型、あるいはアプリがリンクを書き込むテキストフィールドの定義があります。
メールのレイアウトでは、添付ファイルを追加し、そのソースとして「**メタフィールド」**を選択した後、その定義を選択します。ピッカーには、各定義がどのような内容を含んでいるか（ファイル、リンク、あるいはその両方のリスト）が表示されます。
Shopify Flowでは、**「トランザクションメールを送信」または「マーケティングメールを送信」**ステップに、「注文」フィールドと「顧客」フィールドがあります。Flowはこれらをトリガーから自動的に入力するため、「_注文の作成」_によって開始されたワークフローでは、どの注文であるかが最初から把握されています。
メールが送信されると、アプリはその注文またはお客様のメタフィールドを読み取り、ファイル（Shopifyの「ファイル」から、またはリンク先から）をダウンロードして、添付します。リスト型のメタフィールドの場合は、すべてのエントリが添付されます。

このレイアウトでは、メタフィールドの名前のみが指定されています。どの注文やお客様のものかはワークフローで指定されるため、1つのレイアウトですべての注文に対応できます。

ファイルとリンク

このメタフィールドには、	定義の種類	このアプリの機能
Shopifyファイル	ファイル、ファイル一覧	「ファイル」内のファイルへの参照を追跡し、そのファイルをダウンロードします
リンク	URL、URLの一覧、またはテキスト入力欄	そのリンクからファイルをダウンロードします。`https://`形式のリンクのみが有効です。応答がないリンク、またはPDF、画像、CSV、テキストファイル以外のものを指しているリンクの場合、以下の理由により送信に失敗します。

いずれにせよ、サイズの確認はメール送信時に行われ、エディタ内では行われないため、メタフィールドの添付ファイルはエディタ上の添付ファイル総数には含まれません。

設定してください

リッチテキストおよびHTMLレイアウト

エディタの下部にある「添付ファイル」カードで、**「メタフィールドから追加」をクリックしてください。「注文」**または「お客様」を選択し、定義を選択してください。行には、定義の名前、その内容、およびnamespace.keyが表示されます。「変更」をクリックすると、別の定義を選択できます。

視覚的なレイアウト

「添付ファイル」ブロックを追加（または開く）し、そのソースを「メタフィールド」に切り替えてください。「メタフィールドを選択」を選ぶと、同じピッカーが開きます。

権限

このアプリは、ストアデータへのアクセス権限なしでインストールされます。注文またはお客様のメタフィールドを初めて選択する際、ピッカーは、そのリソースのメタフィールドおよびそれらが指すファイルを読み取る許可を求めます。Shopifyでは独自の同意ダイアログが表示されます。「更新」をクリックすると、定義の一覧が読み込まれます。

アプリの**「権限」**ページでは、いつでもすべての権限を確認・取り消すことができます。ある権限を取り消すと、そのメタフィールドからファイルが添付されたすべてのメールは、その権限が再度付与されるまで送信できなくなります。各権限の具体的な内容や適用範囲については、権限：アプリがストアから読み取れる情報をご覧ください。

ファイル名

デフォルトでは、添付ファイルにはファイル自体の名前（Shopifyの「ファイル」に表示されている名前、またはリンクの末尾部分）が保持されます。「ファイル名」フィールドでこれを上書きすることができ、Liquidもサポートされています（例：invoice-{{ variables.order_name }}.pdf）。リストメタフィールドに複数のエントリがある場合、2番目以降のエントリには、上書きされた名前に「-2」や「-3」が追加されます。

メタフィールドが空の場合

ファイルを作成するアプリは、トリガーから数秒後に実行されることが多いため、メールステップが実行される時点では、メタフィールドがまだ空のままである可能性があります。その場合の挙動は、添付ファイルの「**オプション」**チェックボックスの設定によって異なります：

任意	行動
オフ（既定値）	メールはまだ送信されていません。アプリがShopify Flowにこのステップの再試行を指示すると、Shopify Flowは少し後に再送信を行います。ファイルが準備でき次第、メールは送信されます。
～について	このメールには、この添付ファイルは含まれていません。

必ず記載が必要な請求書については、この設定をオフにしておいてください。一部の注文にのみ含まれるファイルについては、この設定をオンにしてください。

要件と制限

「Shopify Flow」ステップでは、「注文」または**「お客様」**フィールドの設定が必要です。このリリース以前に追加されたステップには、まだこれらのフィールドがありません。フローエディタでそのステップを削除し、再度追加してください。
1ファイルあたり最大10** MB**までのファイル。PDF、画像、CSV、プレーンテキスト、カレンダーファイルが対象です。動画や3Dモデルは対象外となります。
リンクは「https://」で始まり、ログインなしでアクセスできるものでなければなりません。https以外のアドレスやプライベートネットワークへリダイレクトするリンクは拒否されます。
**過去60日間の注文です。**Shopifyでは、アプリが読み取れるのは直近の注文のみです。それより古い注文に対してワークフローを実行しようとすると、明確なメッセージが表示され、送信に失敗します。
Microsoft 365 では、添付ファイルの合計サイズが 4 MB を超えるメッセージは拒否されます。詳細については、添付ファイルと画像をご覧ください。

「歴史」で見られるもの

すべての結果は「履歴」ページに表示されます。注文のないステップ、取り消された許可、Shopifyが検出できない注文、応答のないリンク、または制限を超えるファイルは、「失敗」として記録され、その理由と修正すべき点が明記されます。「Optional」がオフになっている空のメタフィールドは失敗とはみなされません。Shopify Flowでは再試行が表示され、ファイルが用意され次第、送信が表示されます。「履歴」からの再送信では、同じ注文またはお客様が再度読み込まれます。

試してみてください

レイアウトエディタからテストメールを送信する場合、参照すべき注文やお客様が存在しないため、メタフィールドの添付ファイルなしで送信されます。添付ファイルをテストするには、すでにファイルが登録されている注文に対して「Shopify Flow」でワークフローを実行するか、そのような注文を使用して「Shopify Flow」のテストを実行してください。