Overview

This structure is part of the response to PwsGetTimeEntryParameters and PwsGetExpenseEntryParameters and it contains metadata about the user defined fields associated with time cards or cost cards. The metadata consists of information such as the UDF data type, and valid values (for text list UDFs), as well as other attributes related to the actual UDF definition.

Format

PwsCardUdf

PwsCardUdf
- UdfDatatype: String
- UdfRequiredFlag: Boolean
- UdfValues: String (4000)
- UdfIdentity: PwsUserDefinedFieldRef
- UdfConnectorCode: String
- UdfDetailSubstitutionCode: String
- UdfItemDetailPageUrl: String
- DecimalDigits: Byte
- UdfPromptText: String

Elements

Element	Data Type	Required?	Description	Sample Data
UdfDatatype	String	N/A	The UDF data type: "D" for date "I" for numeric "T" for text "L" for text list "Y" for boolean "P" for relationshp type (i.e. JIRA and Zendesk)	I
UdfRequiredFlag	Boolean	N/A	Will be 'true' if the UDF is marked as required. Note that boolean UDFs may not be considered required.	false
UdfValues	String[]	N/A	The values associated with a text list type user defined field.
UdfIdentity	PwsUserDefinedFieldRef	N/A	This structure represents the unique key fields associated with identifying a user defined field.
UdfConnectorCode	String	N/A	The UDF connector code is associated with relationship type user defined fields. This field identifies the external connector that applies to this user defined field. External connectors must be separately configured in Projector.
UdfDetailSubstitutionCode	String	N/A	The UDF detail substitution code is associated with relationship type user defined fields. Projector stores three values for a relationship type UDF, a UID, a code and text. This field determines which of these values should be substituted for {0} in the UdfItemDetailPageUrl. The possible values are: "U": The UDF's UID value "C": The UDF's Code value
UdfItemDetailPageUrl	String	N/A	The UDF item detail page URL is associated with relationship type user defined fields. This is a URL that can be used as a link to the external entity referenced by a UDF value. The URL will contain a placeholder '{0}', that should be replaced by either the UID or code component of the UDF value (See UdfDetailSubstitutionCode).
DecimalDigits	Byte	N/A	The number of decimal places associated with a numeric type user defined field.	0
UdfPromptText	String	N/A	The prompt test for the UDF field.

Example(s)

Example 01

               <a:Udf1>
                  <a:UdfDatatype>P</a:UdfDatatype>
                  <a:UdfRequiredFlag>false</a:UdfRequiredFlag>
                  <a:UdfValues xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                  <a:UdfIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                     <b:UdfId i:nil="true"/>
                     <b:UdfName>TUDF_Jira</b:UdfName>
                     <b:UdfUid>1152921504606857845</b:UdfUid>
                  </a:UdfIdentity>
                  <a:UdfConnectorCode>JIRA-V2</a:UdfConnectorCode>
                  <a:UdfDetailSubstitutionCode>C</a:UdfDetailSubstitutionCode>
                  <a:UdfItemDetailPageUrl>https://projectorpsa.atlassian.net/browse/{0}</a:UdfItemDetailPageUrl>
                  <a:DecimalDigits i:nil="true"/>
                  <a:UdfPromptText>Search for Issue</a:UdfPromptText>
               </a:Udf1>