os2forms/os2forms_fasit

OS2Forms Fasit integration

1.2.0 2024-09-26 11:56 UTC

Requires

• php: ^8.3
• ext-dom: *
• drupal/advancedqueue: ^1.0
• drupal/webform: ^6.1
• os2forms/os2forms: ^3.16
• symfony/options-resolver: ^5.4 || ^6.0

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^1.0
• drupal/coder: ^8.3
• mglaman/drupal-check: ^1.4

MIT

• Jeppe Kuhlmann Andersen

README

Adds Fasit Schultz handler for archiving purposes.

Installation

composer require os2forms/os2forms_fasit
vendor/bin/drush pm:enable os2forms_fasit

Settings

Configure Fasit API base url and a way of getting certificate on /admin/os2forms_fasit/settings.

Certificate

The certificate must be in pem or cer format and must be whitelisted by Fasit Schultz. For this the certificate thumbprint, in lowercase and without colons, is needed. To get the thumbprint in the correct format from the command line run

openssl x509 -in SOME_CERTIFICATE.pem -noout -fingerprint |  cut -d= -f2 | sed 's/://g' | tr '[:upper:]' '[:lower:]'

Example output

6acb261f393172d87fa3997cec86569759a8528a

Queue

Archiving is done via an Advanced Queue called fasit_queue.

The queue should be processed with drush:

drush advancedqueue:queue:process fasit_queue

List the queue (and all other queues) with

drush advancedqueue:queue:list

or go to /admin/config/system/queues/jobs/fasit_queue for a graphical overview of jobs in the queue.

Cronjob

Consider running the queue via a cronjob.

*/5 * * * * /path/to/drush advancedqueue:queue:process fasit_queue

Coding standards

Check coding standards:

// PHP CS Fixer
docker run --rm --interactive --tty --volume ${PWD}:/app itkdev/php8.3-fpm:latest composer install
docker run --rm --interactive --tty --volume ${PWD}:/app itkdev/php8.3-fpm:latest composer coding-standards-check

// Markdownlint
docker run --rm --interactive --tty --volume ${PWD}:/app node:20 yarn --cwd /app install
docker run --rm --interactive --tty --volume ${PWD}:/app node:20 yarn --cwd /app coding-standards-check

Apply coding standards:

docker run --rm --interactive --tty --volume ${PWD}:/app itkdev/php8.3-fpm:latest composer coding-standards-apply
docker run --rm --interactive --tty --volume ${PWD}:/app node:20 yarn --cwd /app coding-standards-apply