OPUS indlæsningsintegration

OPUS indlæsningsintegration leverer KMD OPUS’ datafil videre til OS2sofd, så organisationshierarki og medarbejderoplysninger fra OPUS kan indlæses. Komponenten er en on-premise Windows-service, der overvåger et lokalt filområde, matcher OPUS-filen ud fra et navnemønster, og uploader den til Digital Identitys FileShare-middleware. OS2sofd indlæser derefter data fra filen.

KomponentServicenavnDownloadÆndringslog
OPUS indlæsningsintegrationS3 File UploaderDownloadÆndringslog

I Windows Services hedder servicen “S3 File Uploader”. Det er en generel fil-overførselskomponent, der også kan bruges til at uploade andre filer, men i OS2sofd-sammenhæng er det OPUS-indlæsningsintegrationen.

Forudsætninger#

Windows Server#

  • Læseadgang til filområdet, hvor OPUS-filen fra KMD lægges (typisk et KFS-LAN share).
  • Udgående HTTPS-adgang til FileShare-middlewaren (https://fileshare.digital-identity.dk).

Service konto#

Hvis filområdet kræver en domænekonto for at kunne læses, skal servicen afvikles under en sådan (angives på “Log On”-fanen i Windows Services). Ellers kan den køre som Local System.

API-nøgle til FileShare#

Udleveres af Digital Identity. Kan valgfrit hentes via CyberArk (PAM).

Installation#

Download service#

Hent installeren via download-linket øverst på siden eller fra den samlede Download-oversigt.

Konfiguration af service#

Konfigurationen foretages i filen appsettings.json i installationsmappen. For OPUS skal der være en upload med navnet Opus, der peger på mappen, hvor OPUS-filen fra KMD lægges.

{
  "LogFile": "C:/Logs/s3fileuploader/S3FileUploader.log",
  "CronSchedule": "0 0/15 * ? * * *",
  "FileShare": {
    "url": "https://fileshare.digital-identity.dk",
    "apiKey": ""
  },
  "PAMSettings": {
    "Enabled": false,
    "CyberArkAppId": "",
    "CyberArkSafe": "",
    "CyberArkObject": "",
    "CyberArkAPI": ""
  },
  "FileUploads": [
    {
      "Name": "Opus",
      "DirectoryPath": "C:/Temp",
      "InputFileNamePattern": "ZLPE(?<year>\\d{4})(?<month>\\d{2})(?<day>\\d{2})",
      "OutputFileNameTemplate": "opus-<year><month><day>.xml"
    }
  ]
}
IndstillingBeskrivelse
LogFileSti til logfilen.
CronScheduleHvor ofte filområdet tjekkes for nye filer (default hvert 15. minut).
FileShare.urlAdressen på FileShare-middlewaren.
FileShare.apiKeyAPI-nøgle til FileShare (udleveres af Digital Identity).
PAMSettingsValgfrit: hent apiKey fra CyberArk i stedet for klartekst.
FileUploads[].NameNavnet på uploaden. For OPUS er det Opus.
FileUploads[].DirectoryPathMappen (typisk et KFS-LAN share), hvor OPUS-filen fra KMD lægges.
FileUploads[].InputFileNamePatternRegulært udtryk, der matcher OPUS-filnavnet (ZLPE efterfulgt af dato) og udtrækker år/måned/dag.
FileUploads[].OutputFileNameTemplateFilnavnet ved upload, med dato indsat.

Komponenten kan også konfigureres til at hente filer fra FileShare via en tilsvarende FileDownloads-sektion (samme felter: Name, CronSchedule, DirectoryPath, InputFileNamePattern, OutputFileNameTemplate). Det bruges til andre formål end OPUS-indlæsningen og er ikke nødvendigt for OPUS-flowet.

Start af service#

Efter konfiguration startes servicen via Windows Services. Ved start køres en upload med det samme, og derefter efter CronSchedule. Kræver filområdet en domænekonto, angives den på “Log On”-fanen.

Ændringslog#

Ændringslog for OPUS indlæsningsintegration. Nyeste version øverst.

VersionDatoÆndring
1.3.001.08.2024Tilføjet understøttelse af CyberArk (Privileged Access Management)
1.2.014.03.2024Rettet fejl i fil-download-koden
1.1.013.10.2023Tilføjet valgfri overstyring af encrypt-indstilling for uploads
1.0.324.05.2022Rettet cron-udtryk i appsettings.template.json
1.0.204.05.2022Forbedret noget logning
1.0.110.12.2019Uploaderen kræver ikke længere skriveadgang til kildemapperne, kun læseadgang
1.0.010.12.2019Første version