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 .
- Insert a Run with a user form and parameters macro to build the form.
- Click Edit to open the macro setting settings window.
Add - In Field settings, click +Add field to add fields to the form based on the field requirement under Field settings.
a. Add date field on the form.
b. . 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 you want to display on Form under 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.
The form is displayed as follows: - Insert a 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 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. |