SpGetCurrentState (DriveWorks Documentation)

SpGetCurrentState

Will return a table of the given specification's current state information.

SpGetCurrentState(Specification Id)

Where:

Specification Id (optional) is the Id of the specification to return the current state information.

Rule	Result	Meaning
SpGetCurrentState()	{"Name","Type","All Teams","Team Names","Owner", "Creator"; "Specify", "Running", True,"Administrators\|Sales\|Ops\|Engineering", True, True}	This will return a table showing the information about the current state in the current specification.
SpGetCurrentState("174")	{"Name","Type","All Teams","Team Names","Owner", "Creator"; "Specify", "Running", True,"Administrators\|Sales\|Ops\|Engineering", True, True}	This will return a table showing the information about the current state in the specification with the Id of 174.

The columns returned in the table and their meanings are listed below:

Name - The name of the states in the project.
Type - The type of state (running, paused or automatic)
All Teams - True if All is checked in the Specification Flow Security.
Team Names - A pipe delimited list will be returned of the teams that have permission to the state.
The Team Names displayed are the Teams that have access to the state.
In some circumstances this could differ from the Teams that have been set on the state itself.
This is because subsequent Transitions could elevate a Team's permission to the state.
Owner - True if the Owner of the specification, as defined in the Specification Flow Security, has permission to the state.
Creator - True if the Creator of the specification, as defined in the Specification Flow Security, has permission to the state.

For more information on States and Specification Flow see Specification Flow

The result from the function as displayed in a table (such as a Data Table).

Name	Type	All Teams	Team Names	Owner	Creator
Specify	Running	True	Administrators\|Sales\|Ops\|Engineering	True	True