Posting

The Posting bundle allows access to the Posting web service which allows the retrieval of postings that have been posted to a single channel. A typical use of this bundle would be the retrieval of live postings for displaying on an external system.

The different ways of retrieving the postings are :

  • Get details of all live postings for a channel using getPostedAdverts.
  • Get details of postings for a channel using getPostedAdvertsFromRange for a given date range.
  • Get details of postings to a channel for specified IDs (used in conjunction with the option above).

 

The posting web service does not allow for live searching on postings. Therefore, to create a career web site, a client using the web service must retrieve the postings at regular intervals and store the result. Their career site must then read the position details from their local data store.

 

Typical workflow

 

Use Case

Customers can use posting webservice to advertise to external Job boards. In order to receive candidate applications from the job boards the candidate webservice should be used.

Pre-condition 

  • A Job Board/Channel needs to be setup and configured,
  • The job requisition must be posted to the relevant job board.
  • Webservice User need to be configured in Talentlink and given appropriate right & roles to view postings

Scenario

  1. START: The career site calls the TalentLink Exchange posting web service regularly to get an up-to-date list of active postings.
  2. TalentLink generates a file using the predefined file definition schema to exchange data with career websites.
  3. TalentLink Exchange maps the retrieved job posting(s) to the career website job advertisements definition and returns a success or failure message as appropriate.
  4. If TalentLink Exchange successfully manages the request, active postings are retrieved and stored in the cache component. Once a candidate makes a search by defining the job criteria, the career site calls the cache to get suitable results and displays them to the candidate. END.
  5. If TalentLink Exchange returns an error, an appropriate SOAP response is sent to the web service client (for SOAP web services).

Response Format

XML

SOAP METHODS

The method getActiveChannels is used to return a collection of all active channels that are accessible by the user of the web service. Only channels to which the user has access will be returned. Typically one or more channels will be created for a third party such as a job board. The third party will be informed of their channel ID(s) which then allows them to access posting data assigned to that channel.

This method must be called with Talentlink backoffice user credentials.
The user name must be set to the following format: CompanyName:saif:BO.
The password must be the user password for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
sourcingChannel
List
Contains information about the channels (Sites) available for this user.
  id
Long
Returns channel identifier (FeatureItem id).
  name
String
Returns name of the sourcing channel (for example Pracuj).
  type
String
Returns type of the sourcing channel (for example JobBoard).
  description
String
Returns channel description.
  technicalId
String
Returns site technical ID such as QU9FK026203F3VBQB6GV4688G.
The method getAttachments is used to return details of attachments which are linked a requisition within a job posting in the TalentLink system.

This method must be called with anonymous access.
The user name must be set to the following format: TechnicalID:guest:FO.
The password must be set to "guest".

Post Parameter

 
Parameter Data Type Description
postingId
Long
ID which identifies posted advert.

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
attachments
List
Contains information about attachments available for the specified advert.
  id
Long
TLK Internal ID
  fileName
String
[mandatory] Name of the file with file extension
  description
String
Description of the file.
  docType
DocumentType
[mandatory] Business type of the current document (cover letter, resume, mail...) Click to see possible values
  docLanguage
String
Language code used whilst uploading of the document.
  binaryData
DataHandler
The binary representation of the file
  creationDate
Date
Time and date of the document was added to the post
  size
Long
Size of file
  author
String
Name of the user who uploaded the document
  docId
Long
ID for the document that needs to be used for downloading the attachements. (Use method downloadAttachedFile within the Document web service to download).
  publishable
Boolean
TRUE or FALSE
The method getPostedAdverts returns all postings for a specified channel.

This method must be called with Talentlink backoffice user credentials.
The user name must be set to the following format: CompanyName:saif:BO.
The password must be the user password for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
channelId
Long
[Mandatory] - ID of the channel from which the adverts will be displayed.

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
postingTarget
List
The response is a collection of adverts (“postingTargets”) posted to specified site (channelID)
  status
