Skip to main content

Roster Engine

The Roster Types that are set to active on this page will be available in the Roster drop-down list on the Routings tab of the Form Type Table.

Navigation: Main Menu > Manage GT eForms 3.x > GT Functional Setup > eForm Parts Gallery > Roster Type Table

Roster Type Setup
Screen shot of Roster Type Setup
FieldValue/Use
1 (Add and Remove buttons)The plus button will add a new entry. The minus button will remove the entry.
2Roster TypeTwo letter unique identifier
3Active FlagActive when checked
4DescriptionDescription for this roster type
5Short DescriptionShort description
6Edit TableSelect the table used to define values for roster type
7Root Package IDSelect the package ID
8Qualified Package/Class PathEnter path
9Application Class IDEnter class ID

Roster Groups

The Roster Types that are set to active on this page will be available in the roster drop-down list on the form type table routings tab.

Navigation: Main Menu > Manage GT eForms 3.x > Form Setup > Form Type Table > Routings tab > Roster Lookup icon

Alt Navigation: Main Menu > Manage GT eForms 3.x > GT Functional Setup > eForm Parts Gallery > Roster Groups

Roster Groups Main Setup

Define Roster Groups
Screenshot of Open Roster Group
FieldValue/Use
1Open Roster GroupLink to select an existing roster group. Allows users to make edits or a copy of group
2Remember MeDefine the name that should be used when saving this group.
Note: this must be a unique name or an error will appear.
3ClearClears the data on the page
4DeleteDeletes the roster group from the database
5Screenshot of Roster Lookup button (Roster Lookup)Opens the Roster Lookup page. See details below.
6Screenshot of Add, Intersect and Subtract ButtonsSelect the operator for the user roster that follows.

'Add' will add the user list to the list of users above.
'Intersect' will only include the users on the list above and those in the selected user list.
'Subtract' will remove the users in this list from the list above.

Roster Lookup

Use the roster lookup to build pieces of the roster group. Select roster type and user roster in the window below

Define Roster Groups - Roster Lookup
Screenshoot of Roster Lookup.
FieldValue/Use
1Roster TypeList of active roster types from the Roster Type Table
2User RosterSelect the User Roster

Defined Rosters

Most Rosters can be set up in Form Configuration via the Form Configuration link. However, there is an option to add complex filters that pass in binds from the form (or system) to help limit the list of users in the roster for that specific form or step. This page is used to configure Rosters that require binds.

Screenshot of Defined Roster SetupNavigation: Main Menu > Manage GT eForms 3.x > GT Functional Setup > eForms Parts Gallery > Defined Roster Setup

The search defaults to Advanced Search. To change to basic search, click Basic Search

FieldValue/Use
1FilterName for this filter. When creating a new filter use a name that easily distinguishes what is the purpose of the filter.
2Filter TypeSelect from PeopleCode, Query, or SQL object.
3Workflow ContextSelect the workflow context for this filter from the list of developed contexts
Basic Search using one of the below fields. To change to the advanced search, click Advanced Search.
Screenshot of Defined Roster Setup
FieldValue/Use
1Search bySelect from Filter, Filter Type, or Workflow Context. See the above Advanced Search section for details on each of these fields.

Add a New Value

Add a new value to create a new defined roster
Screenshot of Add a New Value Defined Roster Setup
FieldValue/Use
1FilterName for this filter. When creating a new filter use a name that easily distinguishes what is the purpose of the filter.

Defined Roster Table - PeopleCode (defined roster)

Defined Rosters - PeopleCode
Screenshot of PeopleCode Defined Roster Setup
FieldValue/Use
1Defined RosterThe description should be easy for the functional user to identify
2Roster TypePeopleCode
3Root Package IDSelect the Root Package ID
4Qualified Package/Class PathSelect the Path
5Application Class IDEnter the Class ID
6Bind Values – Param NameParameters for the workflow filter can be further defined by a bind variable that can be a predefined snippet or defined here.
7Bind Values – Constant/SmartSourceDefaults to Constant. For a SmartSource, click the Constant button once to define the parameter as a SmartSource.
8Bind Values – Constant Value/Param ValueEnter a constant or use the lookup to select a SmartSource for the given parameter
9Add a RowAdds a row to add an additional bind value
10Delete a RowDeletes a row to remove a bind value

Defined Roster Table –Query

Defined Rosters – Query
Screenshot of Query Defined Roster Setup
FieldValue/Use
1Defined RosterThe description should be easy for the functional user to identify
2Roster TypeQuery
3Query NameSelect the query name
4Bind Values – Param NameDefaults based upon the prompts defined in the query.
5Bind Values – Constant/SmartSourceDefaults to Constant. For a SmartSource, click the Constant button once to define the parameter as a SmartSource.
6Bind Values – Constant Value/Param ValueEnter a constant or use the lookup to select a SmartSource for the given parameter

Defined Roster Table – SQL Object

Defined Rosters – SQL Object
Screenshot of SQL Object defined roster setup
FieldValue/Use
1Defined RosterThe description should be easy for the functional user to identify
2Roster TypeSQL Object
3SQL Object IdentifierSelect the SQL Object Identifier
4Binds Values – Bind NumberAuto-numbers based on the number of rows on the page
5Bind Values – Constant/SmartSourceDefaults to Constant. For a SmartSource, click the Constant button once to define the parameter as a SmartSource.
6Bind Values – Constant Value/Param ValueEnter a constant or use the lookup to select a SmartSource for the given parameter
7Add a RowAdds a row to add an additional bind value
8Delete a RowDeletes a row to remove a bind value