ACTIVITIES / ACTS
Searching for activities based on given criteria and displaying information about the activities that are found. There are two ways to display the output:
-
Formatted : The formatted output, which is used by default, is easier to read, but it can truncate some long names.
-
Unformatted : The unformatted output does not truncate any names, but can be less readable than the formatted output. It is specified by the -uf option.
Syntax
ACTIVITIES/ACTS
|
Syntax |
ACTIVITIES [-u userName] [-a activityName] [-risn @isnLowerLimit [@isnUpperLimit]] [[-i isn] [-w "workspacePath"] [-fFields] [-s state] [-uf]] |
|
Arguments |
|
|
[-u userName] |
Name of the user to which the activities of the specified activity list will be restricted. If the user name is given as ALL , the activities of all users will be displayed. There are three possibilities, also giving the restriction options that work with the corresponding possibility: User not specified: -c/-o/-risn/-e/-ex User specified: Only ActualName (and/or) ISN (and/or) workspace are required for closed activities of all users -risn Other combinations -c/-o/-risn/-rind/-p/-px/-cx/-e/-ex . |
|
[-a activityName] |
If specified, the activity list will be restricted to the activities whose names are provided. |
|
[-risn @isnLowerLimit [@isnupperlimit]] |
This option should be specified if the listing has to be restricted based on Integration Sequence Numbers (ISNs) of the activity. <Example> Lists activities whose ISN is between 3 and 8: -risn @3 @8 <example> Lists activities whose ISN is greater than 8: -risn @8 |
|
[-i isn] |
Integration Sequence Number (ISN). If specified, the activity list will be restricted to the activities whose ISNs are provided. If ISNs are specified, then a workspace has to be specified since the ISN of an activity is dependent on the workspace. If activities are specified using either -a or -i then the restriction of -w does not hold, that is, all the activities of the workspace will not be displayed. Also none of the other restrictions specified using the options below will apply. |
|
[-w "workspacePath"] |
If specified, the activity list will be restricted to the activities which belong to this workspace only. If a workspace is not specified and the current directory (in shell mode) is under a workspace, then the activities will be shown for that workspace only. If the user is not under a workspace, all activities will be shown. |
|
[-fFields] |
Allows you to specify the properties of the activities that have to be displayed. |
|
[-s sort] |
Using this option, you can specify the field on which the sorting of the output is based. The fields that can be specified are the ones listed above. The entries are sorted in ascending order by default. Sorting of output activities will be for each workspace. |
|
[-uf] |
If this is specified, then the field values will not be truncated to fit into a given space. However, this may lead to output that is not easy to read. We recommended that you use this argument for scripting only. |
|
[-wall] |
If the user is under a workspace and still wants to view all activities, then this option has to be used. |
|
[-o] |
If specified, the activity list will be restricted to the open activities. |
|
-c |
If specified, the activity list will be restricted to the closed activities. |
|
-e |
If specified, the activity list will also contain a list of empty activities. |
|
-ex |
If specified, the activity list will contain only a list of empty activities. |
|
-cx |
If specified, the activity list will contain a list of activities created in the specified workspaces. |
|
-p |
If specified, the activity list will also contain a list of propagation lists. |
|
-px |
If specified, the activity list will contain propagation lists only. |
|
-f |
Using this option you can specify the properties of the activities that have to be displayed. List -fDisplayName -fCheckInDate |
|
Description |
Displays information about activities. |
All Open Activities of One User in a Specific Workspace
To show all open activities of user X created in workspace //path/to/wsp1 , execute:
acts -UX -w //path/to/wsp1 -o
The -U option specifies the user who created the activity, the -w option specifies the workspace the activities are associated to, and the -o option specified that you want only open activities.
All Activities Integrated into a Workspace After a Specific Date
To show all activities integrated into workspace //path/to/wsp1 after the 1st of April 2007 (for each activity, show its name , creatorname , and integrationdate ), execute:
acts -w //path/to/wsp1 -rind "@2007-04-01 00:00:00" -fAN -fCBy -fIND
The option -rind "@2007-04-01 00:00:00" specifies the "integrated after 1st of April 2007" constraint, the -f switches specify output fields as follows: - fAN specifies the activity name field, -fCBy specifies the field created by and -fIND specifies the field integration date .
All Activities Integrated into a Workspace in a Specific Period
To show all activities integrated into workspace //path/to/wsp1 between 1st of April 2007 and 1st of May 2007 , execute (for each activity, show its name , integrationdate and the integration number ; use unformatted output):
acts -w //path/to/wsp1 -rind "@2007-04-01 00:00:00" "@2007-05-01 00:00:00" -fAN -find -fIN -uf
The -fIN option specifies the field integrationnumber . The -uf specifies the option unformatted output .