SOAP Import

Aus Onlinehelp
Zur Navigation springen Zur Suche springen


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

  • 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> (- nach folgender Beispiel-Struktur: XML Import/Export Struktur)
  • 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

Lebenslaufdaten als Komplettimport: Die Importe für Lebenslaufdaten werden auch als Komplettimporte angeboten. Dadurch können über den Import auch Werte gelöscht werden, indem sie im entsprechenden Import nicht mehr vorhanden sind.

Die folgenden Importarten gibt es derzeit im Mitarbeitermanagement (employeeapp):
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
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)

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
  • "
  • "ApplicationXML" -
  • "UsersExcel" - EXCEL Import: Benutzer importieren (Komplettimport)
  • "UsersXML" - XML Import: Benutzer importieren (Komplettimport)
  • "DynlistsExcel" - EXCEL Import: Auswahllisten importieren
  • "UsersWithoutHistorizationExcel" - EXCEL Import: Benutzer importieren (Teilimport)
  • "UsersWithoutHistorizationXML" - XML Import: Benutzer importieren (Teilimport)
  • "PositionsXML" - XMLImport: Stellen importieren


<Import Type> / Importart <Category> Beschreibung
ApplicationXML Bewerbungen/Personen-Import XML Import: Bewerbungen importieren
ApplicationExcel - EXCEL Import: Bewerbungen importieren
xx yy
xx yy
xx yy
xx yy
xx yy
xx yy
xx yy

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>
Abgerufen von „https://de.onlinehelp.umantis.com/index.php?title=SOAP_Import&oldid=14957“