Process Feedback PTC-ILM specific

First of all, create or choose a ILM item type where the feedback will be collected.

Stages will use the SOAP interface to create the items.

Stages config.xml

To enable the following configuration section must be added in the conf/config.xml:

<?xml version="1.0" encoding="UTF-8" ?>
<stages-config>
  <!-- Insert this block to your stages config.xml file -->
  <feedback-system name="ptcilm">
 
    <!-- Url to the WSDL / SOAP endpoint -->
    <host url="http://integrity.example.com:7001/webservices/10/2/Integrity/?wsdl">
 
      <!-- Credentials for a (technical) user who is allowed to create issues -->
      <property name="user" value="user" />
      <property name="password" value="secret" />
 
      <!-- Define the item type where the issue should be created in -->
      <property name="type" value="feedback" />
 
      <!-- Url to the Web ILM. It is used to create a link to the generated item -->
      <property name="imweb" value="http://integrity.example.com:7001/im" />
 
      <!-- Optional: Map issue to a project (Since Stages 7.5.1.3) -->
      <property name="projectName" value="/Feedback Project" />
      <property name="projectField" value="Project" />
 
      <!-- The summary field will always be available and is automatically mapped to the "Summary" field  -->
 
      <!--
      See common feedback documentation
      - The "target" defines the name of the field in ILM (e.g. "Impact").
      - Optional: The targetType defines the type of the field. Supported PTC-ILM fields see below.
      -->
      <attributes>
        <attribute ident="description" type="text" target="Description" targetType="longtext" />
      </attributes>
 
      <!--
      See common feedback documentation
      The "target" defines the name for the field in ILM (e.g. "Element Url").
      Optional: The targetType defines the type of the ILM field. Supported fields see below.
      -->
      <system-attribute-mappings>
        <attribute source="elementUrl" target="Element Url" />
        <attribute source="workspaceName" target="Workspace Name" />
        <attribute source="workspacePath" target="Workspace Path" />
        <attribute source="creatorFullname" target="Creator Fullname" />
        <attribute source="creatorUsername" target="Assigned User" targetType="user"/>
      </system-attribute-mappings>
 
      <!--
      See common feedback documentation
      The "target" defines the name for the field in ILM (e.g. "SourceSystemField").
      Optional: The targetType defines the type of the ILM field. Supported fields see below.
      -->
      <custom-attribute-mappings>
        <attribute value="Stages" target="SourceSystemField" />
      </custom-attribute-mappings>
    </host>
  </feedback-system>
</stages-config>

Supported fields

  • shorttext: targetType=“” (Empty)
  • longtext: targetType=“longtext” (Also with rich text setting)
  • user: targetType=“user”

Be aware: If you choose user then the user entered values or the Stages username must match / exist in ILM. Otherwise the item creation will fail.

Other ILM fields are not supported at the moment.