Purpose

The purpose of this guide is to outline how create various functional specifications using Scaffolding Template.

Scaffolding Forms & Templates is a Confluence add-on that we will be using to manage functional specs layout and make mass changes.

Creating Functional Specifications

1. Create a blank page and create a title.
2. Add the "Live Template" macro and a the pop-up shown below will appear. 
3. Set Type=template and under template fill up the corresponding template name as listed below:
   • [Scaffold]-Data Conversion Specification
   • [Scaffold]-Data Object Cleansing
   • [Scaffold]-Functional Specification
   • [Scaffold]-Functional Specification - Enhancement
   • [Scaffold]-Functional Specification - Form
   • [Scaffold]-Functional Specification - Interface
   • [Scaffold]-Functional Specification - Report/Analytics
   • [Scaffold]-Functional Specification - User Interface
   • [Scaffold]-Functional Specification - Workflow
     
     eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6Ik1VVEhVU0FNWS1leHQsIEt1bmFsYW4iLCJvdXRwdXRUeXBlIjoiYmxvY2siLCJsYXN0TW9kaWZpZXJOYW1lIjoiTVVUSFVTQU1ZLWV4dCwgS3VuYWxhbiIsImxhbmd1YWdlIjoiZW4iLCJ1aUNvbmZpZyI6Int9IiwiZGlhZ3JhbURpc3BsYXlOYW1lIjoiIiwic0ZpbGVJZCI6IiIsImF0dElkIjoiOTMzNzU5MjM5IiwiZGlhZ3JhbU5hbWUiOiJMaXZlIHRlbXBsYXRlIiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IlVzaW5nIFNjYWZmb2xkaW5nIFRlbXBsYXRlcyBmb3IgRnVuY3Rpb25hbCBTcGVjaWZpY2F0aW9ucyIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6OTMzNzU5MjU5LCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjo5MzM3NTkyNjMsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjEsIm1hY3JvSWQiOiJiZjY3Y2UyMi00ZjJhLTQyYWUtOWNjNS02N2UxYTdhZTJmZmIiLCJwcmV2aWV3TmFtZSI6IkxpdmUgdGVtcGxhdGUucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6IjYwMCIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6MTc0NzczNjQ4MjUzNSwiZXhjZWVkUGFnZVdpZHRoIjpmYWxzZSwib0NsaWVudElkIjoiIn0=
4. After entering the correct values, save the macro. The layout of the page should appear as shown below. Save the page to create the document.
   

Troubleshooting:

• If the page is newly created and has not been saved, you might see an error message under preview in "Edit Live Template Macro" pop-up. You can ignore this and save the macro setting and page.
• After saving the page if you see the following error, this could mean that the template name is wrong. Please check spelling, case and there are no additional spaces.
  

Updating documents created with Scaffolding templates

After the document has been created, click "Edit Contents" button add contents to the document. 

Most fields have been created with rich text where you can create diagrams and tables. Please contact MUTHUSAMY-ext, Kunalan, if there is any issue with the field (e.g., wrong format or dropdown list).