Job boards

From Onlinehelp
Jump to navigation Jump to search

Job boards (also called job platforms) and job board providers provide an extensive and powerful method to publish job postings to external job boards from Umantis Applicant Management, alongside AM’s own job board (“Internal job postings”). See Publish job (publication channels) for more details.

Job boards like Jobs.ch or Monsterprovide a useful way to publish job postings through external publication channels. In Umantis Applicant Management, you can set up as many of these job boards as you like. A single job board can be used by multiple branch offices simultaneously for their publications, but only one publication language can be used for each platform. You can optionally specify a maximum publication period for a given job board, which limits how long a job posting can be published to that job board (the publication period is typically agreed on as part of the contract with the platform provider).
If no maximum publication period has been specified for a given job board, the job posting will automatically be withdrawn after 90 days.

Creating & editing job boards

Under Settings > Interfaces > Job boards, you can set up new job boards or edit the entries for existing platforms.

The following options are available in Umantis Applicant Management to publish job postings through job boards:

Email interface

This publication channel can be used to email job postings directly to the appropriate job board, which then publishes them. Multiple attachments can also be included and sent with each email. The format of the email and its attachments (e.g. XML format) can be modified to meet the requirements of different individual job boards. Similarly to the activation email, you can define an email format that should be sent to the job board when withdrawing a job posting.
Note: Only one email address is supported.

Web interface

With this publication method, the jobs to be published are made available to the job board through a dedicated web interface. Job boards typically get direct access to an Internet address that you communicate to them in advance, from which they copy over information about the jobs you publish there. This process is also known in the industry as “crawling” or “spidering” . On this approach, you simply have to inform the job board of the relevant Internet address (URL).

The URL typically has the following structure: https://recruitingapp-[YourID].umantis.com/XMLExport/[ID]?param1=[param1]&param_n=[param_n]

  • https://recruitingapp-[YourID].umantis.com/XMLExport/[ID]?: This part of the URL is fixed and cannot be changed.
  • [YourID]: Your customer ID.
  • [ID]: The export ID of the Automatic Export. This number is generated automatically by the system.
  • param1 to param_n: These parameters can be used to control data output (see Extracting and structuring job data with SQL and XSLT scripts). Including these parameters is optional, and you can add as many of them as necessary.

Example: “URL structure”:
https://recruitingapp-133.umantis.com/XMLExport/106?PlattformID=98010&CustomerID=133

Notes on modifying the request and “Apply” URLs in the SQL statement

If these two URLs are entered in the SQL statement for a job board with the [CustomerID] placeholder (e.g. https://recruitingapp-[CustomerID].umantis.com), this may cause the web interface to malfunction. In this case, follow the steps below to modify the SQL statement:

  1. Navigate to your job boards (/Administration/JobPlattforms/PlattformsDynamic).
  2. Find the job board you are using and click on
  3. In the General Settings for the job board, click on the link to “Edit web interface”.
  4. In the “SQL statement” sections, search for “[CustomerID]”
    • The following expressions are correct/valid: 'https://recruitingapp-'|| '[CustomerID]' ||'.umantis.com/Vacancies/'...
    • The following expressions are not correct: 'https://recruitingapp-[CustomerID].umantis.com/Vacancies/'... and should be modified.
      In this case, replace all occurrences of [CustomerID] with the number/ID of your Umantis solution. If the URL contains other variables that are not expressed in a valid form (in square brackets with no “pipe” characters), then please change these as well by adding the pipes (as shown in the correct example above: '|| '[Variable]' ||').
Check the SQL statement for all the job boards you use.


Additional notes:

  • You can set up as many job boards as you like, i.e. the number of job boards is not fixed.
  • For job boards that specify a maximum publication period, published jobs are automatically withdrawn when this period expires. For those job boards that have activated the email interface, a deactivation email is sent out when the posting is withdrawn.

Note:
The publication period is set when the job is published. This means that changing the publication period has no effect on jobs that have already been published. To change the publication period for jobs that have already been published, the jobs must first be withdrawn and then republished. If no maximum publication period has been specified for a given job board, the job posting will automatically be withdrawn after 90 days.

  • For each job board, you can specify multiple branch offices that can use the given job board as a shared publication platform.
  • Only one publication language can be defined for each job board.
  • Job boards that should not be used for publishing jobs (e.g. only for test purposes) can be marked as “inactive”.
  • When setting up and configuring job boards (SQL), an additional “source” parameter can be added to the job posting URL in order to automatically record the source of the application (see URL structure and parameters for a job posting (URL parameterization)).


Extracting and structuring job data with SQL and XSLT scripts
In order to provide the relevant job data through the URL, an SQL script is needed to extract the data, along with an XSLT file to structure the data in a well-defined XML format.

Example: “SQL and XSLT files”:
The following two files are used as a basis for extracting and structuring job data for the job board at jobs.ch. These scripts can be used as the basis for implementing other job boards as well.

‎

Deleting job boards

Deleting a job board means that the associated publication channel can no longer be used to publish new job postings. Jobs that are currently published on the job board can no longer be accessed after the job board is deleted, and the associated deactivation emails will not be automatically sent out.

Legacy job boards (HTML)

Older job boards delivered job postings in a fixed, predefined structure (HTML), and used URLs based on the following template: “https://recruitingapp-[IhreNummer].umantis.com/VacanciesPlattformA”. As the use of job boards has expanded, these static job boards have been replaced with a more flexible approach, so that the publication structure can now be dynamically modified (through the use of SQL and XSLT), and the URLs are now accessed with numeric IDs. The static URLs are still supported for these “old” job boards to provide backward compatibility, and job postings published to these boards can be accessed with both the old URL structure and the new structure.

The mapping from old to new structure is as follows:

  • VacanciesPlattformA ==> 98010
  • VacanciesPlattformB ==> 98020
  • VacanciesPlattformC ==> 98030
  • VacanciesPlattformD ==> 98040
  • VacanciesPlattformE ==> 98050
  • VacanciesPlattformF ==> 98060
  • VacanciesPlattformG ==> 98070
  • VacanciesPlattformH ==> 98080
  • VacanciesPlattformJ ==> 98090


Also worth knowing


Related topics

Retrieved from "https://en.onlinehelp.umantis.com/index.php?title=Job_boards&oldid=8657"