Indholdsfortegnelse

Se eksempel på udfyldelse på DDS: DDS - Guide til anvendere - NSP services - Global Site

Introduktion

Formål

Denne guide har som formål at give et overblik over GM-CMS, herunder dets funktionalitet, arkitektur, og hvordan det integreres med relaterede services.

Denne guide er tilegnet klienter til NSP, specielt dem, der skal udvikle aftagersystemer. Der vil blive givet referencer til relevante dokumenter for at skabe en bredere forståelse af komponentens omgivelser.

Beskrivelse

GM-CMS er en backend-service, der understøtter indholdshåndtering for applikationen "Min Graviditet".

Systemet tilbyder fleksible værktøjer til oprettelse, redigering og publicering af indhold såsom artikler, billeder og videoer.

Links til mere information

• GM-CMS repository: git.nspop.dk/projects/bff/repos/min-graviditet-content-management-system  
• Strapi documentation: https://docs.strapi.io/cms/intro
• Meilisearch plugin: https://market.strapi.io/plugins/strapi-plugin-meilisearch  
• CKEditor 5: https://market.strapi.io/plugins/@_sh-strapi-plugin-ckeditor
• Config Sync plugin: https://market.strapi.io/plugins/strapi-plugin-config-sync

Grafisk fremstilling og sammenhængen

Følgende ses diagram over GM-CMS struktur og relationer til relaterede services (Min Graviditet-app, BFF, m.fl.)

Relevante use-cases

Der findes tre typer brugere i forhold til use cases:

• Borgere: Brugere af app’en "Min Graviditet".
• Redaktører: Brugere med indholdsredigeringsrettigheder i GM-CMS.
• Systemadministratorer: Brugere med administratortilladelser i GM-CMS.

GM-CMS skal understøtte use cases for "Min Graviditet" appen ved at udstille data. I den efterfølgende parentes angives use case nummer jf. Appendix 1b fra tilbudsmateriale.

Use cases for "Min Graviditet" appen:

• Borger skal kunne se vejledninger som er knyttet til specifikke graviditetsuger (artikler og videoma teriale) (UC11)
• Borger skal kunne søge i vejledninger (UC12)
• Borger skal kunne tilføje nye emner til tjeklisten (UC13)
• Borger skal kunne se menupunktet “Mere”, som indeholder information omkring support, sikker hed, FAQ, privatslivspolitik, samtykke mm. (UC22)
• Borger skal kunne tilgå information omkring privatlivspolitik (databeskyttelse, logning, etc) (UC25)

For at undersøtte disse use cases skal GM-CMS overholde følgende use cases.

• Redaktør skal kunne oprette, redigere, publicere og slette indholdstyper, herunder kategorier, artikler, sektioner, tjeklister, tjeklistepunkter, forklaringer på fagtermer og ofte stillede spørgsmål (FAQs).
• Det skal være muligt søge i artikler
• Administrator skal kunne tilføje og administrere CMS-brugere
• Redaktør skal kunne ændre eget kodeord
• Alle brugere skal logge ind i CMS administrationspanel via 2-faktor. 
• Redektører skal kunne filtrere indhold på udgivet og kladdeversioner samt sortere på dato og kategorier
• Redaktøren skal kunne angive følgende per artikel: Titel, kategori, tags, angivelse af ugenumre, hvor artikel dermed vil blive vist på forsiden ved den pågældende graviditetsuge, angivelse af ugenumre, hvor artikel dermed vil blive vist på forsiden den pågældende efter fødsel er angivet, sektioner, hvorvidt artikel skal skjule på forside, samt tekst og medier.
• På artikel skal forfatter og dato for udgivet/published eller sidst redigeret/modified sættes
• Redaktører skal kunne eksportere alle tekster fra CMS’en til en samlet tekstfil

Læsevejledning og forudsætninger

Dette dokument er henvendt til udviklere og arkitekter, der skal anvende GM-CMS. Det forventes, at læseren har kendskab til RESTful API'er samt grundlæggende webteknologier.

Sikkerhed

Forudsætninger for anvendelse inkluderer:

Definitioner og referencer

Adgang

<Beskrivelse af hvordan service/komponent bruges, snitflade(r), endpoints, og andet relevant>

Brugertyper (roller)

I Strapi administrationpanelet arbejdes der med følgende brugertyper:

• Systemadministrator: En bruger med overordnede rettigheder, der administrerer systemindstillinger og brugeradgange.
• Redaktør: En administrator, der har ansvar for indholdsoprettelse og -vedligeholdelse i administrationsportalen.
• Redaktør med brugeroprettelsesrettigheder: En administrator, der har ansvar for indholdsoprettelse og -vedligeholdelse i administrationsportalen, samt oprettelse og administration af brugere.

Snitfladebeskrivelse og brug

