{"id":76463,"date":"2020-04-02T13:42:40","date_gmt":"2020-04-02T11:42:40","guid":{"rendered":"https:\/\/prohoster.info\/blog\/administrirovanie\/proektirovanie-v-confluence"},"modified":"2020-04-02T13:42:40","modified_gmt":"2020-04-02T11:42:40","slug":"proektirovanie-v-confluence","status":"publish","type":"post","link":"https:\/\/prohoster.info\/no\/blog\/administrirovanie\/proektirovanie-v-confluence","title":{"rendered":"Prosjektering i Confluence","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Hei alle sammen! <\/p>\n

Eg heiter Masha, og eg arbeider som kvalitetssikrar i Tinkoff-gruppa. Jobben som QA inneber mange kommunikasjonar med ulike folk fr\u00e5 forskjellige team, og sidan eg ogs\u00e5 har vore leiar og undervisar i utdanningsprogram, har eg eit breitt kommunikasjonskart. Og i eit augneblink fekk eg eit utbrudd: eg inns\u00e5g at eg ikkje lenger kunne fylle ut vonde tonn med uleste tabellar og dokument. <\/p>\n

\"Prosjektering
\n
\n<\/a><\/noindex>
\nSannsynlegvis har kvart og ein av dykk no forestilt seg det eg snakkar om, og f\u00e5tt svette p\u00e5 panna: lister med namn utan alfabetisk rekkef\u00f8lgje, tabellar med hundrevis av kolonnar der oppsettet er \u00f8ydelagt, tabellar med tusenvis av rader der ein m\u00e5 gni fingeren mot musa for \u00e5 sj\u00e5 overskrifta, tonn med ikkje-nummererte instruksjonssider, hundrevis av e-postar som blir sendt fram og tilbake med data som m\u00e5 analyserast og systematiserast og puttast inn i like uleste tabellar.<\/p>\n

\"Prosjektering
\n
\nOg n\u00e5r eg kj\u00f8lte meg litt ned, bestemte eg meg for \u00e5 skrive denne artikkelen. Eg vil fortelje om korleis ein kan f\u00f8re diverse ikkje-produktdokumentasjon p\u00e5 ein ordentleg (og til og med ofte behageleg) m\u00e5te. Eg h\u00e5par at artikkelen vil spreie seg i nettet og at niv\u00e5et av elendighet i nabodepartementa til utviklinga vil bli litt mindre, og at folk (inkludert meg sj\u00f8lv) vil bli eit lite grann meir lukkelege.<\/p>\n

\"Prosjektering
\n<\/p>\n

Tools<\/h2>\n

\nProduktdokumentasjonen blir oftast lagra n\u00e6r koden, og det er bra. Ikkje-produktdokumentasjonen blir derimot ofte lagra overalt. Folk pr\u00f8ver ofte \u00e5 flytte informasjon fr\u00e5 ulike stader til Confluence, og vi er ikkje unntaket. S\u00e5 heile vidare fortelinga handlar om det.<\/p>\n

Confluence er eigentleg ein avansert wiki-motor. Det gir deg moglegheit til \u00e5 arbeide med data p\u00e5 ulike vis: tekst med formatering, tabellar, diverse diagram. Det er eit sv\u00e6rt interessant og kraftig verkt\u00f8y, men dersom ein ikkje veit korleis ein skal bruke det, f\u00e5r ein berre ei ny s\u00f8ppelhaug med uleste dokument. Eg vil l\u00e6re deg \u00e5 bruke det!<\/p>\n

\"Prosjektering
\n<\/p>\n

Makros<\/h2>\n

\nNesten all magia i Confluence er basert p\u00e5 makros. Det finst mange makros, og dei kan kombinerast med kvarandre. Nokre er betalte, og andre er gratis; det vil kome diverse d\u00f8me p\u00e5 makros med lenker til dokumentasjonen for dei.<\/p>\n

Grensesnittet for \u00e5 arbeide med makros er sv\u00e6rt enkelt. For \u00e5 legge til eit makro, trykker ein p\u00e5 pluss-teiknet og vel den aktuelle boka fr\u00e5 lista.<\/p>\n

\"Prosjektering
\n
\nHvis makroen er selvforsynt, det vil si at den ikke krever at noe annet settes inn i seg, ser den ut som en blokk.<\/p>\n

\"Prosjektering
\n
\nHvis makroen trenger at noe settes inni den for \u00e5 fungere, ser den ut som en ramme.<\/p>\n

\"Prosjektering
\n
\nMan kan imidlertid plassere s\u00e5 mange andre inn i en ramme, s\u00e5 lenge det er logikk i pyramiden din.<\/p>\n

\"Prosjektering
\n
\nHver makro har en forh\u00e5ndsvisning: der kan man umiddelbart se om man har fylt ut og konfigurert makroen riktig.<\/p>\n

Malverk<\/h2>\n

\nI tillegg til makroer finnes det et praktisk verkt\u00f8y for forh\u00e5ndsutfylling av innhold \u2013 det er malen.
\nMalene kan brukes n\u00e5r man oppretter hvilken som helst side: bare klikk p\u00e5 de tre prikkene ved siden av knappen \"Opprett\" og velg \u00f8nsket mal.<\/p>\n

\"Prosjektering
\n
\nDa vil alt innholdet i malen legges til den opprettede siden.<\/p>\n

Alle kan opprette sider fra maler, men bare de som har tillatelse kan opprette eller redigere selve malene. Man kan legge til ekstra instruksjoner til malen om hvordan siden b\u00f8r f\u00f8res.<\/p>\n

\"Prosjektering
\n<\/p>\n

Tabellenes magi<\/h2>\n

\nSom teknisk person elsker jeg faktisk tabeller og kan nesten pakke hvilken som helst informasjon inn i dem (selv om det ikke alltid er effektivt). Selve tabellene er klare, strukturerte, skalerbare, magiske!<\/p>\n

\"Prosjektering
\n
\nMen selv en s\u00e5 fantastisk enhet som tabellen kan \u00f8delegges. Den kan ogs\u00e5 brukes smart og til og med forbedres. Mer om dette nedenfor.<\/p>\n

Filtrering (betalt plugin)<\/h3>\n

\nEnhver stor, uleselig tabell kan gj\u00f8res litt mindre stor og litt mer lesbar ved hjelp av filtrering. For dette kan man bruke en betalt makro. \u00abTabellfilter\u00bb<\/a><\/noindex>.<\/p>\n

Inn i denne makroen m\u00e5 man putte tabellen (man kan til og med bruke den styggeste, det viktigste er \u00e5 f\u00e5 den helt inn). I makroen kan man velge kolonner for filtrering fra en rullegardinliste, tekstfilter, numerisk filter og datofilter. <\/p>\n

\"Prosjektering
\n
\nTenk deg at all informasjon om kandidater til alle stillinger blir registrert i en tabell. Naturligvis usortert \u2013 folk kommer ikke til intervjuene i alfabetisk rekkef\u00f8lge. Og du m\u00e5 finne ut om du har intervjuet en bestemt s\u00f8ker tidligere. Bare putt dette kaoset inn i filtermakroen, legg til tekstfilter etter etternavn \u2013 og voil\u00e1, informasjonen er p\u00e5 skjermen.<\/p>\n

\"Prosjektering
\n
\nDet er verdt \u00e5 merke seg at filtrering av store tabeller kan p\u00e5virke systemets ytelse og lastetid for sider, s\u00e5 det \u00e5 plassere en stor tabell i filteret er en midlertidig l\u00f8sning. Det er bedre \u00e5 bygge en prosess der folk ikke m\u00e5 lage store, uleselige tabeller (et eksempel p\u00e5 prosessen vil komme p\u00e5 slutten av artikkelen).<\/p>\n

Sortering (betalt plugin)<\/h3>\n

\nMed den magiske makroen \u00abTabellfilter\u00bb<\/a><\/noindex> kan du ogs\u00e5 angi standard sortering etter hvilken som helst kolonne og nummerere radene. Eller klikk p\u00e5 hvilken som helst kolonne i tabellen som er plassert i filtermakroen, s\u00e5 vil sortering skje etter den kolonnen. <\/p>\n

\"Prosjektering
\n
\nFor eksempel, hvis du har den samme tabellen med s\u00f8kere og m\u00e5 finne ut hvor mange intervjuer som har blitt holdt i en viss m\u00e5ned, sorter etter dato og nyt.<\/p>\n

Pivot-tabeller (betalt plugin)<\/h3>\n

\nLa oss n\u00e5 g\u00e5 videre til en mer interessant sak. Tenk deg at tabellen din er gigantisk, og du m\u00e5 gj\u00f8re noen beregninger p\u00e5 den. Selvf\u00f8lgelig kan du kopiere den til Excel, gj\u00f8re de n\u00f8dvendige beregningene og laste dataene tilbake til Confluence. Eller du kan bruke makroen \u00abPivot-Tabell\u00bb<\/a><\/noindex> \u00e9n gang for \u00e5 f\u00e5 det samme resultatet, bare at det oppdateres.<\/p>\n

For eksempel: dersom du har en tabell som samler data om alle ansatte \u2014 hvor de befinner seg geografisk og hvilke stillinger de har. For \u00e5 finne ut hvor mange personer det er i hver by, m\u00e5 du velge i makroen \u00abPivot-Tabell\u00bb den raden som dataene aggregeres etter (plassering) og type operasjon (summering).<\/p>\n

\"Prosjektering
\n
\nSelvf\u00f8lgelig kan du gruppere etter flere kriterier samtidig, alle muligheter kan du se i dokumentasjonen<\/a><\/noindex>.<\/p>\n

Diagrammer (betalt plugin)<\/h3>\n

\nSom jeg allerede har nevnt, er ikke alle like glade i tabeller som jeg er. Dessverre liker de fleste ledere dem overhodet ikke. Men alle elsker fargerike diagrammer.
\nSkaperne av Confluence visste sikkert dette (de har nok ogs\u00e5 overordnede som liker rapporter og diagrammer, hva ville de gjort uten dem). Derfor kan du benytte deg av den magiske makroen \u00abDiagram fra tabell\u00bb<\/a><\/noindex>. I denne makroen m\u00e5 du legge inn pivot-tabellen fra forrige punkt, og vips \u2014 de gr\u00e5, kjedelige dataene dine er pent visualisert.<\/p>\n

\"Prosjektering
\n
\nSelvf\u00f8lgelig finnes det innstillinger ogs\u00e5 i denne makroen. En lenke til dokumentasjonen for hvilken som helst makro kan du finne i redigeringsmodus for den makroen.<\/p>\n

Enkelhet i aggregering<\/h2>\n

\nInformasjonen fra de forrige punktene har sikkert ikke v\u00e6rt \u00e5penbar for deg. Men n\u00e5 kan du definitivt bruke makroer, og jeg kan g\u00e5 videre til den mer interessante delen av artikkelen.<\/p>\n

\"Prosjektering
\n<\/p>\n

Merker<\/h3>\n

\nDet er d\u00e5rlig n\u00e5r folk lagrer informasjon i en enkelt, ustrukturert artikkel eller en enorm tabell. Enda verre er det n\u00e5r deler av denne informasjonen ikke bare er uleselig formatert, men ogs\u00e5 spredt utover Confluence. Heldigvis er det mulig \u00e5 samle den spredte informasjonen p\u00e5 ett sted. For dette m\u00e5 du bruke etiketter<\/a><\/noindex> (de samme som alle kjenner fra sosiale medier).<\/p>\n

\"Prosjektering
\n
\nDu kan legge til et valgfritt antall etiketter p\u00e5 hvilken som helst side. Hvis du klikker p\u00e5 en etikett, kommer du til en aggregasjonsside hvor det finnes lenker til alt innhold med denne etiketten, samt et sett med relaterte etiketter. Relaterte etiketter er de som ofte forekommer p\u00e5 samme side.<\/p>\n

\"Prosjektering
\n<\/p>\n

Sideegenskaper<\/h3>\n

\nDu kan legge til en annen interessant makro for \u00e5 strukturere informasjon \u2014 \u00abSideegenskaper\u00bb<\/a><\/noindex>. I den m\u00e5 du sende inn en tabell med to kolonner, hvor den f\u00f8rste vil v\u00e6re n\u00f8kkelen og den andre verdien av egenskapen. Dessuten kan makroen skjules fra siden, slik at den ikke forstyrrer lesingen av innholdet, men siden vil fortsatt bli merket med de n\u00f8dvendige n\u00f8klene.<\/p>\n

\"Prosjektering
\n
\nMerk ID-en \u2014 det er praktisk \u00e5 tilordne ulike grupper av egenskaper til ulike sider (eller til og med ulike grupper av egenskaper til \u00e9n side). <\/p>\n

Rapporter<\/h3>\n

\nRapporter kan samles basert p\u00e5 etiketter. For eksempel samler makroen \u00abInnholdsrapport\u00bb<\/a><\/noindex> alle sidene med et bestemt sett av etiketter.<\/p>\n

\"Prosjektering
\n
\nMen en mer interessant rapport er makroen \u00abSideegenskapsrapport\u00bb<\/a><\/noindex>. Den samler ogs\u00e5 alle sidene med et bestemt sett av etiketter, men ikke bare viser dem i en liste, men lager en tabell (ser du forbindelsen til starten av artikkelen?), hvor kolonnene er n\u00f8kkene av sidens egenskaper.<\/p>\n

\"Prosjektering
\n
\nDet resulterer i en oppsummeringstabell over informasjon fra ulike kilder. Det er hyggelig at den har praktiske funksjoner: responsiv design, sortering etter hvilken som helst kolonne. Denne rapporttabellen kan ogs\u00e5 konfigureres inne i makroen. <\/p>\n

\"Prosjektering
\n
\nVed konfigurasjon kan du fjerne visse kolonner fra rapporten, sette standardstatus eller antall viste poster. Og du kan ogs\u00e5 angi ID-en til sidens egenskap for \u00e5 se kun informasjonen du trenger.<\/p>\n

For example, you have many employee pages, and these pages have a set of properties about the person: their level, location, when they joined the team, and so on. These properties are marked ID = employee_inf<\/i>. There is also a second set of properties on the same page, which collects information about the person as part of the team: what role the person performs, what team they are in, and so on. These properties are marked ID = team_inf<\/i>. Then, when generating a report, you can pull information based on a single ID or both at once \u2014 whichever is more convenient.<\/p>\n

The beauty of this approach is that anyone can compile the information table they need, which will not have any duplicates and will be updated whenever the main page is updated. For example, the team lead doesn\u2019t care when their developers started working, but it\u2019s important what role each one plays in the team. The team lead will compile a report on the team. Meanwhile, the accountant doesn\u2019t care what roles are performed, but it\u2019s important to know the positions \u2014 they will compile a report on positions. The source of information will not be duplicated or transferred.<\/p>\n

Final process<\/h2>\n

<\/p>\n

Bruksanvisning<\/h3>\n

\nSo, we can beautifully structure and efficiently aggregate information in Confluence using macros as an example. Ideally, we need to ensure that new information is immediately structured and into all existing aggregation mechanisms.<\/p>\n

Here, the combination of macros and templates will help. To encourage people to create new pages in the required format, you can use the macro \"Create from Template.\" It adds a button to the page, which, when clicked, creates a new page from the template you want. In this way, you make people work in the format you need right away. <\/p>\n

\"Prosjektering
\n
\nIn the template from which you allow page creation, you need to pre-add tags, the \"Page Properties\" macro, and a table of the necessary properties. I also recommend adding instructions on what values should fill the page, and the values of the properties.<\/p>\n

\"Prosjektering
\n
\nThen the final process will look like this:<\/p>\n

    \n
  1. You create a template for a specific type of information.<\/li>\n
  2. In this template, you add tags and page properties in the macro.<\/li>\n
  3. Du kan opprette en rot side med en knapp hvor du klikker for \u00e5 lage en underside fra en mal, hvor som helst. <\/li>\n
  4. Du lar brukerne, som potensielt vil generere n\u00f8dvendig informasjon (i den n\u00f8dvendige malen ved \u00e5 klikke p\u00e5 knappen), g\u00e5 inn p\u00e5 rot siden.<\/li>\n
  5. Du samler rapporten om egenskapene til siden gjennom etikettene du har angitt i malen.<\/li>\n
  6. Du glede deg: du har all n\u00f8dvendig informasjon i et praktisk format. <\/li>\n<\/ol>\n

    \"Prosjektering
    \n<\/p>\n

    Feller<\/h3>\n

    \nSom kvalitetsingeni\u00f8r kan jeg trygt si at ingenting er perfekt i verden. Selv guddommelige tabeller er ikke uten feil. Og det er feller i den prosessen som er nevnt ovenfor.<\/p>\n