The first step when using DocumentData to set up an integration to an external system, will be to fetch data from the external system. To learn more about DocumentData and the data flow, read the basics.

In this article, you can read about how we fetch data from all the various external systems, we integrate to. When you have the data you need, the next step in configuring your integration is to transform your data, before you output your data in the final step.

Contents

General info
OutputDebug
List of Integrations

General info [Back to top]

To fetch data into DocumentData, you need to run a command from a module. Usually, the command is run from a separate plugin unique to the external system you are integrating to.

Remember that commands can be run from buttons or as events. Most commonly, you will need both when configuring your integration.

Finally, be aware that in some cases you might also need to add additional files or plugins to your solution. In any such cases, the integration-specific articles at the bottom of this article will clearly state any additional needs.

OutputDebug [Back to top]

OutputDebug is a command that can be used during the transformation step to ensure that DocumentData actually receives data from the external system, thereby verifying that your fetch attempt was successful.

CMD

<Cmd case="SkabelonDesign.DocumentData:OutputDebug"/>

When placed in a module, the command will save all data currently stored in DocumentData to a .txt file. A save dialogue will open for you to choose a location for the .txt-file.

Example

Below example should illustrate where the command must be placed in the module: between EnablePendingChanges and Commit, usually at the end of the series of commands - right before committing.

<Cmd case="BaseExtensions:content-create" type="docprop" name="Teste" value="Leste"/>
<Cmd case="SkabelonDesign.DocumentData:EnablePendingChanges"/>
<Cmd case="SkabelonDesign.DocumentData:DefineData" variableName="TesteValue">
   <Doc.Prop.Teste>
      <Doc.Prop.Teste/>
   </Doc.Prop.Teste>
</Cmd>
<Cmd case="SkabelonDesign.DocumentData:OutputDebug"/>
<Cmd case="SkabelonDesign.DocumentData:Commit"/>