LA API

In diesem Repository werden die Beschreibung der API zum HS Personalwesen (YAML-Datei) und der Changelog veröffentlicht.

Elements UI API

Die Schnittstellenbeschreibung kann auch in der Elements UI API direkt als GitHub-Page angezeigt werden unter folgender URL: https://hamburger-software.github.io/la-api/

Code-Generierung

Für die Code-Generierung aus der YAML-Datei kann z.B. der OpenApi Generator verwendet werden (https://openapi-generator.tech/docs/usage/). Es werden diverse Programmiersprachen unterstützt.

Die Code-Generierung kann mit dem Kommandozeilen-Tool "openapi-generator-cli" erfolgen. Für C#-Client-Code kann das z.B. so aussehen:

java -jar openapi-generator-cli-7.3.0.jar generate -i LA-API.yaml -g csharp --generate-alias-as-model --model-name-suffix Model -c config.json --http-user-agent MySolution -o C:\TEMP\Hs.La.RestApi

Sinnvoll ist die Verwendung eines eigenen Namespaces. Dieser kann über eine Config-Datei (z.B. config.json) angegeben werden, z.B.:

config.json

{
  "packageName": "Hs.La.RestApi.Generated",
  "targetFramework": "net48"
}

Außerdem sollte der HTTP-User-Agent gesetzt werden. Das ist über die Kommandozeile möglich:

--http-user-agent MySolution

Weitere Informationen

Weitere Informationen für Lösungsersteller gibt es

• in der Hilfe des Personalwesens im Kapitel "Anleitung & Wissen / Datenaustausch / API (Webservice) / Anwendungswissen"
• in der Datei "la_api_webservice.pdf" im Unterverzeichnis "Hilfe_Pdfs" des Programmverzeichnisses des installierten Personalwesens (z.B. C:\Program Files (x86)\Hs\La)