ReqFactory object

Manage requirements, including adding and removing requirements.

You get a ReqFactory object by TDConnection.ReqFactory.

Public methods

This object supports the following methods.

Method Description

AddItem

Creates a new requirement.

For details, see AddItem.

Mail

Mails a list of items.

For details, see Mail.

MoveRequirements

Moves the requirements to be child nodes of the specified parent.

Syntax: MoveRequirements(reqIDs, newPositions, newParentId)

Parameters:

  • reqIDs. A string that represents the IDs of the requirements to move. The IDs are quoted and separated by commas. For example "1, 2, 3".

  • newPositions. A string that represents the new positions of the requirements. It is quoted and separated by commas.. For example "1, 2, 3". The positions are 1-based.

  • newParentId. A number that represents the ID of the new parent requirement under which the specified requirements are moved.

Note:

  • The requirements are handled one at a time. The position for the working requirement cannot be greater than the total number of Req objects under the new parent. For example, when moving four requirements under an empty parent, setting the order to "2, 1, 3, 4" fails because when the first requirement is handled, there are not 2 requirements under the parent.

  • The list of IDs and the list of positions must be the same length. The first position applies to the first ID, and so on.

  • If a position number is repeated, the second requirement with the same position is inserted before the previously placed requirement at the specified position, thereby moving all lower items down one position.

NewList

Creates a list of requirements according to the specified filter.

For details, see NewList.

RemoveItem

Removes a requirement from the database. Removal takes place immediately, without a Post.

For details, see RemoveItem.

Item

Gets an object managed by the factory by its key.

For details, see Item.

Public properties

This object supports the following properties.

Method R/W Type Description

Fields

R List

The list of all available fields for the entity managed by the factory.

Syntax: ReqFactory.Fields

Filter

R Object

The TDFilter object for the factory. See TDFilter object.

Syntax: ReqFactory.Flter

Example

Example: Move requirements

Back to top