INDHOLD
Denne guide er en kort introduktion til at lave ny dokumentation af Archimate dokumentationen. For guide til Archimate arkitekturmodellerne se: Archi guide. For at kunne oprette eller rette sider skal man være logget ind og have rettighed til at redigere!
Der er lavet en template som med fordel kan kopieres og benyttes til Stamdata importer dokumentation: Bxx template Importer
Som alternativ, eller som startpunkt for øvrige services, kan i stedet kopieres en tilsvarende service, som så tilrettes.
En NY side i Confluence laves ved vælge "+" symbolet i nederste højre hjørne, og derefter vælge "Create content":
En KOPI af en eksisterende dokumentation foretages ved tryk på de tre prikker i øverste højre hjørne og valg af "Copy". Derved fremkommer en "Copy page" box, hvor der kan vælges (bare begynd at taste og vælg derefter den rigtige) ny parent page, hvis kopien ikke skal blive i samme undermenu som originalen. Herefter trykke "Copy":
Der er en fast struktur som gælder for alle dokumenterede services / stamdata importere:
Punkterne gennemgås her:
1. Beskrivelse (Links)
En kopi af dokumentationen i Archi fra register (ved stamdataimportere) eller business servicen. (Copy fra Archi dokumenation, paste i Confluence)
Skal indeholde support ansvarlig og link til Confluence leverancebeskrivelsen.
Links laves ved "Insert Link" symbolet i bjælken øverst, hvorefter der indtastes de første bogstaver af sidens navn og der vælges i dropdown boxen:
Alternativt kan siden vælges i confluence og så simpelthen tage en kopi af URL'en og indsætte der hvor linket skal være.
2. Forretningsanvendelse (paste af kopierede billeder fra Archi, "tilbage til toppen")
I hver eneste af de efterfølgende headers og sub-headers sikres at linket til toppen af siden, "^^Tilbage til toppen^^" er placeret som første punkt. Dette er et link til et "anker" som er placeret øverst i dokumentet:
Her indsættes Archimate forretningsanvendelse view, original størrelse med border. Gøres ved i Archi at højreklikke på viewet og vælge "copy as image to clipboard), og derefter paste i confluence dokumentation:
2.1. Relaterede registre og services
Her placeres eventuelle links til services og stamdataregistre som er refereret fra denne service
Alle links som laves fra denne services vil fremgå under "6. Refereres fra" i de pågældende services.
3. Applikationsbeskrivelse
Her indsættes Archimate applikationsbeskrivelse view, original størrelse med border.
Derunder copy/pastes teksten fra applikations servicen.
4. Datastruktur
Overskriften "4. Datastruktur" hæftes sammen med Archimate business object navnet på registeret, som derved bliver en del af overskriften (og indholdsfortegnelsen).
Her indsættes et billede af de properties der er tilknyttet register dokumentationen (igen original, border), efterfulgt af selve dokumentationen og endelig Archi datastruktur information view (original, border).
Under "4.1. Entitetsbeskrivelser" indsættes som "heading 3" hver enkel data object navn med efterfølgende dokumentation.
Under "4.2. Tabelbeskrivelser" indsættes som "heading 3" hver enkel tabel/fil artifact navn med efterfølgende dokumentation.
5. Teknologibeskrivelse
Udestår pt.
6. Refereres fra
Dannes automatisk af Confluence og viser alle steder hvor denne service refereres fra (se også 2.1 ovenfor):
