SOAP Import
SOAP ist eine unidirektionale "read only" Schnittstelle, die Sie beim Import von Benutzer- oder Stammdaten in umantis unterstützt.
Datenimport über SOAP
Alle oben aufgeführten Daten zum Mitarbeitermanagement sowie die Benutzer zum Bewerbermanagement können auch über eine SOAP-Schnittstelle in umantis importiert werden. SOAP ist eine Möglichkeit des Imports und wird genutzt, um XML strukturierte Daten bzw. Excel (via SOAP) zu übermitteln.
Der SOAP Import kann nur mit Dateien vollzogen werden, die eine UTF8-Kodierung aufweisen.
URL (SOAP EndPoint)
Für das Schweizer Hostingcenter: https://soap.umantis.com/umantis.WebImport.Stable/HttpImport.asmx
Für das deutsche Hostingcenter: https://soap.de.umantis.com/umantis.WebImport.Stable/HttpImport.asmx
Für Kunden, die selbst hosten (Standalone), kann die URL komplett anders aussehen
Hinweise / Voraussetzungen für Standalone-Installationen
Das SSL-Zertifikat des Webservers muss exakt auf den Namen der Lösung ausgestellt sein.
Request SOAP-Felder
- ApplicationUrl: {Adresse ihrer Applikation}/Public/Import/HTTPInterface<ApplicationUri>
Beispiel Bewerbermanagement CH: https://recruitingapp-ID.umantis.com/Public/Import/HTTPInterface
Beispiel Mitarbeitermanagement DE: https://employeeapp-ID.de.umantis.com/Public/Import/HTTPInterface - AuthenticationKey (string) - der in der Lösung (Einstellungen) für automatische Importe konfigurierte Authenticationkey. <AuthenticationKey>
- ImportType (string) - Typ der zu importierenden Datei (verfügbare Import Typen sehen sie unten) <ImportType>
- ImportFile (byte array) - binärer Dateiinhalt als byte array <File> (- nach folgender Beispiel-Struktur: XML Import/Export Struktur)
- Filename (string) - Name der zu importierenden Datei (wird in der Lösung angezeigt) <Filename>
ACHTUNG!!! Die Dateiendung muss korrekt gesetzt sein, also z.B. "mein_import.xml", lediglich "mein_import" würde nicht funktionieren
Optionale Felder:
- Title (string): Titel des Imports <Title>
- SendStatusMail (boolean) - true, es wird nach Abschluss des Imports eine E-Mail an die in der Lösung konfigurierte E-Mail Adresse geschickt / false = keine E-Mail wird ausgelöst <SendStatusMail>
- Comments (string): Kommentare zum Import <Comments>
Wenn zusätzliche Dokumente übertragen werden sollen, kommen noch folgende beide Felder hinzu:
- ZipFile(byte array) - optional: binärer File Zip-Inhalt als byte array <ZipFile> zum importieren von Dokumenten, siehe Dokumentation zu Dokumente importieren im Import <ZipFile>
- ZipFilename(string) - erforderlich wenn ZipFile angegeben wurde: Name des zu importierenden Zip-Files (wird im Logfile angezeigt) <ZipFilename>
ACHTUNG!!! Dateiendung muss korrekt gesetzt sein, also z.B. "import_dokumente.zip", lediglich "import_dokumente" würde nicht reichen
Response
StatusCode (int) - Http Status code, wie er von der umantis Applikation zurückgegeben wurde. 200 (OK) wenn alles verarbeitet werden konnte. ResultMessage (string) - Text, welcher das Aufrufergebnis beschreibt
das WSDL dazu findet sich unter: https://soap.umantis.com/umantis.WebImport.Stable/HttpImport.asmx?wsdl
Importarten Mitarbeitermanagement
Die Importe für Lebenslaufdaten werden auch als Komplettimporte angeboten. Werte, die im Komplettimport nicht mehr vorhanden sind, werden somit gelöscht
Die folgenden Importarten gibt es derzeit im Mitarbeitermanagement:
Informationen zu Inhalten finden Sie unter Importe.
| <Import Type> / Importart | <Category> | Beschreibung |
|---|---|---|
| CourseExternXml | CourseParticipation-Import | XML Import: Externe Teilnahmen importieren |
| CourseExternExcel | - | EXCEL Import: Externe Teilnahmen importieren |
| CourseParticipationXml | CourseParticipation-Import | XML Import: Teilnahmen an Veranstaltungen importieren |
| CourseParticipationExcel | - | EXCEL Import: Teilnahmen an Veranstaltungen importieren |
| CoursesXml | Course-Import | XML Import: Veranstaltungen importieren |
| CoursesExcel | - | EXCEL Import: Veranstaltungen importieren |
| CoursesWithoutHistorizationXml | Course-Import | XML Import: Veranstaltungen importieren (Teilimport) |
| CoursesWithoutHistorizationExcel | - | EXCEL Import: Veranstaltungen importieren (Teilimport) |
| DynlistsXML | List-Import | XML Import: Auswahlliste importieren (Komplettimport) Bsp.OrgEinheiten |
| DynlistsExcel | - | EXCEL Import: Auswahlliste importieren (Komplettimport) Bsp.OrgEinheiten |
| DynlistsWithoutHistorizationXML | List-Import | XML Import: Auswahlliste importieren (Teilimport) Bsp.OrgEinheiten |
| DynlistsWithoutHistorizationExcel | - | EXCEL Import: Auswahlliste importieren (Teilimport) Bsp.OrgEinheiten |
| ExternalPersonsXml | CourseParticipation-Import | XML Import: Externe Personen importieren |
| ExternalPersonsExcel | - | EXCEL Import: Externe Personen importieren |
| PersonsCVContinuingEducationXml | Personen-CV-Continuingeducation-Import-xml | XML Import: Weiterbildung importieren |
| PersonsCVContinuingEducationExcel | - | EXCEL Import: Weiterbildung importieren |
| PersonsCVEducationXml | Personen-CV-Education-Import-xml | XML Import: Ausbildung importieren |
| PersonsCVEducationExcel | - | EXCEL Import: Ausbildung importieren |
| PersonsCVExperienceXml | Personen-CV-Experience-Import-xml | XML Import: Berufserfahrung importieren |
| PersonsCVExperienceExcel | - | EXCEL Import: Berufserfahrung importieren |
| PersonsCVFurtherEducationXml | Personen-CV-Furthereducation-Import-xml | XML Import: Studium importieren |
| PersonsCVFurtherEducationExcel | - | EXCEL Import: Studium importieren |
| PersonsCVLanguageSkillXml | Personen-CV-LanguageSkills-Import-xml | XML Import: Sprachkenntnisse importieren |
| PersonsCVLanguageSkillExcel | - | EXCEL Import: Sprachkenntnisse importieren |
| StaffingXML | Personen-Stellen-Import | XML Import: MitarbeiterInnen importieren (Komplettimport) |
| StaffingExcel | - | EXCEL Import: MitarbeiterInnen importieren (Komplettimport) |
| StaffingWithoutHistorizationXML | Personen-Stellen-Import | XML Import: MitarbeiterInnen importieren (Teilimport) |
| StaffingWithoutHistorizationExcel | - | EXCEL Import: MitarbeiterInnen importieren (Teilimport) |
Hier finden Sie Informationen zu den Unterschieden zwischen Komplettimport und Teilimport.
Importarten Bewerbermanagement
Diese Importarten gibt es derzeit im Bewerbermanagement (recruitingapp).
Informationen zu Inhalten finden Sie unter Importe.
| <Import Type> / Importart | <Category> | Beschreibung |
|---|---|---|
| ApplicationXML | Bewerbungen/Personen-Import | XML Import: Bewerbungen importieren |
| ApplicationExcel | - | EXCEL Import: Bewerbungen importieren |
| DynlistsXML | List-Import | XML Import: Auswahllisten importieren |
| DynlistsExcel | - | EXCEL Import: Auswahllisten importieren |
| PositionsXML | Stellen-Import | XMLImport: Stellen importieren |
| PositionsExcel | - | EXCEL Import: Stellen importieren |
| UsersXML | User-Import | XML Import: Benutzer importieren (Komplettimport) |
| UsersExcel | - | EXCEL Import: Benutzer importieren (Komplettimport) |
| UsersWithoutHistorizationXML | User-Import | XML Import: Benutzer importieren (Teilimport) |
| UsersWithoutHistorizationExcel | - | EXCEL Import: Benutzer importieren (Teilimport) |
Hinweise zur Anbindung des Web Services über Visual Studio
Der Zugriff auf den Web Service geschieht immer über HTTPS. Dieser Zugriff greift auf einen Proxy zu und dieser widerum leitet die Requests über HTTP an unsere Server weiter. Dadurch, dass unsere internen Server über HTTP kommunizieren wird in der WSDL Datei der Link als HTTP angezeigt.
Damit die Anwendung korrekt funktioniert sind zwei Einstellungen in der app.config Datei zu beachten:
- Den security mode auf "Transport" umstellen (entspricht HTTPS):
<security mode="Transport">
<transport clientCredentialType="None" proxyCredentialType="None"
realm="" />
<message clientCredentialType="UserName" algorithmSuite="Default" />
</security>
- Client address point auf "HTTPS" umstellen:
<client>
<endpoint address="https://soap.umantis.com/umantis.WebImport.Stable/HttpImport.asmx"
binding="basicHttpBinding" bindingConfiguration="HttpImportSoap"
contract="umantis.WebImport.Beta.HttpImportSoap" name="HttpImportSoap" />
</client>