GetUdfValues
For a given user-defined field (UDF), get a list of Projector entities that have a defined value for the UDF, along with the UDF values.
Request
The service request contains:
Name | Data Type | Required? | Default Value | Discussion |
|---|---|---|---|---|
UdfType | string(1) | yes | Set to type of UDF: "C" for client, "E" for Engagement, "P" for Project or "R" for Resource. Service does not support Role, Task, Issue, Time card, or Cost card UDF types. | |
UdfName | string(32) | yes | The name of the UDF. Stoplight UDFs are not supported. | |
UdfValueInteger | integer | no | If a value is specified here, and the UDF is an integer UDF, results will be limited to those Clients, Engagements, Projects or Resources whose value for the given UDF matches this value. | |
UdfValueString | string(255) | no | If a value is specified here, and the UDF is a string UDF, results will be limited to those Clients, Engagements, Projects or Resources whose value for the given UDF matches this value. | |
UdfValueDate | date | no | If a value is specified here, and the UDF is a date UDF, results will be limited to those Clients, Engagements, Projects or Resources whose value for the given UDF matches this value. |
Response
For each value in the result set the following data is returned:
Name | Data Type | Discussion |
|---|---|---|
EntityReferenceID | string | Content depends on UDF type. For Clients, it is the Client Number, for Engagements, the Engagement Code, for Projects the Project Code and for Resources, the Resource Reference System Id. |
EntityName | string | Content depends on UDF type. For Clients, it is the Client Name, for Engagements, the Engagement Name, for Projects the Project Name and for Resources, the Resource Display Name. |
UdfValue | string | The UDF value, converted to a string if necessary. |