String
Status of the posting target, for example: published, new. etc
  startDate
Date
Date from which the posting is active
  endDate
Date
Date that posting stops being active.
  urlApplicationAddress
String
Application URL (Please note in some cases the URL will need to be decoded)
  emailApplicationAddress
String
Email address for email application.
  posting
PostingDto
Posting details as a Posting object.
    id
Long
Unique ID to represent the posting.
    title
String
The title of the posting
    language
String
The language of the posting. Returned as a 2 character string.
    comment
String
Advertisement comment.
    creationDate
Date
Date the position was created.
    keywords
String
A collection of key words associated with the posting.
    company
String
Recruiting company associated with this advert.
    location
LocationDto
The location of the position.
      city
String
City/location.
      region
String
Country region.
      country
String
Country name.
    position
PositionDto
Job position.
      id
Long
Unique ID to represent the position
      jobNumber
String
A string allocated to the job by the client.
      title
String
Title of position
      headCount
Long
Number of positions available.
      creationDate
Date
Date the position was created.
      lastUpdate
Date
The time the position was last updated
      dueDate
Date
Job activity/due date.
      company
String
The company associated with the position.
      location
LocationDto
Returns job location (city/region/country).
      language
String
The location of the position.
      status
String
Status of position
      customField
String
Custom field values associated with current job. There can be maximum 8 CustomField objects assigned to a job. Please note: Value of the "label" field will only be displayed if filled in the advert in Talentlink Application (BO).
      compensation
CompensationDto
Salary. Made up of currency, salary range and period.
        minAmount
BigDecimal
Minimum rate amount for this position
        maxAmount
BigDecimal
Maximum rate amount for this position
        period
String
This will be the rate set, for example: hour
        currency
String
Compensation currency for current job. Click to see possible values
      configurableFields
ConfigurableFieldsDto
Collection of configurable fields configured by the client.
        freeFormFields
FreeFormFieldDto
FreeFormField DTO object represented as a simple header/label/value.
          header
String
Header which is a translated parent LOV value
          label
String
Label which is a translated LOV value
          value
String
Value which was provided for current header and label
          unlocalizedHeader
String
Unlocalized header value.
          unlocalizedLabel
String
Returns unlocalized label value.
        lov
CustomField
LOV DTO object represented as a simple label/order/value. Contains the information about the LOV fields available and defined on the advert.
          label
String
Name of the custom field e.g.: Additional Information
          value
String
Value of the custom field e.g.: Lumesse is an ambitious, innovative and successful organisation but we are also a people-friendly business that is proud to be different - in our culture, our values and our approach to employees and customers. Our philosophy is simple: Happy employees create happy customers.
          order
Int
Returns the (optional) position order of the current CustomField, or zero if no order was set before.
          unlocalizedLabel
String
Returns unlocalized label of the current customField.
      contractType
String
String representing fixed term contract, permanent etc.
      scheduleType
String
Full Time or Part Time
      organization
OrganizationDto
A collection of organizations to which the position belongs. Each organization consists of code, id, level and name.
        unit
Unit
Returns list of organizations to which the position belongs. Each organization consists of code, id, level and name. If non default constructor is used to create Organization object, list will contain organization for which opening was created and its all higher level organizations. Example of data sent in response: <organization> <unit level="1" id="151">First level organization.</unit> <unit level="2" id="222">Parent organization for organization on level 3.</unit> <unit level="3" id="248">Organization related with opening, level 3.</unit> </organization>
          name
String
Returns name of organization as a xml tag value.
          level
Integer
Returns organization's level.
          id
Long
Returns organization's id.
          code
String
Organization code.
          nameTranslation
String
Translation of the organization name (if defined in BO).
      workTime
WorkTime
Consists of count, period and workunit. E.g. 40 hours per week.
        workPeriod
