Reports in Cellica Database – Enterprise Edition

Introduction: _________________________________________________________________________ 3

Report Manager: ______________________________________________________________________ 4

Creating Report: _______________________________________________________________________ 5

Report Properties: _____________________________________________________________________ 8

Report Controls _____________________________________________________________________ 8

Label: ___________________________________________________________________________ 8

Text Box: ________________________________________________________________________ 9

Container: ______________________________________________________________________ 10

Formula: ________________________________________________________________________ 11

Unbound Image Control: ___________________________________________________________ 11

Graph: _________________________________________________________________________ 12

Location:________________________________________________________________________ 13

Shape:__________________________________________________________________________ 14

Grid Control: ____________________________________________________________________ 14

SubReport: ______________________________________________________________________ 14

Input Parameters: ________________________________________________________________ 15

Using Reports on Form: ______________________________________________________________ 19

Using Reports in Cellica Database Device Application: _______________________________________ 21

Introduction:

“Report” is the easiest way to organize and present data from your database.

Reports enable you to format your data in an attractive and informative layout for

printing or viewing. Reports provide a way to distribute snapshots of your data,

either by being printed out or converted to PDF. Reports can provide details about

individual records, summaries across many records, or both.

For meetings, for mailings, for making your point, there's nothing better than clear,

elegant data. Whether you are sharing a weekly status report with your team or

sending a product catalog to your customers, reports draw attention to your data

and make it work for you.

Cellica Database includes a module namely “Report Manager". Use this to design

reports for profiles as per your requirement.

“Report Manager allows to graphically design report layout using wide variety of

controls and link fields from profile as a data sources. Fields from these tables can

be placed on the report design surface, and can also be used in formulas. Formulas

can be evaluated at several phases during report generation as specified by the

developer.

Support controls in “Report Manager” have a wide array of formatting options

available. Cellica Database Reports also supports subreports, graphing, drawing and

GPS functionality.

Report Manager: Open “Reports Manager” module in Cellica Database Enterprise Edition desktop

application.

Figure 1: Report Manager

Add Report: Click on "Add Report" button to create a new report for a profile.

Edit Report: Use "Edit Report" button to modify the existing report layout.

Add/remove Users: Assign or remove user for the selected report.

Remove Report: Removes selected report.

Report Password: Administrator can set password to each report using this

option. Password set for each report will be same for all the users assigned to that

report. When user will try to open the report on his device, software will ask for

password. Device user needs to use the password set by administrator to view the

report on device.

Creating Report:

Click on “Add Report” button. Now select a base profile for report from list of

profiles.

Figure 2: Select Base Profile for Report

Select “Design New Report”.

On “Select Users” page of report creation wizard, select the users for which you

want to create this report.

You can also use “Import Report” option to import already exported/saved report

template from Cellica Database application.

Reports can be designed in both “Portrait” and “Landscape” Mode.

Select “Page Size for Report”. Currently supported page size are, “Letter”, “Legal”

and “A4”.

Figure 3: Select User and Page Size for Report

After clicking on Click “Next” button, you will get blank canvas to design the

report.

Add controls to canvas from Control Pallet according to your requirement. You can add controls to canvas by two ways either select the control in Control pallet and

drag it to canvas or select the particular control and then click on canvas.

Figure 4: Report Designer with various controls

Figure 5: Report with SubReport

Report Properties:

Use "Report Properties" to set Report Name, Caption (SubReport names), Report

Color, Page size : user can specify the size for report, this size is used while

printing report.

Figure 6: Report Properties

Report Controls Following section will explain controls available for reports. To design a report, you

have to drag the control as per your requirement and set the properties for each

control.

Label:

You use labels on a report to display descriptive text such as titles, captions, page

number, time stamp, current time or brief instructions. Labels don't display values

from fields or expressions; they're always unbound.

Content Type: Here select the type as per your requirement.

- Label: Display the Caption.

- Page Number: Displays the page number on report pages

- Now: Displays the current time when report is generated.

- TimeStamp: Displays a Fix DateTime value provided at the time of report

design.

Show Border: Show/Hide border around label.

Align Text: You can align the text to Left, Right and Center.

Figure 7: Label control properties

Text Box:

Use text boxes on a report to display data from a column. This type of text box is

called a bound text box because it's bound to data in a field.

Set “Data Column”. Select the field, which you want to bind with this text field.

Figure 8: TextBox control properties

Container:

To view the image data, you must set following properties to your container control.

Set the “Content Type” property to “Image”. Map the Data Column property to your

image data type column where your image data will be saved.

Figure 9: Image/Signature control properties

Formula:

In Formula field, you can use +, -, *, /, (, ) operators in formula along with the

function provided in List Control.

Select Form Options to select the field which you want to use in the formula.

Select Functions, to use various conversions and Math functions in your Formula.

Select Operators to select operators like +.-, *, /.

