TemplioniX (プレビュー)

TemplioniX は、再利用可能なWord テンプレートから DOCX ファイルと PDF ファイルを作成するためのドキュメント生成 API です。 このコネクタを使用して、テンプレート メタデータの抽出、1 つのドキュメントの生成、一括ドキュメント生成の実行、一括ジョブの状態の確認、生成された結果のダウンロード、サブスクリプションまたは使用状況の情報の表示を行います。

認証は、渡された API キーを使用して実行されます。

生成された一括 ZIP ダウンロード リンクは 24 時間有効です。

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス Regions
コピロット スタジオ Premium 次を除くすべてのPower Automateリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - 中国リージョンAzure
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべてのPower Appsリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate（パワーオートメート） Premium 次を除くすべてのPower Automateリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 TemplioniX のサポート
URL https://templionix.com
Email support@templionix.com
コネクタ メタデータ
Publisher TemplioniX
Website https://templionix.com
プライバシー ポリシー https://templionix.com/privacy-policy
使用条件 https://templionix.com/terms-of-use
カテゴリ 生産性;コンテンツとファイル
IconBrandColor #333A41

TemplioniX コネクタ

概要

TemplioniX は、再利用可能なMicrosoft Word テンプレートと構造化 JSON データから DOCX ファイルと PDF ファイルを作成するのに役立つドキュメント生成サービスです。

このコネクタを使用すると、ユーザーはMicrosoft Power Automate、Power Apps、Azure Logic Apps、およびCopilot Studioワークフローを TemplioniX API に接続できます。 ユーザーは、テンプレート メタデータの抽出、スターター JSON ペイロードの生成、ドキュメントの生成、一括ドキュメント生成ジョブの実行、ジョブの状態の確認、生成された結果のダウンロード、使用可能なテンプレートの取得を行うことができます。

Publisher

TemplioniX

意図されたMicrosoft製品

  • Microsoft Power Automate（マイクロソフト パワー オートメート）

コネクタはMicrosoft Power Platformカスタム コネクタとして実装されており、認定コネクタがサポートされている他のMicrosoft コネクタ エクスペリエンスで使用できます。

認証

コネクタは API キー認証を使用します。 API キーは、 x-functions-key 要求ヘッダーで渡されます。

このコネクタを使用するには、アクティブな TemplioniX アカウントと有効な API キーが必要です。

主な機能

テンプレートを取得する

TemplioniX から使用可能なドキュメント テンプレートのページ分割された一覧を取得します。 この操作を使用すると、メタデータ、スターター モデル、1 つのドキュメント、または一括ドキュメント生成ジョブを生成する前にテンプレートを選択できます。

テンプレート フィールドとプレースホルダーを抽出する

テンプレート フィールドやプレースホルダーなど、選択したテンプレートからメタデータを抽出します。 これにより、ユーザーはテンプレートで期待されるデータを理解できます。

テンプレートのスターター JSON ペイロードを生成する

選択したテンプレートに基づいて JSON ペイロードの例を生成します。 ユーザーは、他のシステムのデータをドキュメント生成要求にマッピングするための開始点として、このペイロードを使用できます。

ドキュメントを生成する

選択したテンプレートから DOCX または PDF ドキュメントを生成し、JSON データを入力します。

ドキュメントを一括で生成する

選択したテンプレートと複数の入力レコードを使用して、一括ドキュメント生成ジョブを開始します。 生成された一括 ZIP ダウンロード リンクは 24 時間有効です。

一括生成ジョブの状態を取得する

特定の一括ドキュメント生成ジョブの状態と結果情報を取得します。

テンプレートによる一括生成ジョブの取得

選択したテンプレートに関連付けられている一括生成ジョブを取得します。

一般的な使用シナリオ

  • 構造化データからコントラクト、請求書、提案、レポート、レター、その他のビジネス ドキュメントを生成します。
  • CRM、ERP、フォーム、Excel、SharePoint、Dataverse、SQL、または API ベースのシステムからのドキュメント作成を自動化します。
  • ワークフローから必要に応じて 1 つのドキュメントを作成します。
  • 複数のドキュメントを一括で生成し、生成された ZIP 結果を取得します。
  • 抽出されたテンプレート メタデータを使用して、ドキュメントの生成に必要なフィールドを理解します。

ワークフローの例

  1. フローを手動でトリガーするか、ビジネス イベントからトリガーします。
  2. テンプレートの取得操作を使用して、テンプレートを選択します。
  3. 予想されるデータ構造を理解するには、スターター JSON ペイロードの生成操作を使用します。
  4. 生成された JSON 構造にソース システム データをマップします。
  5. ドキュメントの生成操作を使用して DOCX または PDF ファイルを作成します。
  6. 生成されたファイルを、OneDrive、SharePoint、Dataverse、電子メール、または別の宛先に保存します。

Support

