Before you get started
There are two options for retrieving these requests: export a file with review responses directly from the administrator interface, or retrieve the export file via the API.
Manual export
To manually export the responses of a campaign, click on the "Campaigns" tab, then select the campaign concerned. On the "Answers analysis" tab, the "Export all responses" button generates an Excel file that contains all the responses sorted in the columns, and employees sorted in the rows.
Export via API
For now, we do not yet have an API to directly retrieve review responses. But there are already several possible options for selecting the campaign(s) you want to analyze and retrieving the export:
|
Required action |
URL |
Method |
|
Exporting a specific campaign |
https://[%1$s:tenant]/popleetalent/api/reviews/export?reviewsCampaignId=[%1$s:idDeLaCampagne] |
GET |
|
Exporting several campaigns |
https://[%1$s:tenant]/popleetalent/api/reviews/export?reviewsCampaignId={idD'uneCampagne},{idD'uneAutreCampagne},{idD'uneAutreCampagne} |
GET |
|
To get the list of all the campaigns |
https://[%1$s:tenant]/popleetalent/api/reviewsCampaigns |
GET |
In practice, you may want to retrieve only the most recent professional review campaigns. To filter by date and category, you can complete your request:
To use other categories than the professional review category, you can retrieve the identifier of the required category using the table below:
|
Annual reviews |
[Description("REVIEWS_CAMPAIGN_CATEGORY_ANNUAL_REVIEW_BACK")] AnnualReview = 1 |
|
Professional reviews |
[Description("REVIEWS_CAMPAIGN_CATEGORY_PROFESSIONAL_REVIEW_BACK")] ProfessionalReview = 2 |
|
Career reviews |
[Description("REVIEWS_CAMPAIGN_CATEGORY_CAREER_REVIEW_BACK")] CareerReview = 3 |
|
Package-per-day reviews |
[Description("REVIEWS_CAMPAIGN_CATEGORY_FIXED_WORKING_DAYS_REVIEW_BACK")] FixedWorkingDaysReview = 4 |
|
Reviews after long-term leave |
[Description("REVIEWS_CAMPAIGN_CATEGORY_LONG_TERM_LEAVE_RETURN_REVIEW_BACK")] LongTermLeaveReturnReview = 5 |
|
End-of-mission review |
[Description("REVIEWS_CAMPAIGN_CATEGORY_END_OF_MISSION_REVIEW_BACK")] EndOfMissionReview = 6 |
|
Discovery report |
[Description("REVIEWS_CAMPAIGN_CATEGORY_AMAZEMENT_REPORT_BACK")] AmazementReport = 7 |
|
End of trial period review |
[Description("REVIEWS_CAMPAIGN_CATEGORY_END_OF_TRIAL_PERIOD_REVIEW_BACK")] EndOfTrialPeriodReview = 8 |
|
Survey |
[Description("REVIEWS_CAMPAIGN_CATEGORY_SURVEY_BACK")] Survey = 10 |
|
Quarterly review |
[Description("REVIEWS_CAMPAIGN_CATEGORY_QUATERLY_BACK")] Quarterly = 13 |
|
Mid-year review (biannual) |
[Description("REVIEWS_CAMPAIGN_CATEGORY_BIANNUAL_BACK")] Biannually = 14 |
You will need to decide with your point of contact on the third-party tool side what nomenclature you will insert in the question titles, e.g. to help them more easily identify the answers that interest you.