DriveWorks Pro 17: SpGetCurrentState [send feedback...]

SpGetCurrentState

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

Syntax

SpGetCurrentState(Specification Id)

Where:

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

Example

RuleResultMeaning
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.

Column Headers

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

Table Result

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

NameTypeAll TeamsTeam NamesOwnerCreator
SpecifyRunningTrueAdministrators|Sales|Ops|EngineeringTrueTrue

Table of Contents