製品情報、ドキュメント、およびサポートについては、以下を参照してください。

認定レビューに関する注意事項

このパッケージには、TemplioniX コネクタ ソリューションと、コネクタの操作を示すサンプル フロー ソリューションが含まれています。 コネクタは運用 TemplioniX API と通信し、 x-functions-key ヘッダーを介して API キー認証を使用します。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。
デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有不可

デフォルト

適用対象: すべてのリージョン

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

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

名前 タイプ Description 必須
TemplioniX Api キー securestring この API の TemplioniX Api キー True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

テンプレート データからドキュメントを生成する

指定された JSON ペイロードを選択したテンプレートとマージし、生成されたドキュメントを返します。 Word出力には.docxを使用し、PDF 出力には.pdfを使用する
テンプレート フィールドとプレースホルダーを抽出する

選択したテンプレートを読み取り、タイトル、タグ、型、定義済みの値 (使用可能な場合) など、ドキュメントで検出されたコンテンツ コントロールを返します。
テンプレートのスターター JSON ペイロードを生成する

選択したテンプレートで検出されたプレースホルダーと一致するサンプル JSON 構造を構築し、ドキュメント生成の入力として再利用できるようにします。
テンプレートの一括生成ジョブを一覧表示する

TemplateId が一致する一括生成パーティションのすべてのジョブを返します。1 つのジョブの状態と同じペイロードの形状(開始時刻の降順で並べ替え)
ドキュメントの一括生成を開始する

一括ジョブを開始して共有テンプレートからドキュメントを生成し、読み取り SAS URL を使用して ZIP をビルドし、進行状況を追跡します。 ジョブ ID を直ちに返します。 返される ZIP ダウンロード URL は、ジョブの完了後に使用でき、生成時間から 24 時間有効です。
一括生成ジョブの状態を取得する

ID によってジョブの状態を読み込みます。状態、開始時刻/終了時刻、完了時の ZIP SAS URL、失敗した場合のオーケストレーション エラー、および項目ごとの生成エラーの解析。
使用可能なテンプレートを一覧表示する

メタデータ抽出、モデル生成、およびドキュメント生成エンドポイントで使用できる、ページ分割されたテンプレートの一覧を返します。

テンプレート データからドキュメントを生成する

操作 ID:
GenerateDocument

指定された JSON ペイロードを選択したテンプレートとマージし、生成されたドキュメントを返します。 Word出力には.docxを使用し、PDF 出力には.pdfを使用する

パラメーター

名前 キー 必須 型 説明
Template
 templateId uuid

一意のテンプレート識別子
データ
 data object

テンプレート プレースホルダーの値を含む JSON オブジェクト。
ドキュメント名
 documentName string

API が拡張機能を受け入れる場合を除き、拡張子のない生成されたドキュメントの名前
Format
 format string

出力フォーマット。 Wordドキュメントには .docx を使用し、PDF ドキュメントには .pdf を使用します。

返品

response
file

テンプレート フィールドとプレースホルダーを抽出する

操作 ID:
GenerateTemplateMetadata

選択したテンプレートを読み取り、タイトル、タグ、型、定義済みの値 (使用可能な場合) など、ドキュメントで検出されたコンテンツ コントロールを返します。

パラメーター

名前 キー 必須 型 説明
テンプレート識別子
 templateId True uuid

テンプレート カタログによって返される一意のテンプレート識別子

返品

response
array of contentControlInfoDto

テンプレートのスターター JSON ペイロードを生成する

操作 ID:
GenerateModel

選択したテンプレートで検出されたプレースホルダーと一致するサンプル JSON 構造を構築し、ドキュメント生成の入力として再利用できるようにします。

パラメーター

名前 キー 必須 型 説明
テンプレート識別子
 templateId True uuid

テンプレート カタログによって返される一意のテンプレート識別子

返品

response
object

テンプレートの一括生成ジョブを一覧表示する

操作 ID:
GetBulkGenerationJobsByTemplateId

TemplateId が一致する一括生成パーティションのすべてのジョブを返します。1 つのジョブの状態と同じペイロードの形状(開始時刻の降順で並べ替え)

パラメーター

名前 キー 必須 型 説明
テンプレート識別子
 templateId True uuid

このテンプレート ID で開始されたジョブのみが返されます

返品

response
array of bulkGenerationJobStatusDto

ドキュメントの一括生成を開始する

操作 ID:
GenerateDocumentsBulk

一括ジョブを開始して共有テンプレートからドキュメントを生成し、読み取り SAS URL を使用して ZIP をビルドし、進行状況を追跡します。 ジョブ ID を直ちに返します。 返される ZIP ダウンロード URL は、ジョブの完了後に使用でき、生成時間から 24 時間有効です。

パラメーター

名前 キー 必須 型 説明
Template
 templateId uuid

一意のテンプレート識別子
Format
 format string

