Appendix: Document Generation Services Core Sample Transforms.xml file

Below is a sample of the Transforms.xml file used in the Document Generation Services Core Component installation. 

<Transforms>
  <Transform FileName="Installs\DGSCore.Installer.msi" Category="Sample"/>
    <Property Id="DGSCORE.STSService.Url" Value="https://Admin.WKMNLAB.NET/STS/"/>
    <Property Id="DGSCORE.DGSCONNECTIONSTRING" Value="data source=Database.wkmnlab.net;Initial Catalog=DocGen;Integrated Security=true" Secure="yes" Encrypt="true"/>
    <Property Id="EZConfigInstalled" Value="true/false"/>    
    #########  the following variables are enabled only if the EZConfigInstalled variable is enabled ########
    <Property Id="SERVICES.EZConfigService.BaseAddress; example "Value="magnum-pi.wkmnlab.net/DocGenServices"/>
    <Property Id="SERVICES.EZConfigService.UserName; example: "admin1"/>
    <Property Id="SERVICES.EZConfigSErvice.Password; example: "xxxxxxxxx"/>
    <Property Id="DGSCORE.RabbitMqHost" Value="rabbitmq://localhost">
    <Property Id="DGSCORE.RunAppPoolAsUser" Value="false"/>        
    <Property Id="DGSCORE.AppPoolUserDomain" Value="na"/>        
    <Property Id="DGSCORE.AppPoolUserName" Value="none"/>        
    <Property Id="DGSCORE.AppPoolUserPassword" Value="none"/>
    <Property Id="DGSCORE.ApiResourceId" Value="wk-dgs-core" />
    <Property Id="DGSCORE.ApiResourceSecret" Value="xxxxxxxxxxxxxxxxxxxxxxx" />
  </Transform>		
</Transforms>

Additional Considerations

Consider additional guidelines when using the property below:

  • DGSCORE.STSService.Url: additional catalog value here should match the value of SHORTTERMSQLSERVERHOSTNAME in the Document Generation Services transform.
  • DGSCORE.DGSCONNECTIONSTRING; by default, "Encrypt" is set to "true". Users should manually change the value to "false" if encryption is not necessary or wanted.
  • EZConfigInstalled: the following variables are enabled only if the EZConfigInstalled variable is enabled (true or false value):
    • SERVICES.EZConfigService.BaseAddress; example "Value="magnum-pi.wkmnlab.net/DocGenServices"
    • SERVICES.EZConfigService.UserName; example: "admin1"
    • SERVICES.EZConfigSErvice.Password; example: "xxxxxxxxx"
    Note: These settings allow DGSCore to do an EZConfig repost if DGSCore is being used to update an alias. If not using UpdateAlias through DGSCore, EZConfigInstalled can be set to "false." If UpdateAlias is being used, set EZConfigInstalled to "true." BaseAddress would be “server/DocGenServices." This is the server where DGS is present. UserName/Password would be an STS user with View All Accounts or Edit All Accounts permission.