Automatic import of vacancies (Alma Career Czechia)

Business-level introduction

This document is designed for anyone who is involved with implementing a technical interface for transferring vacancies to Teamio from an external system. Business-level information is provided in this article:

Description of the interface

  • External application sends the HTTP request to upload interface the import file (authentication data sent by POST method is included)
  • After successful authentication, the loaded file will be converted and Teamio “Drafts” folder
  • In case of failed authentication an error message will be sent to your external application
  • Information about the status for the imported vacancies is sent to the main user by e-mail
  • Only HTTPS protocol is supported

Diagram of import interface

Syntax of HTTP request

  • Url: https://g2.lmc.cz/import/custompath/import (custompath will vary)
  • Method: POST
  • Content-type: application/x-www-form-urlencoded
  • Login credentials – username, password

Sample

cURL command line example for testing/debuging:

Demonstration PHP script for uploading XML of vacancy

Validation of your xml

You should validate your xml file using the following XSD:

For example use xmllint in command line:

    • Download libxml2 for your operationg system and install or unpack from: http://xmlsoft.org/downloads.html
    • Download both xsd in web browser or in Linux command line:

    • Run xmllint from libxml2 (import.xml is validated XML file):

    • When see this output then is XML valid:

See another tools and value lists section.

XML examples of vacancies

XML of ordinary vacancy with HTML tags in Job Description

Simple minimal example:

Each client can have an individual custom field in the import file

Therefore, we will generate a sample import-xml file for each client separately.

XML of vacancy advertised as given presentation unit

Please use <presentationUnit>. We will provide you with the ID of your company’s presentation unit on request.

XML of Temporary job

Importing a temporary job is possible. Please use employmentType 201300004.

A company that wants to import a temporary job must have an active Temporary Jobs Service.

Importing external reply form link

  • requires special active service
  • put following code in your import XML as child of <position> element

Supported HMTL tags in job description – richtext element:

The HTML code must be placed in the CDATA section inside the richtext element!

  • paragraph <p>…</p>
  • a new line <br/>
  • bold <strong>…</strong>
  • italic <em>…</em>
  • title <h2>…</h2>
  • lists <ul>…</ul>, <ol>…</ol>,<li>…</li>

Supported value lists and tools

– Job description XSD
– Value lists (completed, zipped)
– Value lists online
– Field mapping – professions to branches
– Work locations mapping
– Import test tool

See value list section.