HotDocs 工具中是否有任何现有服务可以从外部源接收数据以准备文档？

Question

HotDocs 是一个生成文档的工具，基本上它有两个功能。第一个是寺庙，第二个是答案文件。模板携带变量，这些变量的数据通过应答文件推送。

一般应答文件是页面，它要求数据并进一步生成文档。

现在我们的要求是 - 我需要通过使用 PHP 构建的 API 发送 JSON 格式的数据，而不是通过应答文件传递变量的值。

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：数据的数据类型、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（布尔值）、DateValue（DateTime）和 MCValue（请参阅此答案的后面内容）。

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

对于多项选择，您可以 select 一个或多个答案，因此答案 XML 格式略有不同：

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

如果您有重复的数据要放入文档中，您可以使用列表重复格式：

<Answer name="[Variable name in template]">
    <RptValue>
        <[Variable Type]>[First value]</[Variable Type]>
        <[Variable Type]>[Second value]</[Variable Type]>
    </RptValue>
</Answer>

构建此 XML 结构后，您可以将其作为字符串传递到 REST 服务上的 assemble 文档方法中，并带有 assemble 相应文档的模板。

HotDocs 工具中是否有任何现有服务可以从外部源接收数据以准备文档？

Is there any existing service in HotDocs tools to receive data from an external source to prepare a document?

api

document

documentation-generation