OK dokument (独立系発行元) (プレビュー)
OK dokument は、既存のシステムにシームレスに統合する、使いやすくカスタマイズ可能な電子署名およびデジタル ドキュメント配布プラットフォームを提供します
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Seyfor Slovensko a.s. |
| [URL] | https://www.seyfor.com |
| メール | tomas.szarka@seyfor.com |
| Connector Metadata | |
|---|---|
| 発行者 | Seyfor Slovensko、a.s. |
| Web サイト | https://okdokument.com/ |
| プライバシー ポリシー | https://okdokument.com/_user/files/OKdokument/gdpr-en.pdf |
| カテゴリー | 生産性 |
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 は、署名されたドキュメントの永久アーカイブの役割を果たしません。 以下のルールを適用します:
- 署名された文書は署名から 10 日後に自動的に削除されます
- 署名のないドキュメントは、アップロード後 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 によるドキュメント署名
- マウスによる署名を無効にする
| ルール名 | パラメーター | プロパティ |
|---|---|---|
| signAnywhereEnabled | true/false | Sign Anywhere 関数を無効にするためのパラメータ |
| guiRequestSignerName | true/false | 署名者名の入力を有効にするためのパラメーター |
| guiSignerName | 署名者の名前 | 署名者名の事前定義値、最大 40 文字。 guiRequestSignerName が有効な場合、署名者は署名者名を変更できます。 |
| signAnywhereEnabled | true/false | Sign Anywhere 関数を無効にするためのパラメータ |
| emailTo | 署名者メールアドレス | 署名リクエストの URL が送信される署名者の電子メール |
| 配送されます。 | ||
| emailFrom | Sender email | 送信者の電子メール。 emailTo ルールを使用する場合は必須 |
| nameFrom | Sender name | 電子メール テンプレートで使用される送信者の名前 |
| emailNotification | 電子メールによるリマインダーを有効にするルール。 電子メールリマインダーは、署名されていない署名リクエストに対して毎朝 7:00 に電子メールを送信します。 電子メールは、signatureRequest の構成に従って、emailTo と emailFrom に送信されます。 | |
| emailFinal | 署名者メールアドレス | 署名された文書を電子メールで配信します。 emailFinal にパラメーターがない場合、署名された文書は emailTo に送信されます。 |
| openOtpPhone | 署名者電話番号 | 文書にアクセスするためのワンタイム パスワードが送信される署名者の電話番号。 SMS OTP を使用するには、SMS 付きの署名要求パッケージを購入する必要があります。 |
| openOtpEmail | 署名者メールアドレス | 文書にアクセスするためのワンタイム パスワードが送信される署名者のメールアドレス。 |
| signOtpPhone | 署名者電話番号 | 文書に署名するためのワンタイム パスワードが送信される署名者の電話番号。 OTP 署名には、アクロフィールド署名が必要です。 |
| signOtpEmail | 署名者メールアドレス | 文書に署名するためのワンタイム パスワードが送信される署名者のメールアドレス。 OTP 署名には、アクロフィールド署名が必要です。 |
| lang | sk、cs、en、ro、uk、pl、pt、hu | 電子メールと SMS テンプレートの言語。ルールが設定されていない場合は、既定の言語としてスロバキア語が使用されます。 |
| mouseSignature | 偽 | マウスによる署名を無効にするルール。 |
署名要求ルールを記述するための構文
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_.
カスタム アクロフィールド内部名が現在使用されています:
| チェックボックス | アクロフィールド |
|---|---|
| オプションのチェックボックス | CO |
| 必須チェックボックス | CR |
| テキスト フィールド | アクロフィールド |
|---|---|
| オプション TextField | 目的 |
| 強制テキスト フィールド | TC |
| ラジオ ボタン グループ | アクロフィールド |
|---|---|
| オプション ラジオ ボタン グループ | RO |
| 強制 ラジオ ボタン グループ | RC |
| コンボ ボックス | アクロフィールド |
|---|---|
| オプションのコンボボックス | CBO |
| 必須コンボボックス | CBC |
展開指示
このコネクタを Microsoft Power Automate、Power Apps または Azure LogicApps のカスタムコネクタとして展開するには、こちらの手順を使用してください。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| OK dokument API キー | securestring | Anasoft が発行したアプリ/サブスクリプション API キー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ドキュメントのアップロード |
ドキュメントのアップロード |
| ドキュメントの削除 |
ドキュメントの削除 |
| 署名付きドキュメントのダウンロード |
署名付きドキュメントのダウンロード |
| 署名要求 |
署名要求 |
ドキュメントのアップロード
ドキュメントのアップロード
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Document operation
|
state | string |
Document operation |
|
|
File
|
file | True | binary |
File content |
|
Filename
|
filename | string |
ファイル名 (拡張子付き) |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Document ID
|
result | string |
Document ID |
ドキュメントの削除
ドキュメントの削除
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Document ID
|
Document ID | True | string |
ドキュメント ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
code
|
code | string |
コード |
|
message
|
message | string |
メッセージ |
|
statusCode
|
statusCode | integer |
statusCode |
署名付きドキュメントのダウンロード
署名付きドキュメントのダウンロード
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Document ID
|
Document ID | True | string |
ドキュメントのアップロード アクションからのドキュメント ID |
戻り値
ドキュメントのコンテンツ
- ドキュメントのコンテンツ
- binary
署名要求
署名要求
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Document ID
|
id | True | string |
ドキュメントのアップロード アクションからのドキュメント ID |
|
Signature fields
|
SIGNATURE | string |
ドキュメントの署名フィールド |
|
|
有効期限
|
expirationTime | string |
ミリ秒単位の有効期限 |
|
|
件名
|
name | string |
アクロフィールド名 |
|
|
価値
|
value | string |
アクロフィールド値 |
|
|
読み取り専用
|
readOnly | boolean |
アクロフィールドは読み取り専用 |
|
|
追加ルール
|
rules | string |
署名要求プロセスを定義するルール |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Signature Request ID
|
result | string |
Signature Request ID |
|
Signature Request URL
|
url | string |
url |
トリガー
| ドキュメントの署名の待機 |
ドキュメントの署名の待機 |
ドキュメントの署名の待機
ドキュメントの署名の待機
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Signature Request ID
|
signatureRequestId | True | string |
署名要求アクションからの署名要求 ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
code
|
code | string |
code |
|
状態Code
|
statusCode | integer |
状態Code |
定義
binary
これは基本的なデータ型 'バイナリ' です。