› KCM Core Developer's Guide › Document composition › ITPRun command › Use a rep:/ URl to create a document

Use a rep:/ URl to create a document

You can use a rep:/ URl to compose a document.

The URLs supported to compose a document from a template or a Letter Book use the following generic format. 

rep://[{host}:port}]/{type}/{project}/[{path}/]{object}[?{key}={value}[&{key}={value}]*]

rep://[{host}:{port}]/letter/{project}/{letterbook}/[{path}/]{object}[?{key}={value}[&{key}={value}]*]

host: TCP/IP host name of the system hosting the KCM Repository Server

port: TCP/IP port the server listens to

type: Select one of the following template types to run or letterbook

  • documenttemplate
  • mastertemplate
  • staticdocument
  • quickdocument
  • documentpacktemplate

project: Project

path: Optional. Folders separated by a slash symbol

object: Template to be retrieved

key/value: Additional key/value pairs for parameters. Supported keys are the following:

  • user=Repository User
  • status=[published|accepted|current|development]

Examples are provided below. 

rep:/documenttemplate/DemoProject/Letter

The preceding example refers to the specific Document Template Letter in the project DemoProject. The Document Template is retrieved from the KCM Repository Server configured in ContentPublicationName on the default environment. The status retrieved is the status configured in RepositoryObjectStatus on the default environment. 

rep://localhost:2587/mastertemplate/DemoProject/Letters/Documentgenerator?status=accepted

The preceding example refers to the accepted status of the Master Template Document generator in the Letters folder (a subfolder of Templates) of the project DemoProject. The location of the KCM Repository Server host:port is supplied as localhost:2587, which indicates that KCM Repository installed on the local host configured with port 2587. The status indicates that the accepted status of the Master Template is retrieved, and that the accepted status of any dynamic objects is retrieved. 

rep://localhost:2587/letter/DemoProject/Correspondence/Welcome Letter

The second example refers to the Document Template defined in the Correspondence Letter Book under the name Welcome Letter. Letter Books allow an additional level of indirection in application integration.