Double click on the Field names, functions or operators you want to use in the

formula. Double click or Paste button will write selected function or field name in

Formula control.

Figure 10: Formula control properties

Unbound Image Control:

Please note that, this control will not show images from data column. This control

can be used to display images assigned to records on device by using unbound

image control on form.

Figure 11: Unbound Image control properties

You can also use Unbound Image Control to display Logo which is transferred from

desktop.

Set “Content Type” property to “Logo”. Now select the logo from available list in

front of “Logo Name” property.

Figure 12: Content Type for Unbound Image Control

Graph:

You can use graph control to add various type of graphs on your report. Set “Chart

Type” property to required chart type. Now set the other information such as X-Y

axis column names.

Figure 13: Graph Control Properties

Location:

You can use location control to add location to your reports. When report is

generated location control will get values according to “Location Type” property set

while designing report.

Figure 14: Location control properties

Shape:

You can draw various shapes using Shape control on report. Set “Shape Type”

property to required shape. You can draw Line, Rectangle, Oval and Rounded Rect

using Shape control.

Figure 15: Shape Control Properties

Grid Control:

You can use Grid control to view multiple records on report in list view. Use

“Column Settings” property to set the required column information for grid.

Figure 16: Grid Control Properties

SubReport:

A Subreport is a report that is inserted in another report. The primary report is

called the main report (main Report: A report that contains one or more

subreports.), and the report within the main report is called the subreport. A

report/subreport combination is often referred to as a hierarchical report, a

master/detail report, or a parent/child report.

Set mapping for Subreport control like Subform control.

The important property is “Print Option”, You can print only currently viewable

records on subreport (number of records that fit in to size of subreport) or you can

print all records related to main record in subreport. In this case the report may

span to multiple pages depending on the number of records in subreport for single

main report record.

Figure 17: SubReport control properties

Input Parameters:

You can use the “Input Parameters” property of report to set the parameters of a

report at run time. You can pass the appropriate values to the Input Parameters

that can be either fixed or dynamic.

Input parameters are fixed values/ data fields that you pass to the report at run

time.

Administrator can specify input parameters to the Report, based on which the

report can display data.

If we design a report to display employee information, we can provide a parameter

to the report stating which employees need to be displayed. In Cellica Database we

provide the text-box to input the data from the user at runtime.

For specifying input parameter to report, we need to tap on Report Property "Input

Parameter".

Figure 18: Input Parameter dialog

On Input parameter dialog -

1) You can create multiple parameter with AND/OR joining operators.

2) Select a Field (Column) for applying criteria.

3) Supported field operators are “=, <>, <, > <=, >= and between” etc.

4) You can specify a fixed value or runtime value to parameter.

5) For “between” operator you need to specify two values.

Need of Input parameters

Suppose you have a query named Last Order which returns the names and

addresses of your customers together with the date when you shipped their most

recent order. Recently you added some exciting new products to your inventory and

catalog. Every time that you ship an order, you include a copy of the current

catalog. You expect that the new products will be very popular, and you want to

make sure that all your customers know about them. You want to mail a new

catalog to all customers who have not already received one in a shipment.

So you want to create a mailing list that contains the names and addresses of those

customers whose most recent order was shipped before you produced the new

catalog. To do this, you apply a criterion to the ship date field of your Last Order

query. The criterion specifies that the date in the ship date field comes before the

date when you started distributing the new catalog, for example, 3/31/2006. When

you run the query, you get a mailing list that contains only those customers who

have not received a new catalog.

But what if this situation happens again? You could modify the design of your query

by changing the value specified by the criterion, but wouldn't it be nice if your

query could ask you for a date and then use that date to decide which customers to

include on the mailing list? You can make your query do this by using a special kind

of criterion, called a parameter.

Figure 19: Fixed value input parameter

.

Figure 20: RunTime value input parameter

Figure 21: Input parameters list

Using Reports on Form: To open particular report from Form use need to use “Button” control on Form.

While designing the form, drag “Button” control on your form and Set “Action”

property to “Report”. Now set "Report" property of this "Button" control to required

report name from the dropdown list.

Save and sync the reports and updated forms to device.

Figure 22: "Button" control with "Action" property set to "Report"

Figure 23: Set required "Report" name to report button from available report name list.

Using Reports in Cellica Database Device Application:

Open the form and tap on “Report” button.

Figure 24" Form with "Report" button

You will get a screen to specify record range for creating report. You can generate

report for “Current Record”, a Set of selected records or “All Records” from profile.

If you have specified any “Input Parameters” for report then you can enter them on

this screen.

Figure 25: Report Options

Figure 26: Providing value for RunTime input parameters

Once you finish with your report option, tap on “Done” button. You can see your

report generated like given below.

Figure 27: Report preview in Cellica Database application

You can either print, mail in pdf format or copy the report .

Figure 28: Print or Email report as pdf option for report