OK dokument (独立系発行元) (プレビュー)

OK dokument は、既存のシステムにシームレスに統合する、使いやすくカスタマイズ可能な電子署名およびデジタル ドキュメント配布プラットフォームを提供します

このコネクタは、次の製品および地域で利用可能です:

OK dokument - 電子署名

OK dokument は、既存のシステムとシームレスに統合できる、使いやすくカスタマイズ可能な電子署名およびデジタル コンテンツ配信プラットフォームを提供します。

発行者

Seyfor Slovensko、a.s.

前提条件

https://app.okdokument.com のアカウントと OK dokument サービスによって生成された有効な API キーが必要です。

サポートされている操作

1. ドキュメントのアップロード

PDF ファイルをドキュメント署名サービスにアップロードするために使用されるアクション。 このアクションは base64 文字列を受け取り、OK dokument API プラットフォームにアップロードします。

ドキュメントは、その存続期間中にいくつかの状態を通過します。 OK dokument API は次のドキュメント状態を使用します:

• タグ – テキストタグを検索し、署名アクロフィールドを挿入する状態。 アクロ フィールドの挿入が成功すると、状態が自動的に tosign に変更されます
• Tostamp – デジタルスタンプを文書に挿入する状態
• tosign – 署名済みドキュメント
• Signed – 署名されたドキュメント (指定された signatureRequestID 内)
• Errorsendinfo – 情報サービスの呼び出し中にエラーが発生しました
• canceled – キャンセルされた文書 – 署名者が文書内の「キャンセル」ボタンを押しました

シグネチャー アクロフィールド

アクロフィールドは、PDF でサポートされているアクティブ フィールドの一種です。 署名アクロフィールドは、文書の固定位置に署名を挿入できる特殊なタイプのアクティブ フィールドです。 アクロフィールドは、Adobe PRO などの特殊な PDF ツール、または JasperReport などのテンプレート ツールを使用して PDF に挿入できます。

Tags

タグは、API サーバーがスキャンする一意のテキスト値を表します。 見つかった場合は、その場所に署名アクロフィールドを挿入します。 タグ検索は「タグ」ドキュメント状態によって提供されます。これは、JSON/ドキュメント サービスの呼び出し時に設定する必要があります。 OKdokument API は、オプションの署名として次のタグをサポートしています:

_SO1_ _SO2_ _SO3_ _SO4_ _SO5_

OKdokument API は、必須の署名として次のタグをサポートしています: _SC1_ _SC2_ _SC3_ _SC4_ _SC5_

必須タグが使用されている場合は、文書を送信する前に、表示されているすべての必須署名アクロフィールドに署名する必要があります。

SignatureRequest の登録時に署名アクロフィールドまたはタグを含むドキュメントを準備できない場合は、「どこでも署名」機能を有効にすることができます。これにより、ユーザーはクリック/タップするだけで、任意の場所でドキュメントに署名できるようになります

ドキュメントを PDF に変換

OKdokument API は、.doc、.docx、.xls、.xlsx から PDF ファイル形式への変換をサポートしています。 ソース ファイルにはタグも含めることができます。OKdokument API は最初にファイル変換を実行し、次に署名アクロフィールドを自動的に挿入します。

ファイルを PDF に変換するには、ドキュメントの名前を入力する必要があります。 ファイルを PDF 形式に変換する場合、このパラメータは必須です。 変換するには、ファイルの接尾辞は次のようにする必要があります:

• contract.doc
• contract.docx
• contract.xls
• contract.xlsx

文書の保存と削除

OK dokument API は、署名されたドキュメントの永久アーカイブの役割を果たしません。 以下のルールを適用します:

1. 署名された文書は署名から 10 日後に自動的に削除されます
2. 署名のないドキュメントは、アップロード後 30 日経過すると自動的に削除されます

2. シグネチャ リクエスト URL

このアクションは、署名要求 ID を生成するために使用されます。 このアクション内では、ドキュメント ID を使用する必要があります。 ドキュメント ID は、ドキュメントのアップロード アクションの結果です。
このアクションでは、署名プロセスを多段階の署名プロセスに変換できます。 パラメーター「署名フィールド」を追加すると、各署名リクエストで使用できるものを管理できるようになります。 アクロフィールドを内部名で使用できます

_SO1_ _SO2_ _SO3_ _SO4_ _SO5_

OR

_SC1_ _SC2_ _SC3_ _SC4_ _SC5_

このアクションはプロセス内で複数回使用できます。 署名リクエスト アクションは、 OK dokument サービスで「署名リクエスト」として生成され、この ID はすべての「署名」アクションに対して一意です。

ドキュメント署名のリクエストを送信するには、応答属性 URL を使用し、それを電子メール、プッシュ通知、または MS Teams で使用して、誰かに特定のドキュメントに署名するよう依頼します。

