...
...
...
...
...
...
...
...
...
...
...
...
Scenario
| Div |
|---|
|
 Estimated Time: 13 min
|
As an example, let's create a Bar Pie chart to display "Book Print Operational Costs".
Background
Our scenario uses a data source profile, BookWarehouse, to query a database table, PRINTOPERATION. The table contains current minimum, maximum, and, average operational costs associated with the printing and go-to-market costs for books.
For this scenario, we will focus on charting the current average market costs for each type of print operation.
| Code Block |
|---|
|
SQL > mysql> select po_book_id, printoperation, avgcost from printoperation;
+------------+-----------------------+----------+
| po_book_id | printoperation | avgcost |
+------------+-----------------------+----------+
| 2 | Developmental Editing | 18000.00 |
| 3 | Copyediting | 7000.00 |
| 4 | Cover Design | 3500.00 |
| 5 | Formatting | 2500.00 |
| 6 | Illustrations | 4000.00 |
| 7 | ISBN Registration | 250.00 |
| 8 | Marketing & PR | 5000.00 |
+------------+-----------------------+----------+
|
| Info |
|---|
For more information about data source profiles, click the appropriate version: |
Our query against the PRINTOPERATION table looks like:
| Code Block |
|---|
|
SELECT printoperation as "Service"
,format(avgcost,0) AS "Cost"
FROM printoperation; |
Steps
The following steps demonstrate how to use Markup to insert Confluence's native Chart macro and our SQL macro on a Confluence page:
| Table plus |
|---|
| border | 0 |
|---|
| heading | 0 |
|---|
| multiple | false |
|---|
| enableHeadingAttributes | false |
|---|
| columnAttributes | style="border:0;width=5%;",style="border:0;width=65%;",style="border:0;width=30%;max-width=30% !important;" |
|---|
| id | steps_table |
|---|
| enableSorting | false |
|---|
| enableHighlighting | false |
|---|
|
| Create a Confluence pageCreate a Confluence page to add the macros needed to produce the chart. - Create a page named Print Operations in a space accessible to the desired audience.
- Click Save to close the Page Restrictions screen.
- Click Save to save to publish the new page.
|
|
| | Edit the Print Operations page and do the following: - Insert the Chart macro.
- Click the Chart macro container and click Edit so you can adjust its modify parameters as shown on the right. The following parameters indicate:
- Type - type of a chart.
- Width - width of the chart in pixels.
- Height - height of the chart in pixels.
- Column - column name or order of mapping from the query result to the chart.
- Chart Title - title for the chart.
- Show legend - displays the name associated with the colored bars rendered.
- Click Save to save your changes to the macro's parameters.
| Chart macro parameters: | Type | pie | | Width (pixel value only) | 600 | | Height (pixel value only) | 400 | | Column | Service, Cost | | Chart Title | Average Print Operational Costs | | Show legend |  |
|
| | This step uses the SQL macro to retrieve the data to be displayed in the bar chart. To configure the SQL macro, do the following: - Edit your Print Operations page.
- Add a line below your Chart macro.
- Using Markup, insert a new SQL macro on the page (more on Markup here).
- Adjust its parameters as shown on the right. The following parameters indicate:
- Data source profile- name of the data source profile that you set up.
- Use database column labels - usage of the column names defined within the SELECT statement (e.g., Publisher, M Rev.) rather than the columns names defined within the database table(s) themselves.
- Show error if there are no rows - displays an error if no rows are returned in the resultset of the SQL query.
- Text to display when there are no rows - text of the error message to be displayed when no rows are returned in the resultset of the SQL query.
- Click Save to save your changes to the SQL macro's parameters.
With the cursor positioned inside the SQL macro container, paste in this SQL statement: | Code Block |
|---|
| language | sql |
|---|
| theme | DJango |
|---|
| linenumbers | true |
|---|
| SELECT printoperation as "Service"
,format(avgcost,0) AS "Cost"
FROM printoperation; |
Using your mouse, drag the SQL macro container into your Chart macro container (see right).
| SQL macro parameters: 10.x: SQL settings > SQL statement > Data source profile
8.x: Data source profile | BooksWarehouse | 10.x: Display settings > Data layout > Use database column labels
8.x: Use database column labels | On | 10.x: Display settings > Data layout > Show error if there are no rows
8.x: Show error if there are no rows | On | 10.x: Display settings > Data layout > Text to display when there are no rows
8.x: Text to display when there are no rows | No rows selected |
Moving the SQL macro inside the Chart macro: 
|
| | Save and test the pageNow, go back to the Print Operations page and click Save. You should now see a page that appears as shown on the right.
| Book Print Operational Costs: 
|
|
...
