Table Of Contents

Objective and Scope

Objective of this Procedure

This document describes how to create and maintain Operating Procedure (OP) in Confluence, including approval process and best practices to be followed in order to ensure aligned maintenance approach between different domains and processes. 

Scope

Data Operations Team based in Riga is responsible to create and maintain Operating Procedures (OP) for procedures in their scope, including customer, vendor and material data maintenance in Baan and SAP systems for GBU's within Riga Data Operation teams scope as well as Operating Procedures (OP) for any other additional activities. 

Roles & responsibilities of each actor 

The approval process below is in place to ensure a 6 eye check for OP according to audit standards.

Editor (Data Operations Specialist L1/L2) - once a need for new OP or update of existing ones is identified Editor creates or updates the corresponding confluence page and submits it to Reviewer in a timely manner.  

Reviewer (Data Operations Team Lead/Manager) - reviews the OP to ensure that nothing is missing and everything is updated correctly.

Approver (Data Operations Manager/Data Architect) -  approves the changes. Process and any changes should be approved by them before they are added in the OP. 

Creating a new page

To create new page in Confluence press "Create" on the upper left corner. 

Publishing a page

To make added document as "published" for everyone you need to follow the steps below.

Labels 

Labels (tags) drive the organization of the files under service center sections of the Data Operation space. For Operating Procedure to appear under Riga SC page, use "riga_sc" label.  Use appropriate labels from the table below to store them under correct domain. 

Best practices

Find below some best practices for maintaining the document. 

Images

When inserting an image from a link or Google document make sure the image is uploaded into Confluence and does not retain the link to the source; otherwise you risk of loosing an image when it is deleted from the source.

For Google documents it is also true if the access to the document, where the image comes from, is restricted.

Appendixes

Please follow the guidelines below when adding or referring to an Appendix:

• Do not number the Appendixes. 
• Always refer to the Appendix with it's full name, e.g. "Appendix - Macros used in Template", to ensure, that text is readable even if the link is broken.
• Please use Anchor to link to the appendix. This will ensure, that link remains intact even if the name of the appendix is changed.

Useful Macros

Below you will find examples of some useful Macros available in confluence. You can find all macros by pressing and choosing "Other macros" at the bottom of the list. Please note that the list is not comprehensive.

Appendix - Macros used in Template

Table of contents numbering

To achieve the table of contents numbering you will need:

• HTML macro with code
• Table of contents macro

Steps to follow:

1. Insert HTML macro and add the following code into it:

   <style>
   .toc-macro ul {display: block; counter-reset: item}
   .toc-macro li {list-style-type: none}
   .toc-macro li:before { content: counters(item, ".") ". " ; counter-increment: item}
   </style>

2. Insert Table of contents macro with following adjustments:

   • Output Type: list
   • List style: none
   • Exclude Headings: (Table of contents).* - will exclude headings listed.

Resulting TOC will look like this:

"Back to top" button

To create a button that brings you to the top of the wiki page you will need following:

• HTML macro with code
• HTML wrap macro with an assigned ID
• An image for the button
• An anchor that leads to the top of the page

Steps to follow:

1. Create an anchor at the top of the page and give it a name.  In this example the name is "thisitop"
   
2. Insert an HTML Wrap macro and assign a CSS ID to it (ID = backToTopButton). Leave the rest unchanged
   
3. Place an image for the button inside the HTML Wrap.
   
   Standard image can be found in Data Operations space, by using insert image .
   
   
   
4. Create an advanced link  for the image to the anchor you made earlier. 
   

5. Insert an HTML macro and add the following code in it:

   <style>
   #backToTopButton {
   	position: fixed;
   	right: 20px;
   	bottom: 20px;
   	Z-index: 1;
   }

The final composition looks as follows: