verifGetReqCustomFieldValue

verifGetReqCustomFieldValue(
g_sessionId
t_reqId
t_fieldName
)
=> l_fieldValue / nil

Retrieves the value of the specified custom field of a requirement in a Verifier session.

g_sessionId	Integer, string number, or window specifying the Verifier session ID. For example, `0`, `"0"`, or `window(2)`.
t_reqId	ID of the requirement.
t_fieldName	String name of the custom field for requirements.

l_fieldValue	List of values of the specified custom field of the requirement.
`nil`	Specified custom field of the requirement does not exist, has no value, or the command failed.

The following example opens a Verifier cellview and retrieves the value of the custom field for a requirement.

uid = verifOpenCellView("test" "results" "verifier")
=> 0
verifGetReqCustomFieldNames(uid)
=> ("Email" "Engineer")

Returns "" if the custom field is empty and contains no value.

verifGetReqCustomFieldValue(uid "ID1" "Email") 
=> ""

Returns a value if the custom field contains the specified value.

verifGetReqCustomFieldValue(uid "ID1" "Engineer")
=> "Fred"

Returns nil if the query is for a non-existing custom field name.

verifGetReqCustomFieldValue(uid "ID1" "Project")
*WARNING* (VERIFIER-1239): unknown custom property name 'Project' on requirement 'ID1'
=> nil