Appendix: Document Generation Services DocViewer API Component Sample Transforms.xml file

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

<Transforms>
  <Transform FileName="Installs\DGSCore.Api.DocViewer.Installer.msi" Category="Sample">
    <Property Id="WKFSAuth.Domain" Value="admin.wkmnlab.net" />

    <Property Id="SERVICES.SecuritySession.BaseAddress" Value="dgs.wkmnlab.net/DocGenServices" />
    <Property Id="SERVICES.SecuritySession.UserName" Value="XXXXXX" />
    <Property Id="SERVICES.SecuritySession.Password" Value="XXXXXXXXX" />
    <Property Id="KESTREL.Certificates.Default.Subject" Value="*.wkmnlab.net" />
    <Property Id="SERVICES.SecuritySession.OpenTimeout" Value="00:02:00"/>
    <Property Id="SERVICES.SecuritySession.CloseTimeout" Value="00:02:00"/>
    <Property Id="SERVICES.SecuritySession.SendTimeout" Value="00:02:00"/>
    <Property Id="SERVICES.SecuritySession.ReceiveTimeout" Value="00:02:00"/>
    <Property Id="DGSCORE.DocViewer.RunAppPoolAsUser" Value="false"/>    
    <Property Id="DGSCORE.DocViewer.AppPoolUserDomain" Value="na"/>    
    <Property Id="DGSCORE.DocViewer.AppPoolUserName" Value="none"/>    
    <Property Id="DGSCORE.DocViewer.AppPoolUserPassword" Value="none"/>
    <Property Id="DGSCORE.DocViewer.ApiResourceId" Value="wk-dgs-core" />
    <Property Id="DGSCORE.DocViewer.ApiResourceSecret" Value="xxxxxxxxxxxxxxxxxxxxxxx" />
  </Transform>	
</Transforms>

Additional considerations

Consider additional guidelines when using the following properties:

  • WKFSAuth.Domain: this the name of the machine hosting STS.
  • SERVICES.SecuritySession.BaseAddress: this is the name of the machine hosting DGS plus the path.
  • SERVICES.SecuritySession.UserName and SERVICES.SecuritySession.Password: this is the username and password for a system level user in STS, used by the Default data client to begin a DocViewer session.
  • KESTREL.Certificates.Default.Subject: this is the subject value of the certificate assigned to IIS.
  • SERVICES.SecuritySession.OpenTimeout, SERVICES.SecuritySession.CloseTimeout, SERVICES.SecuritySession.SendTimeout, and SERVICES.SecuritySession.ReceiveTimeout are optional properties and all contain a defailt value of 2:00 minutes; however these values can be modified.