String
One of the below values must be used: Day, Week, Month, Quarter, Year
        workUnit
String
One of the below values must be used: Hours, Day, Week, Month, Quarter
        timeCount
Float
For example : 40
      recruiter1Id
Long
Internal TLK Recruiter id
      operationalUser1Id
Long
Internal TLK Operational User ID
    customField
CustomField
A collection of custom fields on the posting. Each custom field is made up of a label, a value and an order. They are typically used for holding sections of the posting description with the label being the section header and the value being the description. There can be maximum 8 CustomField objects assigned to a Posting.
Please note: Value of the "label" field will only be displayed if filled in the advert in Talentlink Application (BO).
    lastUpdateDate
Date
Advertisement last update date.
    plainText
Boolean
Is the content of posting plain text
    team
List
Represents recruitment team assigned to posting
      recruiter
RecruiterDto
        order
Int
Order of recruiters in team
        lastname
String
Recruiter last name
        firstname
String
Recruiter first name
        email
String
Recruiter email
  sourcingChannel
SourcingChannelDto
Contains FeatureItem Id, channel name, type and description.
    id
Long
Returns channel identifier (FeatureItem id).
    name
String
Returns name of the sourcing channel (for example Pracuj).
    type
String
Returns type of the sourcing channel (for example JobBoard).
    description
String
Returns channel description.
    technicalId
String
Returns site technical ID such as QU9FK026203F3VBQB6GV4688G.
  categoryList
CategoryListDto
Posting categories list
    name
String
Category list name.
    values
String
Values within this category.
  urlJobDescription
String
Application URL (Please note in some cases the URL will need to be decoded)
  id
Long
Returns id for the PostingTarget.
  updateDate
Date
Returns posting update date.
The method getPostedAdvertsByIds returns selected “postingTargets” for a given list of IDs. This method accepts parameters of a channelId and a list of posting target ids.

This method must be called with Talentlink backoffice user credentials.
The user name must be set to the following format: CompanyName:saif:BO.
The password must be the user password for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
channelId
Long
[Mandatory] - ID of the channel from which the adverts will be displayed.
postingTargetIds
String
[Mandatory] A comma separated list of posting target IDs. There must be no spaces between the commas. Valid values would be 1,2,3 whereas 1, 2, 3 would be invalid.

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
postingTarget
List
The response is a collection of adverts (“postingTargets”) posted to specified site (channelID) and specified by IDs.
  status
String
Status of the posting target, for example: published, new. etc
  startDate
Date
Date from which the posting is active
  endDate
Date
Date that posting stops being active.
  urlApplicationAddress
String
Application URL (Please note in some cases the URL will need to be decoded)
  emailApplicationAddress
String
Email address for email application.
  posting
PostingDto
Posting details as a Posting object.
    id
Long
Unique ID to represent the posting.
    title
String
The title of the posting
    language
String
The language of the posting. Returned as a 2 character string.
    comment
String
Advertisement comment.
    creationDate
Date
Date the position was created.
    keywords
String
A collection of key words associated with the posting.
    company
String
Recruiting company associated with this advert.
    location
LocationDto
The location of the position.
      city
String
City/location.
      region
String
Country region.
      country
String
Country name.
    position
PositionDto
Job position.
      id
Long
Unique ID to represent the position
      jobNumber
String
A string allocated to the job by the client.
      title
String
Title of position
      headCount
Long
Number of positions available.
      creationDate
Date
Date the position was created.
      lastUpdate
Date
The time the position was last updated
      dueDate
Date
Job activity/due date.
      company
String
The company associated with the position.
      location
LocationDto
Returns job location (city/region/country).
      language
String
The location of the position.
      status
String
Status of position
      customField
String
Custom field values associated with current job. There can be maximum 8 CustomField objects assigned to a job. Please note: Value of the "label" field will only be displayed if filled in the advert in Talentlink Application (BO).
      compensation