ドキュメントが署名されたら、「署名リクエスト」を使用してドキュメントの状態を「tosign」に変更し、新しい signatureRequestId を作成して次の署名に備えてドキュメントを準備できます。 その後、プロセスはステップ 3 ～ 5 を繰り返します。

必須のアクロフィールドが 1 つある署名リクエストの例

_SC1_

たとえば、1 つの署名リクエストに 1 つの必須アクロフィールドと 1 つの任意アクロフィールドがある場合 _SC1_;_SO2_

署名リクエストの追加ルール

追加ルールは以下のように使用できます:

• どこでもサイン機能を無効または有効にします
• 署名者名の事前定義値
• 署名者名の入力を有効にする
• OK Document からの署名リクエストの送信を有効にする
• メール アラームの有効化
• 電子メールまたは SMS による OTP (ワンタイムパスワード) 設定
• OTP によるドキュメント署名
• マウスによる署名を無効にする

署名要求ルールを記述するための構文
RuleName-Value

複数の署名要求ルールを記述するための構文
RuleName1-Value_RuleName2-Value_RuleName3-Value

Sign Anywhere が有効になっている署名リクエストの例
signAnywhereEnabled-true

Sign Anywhere が無効になり、値が事前入力された署名者名が有効になった署名リクエストの例
guiSignerName-John Doe_guiRequestSignerName-true_signAnywhereEnabled-false

Sign Anywhere が無効になっている署名リクエスト、値が事前入力された有効な署名者名、署名リクエストを開くための定義された OTP 電子メール、署名リクエストが送信される電子メール、電子メール テンプレート言語、署名リクエストの送信者の電子メールを含む署名リクエストの例
guiSignerName-John Doe_guiRequestSignerName-true_signAnywhereEnabled-false_openOtpEmail-john.doe@somefakeemail.com_emailTo-john.doe@somefakeemail.com_lang-sk_emailFrom-sender@someofficetenant.onmicrosoft.com_mouseSignature-false

有効期限

署名リクエストの有効期限の既定値は 24 時間です。 この expirationTime パラメーターを使用すると、この期間を最大 10 日間延長できます。 署名リクエスト ID の有効期限。 1970 00:00:00 UTC 1 月 1 日からのミリ秒単位の時間

メール

OKdokument API を使用すると、signatureRequest URL を電子メールで共有できます。 電子メールを送信するには、ルールを使用する必要があります:

• emailTo - 署名者の電子メール アドレス
• emailFrom – 電子メールの送信者
• nameFrom – 送信者名

メールは okdokument@okdokument.sk から配信されますが、署名者が返信/全返信ボタンを押すと、返信は送信者 (emailFrom) に直接送信されます。 署名プロセスでの追加設定には次のルールを使用することもお勧めします:

• emailFinal – 署名された文書を送信するための電子メール。 既定では、emailTo が使用されますが、変更することができます。 マルチラウンド署名の場合、最後の署名ラウンドでこのルールを使用し、すべての歌手の電子メール アドレスを入力します。 例: emailFinalemail@address.com|email2@address.com
• emailNotification - ドキュメントが署名を待っていることを通知するメールを送信します。
• language: メール テンプレートの言語
• filename – メール テンプレートで使用されるドキュメント名です。 ファイル名が入力されていない場合は、技術文書 ID が文書名として使用されます

3. 署名を待機する

トリガーアクション「署名を待機する」プロセスで使用できます。 「署名を待機する」 アクションは、OK dokument サービスで送信ボタンをクリックしてドキュメントの署名が確認されるまで待機します。 署名が送信されると、このトリガー アクションは完了します。 プロセスでドキュメントの署名の確認を待つ必要がある場合は、このアクションを使用できます。

4. 署名付きドキュメントのダウンロード

このアクションにより、署名されたドキュメントをダウンロードし、システム内で追加ステップで処理したり、SharePoint やその他のドキュメントストレージ システムに保存したりすることができます。

5. ドキュメントの削除

署名が完了したら、OK dokument サービスからドキュメントを削除することができます。 アップロードされたすべてのドキュメントは 60 日後に自動的に削除され、署名されたドキュメントは 10 日後に削除されます。

資格情報の取得

OK dokument サービスを利用するために必要な API キーは、https://okdokument.com/en/about/api/ で購読することで取得できます。

既知の問題と制限事項

現在、アクロフィールドとタグの使用には制限があります。 タグまたはアクロフィールドを使用できるのは、プロセスで定義済みの文字列形式のみです: _SC1_, _SC2_, _SC3_, _SC4_, _SC5_ または _SO1_, _SO2_, _SO3_, _SO4_, _SO5_.

カスタム アクロフィールド内部名が現在使用されています:

展開指示

このコネクタを Microsoft Power Automate、Power Apps または Azure LogicApps のカスタムコネクタとして展開するには、こちらの手順を使用してください。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

アクション

ドキュメントのアップロード

ドキュメントの削除

署名付きドキュメントのダウンロード

署名要求

トリガー

ドキュメントの署名の待機

定義

binary