{"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\/da\/blog\/administrirovanie\/proektirovanie-v-confluence","title":{"rendered":"Projektering i Confluence","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Hej alle sammen! <\/p>\n

Mit navn er Masha, jeg arbejder som QA-ingeni\u00f8r i Tinkoff Group. QA-arbejde involverer mange kommunikationer med forskellige personer fra forskellige teams, og da jeg ogs\u00e5 har v\u00e6ret leder og underviser i uddannelsesprogrammer, var mit kommunikationsnetv\u00e6rk meget omfattende. Og p\u00e5 et tidspunkt eksploderede jeg: jeg inds\u00e5, at jeg ikke l\u00e6ngere kunne, kunne ikke, kunne ikke udfylde de uendelige m\u00e6ngder ul\u00e6selige tabeller og dokumenter. <\/p>\n

\"Projektering
\n
\n<\/a><\/noindex>
\nSikkert har hver af jer lige nu forestillet sig det, jeg taler om, og f\u00e5et sved p\u00e5 panden: navnelister uden alfabetisk r\u00e6kkef\u00f8lge, tabeller med hundrede kolonner og forskudt layout, tabeller med tusindvis af r\u00e6kker, hvor man skal gnide fingeren mod musens hjul for at se overskriften, tonvis af ikke-nummererede instruktioner, hundrede e-mails der sendes frem og tilbage med data, der skal analyseres og systematiseres og presses ind i lige s\u00e5 ul\u00e6selige tabeller.<\/p>\n

\"Projektering
\n
\nOg n\u00e5r jeg nu var lidt k\u00f8let ned, besluttede jeg at skrive denne artikel. Jeg vil fort\u00e6lle om, hvordan man kan f\u00f8re forskellig ikke-produktdokumentation ordentligt (nogle gange endda bekvemt). Jeg h\u00e5ber, at artiklen vil sprede sig p\u00e5 nettet, og at niveauet af kaos i de nabointeresserede afdelinger til udviklingen vil falde en smule, s\u00e5 folk (og jeg selv) bliver lidt lykkeligere.<\/p>\n

\"Projektering
\n<\/p>\n

V\u00e6rkt\u00f8jer<\/h2>\n

\nProduktdokumentation opbevares ofte t\u00e6t p\u00e5 koden, hvilket er godt. Ikke-produktdokumentation opbevares derimod ofte hvor som helst. Folk fors\u00f8ger ofte at overf\u00f8re information fra forskellige steder til Confluence, og vi er ingen undtagelse. S\u00e5 alt videre handler om det.<\/p>\n

Generelt er Confluence en avanceret wiki-motor. Den tillader arbejde med data i forskellige visningsformer: tekst med formatering, tabeller, forskellige diagrammer. Det er et meget interessant og kraftfuldt v\u00e6rkt\u00f8j, men hvis man ikke ved, hvordan man forbereder det, ender man med en bunke ul\u00e6selige dokumenter. Jeg vil l\u00e6re dig at forberede det!<\/p>\n

\"Projektering
\n<\/p>\n

Makroer<\/h2>\n

\nN\u00e6sten al magi i Confluence bygger p\u00e5 makroer. Der er mange makroer, og de kan kombineres med hinanden. De findes i b\u00e5de betalte og gratis versioner, og f\u00f8lgende vil v\u00e6re forskellige eksempler p\u00e5 makroer med links til dokumentationen for dem.<\/p>\n

Gr\u00e6nsefladen til at arbejde med makroer er meget enkel. For at tilf\u00f8je en makro skal man klikke p\u00e5 plusset og v\u00e6lge den \u00f8nskede element fra listen.<\/p>\n

\"Projektering
\n
\nHvis makroen er selvforsynende, det vil sige, at den ikke kr\u00e6ver inds\u00e6ttelse af noget indeni sig selv, ser den ud som en blok.<\/p>\n

\"Projektering
\n
\nHvis makroen har brug for, at der bliver placeret noget indeni den, ser den ud som en ramme.<\/p>\n

\"Projektering
\n
\nMan kan dog placere s\u00e5 mange andre inde i \u00e9n ramme, som man vil, s\u00e5 l\u00e6nge der er logik i din pyramide.<\/p>\n

\"Projektering
\n
\nHver makro har en forh\u00e5ndsvisning: Her kan du straks se, om du har udfyldt og indstillet makroen korrekt.<\/p>\n

Skabeloner<\/h2>\n

\nUdover makroer er der et praktisk v\u00e6rkt\u00f8j til forudfyldning af indhold \u2013 det er en skabelon.
\nSkabeloner kan bruges, n\u00e5r du opretter enhver side: du skal blot klikke p\u00e5 de tre prikker ved siden af knappen \u2018Opret\u2019 og v\u00e6lge den \u00f8nskede skabelon.<\/p>\n

\"Projektering
\n
\nS\u00e5 vil al indholdet fra skabelonen blive tilf\u00f8jet til den oprettede side.<\/p>\n

Alle kan oprette sider ud fra skabeloner, men kun de, der har rettigheder, kan oprette eller redigere selve skabelonerne. I skabelonen kan der tilf\u00f8jes yderligere instruktioner om, hvordan siden skal h\u00e5ndteres.<\/p>\n

\"Projektering
\n<\/p>\n

Magien ved tabeller<\/h2>\n

\nSom tekniker elsker jeg faktisk tabeller og kan n\u00e6sten pakke enhver information ind i dem (selvom det ikke altid er effektivt). Tabeller i sig selv er klare, strukturerede, skalerbare, magiske!<\/p>\n

\"Projektering
\n
\nMen selv en s\u00e5 vidunderlig enhed som en tabel kan blive \u00f8delagt. Men den kan ogs\u00e5 bruges effektivt og endda forbedres. Det handler om nedenfor.<\/p>\n

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

\nEnhver stor, uoverskuelig tabel kan g\u00f8res lidt mindre enorm og lidt mere l\u00e6sbar med hj\u00e6lp fra filtrering. Til dette kan man bruge en betalt makro. \u2018Tabelfilter\u2019<\/a><\/noindex>.<\/p>\n

Ind i denne makro skal tabelen presses (man kan endda bruge den mest grimme, s\u00e5 l\u00e6nge den presses helt ind). I makroen kan du v\u00e6lge kolonner til filtrering med en drop-down liste, tekstfilter, numerisk filter og datofilter. <\/p>\n

\"Projektering
\n
\nForestil dig, at al information om kandidater til alle job skrives i en tabellist. Selvf\u00f8lgelig usorteret \u2013 folk kommer jo ikke til samtaler i alfabetisk r\u00e6kkef\u00f8lge. Og du skal finde ud af, om du tidligere har afholdt en samtale med en bestemt ans\u00f8ger. Du skal bare presse dette kaos ind i filtreringsmakroen, tilf\u00f8je et tekstfilter efter efternavn \u2013 og vupti, s\u00e5 har du informationen p\u00e5 din sk\u00e6rm.<\/p>\n

\"Projektering
\n
\nDet skal bem\u00e6rkes, at filtrering af store tabeller kan p\u00e5virke systemets ydeevne og indl\u00e6sningstider, s\u00e5 det er en midlertidig l\u00f8sning at putte en enorm tabel i et filter; det er bedre at opbygge en proces, hvor folk ikke beh\u00f8ver at lave enorme, ul\u00e6selige tabeller (et eksempel p\u00e5 processen vil v\u00e6re i slutningen af artiklen).<\/p>\n

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

\nVed hj\u00e6lp af et magisk makro \u2018Tabelfilter\u2019<\/a><\/noindex> kan man ogs\u00e5 angive standard sortering p\u00e5 hvilken som helst kolonne og nummerere r\u00e6kkerne. Eller klikke p\u00e5 en hvilken som helst kolonne i tabellen, der er lagt ind i filtermakroen, og sortering vil ske p\u00e5 denne kolonne. <\/p>\n

\"Projektering
\n
\nFor eksempel, hvis du har den samme tabel med ans\u00f8gere og skal vurdere, hvor mange interviews der er blevet afholdt i en bestemt m\u00e5ned, - s\u00e5 sorter efter dato og v\u00e6r glad.<\/p>\n

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

\nLad os nu g\u00e5 videre til en mere interessant case. Forestil dig, at din tabel er enorm, og du skal regne noget ud. Selvf\u00f8lgelig kan du kopiere den over i Excel, beregne det n\u00f8dvendige og eksporter dataene tilbage til Confluence. Men du kan ogs\u00e5 en gang for alle anvende makroen \"Pivot-tabel\"<\/a><\/noindex> og f\u00e5 det samme resultat, kun opdateret.<\/p>\n

For eksempel: du har en tabel, der indeholder oplysninger om alle medarbejdere - hvor de geografisk befinder sig, og hvilke stillinger de har. For at t\u00e6lle, hvor mange personer der er i hver by, skal du v\u00e6lge i makroen \"Pivot-tabel\" den r\u00e6kke, som dataene aggregeres efter (placering) og type operation (summering).<\/p>\n

\"Projektering
\n
\nNaturligvis kan man gruppere efter flere kriterier p\u00e5 \u00e9n gang; alle muligheder kan ses i dokumentationen<\/a><\/noindex>.<\/p>\n

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

\nSom jeg allerede har n\u00e6vnt, elsker ikke alle tabeller lige s\u00e5 meget som jeg. Desv\u00e6rre kan managerne i de fleste tilf\u00e6lde slet ikke lide dem. Men alle elsker klart farverige diagrammer.
\nSkaberne af Confluence vidste uden tvivl om dette (de har sikkert ogs\u00e5 chefer, der elsker rapporter og diagrammer, hvor skulle de ellers hen). Derfor kan du bruge det magiske makro \"Diagram fra tabel\"<\/a><\/noindex>. I dette makro skal du inds\u00e6tte den pivot-tabel fra det forrige punkt, og vupti - dine gr\u00e5, kedelige data er smukt visualiseret.<\/p>\n

\"Projektering
\n
\nNaturligvis er der ogs\u00e5 indstillinger i dette makro. Linket til dokumentationen til ethvert makro kan findes i redigeringsmodus for dette makro.<\/p>\n

Simplicity in aggregation<\/h2>\n

\nInformation from the previous sections was certainly not a revelation for you. But now you definitely know how to use macros, and I can move on to a more interesting part of the article.<\/p>\n

\"Projektering
\n<\/p>\n

Labels<\/h3>\n

\nIt's unfortunate when people store information in one unstructured article or a huge table. Even worse is when parts of that information are not only poorly formatted but also scattered across the vastness of Confluence. Fortunately, there is a way to gather the scattered information in one place. To do this, you need to use tags<\/a><\/noindex> (familiar to everyone from social media tags).<\/p>\n

\"Projektering
\n
\nYou can add any number of tags to any page. If you click on a tag, you will be taken to an aggregation page that contains links to all materials with that tag, as well as a set of related tags. Related tags are those that often appear on the same page.<\/p>\n

\"Projektering
\n<\/p>\n

Page properties<\/h3>\n

\nYou can also add another interesting macro for structuring information to a page \u2014 Page Properties<\/a><\/noindex>. You need to provide a table with two columns inside it, the first being the key and the second being the value of the property. Moreover, the macro can be hidden from the page so that it doesn't interfere with reading the content, but the page will still be marked with the necessary keys.<\/p>\n

\"Projektering
\n
\nNote the ID \u2014 it is convenient to assign it in order to attach different groups of properties to different pages (or even different groups of properties to one page). <\/p>\n

Rapporter<\/h3>\n

\nYou can generate reports based on tags. For example, the macro Content Report<\/a><\/noindex> gathers all pages with a specific set of tags.<\/p>\n

\"Projektering
\n
\nBut a more interesting report is the macro Page Property Report<\/a><\/noindex>. It also collects all pages with a specific set of tags, but it doesn't just list them; it creates a table (catching the connection to the beginning of the article?), where the columns are keys of the page properties.<\/p>\n

\"Projektering
\n
\nThis results in a consolidated table of information from various sources. It's nice that it has convenient features: responsive layout, sorting by any column. This report table can also be configured within the macro. <\/p>\n

\"Projektering
\n
\nWhen configuring, you can remove certain columns from the report, set a default state, or specify the number of displayed records. You can also set the page property ID to see only the relevant information.<\/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>. And there is a second set of properties on the same page, which gathers information about the person as part of the team: what role the person performs, which team they belong to, and so on. These properties are marked ID = team_inf<\/i>. Then, when compiling a report, you can output information for just one ID or both \u2014 whichever is more convenient.<\/p>\n

The beauty of this approach is that everyone can create the informational table they need, which will not duplicate anything and will update when the main page is updated. For example: a team lead doesn't care when their developers were hired, but it is important what role each of them plays in the team. The team lead will compile a report on the team. An accountant, on the other hand, doesn't care about the roles; they care about positions \u2014 they will compile a report on positions. Meanwhile, the source of the information will not be duplicated or transferred.<\/p>\n

The final process<\/h2>\n

<\/p>\n

Brugsanvisning<\/h3>\n

\nSo, we can beautifully structure and effectively aggregate information in Confluence using macros as an example. But ideally, the new information should be structured from the start and fit into all the already used aggregation mechanisms.<\/p>\n

Here, a 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, and when clicked, a new page is created from the template you need. In this way, you make people work in the format you want from the start. <\/p>\n

\"Projektering
\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 properties you need. I also recommend adding instructions on what values should be entered on the page and the values of the properties.<\/p>\n

\"Projektering
\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. Opret en roden side hvor som helst med en knap, som n\u00e5r den klikkes, opretter en underliggende side fra skabelonen. <\/li>\n
  4. Giv adgang til roden siden for brugere, der potentielt vil generere den n\u00f8dvendige information (i henhold til den \u00f8nskede skabelon ved at klikke p\u00e5 knappen).<\/li>\n
  5. Saml en rapport om egenskaberne p\u00e5 siden via de tags, du har angivet i skabelonen.<\/li>\n
  6. Du kan gl\u00e6de dig over, at du har al den n\u00f8dvendige information i et praktisk format. <\/li>\n<\/ol>\n

    \"Projektering
    \n<\/p>\n

    Faldgruber<\/h3>\n

    \nSom kvalitetsingeni\u00f8r kan jeg sagtens sige, at der ikke findes noget perfekt i verden. Selv guddommelige tabeller er ikke perfekte. Og i den beskrevne proces er der faldgruber.<\/p>\n