Org2Smart Administration Guide

What is Org2Smart ?

With Org2Smart you can import and export job and organizational fields in SmartRecruiters using a CSV file. It is available at https://rhaegal.app/org2smart

Getting Started

  1. First, get your Rhaegal key by contacting sales@rhaegal.com. This key is used to connect to Org2smart.

  2. Make sure your account has the integration pack from SmartRecruiters.

  3. Log into SmartRecruiters

Data privacy

No data from your files will be stored by Rhaegal. Only your parameters are locally stored in your navigator in plain text, as well as your Rhaegal key (optional).

Requirements

CSV Format

Each record must have 6 columns. Some columns can be left empty.

Default org fields

There are default org fields in SmartRecruiters: country, Function, Industry, Type of Employment, Experience Level, EEO Category, Brands and Department. None can be modified but Department. However, Department codes will be assigned by SmartRecruiters and cannot be customized.

Header and columns

Export

  • field_label*: Name of the field

  • value_code: Code of the value. For Departments, this cannot be customized

  • value_label: Label of the value

  • parent_field_label*: Name of the parent field. If blank, no dependency exists.

  • parent_value_code: Code of the parent value. If blank, no dependency exists.

  • parent_value_label: Label of the parent value. If blank, no dependency exists.

  • value_archived: Status of the value

Import

  • field_label*: Name of the field

  • value_code: Code of the value. For Departments, this cannot be customized

  • value_label: Label of the value

  • parent_field_label*: Name of the parent field. If blank, no dependency will be created.

  • parent_value_code: Code of the parent value. If parent_field_label is blank, must be blank too.

  • parent_value_label: Label of the parent value. If parent_field_label is blank, must be blank too.

If fields were previously translated using APIs or Translate2Smart, all fields marked with an asterisk (*) must use the English language value. Otherwise, you can use the values displayed in the job fields administration screen of SmartRecruiters.

Connecting to Org2Smart


  1. Paste your Rhaegal key to access to Org2Smart.

  2. Click on Login to open SmartRecruiters to authenticate your credentials.

Once connected, " Logged as: first name last name" will be displayed.


Uploading the .CSV file


Click on Choose File to select the file to upload.

Filter: select the org fields to upload from the CSV file. If no filters are selected, all org fields are managed.

Delimiter: this input is used to separate the fields in your CSV file.

If no filters are selected and the file only contains some of the org fields values, all others will be deactivated.

When Export org and job fields is selected, Org2Smart will export org and job fields and their values from SmartRecruiters.

Scheduler


Parameters

  • Cron -> See Cron expression

  • Host -> SFTP server address

  • Port -> The port of your SFTP server

  • Login -> Login to connect to your SFTP server

  • File path -> URI of your file on the SFTP server

  • Log directory -> Folder where logs will be saved. On the SFTP server

  • Log prefix -> Prefix of the log file: myLog-20190506060001.log

  • Delimiter -> See Delimiter above

  • Filter -> See Filter above


Cron expression

A cron expression represents a set of times. It used to define when your action will be executed. To generate a cron expression, https://www.freeformatter.com/cron-expression-generator-quartz.html.

After you configured your cron, copy the generated expression in Resulting Cron Expression, paste it in Org2Smart, in the Cron input.