verifSetReqCustomFieldValue

verifSetReqCustomFieldValue(
g_sessionId
t_reqId
t_fieldName
t_fieldValue
)
=> t / nil

Description

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

Custom fields can be specified using the Preferences form. To access the Preferences form from the Verifier graphical user interface, choose Edit — Preferences. To access the requirement editor form from the Verifier graphical user interface, select the requirement and choose Edit — Open Requirement Editor.

Arguments

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

Value Returned

`t`	The value of the custom field is successfully set to the new value.
`nil`	The value of the custom field is not set.

Examples

Consider that you have defined the custom fields Engineer Name and E-mail Address for the requirements of a verification project.

The following example opens a Verifier cellview of the verification project and sets the values in the custom fields for the specified requirement.

uid = verifOpenCellView("test" "results" "verifier")
=> 0
verifGetReqCustomFieldNames(uid)
=> ("Email" "Engineer")
verifGetReqCustomFieldValue(uid "ID1" "Engineer")
=> ""
verifSetReqCustomFieldValue(uid "ID1" "Engineer" "Harry")
=> t
verifGetReqCustomFieldValue(uid "ID1" "Engineer")
=> "Harry"

Virtuoso ADE Verifier SKILL Reference
Product Version IC23.1, November 2023