WenDocs Linker (プレビュー)
WenDocs Publish API サービスに接続します。 登録ユーザーがサービスを呼び出して、WenDocs テンプレート (Word アドイン: Wendocs Template Designer で作成) と json データをアセンブルし、Word、PDF、HTML 形式で公開できるようにします。 他のコネクタと統合することで、ウェルカムレター、履歴書、ビジネスレポートなど、データに基づいて自動的に作成されるドキュメントを簡単に作成できます。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | WenDocs サポート |
| [URL] | https://www.wendocs.com/#/support |
| メール | support@wendocs.com |
| Connector Metadata | |
|---|---|
| 発行者 | WenDocs Ltd |
| Web サイト | https://www.wendocs.com |
| プライバシー ポリシー | https://www.wendocs.com/public/PrivacyPolicy_en.html |
| カテゴリ | ビジネス 管理; 生産性 |
WenDocs Linker は WenDocs Publish REST API サービスに接続します。 登録済みユーザー、サービスを呼び出して WenDocs テンプレートと JSON データを組み立て、Word、PDF、HTML の形式で公開します。
WenDocs Linker は、エンタープライズが一貫した外観とパーソナライズされたコンテンツを備えたマルチチャネル ドキュメント発行システムを確立するのに役立ちます。 Microsoft 365 プラットフォーム上の他のコネクタと統合することにより、紹介状、履歴書、受注通知、さらには財務諸表など、ビジネス データに基づくドキュメントを簡単に自動的に公開できます。
前提条件
- REST サービスへの基本的な認証接続を確立するために、support@wendocs.com から取得した API_Key と API_Secret を準備してください。
- WenDocs テンプレート ファイルと JSON 形式のデータを準備します。Word Office アドイン ストアで「WenDocs Template Designer」を検索し、ヘルプ または 使用の開始 から開始します。
資格情報の入手方法
コネクタの接続を作成するときに、API_Key と API_Secret を入力します。
コネクタで開始する
例としてクラウド フローを取り上げます。
テンプレートと json ファイルを OneDrive または SharePoint サイトにアップロードします。
他のコネクタからテンプレートと json ファイルのコンテンツを取得します。
「WenDocs Linker」から公開アクションを作成し、次のようにパラメーターを入力します。
- 「docName」、このテンプレート ファイルに名前を付けるための文字列値を指定します。
- 「documentTemplateData」、base64() 式を使用してテンプレートファイルのコンテンツをエンコードします。
- 「jsonData」、json ファイルのコンテンツを使用します。
- 「logLevel」、公開ログのレベルの 1 つを入力します: 「デバッグ、エラー、警告、情報」。
- 「言語」、公開ログ言語コードの 1 つを入力します: 「en、zh」。
- 「country」、公開国コードの 1 つを入力します: 「US、CN」。
- 「clientType」、「API サービス」を入力します。
次のアクションで公開されたドキュメントを取得し、base64ToBinary() 式を使用して、公開アクションの出力の「ドキュメント」アイテムをデコードします。 出力ファイルのバイナリ データです。
既知の制限
公開 API 呼び出しは、サブスクリプションの合計数と有効期限によって制限されます。
一般的なエラーと解決策
OneDrive の「ファイル コンテンツの取得」および「パスを使用したファイル コンテンツの取得」アクションの操作
「outputs()」式を使用して、「ファイル コンテンツの取得」および「パスを使用したファイル コンテンツの取得」によって返される出力本文から「コンテンツ」項目を取得してください。 OneDrive は base64 を使用してファイル コンテンツをエンコードするため、OneDriveから json ファイルを読み取る場合は、「decodeBase64()」式を使用して「コンテンツ」項目をさらに処理する必要があります。サンプルは次のとおりです。
decodeBase64(outputs('Action_Name')?['body/$content'])
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名称 | タイプ | 内容 | 必要 |
|---|---|---|---|
| API_Key | securestring | WenDocs Corporation [www.wendocs.com] から取得した API_Key を提供します | 真 |
| API_Secret | securestring | アクセス公開 API サービス用の API_Secret | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| Docx ファイルを公開する |
テンプレートと json データを含む docx ファイルを公開する |
| Html ファイルを公開する |
テンプレートと json データを含む Html ファイルを公開する |
| PDF ファイルを公開する |
テンプレートと json データを含む PDF ファイルを公開する |
Docx ファイルを公開する
テンプレートと json データを含む docx ファイルを公開する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
docName
|
docName | string |
ドキュメントの名前 |
|
|
documentTemplateData
|
documentTemplateData | string |
テンプレート ファイルのバイナリ データを表す base64 文字列 |
|
|
jsonData
|
jsonData | string |
JSON 形式の顧客データ |
|
|
logLevel
|
logLevel | string |
公開ログのレベル: デバッグ、エラー、警告、情報 |
|
|
language
|
language | string |
エラー メッセージで使用するサポートしている言語コード: en、zh |
|
|
country
|
country | string |
エラー メッセージで使用するサポートしている国コード: US、CN |
|
|
clientType
|
clientType | string |
API サービスのユーザーは 'API サービス' をご利用ください |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
documentName
|
documentName | string |
公開したドキュメントの名前 |
|
ドキュメント
|
document | string |
公開したドキュメントのバイナリ データに使用する base64 文字列 |
|
errorMessage
|
errorMessage | string |
エラー メッセージ |
|
errorCode
|
errorCode | string |
エラー コード |
|
messages
|
messages | array of object |
例外スタックのメッセージ |
|
レベル
|
messages.level | string |
ログ レベル |
|
source
|
messages.source | string |
ログ情報のソース |
|
message
|
messages.message | string |
ログ メッセージ |
|
パラメーター
|
messages.parameters | array of string |
ログ ソースのパラメーター |
|
例外
|
messages.exception | string |
例外スタック情報 |
Html ファイルを公開する
テンプレートと json データを含む Html ファイルを公開する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
docName
|
docName | string |
ドキュメントの名前 |
|
|
documentTemplateData
|
documentTemplateData | string |
テンプレート ファイルのバイナリ データを表す base64 文字列 |
|
|
jsonData
|
jsonData | string |
JSON 形式の顧客データ |
|
|
logLevel
|
logLevel | string |
公開ログのレベル: デバッグ、エラー、警告、情報 |
|
|
language
|
language | string |
エラー メッセージで使用するサポートしている言語コード: en、zh |
|
|
country
|
country | string |
エラー メッセージで使用するサポートしている国コード: US、CN |
|
|
clientType
|
clientType | string |
API サービスのユーザーは 'API サービス' をご利用ください |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
documentName
|
documentName | string |
公開したドキュメントの名前 |
|
ドキュメント
|
document | string |
公開したドキュメントのバイナリ データに使用する base64 文字列 |
|
errorMessage
|
errorMessage | string |
エラー メッセージ |
|
errorCode
|
errorCode | string |
エラー コード |
|
messages
|
messages | array of object |
例外スタックのメッセージ |
|
レベル
|
messages.level | string |
ログ レベル |
|
source
|
messages.source | string |
ログ情報のソース |
|
message
|
messages.message | string |
ログ メッセージ |
|
パラメーター
|
messages.parameters | array of string |
ログ ソースのパラメーター |
|
例外
|
messages.exception | string |
例外スタック情報 |
PDF ファイルを公開する
テンプレートと json データを含む PDF ファイルを公開する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
docName
|
docName | string |
ドキュメントの名前 |
|
|
documentTemplateData
|
documentTemplateData | string |
テンプレート ファイルのバイナリ データを表す base64 文字列 |
|
|
jsonData
|
jsonData | string |
JSON 形式の顧客データ |
|
|
logLevel
|
logLevel | string |
公開ログのレベル: デバッグ、エラー、警告、情報 |
|
|
language
|
language | string |
エラー メッセージで使用するサポートしている言語コード: en、zh |
|
|
country
|
country | string |
エラー メッセージで使用するサポートしている国コード: US、CN |
|
|
clientType
|
clientType | string |
API サービスのユーザーは 'API サービス' をご利用ください |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
documentName
|
documentName | string |
公開したドキュメントの名前 |
|
ドキュメント
|
document | string |
公開したドキュメントのバイナリ データに使用する base64 文字列 |
|
errorMessage
|
errorMessage | string |
エラー メッセージ |
|
errorCode
|
errorCode | string |
エラー コード |
|
messages
|
messages | array of object |
例外スタックのメッセージ |
|
レベル
|
messages.level | string |
ログ レベル |
|
source
|
messages.source | string |
ログ情報のソース |
|
message
|
messages.message | string |
ログ メッセージ |
|
パラメーター
|
messages.parameters | array of string |
ログ ソースのパラメーター |
|
例外
|
messages.exception | string |
例外スタック情報 |