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 unten aufgeführten Daten zum Mitarbeitermanagement sowie die Benutzer des Bewerbermanagements 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 eine komplett andere Struk-tur aufweisen.
WSDL - Definition
Für das Schweizer Hostingcenter: https://soap.umantis.com/umantis.WebImport.Stable/HttpImport.asmx?wsdl
Für das deutsche Hostingcenter: https://soap.de.umantis.com/umantis.WebImport.Stable/HttpImport.asmx?wsdl
Hinweise / Voraussetzungen für Standalone-Installationen
Das SSL-Zertifikat des Webservers muss exakt auf den Namen der Lösung aus-gestellt sein.
Request SOAP-Felder
- ApplicationUri: {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 unter Einstellungen konfigurierte Authentifikationsschlüssel für automatische Importe: <Authen-ticationKey>
- ImportType (string): Typ der zu importierenden Datei (verfügbare Import-Typen sehen Sie weiter unten): <ImportType>
- File (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): <Filena-me>
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: Wenn Sie "true" eingeben, wird nach Abschluss des Imports eine ent-sprechedne E-Mail an die in der Lösung konfigurierte E-Mail-Adresse gesendet; wenn Sie "false" eintragen, dann wird keine E-Mail gesendet: <SendStatusMail>
- Comments (string): Kommentare zum Import: <Comments>
Wenn zusätzliche Dokumente übertragen werden sollen, kommen noch folgende zwei 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: Die Da-teiendung muss korrekt gesetzt sein, also z.B. "import_dokumente.zip", lediglich "import_dokumente" würde nicht funktionieren.
Response
StatusCode (int): HTTP-Status-Code, wie er von der Umantis-Lösung zurückgegeben wurde. "200 (OK)" wird angegeben, wenn alles verarbeitet werden konnte.
ResultMessage (string): Text, welcher das Aufrufergebnis beschreibt.
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 | CourseAll-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.
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) |
| BranchOfcsXML | Niederlassungs-Import | XML Import: Niederlassungen importieren |
| BranchOfcsExcel | - | EXCEL Import: Niederlassungen importieren |
Hinweise zur Anbindung des Web Services über Visual Studio
Der Zugriff auf den Webdienst geschieht immer über HTTPS. Damit wird auf einen Proxy zuge-griffen, welcher die Anfragen (Requests) über HTTP an den Umantis-Server weiterleitet. Dadurch, dass die internen Umantis-Server über HTTP kommunizieren können, wird in der WSDL-Datei der Link als HTTP angezeigt.
Damit die Anwendung korrekt funktioniert, sind zwei Einstellungen in der app.config-Datei zu be-achten:
- 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>