Følgende bekriver Strapi og Meilisearch snitfladerne. 

Strapi snitflade

Strapi CMS'en udstiller en række endpoints til at hente de definerede indholdstyper. Alle API-endpoints er offentligt tilgængelige, hvilket betyder, at det ikke er nødvendigt at sætte en authentication header på anmodningerne.

Indholdstyper

Jf. use cases skal følgende indholdstyper konfigureres i GM-CMS.

Strapi endpoints

 For at relationer mellem indholdstyperne inkluderes i responsen tilføjes:

Eksempelvis for at få alle artikler, samt relaterede kategorier og sektioner kaldes:

 Eksempler på Strapi request/responses

Herunder ses eksempler på Strapi request/responses der foretages af GM-BFF:

"data": [
        {
            "id": 6,
            "documentId": "yl4fr112xq1wnjrmgq4c0hdk",
            "Titel": "Ammeassistenten",
            "Tags": null,
            "SkjulPaaForside": true,
            "Beskrivelse": "<p>Ammeassistenten.dk er et supplement til den hjælp, som forældre kan få fra sundhedsplejersker eller på fødestedet. Her kan du finde svar på mange af de spørgsmål, der måtte opstå i forbindelse med amning.</p>",
            "createdAt": "2025-03-13T11:47:23.616Z",
            "updatedAt": "2025-03-13T11:47:23.616Z",
            "publishedAt": "2025-03-13T11:47:23.642Z",
            "Kategori": {
                "id": 2,
                "documentId": "kh2fio7vc6dyoj368j94n4gw",
                "Titel": "Amning",
                "createdAt": "2025-03-13T11:37:55.157Z",
                "updatedAt": "2025-03-13T11:37:55.157Z",
                "publishedAt": "2025-03-13T11:37:55.180Z"
            },
            "Sektioner": [
                {
                    "id": 11,
                    "documentId": "ly4pavnpgqto6bpcs5qe8xgn",
                    "Titel": " Hvad kan Ammeassistenten hjælpe dig med?",
                    "Tekst": "<p>Kompetencecenter for Amning har i maj 2024 lanceret <a target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://ammeassistenten.dk/\">Ammeassistenten.dk</a>, som er en ny hjemmeside, der tilbyder omfattende, forskningsbaseret viden om amning til både forældre og sundhedspersonale i hele Danmark. Hjemmesiden er udviklet som en del af et forskningsprojekt om amning i sundhedsplejen.</p><p>Platformen er designet til at støtte og informere om alle aspekter af amning - lige fra forberedelse til vedligeholdelse af amning på længere sigt. <a target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://ammeassistenten.dk/\">Ammeassistenten.dk</a> er i overensstemmelse med den nyeste viden om amning og Sundhedsstyrelsens anbefalinger.</p><p>Hjemmesiden tilbyder en række ressourcer, heriblandt:</p><ul><li>Vejledning om alle faser af amning</li><li>Emnesider med dybdegående information</li><li>Handlingsanvisende videofilm</li><li>Podcast om personlige fortællinger og ammeerfaringer</li></ul>",
                    "createdAt": "2025-03-13T11:38:21.068Z",
                    "updatedAt": "2025-04-07T13:21:20.596Z",
                    "publishedAt": "2025-04-07T13:21:20.610Z",
                    "UgenumreUnderGraviditet": "37, 38, 39",
                    "UgenummreEfterFoedsel": "1, 2",
                    "VisPaaForsideVedTerminsdatoIkkeSat": null
                }
            ]
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "pageSize": 25,
            "pageCount": 1,
            "total": 1
        }
    }
}

Meilisearch snitflade

Meilisearch anvendes til at søge i artikler CMS'en udstiller en række endpoints til at hente de definerede indholdstyper. Alle API-endpoints er offentligt tilgængelige, hvilket betyder, at det ikke er nødvendigt at sætte en authentication header på anmodningerne.

Generelle koder, værdier, etc.

Ikke relevant

Fejlbeskeder

Herunder er nogle af de mest almindelige fejlbeskeder og deres årsager.

Strapi - 401 Unauthorized

• Mulige årsager: 
  • Der er sendt en authentication header med anmodningen. Selvom endpointet er offentligt vil enhver bearer token i headeren resultere i et ugyldigt kald.
  • Endpointet er konfigureret til, at anmoderen skal være authenticated. Dette er default konfigurationen i Strapi.
• Løsninger: 
  
  • Gå til Strapi adminpanelet → Settings → Users & Permissions plugin → Roles → Public.
  • Tjek, at “Find” og “FindOne” er markeret for alle indholdstyper, som du ønsker at tilgå. Dette tillader offentlige brugere at få adgang til de angivne indholdstyper uden at være autentificeret.
  • Tjek, at authentication header ikke er sat.

Meilisearch - XXX

Test

Ikke relevant.

Dokument Historik