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
- START: The career site calls the TalentLink Exchange posting web service regularly to get an up-to-date list of active postings.
- TalentLink generates a file using the predefined file definition schema to exchange data with career websites.
- TalentLink Exchange maps the retrieved job posting(s) to the career website job advertisements definition and returns a success or failure message as appropriate.
- 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.
- 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
getActiveChannels
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!"
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
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. |
getAttachments
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".
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
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 |
getPostedAdverts
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!"
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
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 |
|
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. |
getPostedAdvertsByIds
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!"
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
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 |
|
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. |
getPostedAdvertsFromRange
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!"
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
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 |
|
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. |
getPostedAdvertsIdsFromRange
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!"
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
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. |
getPostingImages
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".
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
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 |