FAQ Web-Agenturen - Anbindung Karriereseite
Um Ihre Stellen auf der Homepage veröffentlichen gibt gibt es verschiedene Methoden.
Stimmen Sie sich zusammen mit concludis und der Ihrer Web-Agentur (Oder Marketing-Abteilung) ab, welche Option für Sie in Frage kommt.
Wir beraten Sie gerne!
Anbindungsmethoden:
API:
https://concludis-hilfecenter.helpscoutdocs.com/article/416-integration-per-api
Beispiel: https://www.rhenus.group/karriere/jobboerse/
Java-Script-Snippet:
https://concludis-hilfecenter.helpscoutdocs.com/article/414-integration-per-javascript-snippet
Beispiel: https://diederichs-gruppe.de/karriere/
By concludis:
FAQ Anbindung via API:
Um was für eine Art Schnittstelle handelt es sich genau?
Es handelt sich um eine Rest-Api (Representational State Transfers) auf Json Basis. REST-APIs nutzen http/https, während Apis zusätzlich zu http/https Protokolle wie SOAP und BEEP nutzen.
Existiert eine Dokumentation für eine Api-Anbindung?
Jeder Kunde (Ansprechpartner einer Installation) kann die Daten über unseren concludis Support anfragen. Wir legen auf Wunsch, z.B. für die Web-Agentur in der Installation einen Api-Nutzer mit einem Passwort an. Dieser Nutzer kann mit seinen Login-Daten unter dem Link: https://kundeninstallationsnamen.concludis.de/API/2.0/de_DE auf die Dokumentation zugreifen.
Welche Endpoints bietet concludis an?
In concludis finden sich zahlreiche Endpoints. Wir konzentrieren uns im folgenden auf diejenigen, die für Sie als Mitarbeiter einer Web-Agentur eine hohe Relevanz haben:
| Endpoint_name | Relevanz für |
| projects | Stellenanzeigen/Stellenbörse |
| apply | Bewerbungen ins System einspielen |
| candidate transmission | Übertrag von Bewerberdaten von concludis in ein Fremdsystem via HR JSON |
| data connect | (kostenpflichtig) Anbindung an BI-Tools |
Kann auf Kundenwunsch ein eigenes Bewerberformular erstellt werden?
Ja, über die Endpoints "apply" und "setup" kann ein, z.B. von der Web-Agentur erstelltes Formular, angebunden werden. Bewerbungsrelevante Fragen aus dem jeweiligen, in concludis erstellten Projekt (Stellenanzeige), sowie Fragen aus einem erstellten Fragebogen, können im Formular dargestellt werden.
Was wird an die Api aus den Projekteigenschaften übergeben?
Alle relevanten Projekteigenschaften werden an die Api übergeben.
Ist es für international agierende Unternehmen möglich die concludis Mehrsprachigkeit via Api abzurufen?
Ja, dies ist über eine separate Abfrage möglich. Der Ansprechpartner auf Kundenseite entscheidet über die Fallback-Sprache.
Beispiel URL: kundeninstallationsname.concludis.de/Api/2.0/EN_GB für eine englischsprachige Installation
Für die Sprachparameter orientieren wir uns an dem Standard Sprachcode (local). Z.B. verwende wir für Englisch: "EN_GB"
Wäre ein Testing der Anbindungsmethode über ein Staging-System möglich?
Der Kunde kann ein Staging-System, sprich eine weitere Installation für Testzwecke erwerben. Dies wäre eine hochspezifische Konfiguration einer Kundeninstallation.
Im Regelfall finden Testings ohne den Erwerb eines Staging-Systems, sondern im Produktivsystem statt. Aus der Erfahrung ist hier nicht mit spezifischen Risiken zu rechnen. Gerne unterstützt der concludis Support Sie und den Kunden bei diesem Vorgehen.
Existieren fertige Plugins für bekannte CMS?
Nein, diese existieren nicht.
Ist es Möglich auf fertige Bibliotheken zugreifen zu können?
Es besteht die Möglichkeit auf die von uns angelegte Git-Bibliothek zugreifen zu können. Bitte kontaktieren Sie hierfür gern unseren concludis Support.
Sind Live-Abfragen über die concludis Api möglich?
Nein, die Abfragen werden in einem kompletten Caching erfolgen. Dieses Caching sollte ein 15 min Rhythmus nicht unterschreiten.
Entstehen dem concludis Kunden durch die Api Kosten?
Grundsätzlich nicht. Alle Api Endpoints, bis auf den Endpoint "Data Connect" stehen unseren Kunden kostenfrei zur Verfügung.
Wird das HTML markup einer Stellenanzeige über den Api Endpoint "project" an die Web-Agentur übergeben?
Es werden strukturierte Textcontainer, wie das komplette HTML markup und das CSS via der Api-Schnittstelle übergeben. Weitere Informationen können der Api-Dokumentation entnommen werden.
Werden einzelne Bewerbungswege via URL übergeben?
Ja, concludis leitet auf eine landing page weiter. Dort werden dem Bewerber, die vorab ausgewählten Bewerbungswege als Auswahl zur Verfügung gestellt.
Ebenfalls besteht die Möglichkeit des Erhalts eines direct link. Bitte sprechen Sie hierfür den concludis Support an.
Welche Punkte müssen für eine erfolgreiche Anbindung von concludis an Ihre Karriereseite beachtet werden?
Concludis benötigt entsprechende forwarding Links:
- zur Stellenbörse
- zur Stellenanzeige
- zum Bewerbungsformular (sofern das Formular auf Kundenseite über die Agentur eingebunden ist)
Wie ist der Aufbau des forwarding Links?
um die concludis Stellenliste in die Karriereseite zu integrieren können mögliche Platzhalter verwendet werden:
- [lang] Aktuell angefragte Sprach-Parameter, z.B de, en oder fr
- [locale] Aktuell angefragter Locale-Parameter, z.B de_DE, en_GB oder fr_FR
- [jobid] Aktuell angefragte Projekt-ID (Integer), nicht verwendbar in URL Stellenbörse
- [jobtitle] Aktuelle Positionsbezeichnung für SEO-Urls (String), nicht verwendbar in URL Stellenbörse
- [location_external_id] Aktuell angefragte externe Location-ID (String), nicht verwendbar in URL Stellenbörse
Bsp. für die URL der Stellenbörse:
https://www.kundeninstallationsname.com/[locale]/career/current-jobs
Bsp. für die URL für die Stellenanzeigen:
https://www.kundeninstallationsname.com/[locale]/career/current-jobs/job-detail/[jobid]
Bsp. für die URL des Bewerbungsformulars:
https://www.kundeninstallationsname.com/[locale]/career/current-jobs/job-apply/[jobid]
Sollte der Aufbau gemäß den gezeigten Beispielen nicht möglich sein, z.B. wegen SEO Gründen, empfehlen wir einen Aufbau einer sogenannten Schattenseite seitens der Web-Agentur. Auf diese Weise kann ein eigener forwarding Algorithmus erstellt werden.
Im Falle einer Anbindung via JavaScript Snipped reicht ggfs. ein Deeplink Parameter aus.
Weiter führender Artikel siehe:
Integration via Api:
https://concludis-hilfecenter.helpscoutdocs.com/article/416-integration-per-api
Integration via Java Script Snipped:
https://concludis-hilfecenter.helpscoutdocs.com/article/414-integration-per-javascript-snippet