Skip to content

Commit 7053e12

Browse files
ds-bellcomds-bellcom
committed
Documentation collection
1 parent c976dcb commit 7053e12

6 files changed

+277
-0
lines changed

‎modules/documentation-on-digital-signature-module.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: Digital Signature module
3+
layout: default
4+
nav_order: 1
5+
parent: Modules
6+
---
7+
8+
# Digital Signature module in OS2forms
9+
10+
**Link to module: https://github.com/OS2Forms/os2forms/modules/os2forms_digital_signature/**<br>
11+
**JIRA case: https://os2web.atlassian.net/browse/S2FRMS-57**
12+
13+
In order to digitally sign a document in OS2forms, the “OS2Forms Digital Signature” module must be installed and configured.
14+
15+
The installation takes place under “Extend” and after installation, the configuration can be found via “Settings” \-\> “System” \-\> “OS2Forms Digital Signature”.
16+
17+
There are 4 values ​​that must be configured in order to use digital signature.
18+
19+
* **Signature server URL:** The URL of the service providing digital signature. This is an example of a known service: https://signering.bellcom.dk/sign.php?
20+
* **Hash Salt used for signature:** Must match the Hash Salt on the signature server.
21+
* **List IP's which can download unsigned PDF submissions:** Here, IP addresses that should be able to download the unsigned PDF file that the submission has generated can be entered. This will typically be the IP address of the signature server, which should be able to retrieve the PDF file in order to sign it.
22+
* **Unsigned submission timespan(s):** This specifies the number of seconds that must pass from the time the unsigned submission is made until it must be signed. If this number of seconds is exceeded, the unsigned submission will be automatically deleted.
23+
24+
Once this configuration has been made, the module is ready for use.
25+
26+
## How to use Digital Signature in OS2forms?
27+
28+
You create your form as usual, with the elements you want in the form.
29+
30+
The digital signature is made via “The Danish Digital Agency's signing component” (in danish: “Digitaliseringsstyrelsens signeringskomponent”), which shows the signer a PDF file, which the signer then signs. Therefore, it requires that you have the element “OS2Forms Attachment” added to your form, as that element can generate a PDF file.
31+
32+
When the module “OS2Forms Digital Signature” is installed, there is an option to turn “Digital signature” on and off under “Attachment settings” on the element “OS2Forms Attachment”. If you enable it, the PDF file that the element generates when submitted will be sent for signing.
33+
34+
In addition to enabling “Digital signature” on the “OS2Forms Attachment” element, the “Digital Signature” handler must also be added. Do this under “Settings” \-\> “Emails / Handlers” \-\> “+ Add handler”. No setup/configuration is required for the “Digital Signature” handler.
35+
36+
If you have some email handlers on your form and you would like to wait for them to be sent until the digital signature has taken place, you must go into each of these handlers and set them to only be sent when the submission is locked.
37+
38+
This is done under “Advanced” and under “Additional settings”, where you can check the box under “…when submission is locked.”
39+
40+
## What is not supported in the PDF file for digital signing?
41+
42+
* We currently know that “The Danish Digital Agency's signing component” (in danish: “Digitaliseringsstyrelsens signeringskomponent”) does not support the way Drupal creates links in PDF files. This applies to both the elements in the PDF file, but also the header, footer and colophon.

‎modules/modules.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
title: Modules
3+
layout: default
4+
nav_order: 3
5+
---

