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 following query, theCAST
operator is used to convert the literal strings'2003-01-01'
and'2003-12-31'
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 shown as below. - s
...
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 key used in the Run self-service report macro is to input data using the SQL query. |