This article explains how to display the provides step-by-step instructions to generate and display a report for a specific date range using the Run Self-Service Reports and SQL for Confluence app apps.
Instructions
Follow the below steps:
Log into the your Confluence instance.
- Navigate to the required page and click the Edit icon ()click .
- Add the macro Insert Run with a user form and parameters to build macro to build the form.
- Click Edit to open the macro setting settings window.
Add the fields to the form based on the field requirement. - In Field settings, click +Add field to add fields to the form. Ensure to select Field type as Date for at least two fields so as to provide a date range.
- Enter the name of the button in the Run button text field. This ensures that a button with the given text is displayed on the form.
- Click Save settings and Save the page.
Add the The form is displayed as follows: - Insert SQL Query macro under inside the Run with a user form and parameters macro. Enter {sql or search for the SQL for Confluence macro.
Edit the macro and select the Data source profile. - Edit the SQL Query macro to open the settings pop-up.
- Select the required Data source profile from the drop-down.
Enter the SQL statement based on the Field key mentioned in the Step5step 5.
In the below following query, used the theCAST
operator is used to convert the literal strings'2003-01-01'
and and'2003-12-31'
to theDATE
toDATE
values.Code Block language sql Select * from tabeltable_name where column_name BETWEEN CAST('$date2' AS DATE) AND CAST('$date1' AS DATE);
- Click Click Save settings and Save confluence the page.
- Enter the date range or select the dates based on your requirements the date format mentioned in step 5, and click Show Data on the form.
Data are shown as below.
The given example displays the following information:
If the user entered a date in an incorrect format (that is, not in the format as specified in the Date format field in step 5), error messages are shown as:
Info |
---|
The field Field key used in the Run self-service report macro will be used in is to input data using the SQL query to input the data. |