Part 4 - Creating an Issues and Solutions article template

Overview

We will build the Issues and Solutions article using the same macros used to build a How-to article

Creating the template

Let's start with a table for some quick details on the affected system and the title of the issue.

Create the dropdown menu for System options

add a 2x 1 table
type System in the header column
add a list-data macro to the empty System row cell
- name - “System”
- separator - “newline”
- blankText - “Not applicable”
- set type option to “select”

When creating a field with predefined options, choose select for drop-down menus, check for checklist, or autocomplete for input field with live search.

nest three list-option macros and set a value and label to each
- value=“Confluence” and label=”Confluence”
- value=“HipChat” and label=”HipChat”
- value=“JIRA” and label=”JIRA”

Add Title information

Use the Reporting app to report on the title of the page

add a second row to the table
add Title to header column
add report-info macro to the empty second row cell

Add text area blocks for Symptoms, Diagnosis and Solution

Finally, some text-area blocks for symptoms, diagnosis and solution fields:

This tutorial is a step-by-step guide to create a new article with this template.

Code

Issues and Solutions article template source code...

<table class="relative-table wrapped">
  <colgroup>
    <col style="width: 110.0px;"/>
    <col style="width: 612.0px;"/>
  </colgroup>
  <tbody>
    <tr>
      <th colspan="1">System</th>
      <td colspan="1">
        <div class="content-wrapper">
          <p>
            <ac:structured-macro ac:macro-id="96fc31e2-9a23-4a02-92c3-626455068702" ac:name="list-data" ac:schema-version="1">
              <ac:parameter ac:name="name">System</ac:parameter>
              <ac:parameter ac:name="separator">newline</ac:parameter>
              <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
              <ac:parameter ac:name="blankText">Not applicable</ac:parameter>
              <ac:rich-text-body>
                <ac:structured-macro ac:macro-id="9079fb29-67a9-428b-99bf-b95e03103489" ac:name="list-option" ac:schema-version="1">
                  <ac:parameter ac:name="label">Confluence</ac:parameter>
                  <ac:parameter ac:name="value">Confluence</ac:parameter>
                  <ac:rich-text-body>
                    <p>Confluence </p>
                  </ac:rich-text-body>
                </ac:structured-macro>
                <ac:structured-macro ac:macro-id="73bbf4ea-c009-4efe-909c-b7134716e33e" ac:name="list-option" ac:schema-version="1">
                  <ac:parameter ac:name="label">HipChat</ac:parameter>
                  <ac:parameter ac:name="value">HipChat</ac:parameter>
                  <ac:rich-text-body>
                    <p>HipChat </p>
                  </ac:rich-text-body>
                </ac:structured-macro>
                <ac:structured-macro ac:macro-id="31f5fc18-47f8-495f-b495-02e5136c6bc8" ac:name="list-option" ac:schema-version="1">
                  <ac:parameter ac:name="label">JIRA</ac:parameter>
                  <ac:parameter ac:name="value">JIRA</ac:parameter>
                  <ac:rich-text-body>
                    <p>JIRA </p>
                  </ac:rich-text-body>
                </ac:structured-macro>
              </ac:rich-text-body>
            </ac:structured-macro>
          </p>
        </div>
      </td>
    </tr>
    <tr>
      <th>Title</th>
      <td>
        <div class="content-wrapper">
          <p>
            <ac:structured-macro ac:macro-id="829fb338-eade-49a5-bf99-5e0a6cc66d35" ac:name="report-info" ac:schema-version="1">
              <ac:parameter ac:name="">content:title</ac:parameter>
            </ac:structured-macro>
          </p>
        </div>
      </td>
    </tr>
  </tbody>
</table>
<h2>Symptoms:</h2>
<p>
  <ac:structured-macro ac:macro-id="6e79b844-871a-4e66-8138-5b0374b5221f" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Issue symptoms</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro> </p>
<h2>Diagnosis:</h2>
<p>
  <ac:structured-macro ac:macro-id="ddb3236e-9cc7-4f49-ad92-938cb29f379e" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Issue diagnosis</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro>
</p>
<h2>Solution:</h2>
<p>
  <ac:structured-macro ac:macro-id="9d27512d-51ce-406f-89d8-2ab5cecb4c20" ac:name="text-data" ac:schema-version="1">
    <ac:parameter ac:name="name">Issue resolution</ac:parameter>
    <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
    <ac:rich-text-body>
      <p> </p>
    </ac:rich-text-body>
  </ac:structured-macro>
</p>