|[Home] [Search] [News] [Site map]|
ART Report Folder
What is the Report Folder?
The Report Folder is a mean of storing your most frequently used queries for AIS applications such as HRT and CET. Once you have used a form to build a query and have set your display preferences (like the list of columns of interest), you may save all of these settings for future use. Once you have saved a report, you may run it at any time. The data will always be selected and formatted in the way that you originally specified.
Storing a report also allows you to schedule a report for automatic execution. E.g. once scheduled, a report is executed in a certain interval (e.g. daily, weekly or monthly) and the results are sent by email to a list of recipients you are free to define. Please click here to learn more about scheduling reports.
Where to Find it
The Report Folder Interface
When you open the Report Folder, it presents itself as shown below:
The Report Folder screen consists of two parts. On the left-hand side, there is the folder tree. On the right-hand side, there is the list of reports that are attached to the currently selected folder. In the above screenshot, the currently selected folder is the root folder (which has a slash as its name '/').
Above each part of the screen (folders and reports), there is a toolbar. The icons are shown in black and white when no action is possible. As soon as a folder or a specific report is selected, the available icons are coloured and clickable. A small tooltip (popup note) indicates the purpose of each button.
Both parts, the folder tree view and the reports table also have a context menu (popup menu), which appears when right clicking on any folder or report. In the context menu, several options depending on the type of folder or report are available. For example it is possible to quickly rename a folder or a report. A report can also be executed, edited or scheduled via the context menu. For folders tree view, specific options like "Expand/Collapse All" are available.
Organising your Reports in Folders
All of your folders are arranged in a tree-like structure beneath a root folder. Folders may contain sub-folders and are used to classify stored reports. They may also be created, renamed, moved or deleted, although you cannot perform these actions on the root folder. Before any of these actions can be performed it is necessary to select a folder to work with.
Navigating in the Folder Tree
Creating a New Folder
You can create a new folder anywhere you like within the structure you have built. Only the "Inbox" folder is not allowed to have any child folders. After creating, a folder can be used straight away to attach your reports and/or other folders.
Renaming an Existing Folder
Renaming a folder works similarly to the creation of a new folder. You have two options to reach the renaming functionality. Either you select a folder and click on the rename icon in the toolbar above the tree or you choose "Rename" in the context menu of a folder. In both cases, a dialog similar to the one shown above for the creation of a new folder, will appear. It allows you to enter a new name and to confirm or cancel your change.
Moving an Existing Folder
To help keep your folder structure in a manageable state, it is possible to move folders around within the tree structure. If you move a folder, all of its sub-folders and any reports that it contains are moved along with it.
Moving folders works using drag and drop. In order to initiate a folder move, point the mouse to the folder you want to move, click it and keep the mouse button pressed down. The folder will become surrounded by a black border and gets a grey background. It can now be moved to another folder.
As soon as you move the folder over another folder and you are allowed to drop your folder there, the background and the border of your dragged folder changes to green. Now, if you release the pressed mouse button, the folder (together with all its sub-folders) will be moved to its new location. See the example in the below screenshot:
Deleting an Existing Folder
You may delete unwanted folders from your folder structure at any moment. Remember that any sub-folders or reports stored within the deleted folder will also be erased, so use this facility with care. There is no possibility to roll a deletion back in the case the deletion was accidental or unintentional!
If you are sure, you want to delete a folder, you can proceed by selecting the folder and then either choosing the delete button from the toolbar above the folder tree or the "Delete" entry from the folder's context menu. Once the button or the context menu item is clicked, you will be asked to confirm your intention before the deletion is actually carried out.
After a folder has been deleted, it will immediately disappear from the folder tree. It, as well as all its sub-folders and all reports attached to it, will be physically removed from the database.
Storing new Reports
It is not possible to create a report directly from the Report Folder application. These pages only provide a mean of browsing and loading existing reports. To create a report, you must first prepare a report in an AIS application such as HRT or CET. You can do this following these instructions:
Go to HRT or CET and open the report you wish to store. In this example, the HRT Personnel List will be used as an example. Open the Personnel List (see point 1 in below screenshot), enter some criteria (2), choose the columns and orderings you require and then click the "Store Report" (3) button.
Now, the HRT/CET Report Folder will be opened in a popup window. You recognise that the folder is in the "Store Report" mode because of the red message box directly below the page header. At first you should select a folder in which you want to place the report to be stored (4). The selection is done by either double-clicking the desired folder or by right-clicking it and selecting "Select" from the context menu.
When you have selected the right folder, you should click on the link "click here" (5) in the red message box. The a small dialog pops up and asks you to enter a name for the new report (6). Type a name (be careful when choosing the name as each name has to be unique within a specific folder) and confirm your selection using the "Ok" button. You can also cancel the process by clicking "Cancel".
If a report with the same name already exists in the selected folder, you are asked whether you want to overwrite the existing report.
If the save operation succeeds, a small message will appear. Then the report appears in the list of reports being attached to the currently selected folder.
Working with your Reports
Your reports should be organised within the structure you have defined using folders. Reports may be executed, edited, renamed, moved, scheduled or deleted from within the Report Folder. In order to perform the various actions on a report, a report must be selected and then the desired action can be performed by pressing one of the available toolbar buttons. Another possibility is to just right click any report and choose the desired action from the available context menu.
Selecting a Report
To select a report, at first find and select the folder which contains it. When you have found the right folder, click on any part of the report (e.g. its name or description). However do not click on the ones mentioned below to select it.
A selected report is highlighted using a different colour.
Executing a Report
Once saved, reports may be executed without going to the application's desktop or the actual report before. That is to say that the data itself is retrieved once the report has loaded, without any intervening steps. There are three ways of executing your stored report:
Editing a Report
You may edit existing reports in order to make changes, run a slightly different 'one off' version, or as a shortcut to create and save an entirely new report.
After having edited the report, you have several options of following up. You may run the report in the usual way, e.g. click the 'Retrieve' button on the form and gather the data. If you wish to save the changes you have made, you should store the modified report using the 'Store Report' button on the form. There you have two options:
Renaming a Report
You may change the names of reports saved in the Report Folder.
Moving a Report
Once you have saved a report, it is possible to change the folder that it is stored in. In order to achieve this, a report needs to be moved to a different folder by using drag and drop.
At first, before you can start dragging a report, you need to select it by clicking for example at its name (1). Then you click it again but this time you keep the mouse button pressed. You can now move the report around. As long as it is not above a potential target folder, the report is represented by a grey box (2). This box changes its colour to green as soon as you are allowed to move it to that folder (3).
When you are above the right folder, just release the mouse button. The report will be moved to the new folder. A short confirmation message appears and the report disappears from the list of reports as the current folder remains the selected (the report is available in the folder it was dropped at). If you change to the target folder, you will see the moved report there.
Scheduling a Report
Deleting a Report
You may remove unwanted reports from the Report Folder by deleting them.
Sending Your Reports to Other Users
The Report Folder has a functionality that allows you to receive reports sent to you by other users and to send your saved reports to them. A dedicated folder called 'Inbox' allows you receiving reports from your colleagues.
The first time someone sends you a report, an Inbox folder appears in your folder tree. The Inbox works like other folders described above. The only restrictions are that it is not possible to create subfolders nor to move in other folders or reports.
Reports sent by other users of AIS applications appear in your Inbox with an annotation about the sender in the description. Note that you do not receive notification of a new report arriving. Preferably ask the person sending a report to you for an alert.
To check the contents of your Inbox simply select it as you would do with a normal folder. Remember, that you may not have the Inbox icon in the folder list, it appears the first time when someone sends you a report.
Sending of a Report
Sending a report to another user is as simple as all the other functions you can perform with the Report Folder. Note that the recipient does not receive notification of a new report arriving, though the report holds an annotation about the sender. Therefore some prior communication with any persons to whom you are sending reports is useful.
To send a report, select it and choose the "Letter" button from the toolbar or the "Send" entry from its context menu (1). A new dialog will be opened. You can now enter the names of the intended recipients or the names of organic units into the text fields that have appeared (2). Once a report has been sent you are informed about it by a small alert window (3).
Note that you can enter names of several recipients separating them with commas. Sending to an organic unit (which can also be a virtual unit) is equivalent to sending to all of its members. A standard search facility is provided to enable you to choose the right person or organic unit.
Consideration of Application Access
Although it is possible to send any report to another user of an AIS application, it is worth remembering that other people might have different levels of access to the application data. For example, in HRT access is determined by your organic or PPA unit and any roles that you are holding. Although you can send a report to any other user the results that they get back might not be the same since it is their application access which is applied to the query and not yours.
Similarly, transmitting a report to a user with a "lower" level of access does not circumvent the access mechanisms in place. The receiving user simply sees the report's results with his or her own access levels applied (i.e. possibly he/she sees no, fewer or more rows than you).
|[Home] [Search] [News] [Site map]|
Last modified on 27.03.2009