‎releases/2024-Q4-Release-notes-Tag-4.0.0.md‎

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
---
2+
title: Release 2024/Q4
3+
layout: default
4+
nav_order: 1
5+
parent: Releases
6+
---
7+
8+
# Release notes
9+
10+
**Release date: 2025-03-06**
11+
**Release no.: 2024/Q4**
12+
**Release tag: 4.0.0**
13+
**JIRA cases with this release tag: [https://os2web.atlassian.net/issues/?jql=labels%20%3D%20%22Release_4.0.0%22](https://os2web.atlassian.net/issues/?jql=labels%20%3D%20%22Release_4.0.0%22)**
14+
15+
OS2forms has been cleaned up, as agreed with the OS2forms coordination group in the fall of 2024\.
16+
17+
This release primarily consists of a number of modules that have been removed from OS2forms, as they have either never been used or are no longer in use. In addition, a few new modules have been added, as requested by the OS2forms coordination group.
18+
19+
There are also some modules that Bellcom and the OS2forms coordination group had agreed should be removed, but which have not been removed. In the list below you can see which ones \- and why they have not been removed. Some of them we had overlooked were core modules (they were not placed in the core group), while others have some dependencies that we need to investigate further. Based on a precautionary principle, they have therefore not been removed in this release.
20+
21+
In addition, a single module from ITK has been added, which is not on the list of modules in the central maintenance agreement. It is the module OS2web Audit (os2web\_audit) \- link to readme: [https://github.com/OS2web/os2web\_audit/blob/develop/README.md](https://github.com/OS2web/os2web_audit/blob/develop/README.md).
22+
23+
**Modules that have been added:**
24+
25+
* OS2Forms Fasit (os2forms\_fasit) \- link to documentation: [https://github.com/OS2Forms/os2forms/blob/8a4d1ec8d4efaa2783accac51bf60be54f182f97/modules/os2forms\_fasit/docs/BENYTTELSE.md](https://github.com/OS2Forms/os2forms/blob/8a4d1ec8d4efaa2783accac51bf60be54f182f97/modules/os2forms_fasit/docs/BENYTTELSE.md)
26+
* FBS Handler (os2forms\_fbs\_handler) \- we can't find any link to documentation or readme on this module.
27+
28+
**Modules that have been removed:**
29+
30+
* Active Directory Integration / LDAP Integration \- NTLM & Kerberos Login (ldap\_auth)
31+
* Advanced Link (editor\_advanced\_link)
32+
* Checklist API Example (checklistapiexample)
33+
* Chosen (chosen)
34+
* Chosen Field (chosen\_field)
35+
* Chosen Library (chosen\_lib)
36+
* CKEditor Accessibility Checker (ckeditor\_a11ychecker)
37+
* CKEditor Balloon Panel (ckeditor\_balloonpanel)
38+
* CKEditor Entity Link (ckeditor\_entity\_link)
39+
* Configuration Filter (config\_filter)
40+
* Crop API (crop)
41+
* Date Popup (date\_popup)
42+
* Drupal Upgrade (migrate\_upgrade)
43+
* Easy Breadcrumb (easy\_breadcrumb)
44+
* Email Logging and Alerts (emaillog)
45+
* Entity (entity)
46+
* Entity Browser (entity\_browser)
47+
* Entity Browser example (entity\_browser\_example)
48+
* Entity Browser IEF (entity\_browser\_entity\_form)
49+
* Entity Embed (entity\_embed)
50+
* Environment indicator (environment\_indicator)
51+
* Environment indicator UI (environment\_indicator\_ui)
52+
* Field Color (field\_color)
53+
* Field Group (field\_group)
54+
* Field Group Migrate (field\_group\_migrate)
55+
* Header and Footer Scripts (header\_and\_footer\_scripts)
56+
* ImageWidgetCrop (image\_widget\_crop)
57+
* ImageWidgetCrop examples (image\_widget\_crop\_examples)
58+
* Inline Entity Form (inline\_entity\_form)
59+
* Linkit (linkit)
60+
* Maillog / Mail Developer (maillog)
61+
* Media entity crop (crop\_media\_entity)
62+
* Metatag (metatag)
63+
* Metatag Custom Routes (Paths) (metatag\_routes)
64+
* Metatag Extended Permissions (metatag\_extended\_perms)
65+
* Metatag: App Links (metatag\_app\_links)
66+
* Metatag: Dublin Core (metatag\_dc)
67+
* Metatag: Dublin Core Advanced (metatag\_dc\_advanced)
68+
* Metatag: Facebook (metatag\_facebook)
69+
* Metatag: Favicons (metatag\_favicons)
70+
* Metatag: Google Custom Search Engine (CSE) (metatag\_google\_cse)
71+
* Metatag: Google Plus (metatag\_google\_plus)
72+
* Metatag: Hreflang (metatag\_hreflang)
73+
* Metatag: Mobile & UI Adjustments (metatag\_mobile)
74+
* Metatag: Open Graph (metatag\_open\_graph)
75+
* Metatag: Open Graph Products (metatag\_open\_graph\_products)
76+
* Metatag: Page Manager (metatag\_page\_manager)
77+
* Metatag: Pinterest (metatag\_pinterest)
78+
* Metatag: Twitter Cards (metatag\_twitter\_cards)
79+
* Metatag: Verification (metatag\_verification)
80+
* Metatag: Views (metatag\_views)
81+
* Migrate Advanced Example Setup (migrate\_example\_advanced\_setup)
82+
* Migrate Example (Advanced) (migrate\_example\_advanced)
83+
* Migrate Example (migrate\_example)
84+
* Migrate Example Setup (migrate\_example\_setup)
85+
* Migrate JSON Example (migrate\_json\_example)
86+
* Migrate Plus (migrate\_plus)
87+
* Migrate Tools (migrate\_tools)
88+
* OS2forms Declaration of Consent (os2forms\_consent)
89+
* OS2Forms SimpleSAML Checklist (os2web\_simplesaml\_checklist)
90+
* Paragraphs (paragraphs)
91+
* Paragraphs Demo (paragraphs\_demo)
92+
* Paragraphs Library (paragraphs\_library)
93+
* Paragraphs Type Permissions (paragraphs\_type\_permissions)
94+
* Scheduler (scheduler)
95+
* Scheduler Rules Integration (scheduler\_rules\_integration)
96+
* Simple LDAP (simple\_ldap)
97+
* Simple LDAP SSO (simple\_ldap\_sso)
98+
* Simple LDAP User (simple\_ldap\_user)
99+
* starterkit\_theme (starterkit\_theme)
100+
* Web Server Logging and Alerts (errorlog)
101+
* White darkblue theme (white\_darkblue)
102+
103+
**Modules that were agreed to be removed but have not been removed:**
104+
105+
* Clientside Validation (clientside\_validation) – required by “Webforms” and “OS2forms”
106+
* Clientside Validation Demo (clientside\_validation\_demo) – required by “Webforms” and “OS2forms”
107+
* Clientside Validation jQuery (clientside\_validation\_jquery) – required by “Webforms” and “OS2forms”
108+
* Drupal Roles Authorization consumer (authorization\_drupal\_roles) – required by “LDAP”
109+
* Embed (embed) – required by ”OS2forms”
110+
* Entity Mask (ctools\_entity\_mask) – required by ”ImageWidgetCrop”
111+
* Migrate (migrate) – is part of Drupal core, so it cannot be removed
112+
* Migrate Drupal (migrate\_drupal) – is part of Drupal core, so it cannot be removed
113+
* Migrate Drupal UI (migrate\_drupal\_ui) – is part of Drupal core, so it cannot be removed
114+
* Redirect 404 (redirect\_404) – required by ”OS2forms”
115+
* Redirect Domain (redirect\_domain) – required by ”OS2forms”
116+
* Views Revisions (views\_revisions) – required by ”OS2forms”
117+
* Webform iCheck (webform\_icheck) – is part of Webforms, so it cannot be removed
118+
* Webform jQueryUI Buttons (webform\_jqueryui\_buttons) – is part of Webforms, so it cannot be removed
119+
* Webform Location Geocomplete (webform\_location\_geocomplete) – is part of Webforms, so it cannot be removed
120+
* Webform Toggles (webform\_toggles) – is part of Webforms, so it cannot be removed

‎releases/2025-Digital-Signature-Release-notes-Tag-4.X.X.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: Digital Signature module
3+
layout: default
4+
nav_order: 2
5+
parent: Releases
6+
---
7+
8+
# Release notes for Digital Signature module
9+
10+
**Release date: 2025-XX-XX**<br>
11+
**Release tag: 4.X.X**<br>
12+
**Link to module: https://github.com/OS2Forms/os2forms/modules/os2forms_digital_signature/**<br>
13+
**JIRA case: https://os2web.atlassian.net/browse/S2FRMS-57**
14+
15+
It is now possible to add digital signatures to forms submissions in OS2forms via the “OS2Forms Digital Signature” module. The module is installed under “Extend”, and subsequently configured via “Configuration” \-\> “System” \-\> “OS2Forms Digital Signature”. Here, among other things, the URL to the signature server, hash salt, relevant IP addresses and time period for handling unsigned submissions must be specified.
16+
17+
To use digital signatures in a form, the “OS2Forms Attachment” element must be added, as it generates the PDF that is sent for signing via the Digitaliseringsstyrelsen’s signing component. Digital Signature can be activated on the “OS2Forms Attachment” element. In addition, the Digital Signature handler must be added (no configuration required at this handler). If e-mail handlers are used, and you want these to be activated only after signing, this can be specified under the handler’s advanced settings.
18+
19+
Please note that the Digitaliseringsstyrelsen’s signing component does not support links in PDF files generated by Drupal – neither in content nor in layout (e.g. header and footer).
20+
21+
You can find a detailed user description in our documentation here: https://github.com/OS2Forms/os2forms_docs/blob/master/docs/digital_signature/documentation-on-digital-signature-module.md

‎releases/2025-Q4-oplæg-til-koordinationsgruppen.md‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: Efterårsrelease 2025
3+
layout: default
4+
nav_order: 3
5+
parent: Releases
6+
---
7+
8+
# Efterårsrelease 2025 - oplæg til koordinationsgruppen
9+
10+
Overblik over efterårsrelease til koordinationsgruppens videre arbejde.
11+
12+
## \#196: Diskussion og fastlæggelse af sikkerhedsopdateringer og løbende vedligehold
13+
14+
1. **#200: Modulet "CKEditor 4 (contrib) (ckeditor)" bør erstattes (af "CKEditor 5 (ckeditor5)") da det er deprecated**
15+
16+
* Afventer svar fra ITK (som har prøvet CKEditor 5 af)
17+
18+
2. **#205: Modulet "@fontyourface (fontyourface)" bør fjernes fra OS2forms da modulet ikke er compliant med GDPR**
19+
20+
* Bellcoms anbefaling er at benytte “@fontyourface - Local Fonts (local\_fonts)”, hvis der stadig ønskes en bestemt font i OS2forms. Estimat: 0,00 timer. De anvendere som ønsker at skifte til at bruge “@fontyourface - Local Fonts (local\_fonts)” kan kontakte Bellcom for estimat på opgaven på deres installationer
21+
22+
## \#194: Diskussion og fastlæggelse af udfasninger af moduler
23+
24+
1. **#207: Verificer at moduler der ikke kompatibel med Drupal 10 kan udfases (15 stk.)**
25+
26+
* Alle de nævnte moduler kan fjernes. Estimat: 6,00 timer
27+
28+
2. **#209: Undersøg om moduler der ikke anvendes og ikke er omfattet af central vedligehold kan fjernes (17 stk.)**
29+
30+
* 4 af modulerne kan fjernes. De andre moduler er enten core moduler i Drupal eller moduler som andre core moduler er afhængige af og derfor anbefaler Bellcom at disse moduler bliver en del af den centrale vedligeholdelsesaftale. Estimat: 2,00 timer
31+
32+
3. **Undersøg om moduler hvor brugeren afgiver cookies (noncompliant med GDPR) kan fjernes (6 stk.)**
33+
34+
* Disse moduler kan ikke fjernes, hvis man stadig ønsker at “@fontyourface - Local Fonts (local\_fonts)” skal kunne benyttes. Estimat: 0,00 timer
35+
36+
## \#210: Diskussion og fastlæggelse af tilpasning af moduler
37+
38+
1. **Ændring af navne på elementerne der i dag indeholder navnet "NemID", da "NemID" ikke længere eksisterer. Ændringen må dog ikke få konsekvenser for eksisterende formularer/installationer. Nyt navn foreslås til "MitID"**
39+
40+
* Ud fra Bellcoms anbefaling så er der 2 mulige løsninger på dette. Estimat: 2,00 til 4,00 timer (afhængig af valgt løsning)
41+
42+
2. **Modulet "OS2web nemlogin Automated Logout" bør som standard være aktiveret i en OS2forms installation**
43+
44+
* Ingen hindring for Bellcom. Estimat: 0,00 timer
45+
46+
## \#197: Diskussion og fastlæggelse af bidrag fra Bellcom (nyudvikling)
47+
48+
1. **#206: Release af Digital Signatur**
49+
50+
* Afventer internt review hos Bellcom. Estimat: 0,00 timer
51+
52+
## \#198: Diskussion og fastlæggelse af bidrag fra Aarhus Kommune/ITK (nyudvikling)
53+
54+
1. **#170: Implement MeMo1.2 compliance \[SFRMS-129]**
55+
56+
* Estimat: 3,50 timer til review (review er lavet, som aftalt på scopingmøde den 27/8-2025)
57+
58+
2. **#183: Fix: Webform Auto Exports settings issue**
59+
60+
* 0,00 timer til review (review er lavet - gratis fra Bellcom)
61+
62+
3. **#186: Fix: Name- and address protection multiple submission saves issue**
63+
64+
* Estimat: 2,25 timer til review
65+
66+
4. **#188: OS2forms sync modul not working**
67+
68+
* Estimat: ITK har lavet review på Bellcoms rettelse og det er merged ind i deres kode. Bellcom skal bruge 2,00 timer på at sikre at modulet kommer ind med det nye tag/rettelse i OS2forms
69+
70+
5. **#190: Fix: os2forms\_forloeb: Send Maestro notification handler exception handling when sending digital post**
71+
72+
* Estimat: 1,00 timer til review
73+
74+
6. **#195: Fix: os2forms\_forloeb: Maestro notification attempts sending digital post that will never be delivered**
75+
76+
* Estimat: 1,00 timer til review
77+
78+
7. **#218: Fix: MitId Children select missing a succesful check**
79+
80+
* Estimat: Afventer estimat fra Bellcom
81+
82+
8. **#219: Fix: Maestro notification handler ignores conditions (vilkår)**
83+
84+
* Estimat: Afventer estimat fra Bellcom

‎releases/releases.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
title: Releases
3+
layout: default
4+
nav_order: 2
5+
---

0 commit comments

Comments
 (0)