caseCreateExtraFields, logCaseEmailInExtraFields, and logSubcaseEmailInExtraFields Schema

This section of the Dovetail Email Agent XML configuration file applies only when parseMode is set to 'freeform'.

When Dovetail Email Agent creates or logs notes to a case, you can have Dovetail Email Agent set additional/custom fields on the case. This section of the XML file allows you to specify the names, types, and values to use for these fields. The XML consists of a three optional tags ('<caseCreateExtraFields>', '<logCaseEmailInExtraFields>', and '<logSubcaseEmailInExtraFields>') which may contain one or more instances of subtag '<fieldValue>'. The '<fieldValue>' schema is outlined below.

WARNING: All tag and attribute names are CASE SENSITIVE.

<fieldValue> Tag

<caseCreateExtraFields>
    <fieldValue name="x_name" type="string" value="George">
    <fieldValue name="x_date" type="date" value="1/1/2005">
    <fieldValue name="x_num" type="long" value="542"> 			
</caseCreateExtraFields>			

NOTE: To specify "NOW" for a date field, use the value -999. Example:

<fieldValue name="x_last_mod_date" type="date" value="-999">		

NOTE: Instead of the 'value' attribute, you can place the value as the inner text of the tag. This allows you to use a CDATA section for specially formatted text. Example:

<fieldValue name="x_test" type="string">
  <![CDATA[ This is some <b>formatted</b> with HTML and/or "XML" text in it. ]]>
</fieldValue>

Attribute

Required

Default

Description

name

Yes

N/A

Specifies the name of the actual field/column on the table.

type

Yes

N/A

Specifies the type of the data. Valid values are: string long double date

value

no (if inner text is present)

(empty string)

Specifies the value to use for this field. The value must be convertible to the type specified in the 'type' element. Please consult the .NET Framework SDK documentation for DateTimeFormatInfo and NumberFormatInfo for valid formats for 'long', 'double', and 'date' type values. To specify "NOW" for a date type field, use -999.

(inner text)

no (if value attribute is present)

(empty string)

Can be used instead of the value attribute to specify a complicated value. Refer to the value attribute documentation above for the requirements of this text.

See Also

Dovetail Email Agent Configuration

Configuration Parameters Introduction

Dovetail Email Agent Configuration Parameters Reference

ignoreList Schema

Email Tracking

Next

ignoreList Schema

caseCreateExtraFields, logCaseEmailInExtraFields, and logSubcaseEmailInExtraFields Schema