CompensationDto
Salary. Made up of currency, salary range and period.
        minAmount
BigDecimal
Minimum rate amount for this position
        maxAmount
BigDecimal
Maximum rate amount for this position
        period
String
This will be the rate set, for example: hour
        currency
String
Compensation currency for current job. Click to see possible values
      configurableFields
ConfigurableFieldsDto
Collection of configurable fields configured by the client.
        freeFormFields
FreeFormFieldDto
FreeFormField DTO object represented as a simple header/label/value.
          header
String
Header which is a translated parent LOV value
          label
String
Label which is a translated LOV value
          value
String
Value which was provided for current header and label
          unlocalizedHeader
String
Unlocalized header value.
          unlocalizedLabel
String
Returns unlocalized label value.
        lov
Field
LOV DTO object represented as a simple label/order/value. Contains the information about the LOV fields available and defined on the advert.
          label
String
Name of the custom field e.g.: Additional Information
          value
String
Value of the custom field e.g.: Lumesse is an ambitious, innovative and successful organisation but we are also a people-friendly business that is proud to be different - in our culture, our values and our approach to employees and customers. Our philosophy is simple: Happy employees create happy customers.
          order
Int
Returns the (optional) position order of the current CustomField, or zero if no order was set before.
          unlocalizedLabel
String
Returns unlocalized label of the current customField.
      contractType
String
String representing fixed term contract, permanent etc.
      scheduleType
String
Full Time or Part Time
      organization
OrganizationDto
A collection of organizations to which the position belongs. Each organization consists of code, id, level and name.
        unit
Unit
Returns list of organizations to which the position belongs. Each organization consists of code, id, level and name. If non default constructor is used to create Organization object, list will contain organization for which opening was created and its all higher level organizations. Example of data sent in response: <organization> <unit level="1" id="151">First level organization.</unit> <unit level="2" id="222">Parent organization for organization on level 3.</unit> <unit level="3" id="248">Organization related with opening, level 3.</unit> </organization>
          name
String
Returns name of organization as a xml tag value.
          level
Integer
Returns organization's level.
          id
Long
Returns organization's id.
          code
String
Organization code.
          nameTranslation
String
Translation of the organization name (if defined in BO).
      workTime
WorkTime
Consists of count, period and workunit. E.g. 40 hours per week.
        workPeriod
String
One of the below values must be used: Day, Week, Month, Quarter, Year
        workUnit
String
One of the below values must be used: Hours, Day, Week, Month, Quarter
        timeCount
Float
For example : 40
      recruiter1Id
Long
Internal TLK Recruiter id
      operationalUser1Id
Long
Internal TLK Operational User ID
    customField
CustomField
A collection of custom fields on the posting. Each custom field is made up of a label, a value and an order. They are typically used for holding sections of the posting description with the label being the section header and the value being the description. There can be maximum 8 CustomField objects assigned to a Posting. Please note: Value of the "label" field will only be displayed if filled in the advert in Talentlink Application (BO).
    lastUpdateDate
Date
Advertisement last update date.
    plainText
Boolean
Is the content of posting plain text
    team
List
Represents recruitment team assigned to posting
      recruiter
RecruiterDto
        order
Int
Order of recruiters in team
        lastname
String
Recruiter last name
        firstname
String
Recruiter first name
        email
String
Recruiter email
  sourcingChannel
SourcingChannelDto
Contains FeatureItem Id, channel name, type and description.
    id
Long
Returns channel identifier (FeatureItem id).
    name
String
Returns name of the sourcing channel (for example Pracuj).
    type
String
Returns type of the sourcing channel (for example JobBoard).
    description
String
Returns channel description.
    technicalId
String
Returns site technical ID such as QU9FK026203F3VBQB6GV4688G.
  categoryList
CategoryListDto
Posting categories list
    name
String
Category list name.
    values
String
Values within this category.
  urlJobDescription
