Query to Package 

The Query to Package command, accessed on the Data ribbon, allows a user to associate selected entities, along with the targets of the specified relationships chosen, with a designated Package. The command will also follow the selected relationships up to the number of levels specified.  This command can be used to quickly place all entities meeting specified criteria into a container (a Package), which can be useful for communicating a subset of model content with specific stakeholders, for containing all entities associated with a specific Integrated Product Team (IPT) or subystem, etc. 

To enable the command, the user must select the desired starting entity(ies) from the Browser. Multiple entitites can be selected by holding down <ctrl> and selecting the individual desired entities or by holding down the <shift> key and selecting a starting and ending entity, where all entities in between the two selected entities will be selected.

Once the Query to Package command button is pressed, the Query to Package query formulation pop-up window appears. 

The user must then specify:

1. Whether to create a new Basic Package or select an existing Basic Package in which to place the queried entities. 
2. Which relationships the query will follow from the specified starting entities to target entities. Multiple relationships can be selected simply by holding down the <ctrl> key while selecting the desired relationships
3. How many levels to trace out from the starting entities. Levels are defaulted to 1 level of target entities. If a higher value is entered, the function will attempt to continue following the specified relations up to the specified level depth and any target entities encountered will also be added to the package.

When the OK button is selected, the selected entities in the browser panel will have the targets of the chosen relations evaluated, and the selected entities as well as the target entities will be added to the specified package.  

The following conditional logic applies:

• If a new package is specified, it will be placed in the root of Basic Package.
• If a new package is specified that has the same name as an existing package, GENESYS will abort the Query to Package operation when OK is selected. 
• When an existing package is selected as the destination of the query, the contents of that existing package will be overwritten. All entities that were related to the existing package will be removed from the package and replaced with the results of the query. The user is warned of the pending overwrite and must approve it by pressing the OK on the proceed warning window. A “Select package to overwrite” dialog box will appear and allow the user to select the desired existing package. When the OK is selected the selected package will appear in the “Overwrite an existing package” field, and the radio button specifying the overwrite will be filled in. The user has the option to go select “Create a new package” and can simply click the radio button and then enter the new package name.

NOTE:

Choosing an existing package will result in the query results overwriting the relations to the existing package

 Due to the impending overwrite when an existing package is selected, the user will be warned with a confirmation window that will display the operations to be done.