SOAP Import

Für das Einrichten eines automatischen Imports von Benutzer- oder Stammdaten stellt umantis eine SOAP Schnittstelle zur Verfügung.

Datenimport über SOAP

Alle oben aufgeführten Daten zum Mitarbeitermanagement sowie die Benutzer zum Bewerbermanagement können auch über eine SOAP automatisiert in umantis hochgeladen werden.

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.

Request SOAP-Felder

• AuthenticationKey (string) - der in der Lösung (Einstellungen) für automatische Importe konfigurierte Authenticationkey. <AuthenticationKey>
• 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>
• ImportType (string) - Typ des zu importierenden Files (verfügbare Import Typen sehen sie unten) <ImportType>
• ImportFile (byte array) - binärer File Inhalt als byte array <File>
• Filename (string) - Name des zu importierenden Files (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
• Title (string) - optional: Titel des Imports <Title>
• Comments (string) - optional: Kommentare zum Import <Comments>
• ApplicationUrl: {Adresse ihrer Applikation}/Public/Import/HTTPInterface (Beispiel https://recruitingapp-123.umantis.com/Public/Import/HTTPInterface) <ApplicationUri>
• 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 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

Diese Importarten gibt es derzeit im Mitarbeitermanagement (employeeapp). Informationen zu Inhalten finden Sie unter Importe.

• "StaffingExcel" - EXCEL Import: MitarbeiterInnen importieren (Komplettimport)
• "StaffingWithoutHistorizationExcel" - EXCEL Import: MitarbeiterInnen importieren (Teilimport)
• "StaffingXML" - XML Import: MitarbeiterInnen importieren (Komplettimport)
• "StaffingWithoutHistorizationXML" - XML Import: MitarbeiterInnen importieren (Teilimport)
• "DynlistsExcel" - EXCEL Import: Auswahlliste importieren (Komplettimport) Bsp.OrgEinheiten
• "DynlistsWithoutHistorizationExcel" - EXCEL Import: Auswahlliste importieren (Teilimport) Bsp.OrgEinheiten
• "DynlistsXML" - XML Import: Auswahlliste importieren (Komplettimport) Bsp.OrgEinheiten
• "DynlistsWithoutHistorizationXML" - XML Import: Auswahlliste importieren (Teilimport) Bsp.OrgEinheiten
• "CoursesExcel" - EXCEL Import: Veranstaltungen importieren
• "CourseParticipationExcel" - EXCEL Import: Teilnahmen an Veranstaltungen importieren
• "CourseExternExcel" - EXCEL Import: Externe Teilnahmen importieren
• "CoursesXml" - XML Import: Veranstaltungen importieren
• "CourseParticipationXml" - XML Import: Teilnahmen an Veranstaltungen importieren
• "CourseExternXml" - XML Import: Externe Teilnahmen importieren
• "ExternalPersonsExcel" - EXCEL Import: Externe Personen importieren
• "ExternalPersonsXml" - XML Import: Externe Personen importieren

Unterschiede zwischen Komplettimport und Teilimport

Importarten Bewerbermanagement

Diese Importarten gibt es derzeit im Bewerbermanagement (recruitingapp). Informationen zu Inhalten finden Sie unter Importe.

• "PositionsExcel" - EXCEL Import: Stellen importieren
• "ApplicationExcel" - EXCEL Import: Bewerbungen importieren
• "ApplicationXML" - XML Import: Bewerbungen importieren
• "UsersExcel" - EXCEL Import: Benutzer importieren (Komplettimport)
• "UsersXML" - XML Import: Benutzer importieren (Komplettimport)
• "DynlistsExcel" - EXCEL Import: Auswahllisten importieren

(ab 28.10.2013 haben Sie zusätzlich folgende Importarten zur Verfügung)

• "UsersWithoutHistorizationExcel" - EXCEL Import: Benutzer importieren (Teilimport)
• "UsersWithoutHistorizationXML" - XML 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>