String
Application URL (Please note in some cases the URL will need to be decoded)
  id
Long
Returns id for the PostingTarget.
  updateDate
Date
Returns posting update date.
A comma separated list of posting target IDs. There must be no spaces between the commas. Valid values would be 1,2,3 whereas 1, 2, 3 would be invalid.

This method must be called with Talentlink backoffice user credentials.
The user name must be set to the following format: CompanyName:saif:BO.
The password must be the user password for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
channelId
Long
The ID of the channel
startDate
String
Date should be inputed in the following format: 23/10/2010 (DD/MM/YYYY)
endDate
String
Date should be inputed in the following format: 23/10/2012 (DD/MM/YYYY)

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
postingTarget
List
The response is a collection of adverts (“postingTargets”) posted to specified site (channelID) and specified by IDs.
  status
String
Status of the posting target, for example: published, new. etc
  startDate
Date
Date from which the posting is active
  endDate
Date
Date that posting stops being active.
  urlApplicationAddress
String
Application URL (Please note in some cases the URL will need to be decoded)
  emailApplicationAddress
String
Email address for email application.
  posting
PostingDto
Posting details as a Posting object.
    id
Long
Unique ID to represent the posting.
    title
String
The title of the posting
    language
String
The language of the posting. Returned as a 2 character string.
    comment
String
Advertisement comment.
    creationDate
Date
Date the position was created.
    keywords
String
A collection of key words associated with the posting.
    company
String
Recruiting company associated with this advert.
    location
LocationDto
The location of the position.
      city
String
City/location.
      region
String
Country region.
      country
String
Country name.
    position
PositionDto
Job position.
      id
Long
Unique ID to represent the position
      jobNumber
String
A string allocated to the job by the client.
      title
String
Title of position
      headCount
Long
Number of positions available.
      creationDate
Date
Date the position was created.
      lastUpdate
Date
The time the position was last updated
      dueDate
Date
Job activity/due date.
      company
String
The company associated with the position.
      location
LocationDto
Returns job location (city/region/country).
      language
String
The location of the position.
      status
String
Status of position
      customField
String
Custom field values associated with current job. There can be maximum 8 CustomField objects assigned to a job. Please note: Value of the "label" field will only be displayed if filled in the advert in Talentlink Application (BO).
      compensation
CompensationDto
Salary. Made up of currency, salary range and period.
        minAmount
BigDecimal
Minimum rate amount for this position
        maxAmount
BigDecimal
Maximum rate amount for this position
        period
String
This will be the rate set, for example: hour
        currency
String
Compensation currency for current job. Click to see possible values
      configurableFields
ConfigurableFieldsDto
Collection of configurable fields configured by the client.
        freeFormFields
FreeFormFieldDto
FreeFormField DTO object represented as a simple header/label/value.
          header
String
Header which is a translated parent LOV value
          label
String
Label which is a translated LOV value
          value
String
Value which was provided for current header and label
          unlocalizedHeader
String
Unlocalized header value.
          unlocalizedLabel
String
Returns unlocalized label value.
        lov
CustomField
LOV DTO object represented as a simple label/order/value. Contains the information about the LOV fields available and defined on the advert.
          label
String
Name of the custom field e.g.: Additional Information
          value
String
Value of the custom field e.g.: Lumesse is an ambitious, innovative and successful organisation but we are also a people-friendly business that is proud to be different - in our culture, our values and our approach to employees and customers. Our philosophy is simple: Happy employees create happy customers.
          order
Int
Returns the (optional) position order of the current CustomField, or zero if no order was set before.
          unlocalizedLabel
String
Returns unlocalized label of the current customField.
      contractType
String
String representing fixed term contract, permanent etc.
      scheduleType
String
Full Time or Part Time
      organization
OrganizationDto
A collection of organizations to which the position belongs. Each organization consists of code, id, level and name.
        unit
