文書を準備するために外部ソースからデータを受け取るためのHotDocsツールには、既存のサービスはありますか？

Question

HotDocsは文書を生成するためのツールであり、基本的には2つのことを実行します。最初は寺院で、2番目は応答ファイルです。テンプレートは変数を持ち、これらの変数へのデータは応答ファイルを通じてプッシュされます。

一般的に、応答ファイルはデータを要求するページであり、さらにドキュメントを生成します。

ここでは、変数の値を応答ファイルで渡す代わりに、JSON形式のデータを提供するPHPを使用して構築されたAPIを送信する必要があります。

この種類の要求を処理するために、HotDocsに存在するサービスがありますか。必要に応じて、JSONからXMLにデータを変更できます。

Answer 1

現在のところ、JSONからHotDocs Answer XMLまでの棚のコンバーターはありませんが、HotDocsでは常にこれを行っています。アプリケーションからJSONまたはXMLを生成する場合、データをHotDocsの回答XML形式に変換する必要があります。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<AnswerSet title="Demo Answers" version="1.1"> 
    <Answer name="Employee Name"> 
     <TextValue>Graham Penman</TextValue> 
    </Answer> 
    <Answer name="Job Duty"> 
     <RptValue> 
      <TextValue>make tea</TextValue> 
      <TextValue>make coffee</TextValue> 
      <TextValue>make some cake</TextValue> 
     </RptValue> 
    </Answer> 
    <Answer name="Annual Salary"> 
     <NumValue>12.0000000</NumValue> 
    </Answer> 
    <Answer name="Contract Date"> 
     <DateValue>10/10/2016</DateValue> 
    </Answer> 
    <Answer name="Paid Seminar Days"> 
     <TFValue>false</TFValue> 
    </Answer> 
</AnswerSet> 

は、あなたが回答XMLを作成するために知っておく必要がある3つの主要なものがあります：あなたのデータのデータ型は、あなたが渡しているデータHotDocs内とするかどうかのデータ型がリストまたは単一の項目です。

回答XMLを構築するのは比較的簡単です。

回答XMLは、本質的に、キーと値のペアは、開始タグと終了タグの間に含まれている：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<AnswerSet title="Demo Answers" version="1.1"> 
...Answers go here 
</AnswerSet> 

は、我々はその後、追加することによってで答えを追加し、次の答えがに対応したテンプレートで変数を指定し、答えを設定したい実際の値とテンプレート内のデータのタイプ - 下の例ではテキストですが、HotDocsのタイプはTextValue（文字列）、NumValue（小数点） 、TFValue（boolean）、DateValue（DateTime）、MCValue（この回答の後半を参照してください）。

複数の選択肢のために

<Answer name="[Variable name in template]"> 
    <TextValue>[Value from your data]</TextValue> 
</Answer> 

回答XMLフォーマットはわずかに異なっているので、特にあなたが一件の以上の回答を選択することができます。

<Answer name="[Variable name in template]"> 
    <MCValue> 
      <SelValue>[First selected value]</SelValue> 
      <SelValue>[Second selected value]</SelValue> 
    </MCValue> 
</Answer> 

あなたがデータを繰り返している場合は、あなたが使用することができ、文書に入れたいですリストの繰り返し形式：

このXML構造を作成したら、これをRESTサービスのアセンブル・ドキュメント・メソッドにテンプレートを含む文字列として渡すことができます対応する文書を組み立てる。