Create a Report
Access
Tabs: Headings, Output, Prompts, Selection, Sorting
Create a Report is the first step in creating reports using the Report Builder feature. You can access the Report Builder feature from any module menu in STORIS.
Use the Report Builder feature to create custom reports based on a source file you specify, for example the Order file. You specify
-
specify the data for the report - indicate one or more dictionaries (that is, data repositories, for example the Selling Store Location) associated with the source file, and
-
how and where you want the data to appear on the report (for example, the placement of your data columns).
STORIS provides a reference list of the source files and the associated dictionaries that are available to you via Report Builder routines. When planning your report, you can use the list to identify the files and dictionaries you want to include on the report.
STORIS uses numeric transaction codes throughout the system. You can include them in reports using the TRANS_CODE dictionary in the Create a Report routine. Click here for a list of these codes.
To download the latest source file list, which is in Microsoft® Excel format, click here. Enter the User ID and Password you established when you registered for access to the Customer Service web site. After logging in, click on the Documentation menu at the top of the screen, then click on Vision, and then select Spreadsheet Downloads. Scroll down to the bottom of the downloads page. In the Report Builder Source Files List section, click on the link for your revision's list. For example, if you are on STORIS release 9.5, click the 9.5 Report Builder Source Files List button. The File Download window appears, where you can Save the file to your PC.
You access report builder reports via the Run a Report routine or you can use the Set Up Menus routine to Add Reports and DTS Views to Menus.
Report Name
Headings
DescriptionEnter a text description for this report.
Source FileSpecify the source file on which to base your report. You can choose only one file for each report. If you click on the Arrow next to this field, you can choose from a list of available system files.
TitleEnter the title you want to appear at the header of the report.
Sub TitleEnter the sub-title (if any) you want to appear at the header of the report.
If you enter a valid prompt dictionary name (that is, a dictionary name that appears when you click on the arrow at the Dictionary Name prompt on the Prompts tab) and surround it with braces ' {} ', the value you specify for the dictionary name (that is, the response you entered at the dictionary name prompt on the run-time options screen) appears in the header area of the printed report.
For example, if you enter {ORD_DATE} in this field, specify 'Range' as the Prompt Type, and enter a date range of 01/01/07 through 05/01/07 in the associated Order Date field on the run-time options screen, that date range appears on the header of the printed report.
FooterEnter the footer (if any) you want to appear at the bottom of the report.
If you enter a valid prompt dictionary name (that is, a dictionary name that appears when you click on the arrow at the Dictionary Name prompt on the Prompts tab) and surround it with braces ' {} ', the value you specify for the dictionary name (that is, the response you entered at the dictionary name prompt on the run-time options screen) appears in the header area of the printed report.
For example, if you enter {ORD_DATE} in this field, specify 'Range' as the Prompt Type, and enter a date range of 01/01/07 through 05/01/07 in the associated Order Date field on the run-time options screen, that date range appears on the header of the printed report.
Run Time InformationUse this field to enter any notes or instructions you want users to see before they run the report, for example how or when the report should used. You can enter as much text as you want. The system stores the text and then displays it when a user selects it in the Run a Report routine.
Type
OwnerIf you specify an existing report at the Report Name field, the system displays the User ID and Name (from the User File) of the log-on user who created the report.
Creation DateIf you specify an existing report at the Report Name field, the system displays the date the report was created.
Run Time Language Code
Access

Output
Use the fields on this tab to select the detail information you want to include on the report, as well as how you want the information to display (for example, column headings, column widths, sorting, breaks on data, alignment of data, and totals.
Dictionary ItemUse this field to determine the specific detail that will be displayed on this report. Select a Dictionary Item from the drop-down menu to include that information on the report. The dictionaries available for selection are based on the Source File that was chosen on the Headings tab.
Column Heading
WidthThis field determines the width (number of character spaces) of the column of information on the report. The width set for the dictionary selected will default in this field, but may be changed for this report.
BreakSelect this option to have the report break on this field. Note that the field needs to be added as a sort field in order to break on it.
Note that break points do not show on the report if you output to Excel.
New PageTo insert a page break after this dictionary item, check the box. To access this field, you must check the box at the Break field.
TotalSelect this option to include a total for this column of data. The availability of this field depends on the selected dictionary item.
If you choose a dictionary item for break and another for total, you invoke the Summary Only field to appear when you run the report in the Run a Report routine. If you check the Summary Only field, the report omits the details and includes only the totals for the item you selected for break.
Total Report WidthAs you add columns of data to the report, this field displays a running total (from left to right) of the character spaces required to display data on this report.
Note that if you output to Acrobat Reader® and your report exceeds 132 characters wide, the extra characters wrap to the next line.

Prompts
Use the fields on this screen to set up additional run-time prompts for this report. You establish prompts for selected dictionaries, and the prompts appear on the report when selecting criteria for the report.
Dictionary Name
Prompt NameThis field is used for reference purposes only to identify the prompt for this dictionary.
Prompt LabelThis is the text that will appear when the user is prompted to select criteria for this dictionary.
RequiredIf this field is selected, the user will be required to make a selection at this prompt.
Specific EditsThis field is for STORIS use only. This field is used to build or edit a list of available responses for this prompt. The availability of this field depends on the selected prompt. When this field is initially selected, an entry window displays for the creation of the list. To edit an existing list, click the Action button to the right of the field to access the entry window. The Enter field is used to identify the selection data. The Display field is used to define how the selection appears on the screen.
Prompt TypeThis field is used to determine the type of data prompt to display. Select Simple to allow only a single response (Y or N for example) to the prompt. Select Range to allow the user to select a range of data (date range, for example) at this prompt. Select Multi Select to permit the user to select multiple items (multiple product codes for example) in response to this prompt.
Include/ExcludeThis field is used only if Multi Select was chosen at the Prompt Type field. Select Include if the items selected at this prompt are to be used in determining the criteria for this report. Select Exclude if the items selected at this prompt are to be excluded when determining the criteria for this report. For example, the user lists several product codes at a multi-select prompt, and Exclude was chosen at this field. The report will not include data for those products.

Selection
Use the Selection tab to establish condition statements that further limit selection of data for the report.
Dictionary NameSelect a Dictionary from the drop-down menu. The Dictionaries available for selection are based on the Source File chosen on the Headings tab.
OperatorThis is the comparison identifier to be used in this condition statement to select data. For example, select EQ if the dictionary item selected must be EQUAL to the entry in the Value field to be included in the report. Other valid options for this field are NE (Not Equal to), LT (Less Than), GT (Greater Than), LE (Less Than or Equal to), GE (Greater Than or Equal to), TR (True), and FL (False).
Value
You can also exclude or include a value of "blank" for a specific field. For example, if you are reporting customers with email addresses, select the Dictionary Name EMAIL_ADDR (Email Address) on this Selection tab. Next, select NE at the Operator field and at this Value field, enter "" (two quotation marks, no space). Your report includes only those customer records that have an email address and excludes any where the email address field is blank.

Sorting
Use the Sorting tab to specify how you want to sort the report data.
Dictionary NameSelect a Dictionary from the drop-down menu. The Dictionaries available for selection are based on the Source File chosen on the Headings tab.
Sort OrderSelect Ascending to sort the data for this dictionary item in ascending order. Select Descending to sort the data for this dictionary item in descending order.
When you finish building the report selections, click the Save button at the bottom of the screen to save this report. If you have not already Added Reports and DTS Views to Menus, a prompt appears asking if you want to. The next step is to process the report using Run a Report (Run Query Wizard).