Unit
Returns list of organizations to which the position belongs. Each organization consists of code, id, level and name. If non default constructor is used to create Organization object, list will contain organization for which opening was created and its all higher level organizations. Example of data sent in response: <organization> <unit level="1" id="151">First level organization.</unit> <unit level="2" id="222">Parent organization for organization on level 3.</unit> <unit level="3" id="248">Organization related with opening, level 3.</unit> </organization>
          name
String
Returns name of organization as a xml tag value.
          level
Integer
Returns organization's level.
          id
Long
Returns organization's id.
          code
String
Organization code.
          nameTranslation
String
Translation of the organization name (if defined in BO).
      workTime
WorkTime
Consists of count, period and workunit. E.g. 40 hours per week.
        workPeriod
String
One of the below values must be used: Day, Week, Month, Quarter, Year
        workUnit
String
One of the below values must be used: Hours, Day, Week, Month, Quarter
        timeCount
Float
For example : 40
      recruiter1Id
Long
Internal TLK Recruiter id
      operationalUser1Id
Long
Internal TLK Operational User ID
    customField
CustomField
A collection of custom fields on the posting. Each custom field is made up of a label, a value and an order. They are typically used for holding sections of the posting description with the label being the section header and the value being the description. There can be maximum 8 CustomField objects assigned to a Posting. Please note: Value of the "label" field will only be displayed if filled in the advert in Talentlink Application (BO).
    lastUpdateDate
Date
Advertisement last update date.
    plainText
Boolean
Is the content of posting plain text
    team
List
Represents recruitment team assigned to posting
      recruiter
RecruiterDto
        order
Int
Order of recruiters in team
        lastname
String
Recruiter last name
        firstname
String
Recruiter first name
        email
String
Recruiter email
  sourcingChannel
SourcingChannelDto
Contains FeatureItem Id, channel name, type and description.
    id
Long
Returns channel identifier (FeatureItem id).
    name
String
Returns name of the sourcing channel (for example Pracuj).
    type
String
Returns type of the sourcing channel (for example JobBoard).
    description
String
Returns channel description.
    technicalId
String
Returns site technical ID such as QU9FK026203F3VBQB6GV4688G.
  categoryList
CategoryListDto
Posting categories list
    name
String
Category list name.
    values
String
Values within this category.
  urlJobDescription
String
Application URL (Please note in some cases the URL will need to be decoded)
  id
Long
Returns id for the PostingTarget.
  updateDate
Date
Returns posting update date.
The method getPostedAdvertsIdsFromRange returns a collection of all active posting Id's for a given date range.

This method must be called with Talentlink backoffice user credentials.
The user name must be set to the following format: CompanyName:saif:BO.
The password must be the user password for example: "Saif123!"

Post Parameter

 
Parameter Data Type Description
channelId
Long
The ID of the channel
startDate
String
Date should be inputed in the following format: 23/10/2010 (DD/MM/YYYY)
endDate
String
Date should be inputed in the following format: 23/10/2012 (DD/MM/YYYY)

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
postingTargetBase
List
The response is a collection of adverts (“postingTargets”) posted to specified site (channelID) within the date range specified.
  id
Long
Returns id for the PostingTarget.
  updateDate
Date
Returns posting update date.
The method getPostingImages is used to get images linked to the advertisement so it can be properly rendered including branding, maps and other graphical content.

This method must be called with anonymous access.
The user name must be set to the following format: TechnicalID:guest:FO.
The password must be set to "guest".

Post Parameter

 
Parameter Data Type Description
postingId
Long
Advertisement id

Request Parameter

 
Parameter Data Type Description
APi Key Alphanumeric Will be provided by Lumesse

Response Parameter

 
Parameter Data Type Description
postingImage
List
  id
String
Internal TalentLink id of the Image.
  url
String
URL of the image
  position
Values
This is the defined position of where the image appears. Possible values are listed below. - Header1 - Header2 - TopOfJobDescription - Bottom