Skip to main content

Importer Interface

  • Updated
  • ~ minute read

XML importers are an indispensable tool for your business if you want to automatically import large amounts of jobs and will help you to grow your job board. In this article, you will learn how to unlock the full potential of the Jobiqo importer system by managing your importer with minimal effort.

To get to the importer overview, please follow the following steps:

1. Go to "Feeds (Path: "Jobs" > "Feeds" or directly via /admin/content/feed).

2. You can now select the importer you would like to check.

3. Click "Edit".

4. On the top, you find the following five tabs. Below you can find a detailed breakdown of each tab and all relevant functionalities.

mceclip1.png

Available tabs for importer

 

1) View tab

The "View" tab provides an overview of all information associated with the importer, such as the total amount of imported items, included products, and the last import run.

You can click on "import in background" in order to manually trigger an import.

 

mceclip0.png

View tab

 

2) Edit tab (please understand that these changes will be directly reflected in the frontend)

The "Edit" button allows you to update the importer settings.  

Most prominently, site administrators can also carry out the following operations:

  • Needs review: You can set the imported jobs to "needs review" if you would like to test the jobs in advance. This function allows to import jobs, but the jobs are not set to "active" automatically.
  • Mapping organisations: To map jobs to organisations please enable "Mapping organisations" and choose the source (name, jobiqo organisation ID, external client ID).
  • Backfill importer: If you want to mark imported jobs as backfill, please enable "Backfill importer". This setting is important if you would like to exclude backfill jobs from your exports and/or want to put backfill jobs behind organic jobs in the job search. 
  • Disable job updates: If this checkbox is enabled, you can edit imported jobs without losing your changes during the re-import. This setting is relevant if you are using the "needs review" workflow for the importer.
    Please keep the following implications in mind:
      • Imported jobs will not be updated even if the job source will be changed.
      • New jobs will be created if the XML file will be updated.
      • Existing jobs will be unpublished if those jobs will be removed from the source file.
  • Exclude from Google 4 Jobs index and sitemaps: Enabling the "Exclude from Google 4 Jobs index and sitemaps" checkbox allows you to exclude jobs from Google4Jobs index and sitemaps.
      • When the checkbox is enabled, jobs are skipped from the indexing API request, excluded in the sitemaps and we do not display schema.org which is relevant for Google 4 Jobs index.
      • It is recommended to activate this checkbox during a new importer set-up for testing purposes and remove the setting again once completed.
      • Please consider that jobs could still be indexed in Google, as we don't actively send the "noindex" request to Google.

Possible settings for your importer

If you want to learn more about the importer setup, please reach out to your Jobiqo point of contact.

Automatically add products to all imported jobs

If you want to assign existing upgrade products to imported jobs, please use the field "products". You can enter the name of the upgrade-product and save your settings if you want to assign the upgrade-product to all imported jobs.

The reference to the products



3) Items tab

The "Item" overview provides a list of all importer jobs. The view allows setting various filters, such as the job title, organisation name, change dates, workflow states, and job upgrades. 

  • Check the job state: The following workflow states are available: Draft, Needs review, scheduled, published, unpublished and archived.
  • Check included upgrade: The upgrades column lists the upgrades that are active for each importer job.
  • Check the actions taken: The action taken column defines the action taken for that specific job in the last importer run. The actions can be: 
    • Job was updated 
    • Job is expired (the job state changed from published to unpublished
    • none - no action was taken for the job in the last import
  • Review importer jobs: A click on "edit" opens the backend editing view. You can now review or edit the job details, such as the job description, the workflow state, the publishing dates, or the authoring information.
    Note: If you want to edit an imported job, please ensure that the "Disable job updates"  setting either on the importer directly or on the specific job is enabled. 
  • Bulk operations: Archive Jobs
    • Unpublish jobs
    • Mark jobs for reimport: this function is recommended if you want to update the selected jobs
    • Change the job state
    • Note: Please make sure to use bulk operations only with caution! 

4) History tab

To see the jobs imported in a feed as well as detailed statistics for each importer run you can visit the "History" view.


For further details and instructions, find further details about XML importer and how you can use it in this article: What is an XML importer and how can I use it.

Related articles