Integrations: How to use <FieldDefaults>

Products

• Rally On-Premise
• Rally SaaS

Issue/Introduction

Issues setting up <FieldDefaults> and receiving errors in the rallylog.log file.

Field Defaults are used when the destination system has a required field, but the field is not going to be mapped in the configuration file. This will cause field F1to be set to value of V1.

Resolution

You can set as many default values as needed. The <FieldDefaults> are set in the connection section of the system that you want to set values for.

<FieldDefaults>
   <Field>
      <Name>F1</Name>
      <Default>V1</Default>
   </Field>
   [....]
</FieldDefaults>

For a default to work successfully, you must use a valid field value for the destination system.

Additionally, there are two ways for a <FieldDefault> to be recognized

1. The F1 field is not mapped in the <FieldMapping> section
2. If the F1 field is mapped in the <FieldMapping> section then the field in the source system MUST be null, otherwise the connector will use the mapping and ignore the default setting.  

Additional Information

Note* <FieldDefautls> are only valid for COPY of artifacts only. Not valid for UPDATE service