Die Exportfunktion ermöglicht es Recruitern, Daten und Dokumente aus MHMeRECRUITING zu exportieren und in einem HR-Tool oder einer Personalakte zu importieren. Diese Funktion bietet eine Vielzahl von Vorteilen, sowohl für den aktuellen Arbeitsprozess als auch für zukünftige Anwendungen durch die Möglichkeit des Imports. Sie sparen somit beispielsweise die händische Übertragung von Bewerberdaten.
Nachfolgend ist die Schnittstelle und der generelle Ablauf beschrieben:
1. Ablauf Recruiter
Bei einem Bewerber der im Status "Eingestellt" ist kann die Aktion "Exportieren" ausgeführt werden.
Ab diesem Zeitpunkt stehen die Bewerberdaten für maximal zwei Wochen über die unten beschriebene JSON-API bereit.
Hinweis: Die Dauer kann sich noch ändern und ist für Systeme, die den „imported“ Callback nicht aufrufen.
Ein Benutzer kann nachdem ein Bewerber importiert wurde den Export-Vorgang erneut anstoßen.
Der abfragende Service muss also damit umgehen können, dass ein Bewerber erneut geliefert wird.
Im Idealfall werden die Daten des Bewerbers vom abfragenden Service neu importiert oder dadurch aktualisiert.
2. Berechtigungen
Die Berechtigungsgruppe wird von MHM bereitgestellt. Über die Anwendung kann einem Benutzer diese Berechtigungsgruppe zugewiesen werden.
Dieser Benutzer kann dann die API abrufen.
**Beispiel:**
```
$ curl --user 'user-name@your-company.test:n-f4ESC9PlFSCvh.)TQW' https://example.test/interfaces/v1/export_job_applications/all.json
```
JSON-API
3.1 Allgemein
Die Übertragung der Daten zwischen den System erfolgt per HTTPS.
Die Schnittstelle ist durch eine Basic-Authentication geschützt, so dass nur berechtigte Benutzer darauf Zugriff haben.
Die API verfügt über drei verschiedene Endpoints.
- Bewerberdaten abfragen
- Einzelnes Bewerberdokument abfragen
- Bewerber als importiert markieren
3.2 Bewerberdaten abfragen
`/interfaces/export_job_applications/all.json` | field-name | comment | |----------------|-----------|
| salutation | |
| title | |
| firstname | mandatory |
| lastname | mandatory |
| email | mandatory |
| birth_date | iso8601 |
| telephone | |
| mobile_phone | |
| street | |
| zipcode | |
| city | |
| state | |
| country | |
| application_id | uniq id |
| type | |
| created_at | iso8601 |
| vacancy_id | mandatory |
| vacancy_title | mandatory | | attachments | array |
| field-name | comment | |-------------------|---------|
| attachment_id | uniq id |
| type | |
| title | |
| data_file_name | |
| data_content_type | |
| data_file_size | bytes |
**Beispiel:**
```
$ curl -v https://example.test/interfaces/v1/export_job_applications/all.json
...
> GET /interfaces/v1/export_job_applications/all.json HTTP/1.1
...
< HTTP/1.1 200 OK
... [{"salutation":"ms","title":"Dr.","firstname":"Zara","lastname":"Seiboldd","email":"rosen do265@test.test","birth_date":"1981-04- 10","telephone":"","mobile_phone":"","street":"Muster Str. 20","zipcode":"76117","city":"Lucianstadt","state":"","country":"de","application_id":12, "type":"JobApplications::Headhunter","created_at":"2021-07- 05T11:52:42.946+02:00","vacancy_id":21,"vacancy_title":"Developer (m/w/d)","attachments":[{"attachment_id":424,"type":"Profile::Attachments::Document ","title":"curriculum_vitae","data_file_name":"document.pdf","data_content_type":"app lication/pdf","data_file_size":11112}]}]%
```
Hinweis:
Bei manchen Feldern wird statt _""_ der Wert _null_ geliefert. Diese beiden Werte sind gleichbedeutend.
An einer Bewerbung können keine, eine oder mehrere Dokumente hinterlegt sein. Die Dokumente wie Anschreiben, Lebenslauf, Zeugnisse etc. können als separate Dateien oder als eine zusammengefasste Dateien vorliegen.
Die Dateien können vom Bewerber oder Recruiter als Lebenslauf, Zeugnis, etc. klassifiziert werden.