作成フォーム
証明書やディプロマなど、あなたのサイトでファイルを自動的に作成します。 サイトの訪問者がフォームに入力するだけで、ファイルを受け取ることができます。
ファイルの作成をするには、サイトにHTMLフォームを作成する必要があります。これが不可能な場合は、作成ウィジェットを使用してください。
フォームの作成
DiMakerでファイル作成のリクエストを送信するには、サイトにフォームを作成する必要があります。 このフォームは、サイトの公開部分にも非公開部分にも配置できます。CMSを使ってページとそのページ上のフォームを作成してください。
フォームのAction
https://dimaker.app/api/v1/webform-create/フォームのフィールド
以下の値を持ついくつかの隠しフィールドを作成してください:
-
secure*
トークン (36文字の文字列)
-
doc_id*
ファイル作成に使用するドキュメントのID (36文字の文字列)。ドキュメントが開いているときにアドレスバーでIDを取得できます。このドキュメントはゴミ箱には入っておらず、文書フォルダのどこにでも配置されているかもしれません。
-
mail_id
電子メールで送信する場合のテンプレートID (36文字の文字列)。テンプレートが開いているときにアドレスバーでIDを取得できます。変数が渡されていない場合、メールは送信されません。
-
email_send
ファイルと一緒にメールを送信する時間。次の値が使用できます：
onfinish - 全ファイル作成後にメールを送信 (デフォルト)
oncreate - ファイル作成後すぐにメールを送信。1つのファイル作成時、onfinishとoncreateは同じです。
timeout - 一定の時間後にメールを送信。この場合、次の2つのパラメータを追加で渡す必要があります：
email_timeout_value - 送信までの間隔の数値、整数値
email_timeout_unit - 間隔の単位。 "m" (分), "h" (時間), "d" (日) のいずれかを指定できます。
または、指定した時刻に送信するには、unix時間形式で時間をemail_timeout_timestampに渡す必要があります。timeoutとemail_timeout_timestampの両方が渡された場合、後者が優先されます。 -
storage_period
ディスク上のファイル保存期間。このパラメータが指定されていない場合、削除されるまでファイルは無期限に保存されます。時間経過後に削除するには、次の値を指定する必要があります：
timeout。この場合、次の2つのパラメータを追加で渡す必要があります：
storage_period_timeout_value - 削除までの間隔の数値、整数値
storage_period_timeout_unit - 間隔の単位。 "m" (分), "h" (時間), "d" (日) のいずれかを指定できます。
または、削除時刻を指定するには、unix時間形式で時間をstorage_period_timeout_timestampに渡す必要があります。storage_period_timeout_valueとemail_timeout_timestampの両方が渡された場合、後者が優先されます。 -
folder_id
ディスク内のフォルダID (36文字の文字列) は、ファイルを保存する。フォルダが存在しない場合、最初のファイル作成時に自動的に作成されます。
-
page_id
ドキュメントに複数ページがある場合のページ番号 (数値または文字列)。1つの番号 ( 最初のページは0 ) または作成に使用するページ番号をカンマで区切って渡すことができます。
ファイル作成後に自分にメールを送信
ファイルが作成され次第、そのファイルはアカウントの電子メールに送られます。「メールテンプレート」フィールドで送信に使用するテンプレートを選択できます。 メールテンプレートで、アカウントのメールに送るための専用テンプレートを作成可能です。 メールテキスト内に%dataと書くと、その位置にファイルのすべてのデータがテーブル形式で追加されます。
スクリプトとスタイル
統合ページでコードを取得し、ページのHEADまたは任意の場所に挿入してください。サイトのすべてのページにこのコードを挿入しないでください。このコードはフォームがあるページだけに挿入する必要があります。
さらに、idがresult-successとresult-dangerの2つのブロックを作成する必要があります。両方のブロックは非表示で、スタイルはdisplay:none;です。 最初のブロックには、ファイルが正常に作成されたときのメッセージを記入できます。このブロックは正常にリクエストされたときに表示されます。 エラーが発生した場合、idがresult-dangerのブロックが表示されます。 エラーメッセージは自動的にブロックに挿入されます。
ドキュメントへの差し込み
ドキュメントには少なくとも1つの変数を含める必要があり、例として%nameや%courseがあります。フォームに変数名がmask_で始まるフィールドを追加します。例としてmask_nameまたはmask_courseです。訪問者が入力したデータは、ドキュメントのテキスト内の対応する変数に置き換えられます。電子メールアドレスを指定するには、mask_email変数を使用してください。 複数のアドレスにメールを送信するには、カンマやスペースで分離してください。その際、送信状況はディスク上で最初のアドレスに基づいて表示されます。
フォームの機能
フォームを作成した後、公開済みのページを開いてフォームの機能を確認できます。ファイルが作成され、ダウンロード用のポップアップウィンドウに表示されます。
1つのドキュメント = 1つの記入
ご希望に応じて、フォームの記入回数を制限することができます。 すでに指定されたメールアドレスでdoc_idでファイルが作成されている場合は、ファイルは1つだけ作成できる旨の警告が表示されます。
私の文書
人のドキュメントをサイトの非公開部分に表示することができます。そのためには、上記のようにフォームを作成してください。その後、email、secure、doc_idの隠しフィールドを追加します。最初のフィールドには訪問者のメールアドレスを入力し、最後のフィールドにallという値を入力します。このページを開くと、訪問者はフォームの代わりにドキュメントの一覧を見たり、ダウンロードすることができます。すでに訪問者がフォームを記入済みの場合、フォームの代わりにその人のファイルを表示するには、メールフィールドを非表示にし、お手持ちのCMSで自動的に入力するようにしてください。