Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
typeflat
separatorpipe
printablefalse

Overview

We will build the Issues and Solutions article using the same macros we used to build a HowHow-to article, namely the 

...

...

...

...

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

...

Image Removed

...

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”

...

Info

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, which in this case is the title of the issue (Optional).Image Removed

  • 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 SymptomsDiagnosis and Solution

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

...

Image Removed

...

Info

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

...

.

Code

Expand
titleClick here for the Issues and Solutions article template source code...
Code Block
languagexmltitleIssues and Solutions article template
<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>
Tip
titleColorwhite
titleBGColorgreen

Image Removed

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

...

Next

Part 5 - Creating a systems article template