出力フォーマット。 Wordドキュメントまたは PDF ドキュメントの .pdf に .docx を使用する
ファイル名
 fileName string

生成または要求されたファイル名
items
 items object

返品

一括ドキュメント生成ジョブの処理が受け入れられたときに返される応答。

Body
bulkGenerationAcceptedDto

一括生成ジョブの状態を取得する

操作 ID:
GetBulkGenerationJobStatus

ID によってジョブの状態を読み込みます。状態、開始時刻/終了時刻、完了時の ZIP SAS URL、失敗した場合のオーケストレーション エラー、および項目ごとの生成エラーの解析。

パラメーター

名前 キー 必須 型 説明
一括ジョブ識別子
 jobId True string

generateDocumentsBulk 202 応答で返されるジョブ ID (jobId)

返品

一括ドキュメント生成ジョブの状態と結果の詳細。

Body
bulkGenerationJobStatusDto

使用可能なテンプレートを一覧表示する

操作 ID:
GetTemplates

メタデータ抽出、モデル生成、およびドキュメント生成エンドポイントで使用できる、ページ分割されたテンプレートの一覧を返します。

パラメーター

名前 キー 必須 型 説明
ページ番号
 pageNumber True integer

返す 1 から始まるページ インデックス
ページ サイズ
 pageSize True integer

1 つの応答で返されるテンプレートの最大数

返品

テンプレート レコードを含むオフセットベースのページングされた応答。

Body
pagedResponseOffsetDto_templateInfoDto

定義

bulkGenerationAcceptedDto

一括ドキュメント生成ジョブの処理が受け入れられたときに返される応答。

名前 パス 型 説明
ジョブID
 jobId string

一意の一括生成ジョブ識別子。
開始日時
 startedAt date-time

操作が開始された UTC 日時。

bulkGenerationFailureItemDto

一括生成ジョブで失敗した 1 つのドキュメント 項目に関する情報。

名前 パス 型 説明
グローバル インデックス
 globalIndex string

失敗した生成された項目のインデックスまたは内部識別子。
ファイル名
 fileName string

生成または要求されたファイル名。
エラー
 error string

失敗した項目のエラー メッセージ。

bulkGenerationJobStatusDto

一括ドキュメント生成ジョブの状態と結果の詳細。

名前 パス 型 説明
ジョブID
 jobId string

一意の一括生成ジョブ識別子。
テンプレート識別子
 templateId uuid

一意のテンプレート識別子。
地位
 status string

現在のジョブの状態 ([保留中]、[実行中]、[完了]、[失敗]、[PartiallyCompleted] など)。
開始日時
 startedAt date-time

操作が開始された UTC 日時。
終了時刻
 endTime date-time

ジョブが完了した UTC 日時。
Zip Url
 zipUrl string

生成された ZIP ファイルの一時的なダウンロード URL。 一括生成の場合、このリンクは生成時間から 24 時間有効です。
エラー メッセージ
 errorMessage string

オーケストレーションが失敗した場合のジョブ レベルのエラー メッセージ。
failedGenerations
 failedGenerations array of bulkGenerationFailureItemDto

一括生成ジョブ内の失敗した項目のコレクション。
失敗した生成数
 failedGenerationCount integer

一括生成ジョブ内で失敗した項目の数。

categoryDto

テンプレート カテゴリ情報。

名前 パス 型 説明
id
 id uuid

一意な 識別子。
name
 name string

表示名。

contentControlInfoDto

テンプレートで検出された 1 つのWord コンテンツ コントロールまたはプレースホルダーのメタデータ。

名前 パス 型 説明
タイトル
 title string

コンテンツ コントロールのタイトル。
タグ
 tag string

JSON フィールド キーとして使用されるコンテンツ コントロール タグ。
型
 type string

コンテンツ コントロールの種類。

pagedResponseOffsetDto_templateInfoDto

テンプレート レコードを含むオフセットベースのページングされた応答。

名前 パス 型 説明
データ
 data array of templateInfoDto

テンプレート プレースホルダーの値を含む JSON オブジェクト。
ページ番号
 pageNumber integer

現在のページ番号。
ページサイズ
 pageSize integer

1 ページあたりのレコード数。
合計レコード数
 totalRecords integer

使用可能なレコードの合計数。
合計ページ数
 totalPages integer

ページの合計数。

templateInfoDto

テンプレート リスト エンドポイントによって返されるテンプレート カタログ 項目。

名前 パス 型 説明
ID
 id uuid

一意な 識別子。
名前
 name string

表示名。
Description
 description string

人間が判読できる説明。
作成日
 createdOn date-time

テンプレートが作成された UTC 日時。
更新日時
 lastModified date-time

テンプレートが最後に変更された UTC 日時。
categories
 categories array of categoryDto

テンプレート カテゴリ。

ファイル

これは基本的なデータ型 'file' です。

オブジェクト

これは型 'object' です。