Components: application event

An application event is a partial correspondence of which the actual correspondences are generated by the application rules. In the application event, you cannot specify a Document Pack Template. It is set by the application rules instead.

An application event also contains Application, Process, and Event attributes that provide additional business data of the submitting application that can be used to compute the Document Pack Template.

To create an application event out of a correspondence, or vice versa, simply copy and modify (remove and/or add) the existing data.

An application event consists of the following attributes:

  • A correspondence Reference. This is an external identification.
  • Optional. Brand. The brand identifies the style to be used in the HTML version of the HTML cover letter. This attribute is only used if the cover letter is not an HTML template and needs to be converted to HTML with a style sheet.
  • Application.
  • Process.
  • Event.

    Example

     <ccm:ApplicationEvent Reference="Order" 
    Brand="MyBrand" Application="A" Process="P" Event="E">
  • Optional. Sender. The sender describes the contact data of the sender of the correspondence. The active contact configuration object defines which fields are allowed in contact data.

    Each field may have an XML element with its name and simple text content. Nested nodes are not allowed.

    Example

    <ccm:Sender>
      <ct:Name>Jan</ct:Name>
      <ct:City>MyCity</ct:City>
      …
    </ccm:Sender>

  • One or more Recipients. The recipients describe the contact data of the possible recipients of the correspondence. Each recipient is named with a type, and can be referenced and selected by this type. The active contact configuration object defines which fields are allowed in contact data. Each Recipient has a Type attribute, which may have subnodes for each allowed field with their names and simple text content. Nested nodes are not allowed below that point.

    Example

    <ccm:Recipients>
      <ccm:Recipient Type=”Customer”>
        <ct:Name>Jan</ct:Name>
        …
      </ccm:Recipient>
      <ccm:Recipient Type=”Intermediary”>
        <ct:Name>Jack</ct:Name>
        <ct:City>MyCity</ct:City>
        …
      </ccm:Recipient>
      …
    </ccm:Recipients>

  • Zero or more OrganisationalMetadata values. An organizational metadata value is a key/value pair accessible from the KCM components that process the correspondence, to implement custom behavior. The active organizational metadata configuration object defines which keys are allowed. It is required to have keys without a defined default value.

    Each key may have an XML element with its name and simple text content. Nested nodes are not allowed.

    Example

    <ccm:OrganisationalMetadata>
      <data:DepartmentCode>Z801</data:DepartmentCode>
      <data:Priority>High</data:Priority>
      <data:ReturnCopy>True</data:ReturnCopy>
    </ccm:OrganisationalMetadata>
    

  • DataBackbone. Data Backbone describes the raw input data for the composition of the Document Pack Template. It must conform to the format expected by KCM Core. Also, the DataBackbone element maybe replaced by a Did element. See Application events for compatibility templates for more information.
  • Zero, one, or more OptionalDocuments. Optional documents describe which optional slots of the Document Pack Template to keep. The others are removed.
  • Zero, one, or more ImportDocuments. Import documents are base64 encoded files inserted as they are in the import slots of a composed Document Pack Template. They are placed under the importDocuments node of a correspondence, and the Import Documents XML must conform to its XSD. The XSD resides here:

    <deploy root>\KCM\Documentation\<5.8>\Resources\Schemas\Output Management

    Example

    <ccm:ImportDocuments>
      <im:importDocuments version=”1” xmlns:im=
                      ”http://www.kofax.com/ccm/importdocuments/1.0”>
        <im:importDocument name=”1” mimetype=”application/pdf”> …
              </im:importDocument>
      </im:importDocuments>
     </ccm:ImportDocuments>