機能一覧 料金 ドキュメント 私たちについて ウェブアプリを開く

Yandex Forms

ドキュメントは機械学習を使用して自動的に翻訳されています。

Yandex Forms（旧 Яндекабрьс Forms）との統合により、Yandex Forms に入力されたデータを基に DiMaker で証明書やディプロマ、その他のファイルを自動作成できます。

この統合を活用することで、単にメールでファイルを送信するだけでなく、訪問者がその場でファイルをダウンロードすることも可能になります。

統合の作成

Yandex Forms 統合ページで新しい統合を作成して有効化してください。

各 Yandex Forms のフォームに個別の統合を設定することができます。ただし、統合の設定が同一である場合、複数のフォームに対して一つの統合を共有することも可能です。

Yandex Forms の設定

Yandex Forms の「統合」セクションを開き、アクショングループに新しいアクション「API リクエスト」を追加してください。メール送信の設定は有効化または無効化のいずれでも構いません。

Yandex Forms の「統合」セクション

API データ送信方法の選択メニューでは、「指定されたメソッドによるリクエスト」を選択してください。

Yandex Forms でのデータ送信方法の選択メニュー

リクエスト設定ウィンドウに次の情報を指定してください：

  • URL - https://gramotadel.express/api/v1/yandex-forms/
  • リクエストメソッド - POST

    Yandex Forms で指定する URL とメソッド

  • リクエストボディ - ファイル作成に必要なデータ（name_parameter=value の形式）。各パラメータは別行で記述します。
    • doc_id* - ファイル作成に使用するドキュメントの ID（36 文字の文字列）。ドキュメントページを開いたとき、URL バーから ID を取得できます。このドキュメントはゴミ箱にない状態で、任意のフォルダに保存されている必要があります。

    • mask_* - ファイル作成に使用されるアンケートデータ。各パラメータは mask_ を先頭に、DiMaker ドキュメント内に定義された変数（% 記号のないもの）を続けます。

      例: mask_name は %name、mask_score は %score に対応します。メールアドレス用には mask_email、ファイル名指定用には mask_filename を使用してください。それらの変数名は必ず英字で指定する必要があります（例: mask_фио などキリル文字は不可）。

      パラメータに割り当てるデータの選択メニュー

      例えば、特定の質問への回答をパラメータに割り当てたい場合、「質問への回答」を選択し、その後に適切な質問を選びます。

      ID、メールテンプレート、名前を含むリクエストの例

    • mail_id - メール送信用のテンプレート ID（36 文字の文字列）。テンプレートが開いているときに URL バーから ID を取得します。この変数が指定されていない場合、メールは送信されません。
    • email_send - ファイルを含むメールを送信するタイミング（API 統合ドキュメントを参照）。

    • folder_id - 保存先ディスクフォルダの ID（36 文字の文字列）。フォルダが存在しない場合、最初のファイル作成時に自動的に作成されます。

    • page_id - ドキュメントに複数のページがある場合、使用するページ番号（数値または文字列）。最初のページは 0。複数ページを指定する場合、カンマ区切りで列挙します。

    リクエストボディには、ファイル作成（および必要に応じて配信）に必要なすべてのデータを含めてください。パラメータ doc_id、mail_id、folder_id、page_id は手動またはコンストラクタ経由で送信できます。例として、訪問者の回答に応じてドキュメントを変更する場合、doc_id の値をアンケートの結果として渡せます。

  • ヘッダー - 認証トークンとクライアント UUID。訪問者がファイルを自力でダウンロードしない設定の場合は認証トークンのみ指定してください。
    • ヘッダー名: Authorization, 値: Bearer {トークン}（DiMaker で取得可能）

      DiMaker での認証トークン取得

    • ヘッダー名: X-Client-Uuid, 値: GET パラメータ uuid

      GET パラメータを一つ指定する設定を選択してください。

      Yandex Forms での GET パラメータ指定

      次に uuid と入力してください。

      Yandex Forms での GET パラメータ保存

  • アクション結果のメッセージ表示：非表示設定にする。

リクエスト設定を完了すると、以下のようになります。

設定済みリクエスト例（Yandex Forms）

接続と検証

次に、Yandex Forms の「共有」メニューで公開リンクをコピーします。

Yandex Forms でのリンク共有

そのリンクを DiMaker の統合内「フォームリンク」フィールドに貼り付け、「接続」ボタンをクリックします。

フォームリンクと接続ボタン

接続ウィンドウでいくつかの質問に回答し（回答内容は具体的に関係ありません）、フォームを送信します。すべてが正しく設定されている場合、フォーム送信後にウィンドウが閉じられ、統合画面に「フォームが正しく接続されました」と表示されます。

フォーム送信後に何も起こらない場合は、Yandex Forms 側の統合設定が正しくない可能性があります。DiMaker 側でフォームリンクが正しく入力されているか、Yandex Forms 側でトークンが正しく設定されているかを確認してください。

接続に成功すれば、Yandex Forms のデータを基にファイルを作成する準備が整います。

ファイルのダウンロード

Yandex Forms の統合により、フォーム記入者がその場でファイルをダウンロードできる機能を提供できます。以下を設定してください：

Yandex Forms 設定

「設定」-「送信後のテキストとロジック」セクション内の「送信後のアクション」で「ウェブサイトにリダイレクト」を有効化します。
「ウェブサイトリンク」のフィールドに https://dmkr.io/yg/ を入力
「ボタンのテキスト」に例として 証明書をダウンロード などのテキストを入力
「同じフレームでフォームを表示」を有効化。

ウェブサイトリダイレクト設定（Yandex Forms）

DiMaker 設定

フォームが Yandex Forms で直接開かれずに DiMaker 経由で開かれるよう、DiMaker で X-Client-Uuid パラメータをフォームに渡す必要があります。そのためには、フォームの公開リンクを使用せず、DiMaker 内のページで生成されるコードをコピーし、それをフォームを表示するウェブサイトに挿入してください。

「ドメイン」にはフォームを配置するウェブサイトのドメインを記入します。

フォームを単独で使用する場合は、公開設定を適切に行う必要があります。

ファイルダウンロード機能は、フォームが DiMaker 経由で共有された場合のみ動作します。

機能の仕組み

フォーム記入後、訪問者にウェブサイトへの移動を促します。「ダウンロード」ボタンをクリックするとダウンロードウィジェットが開き、個別データを含むファイルがダウンロード可能となります。

なお、Yandex Forms では https://dmkr.io/yg/ というサイトへの移動メッセージがユーザーに表示されます。これを避けたい場合は、自サイトでページを作成し、そこにリダイレクトまたは