[Email DLP] 設定ファイルのカラム (Secure Download for Box タイプ) – HENNGE One ヘルプセンター

対象

Email DLP の初期設定や、運用管理を行う管理者

目的

Secure Download タイプ設定ファイルのカラム（項目）について説明します。
設定ファイルを利用することで Email DLP の設定を一括で登録、更新することができます。
設定ファイルの作成方法およびインポート手順は、次の記事をご参照ください。
Email DLP インポートデータ (設定ファイル) 作成について

注意事項

本記事の内容は 2025 年 12 月時点での製品仕様に基づき作成しており、以後予告なく変更される場合があります。
実際の画面確認や、設定の変更には Email DLP の管理者権限が必要です。
管理者の設定方法は、以下の記事をご参照ください。
Email DLP 管理者権限の設定
Email DLP 管理画面へのアクセス方法は下記の記事を参照してください。
[Email DLP] 管理画面へのログイン方法

内容

ファイル形式は YAML と JSON に対応しています。
ユニークキーは、「name」（Secure Download タイプの名前）です。
「上書き」の場合、ユニークキーに付随する情報は丸ごと上書きされます。
一部だけを修正する場合、Secure Download タイプ単位で必要な情報をすべて記載してください。

カラム

カラム	説明
version	1 を指定します。（固定値）
box_upload_configs	次行以降に指定した Secure Download for Box タイプを作成します。
name	Secure Download for Box タイプの名前を指定します。
options	Secure Download for Box タイプのオプションを次行以降で指定します。
pdf	リンク送付方法が PDF の場合に記載し、次行以降に basename と language_order を記載します。
basename	PDF ファイル名を指定します。
language_order	PDF の言語と順番を指定します。・ja-JP：日本語・en-US：英語・zh-TW：繁体中国語・zh-CN：簡体中国語 ※複数言語の指定が可能です。優先したい順に記載してください。記載した順のページ構成で PDF が生成されます。
msg_body	リンク送付方法がメール本文の場合に記載し、次行で language を記載します。
language	メッセージの言語を指定します。・ja-JP：日本語・en-US：英語・zh-TW：繁体中国語・zh-CN：簡体中国語
custom_template	メール本文にカスタムテンプレートを使用する場合、内容を記載します。
template_name	カスタムテンプレートの名称を指定します。
use_custom_template	カスタムテンプレートを使用する場合、trueを記載します。
use_msg_body	メール本文のリンク送付方法を利用するかどうかを指定します。 ※「use_pdf」と両方の値を false にするとインポートエラーになります。・true ・false
use_pdf	PDFのリンク送付方法を利用するかどうかを指定します。 ※「use_msg_body」と両方の値を false にするとインポートエラーになります。・true ・false
shared_link_expiry_in_days	リンクの有効期限を指定します。 ※1–31日
time_zone	タイムゾーンを指定します。例：日本の場合 Asia/Tokyo と記載します。

作成例

・「PDFとメール本文の両方で送信」のタイプを作成する。
・メール本文の文章はカスタムテンプレートを使用する。

YAML形式

version: 1
box_upload_configs:
- name: PDFで送信
  options:
    pdf:
      basename: hennge_secure_download
      language_order:
      - ja-JP
      - en-US
      - zh-TW
      - zh-CN
    msg_body:
      language: ja-JP
      custom_template: "testTemplate\nダウンロードURL：((%DOWNLOAD-URL%)) \nURL有効期限：((%EXPIRATION-DATE%)) "
      template_name: testTemplate
      use_custom_template: true
    use_msg_body: true
    use_pdf: true
    shared_link_expiry_in_days: 31
    time_zone: Asia/Tokyo

JSON形式

{
"version": 1,
  "box_upload_configs": [
    {
      "name": "PDFで送信",
      "options": {
        "pdf": {
          "basename": "hennge_secure_download",
          "language_order": [
            "ja-JP",
            "en-US",
            "zh-TW",
            "zh-CN"
          ]
        },
          "msg_body": {
          "language": "ja-JP",
          "custom_template": "testTemplate\nダウンロードURL：((%DOWNLOAD-URL%)) \nURL有効期限：((%EXPIRATION-DATE%)) ",
          "template_name": "testTemplate",
          "use_custom_template": true
        },
        "use_msg_body": true,
        "use_pdf": true,
        "shared_link_expiry_in_days": 31,
        "time_zone": "Asia/Tokyo"
      }
    }
  ]
}