The different parts of the Web Integration
An important part of the recruitment process is the website. Here candidates can search for and apply to open vacancies. The web integration is made up of the following parts:
Vacancy list
Vacancy search
Vacancy details
Application form
Vacancy list
The vacancy list is often the first point of contact for candidates visiting a client’s vacancy page. This list is customizable, allowing each client to determine which fields should be visible in the final listing. A common configuration includes displaying the vacancy title, location, and application deadline for each job posted through Talent Hire. This page is created and maintained by the client.
Visma provides a client-specific XML URL for job postings, containing active vacancies in XML format. Clients have considerable flexibility in determining what they display in the vacancy list, provided the data is available in the XML feed.
Configuration and management: Managed by the client
(Note: Configuration is limited if the client uses the standard career page templates. See the section below.)
Vacancy search function
This functionality allows candidates to search for jobs. It is an optional feature, with its usefulness depending on the number of vacancies. For smaller numbers of jobs, a search function might be unnecessary.
The following criteria can be transmitted from Talent Hire for search purposes:
Fixed default search values
Department
Employment type
Occupation
Custom classifications
Clients may also add up to two additional custom classifications if the existing ones are insufficient or if extra granularity is required for their vacancies.
Fixed default search values are consistent across all clients and cannot be customized. However, configurable search values can be created per client with an unlimited number of options.
For each vacancy, only the populated fields are included in the XML feed. The list of the field values for currently published vacancies can be found at the end of the feed. This enables clients to utilize the relevant values and create their own filtering—such as dropdown menus or other filtering tools.
Configuration and management: Managed by the client
(Note: Configuration is limited if the client uses the standard career page templates. See the section below.)
Vacancy details
The vacancy details page displays the individual vacancies. This often includes a description of the organization, job responsibilities, required qualifications, and related details such as contact persons, closing date, and location. This page is built and managed by the client. Data for this page is entered into Talent Hire and can be fetched from the XML feed.
Configuration and management: Managed by the client
(Note: Configuration is limited if the client uses the standard career page templates. See the section below.)
Application form
The application form allows candidates to apply for a job by providing personal details, uploading a CV, or submitting a cover letter. The application form in Talent Hire is highly versatile—it can range from a simple form to a more detailed format that includes multiple candidate questions.
While the application form follows a standard layout for all clients, certain elements such as the logo and banner can be customized by the client.
Configuration and management: Managed by the client
Talent Hire's XML-feed
The XML feed enables integration with Talent Hire by providing access to vacancies in a standardized XML format. This is the most commonly used integration method, as it is quick and easy to implement.
XML feed features
Talent Hire offers a near real-time XML feed, with up to 15 minutes of caching. The XML feed will show the currently published vacancies from Talent Hire. If a vacancy is un-published from Hire, the vacancy will be removed from the XML feed.
Links to the XML-feed
The XML feed is composed of the following components:
Job list: A list of vacancies used to build the vacancy list.
Classification list: A list of search values used to construct the search functionality in the job list.
Vacancy: Vacancy-specific XML-feed containing all detailed information about a vacancy.
Please find your client specific XML links below:
Page | Link |
Job list and Classification list | |
Vacancy |
The "Guid" from the job list XML is used to generate the job-specific XML link.
Take note of the distinction in the URLs between "AssignmentList" (job list) and "AssignmentItem" (job-specific details).
Example:
If the Guid for a job in the job list is ”BCD2EBFE-9BB6-456C-AB39-7056D9B0C0E1”:
Then, the corresponding job-specific XML link will be: https://hire.vismatalent.com/External/Feeds/AssignmentItem.ashx?guidGroup=24f98176-ade9-46d1-ab89-3df5e09405bd&guidAssignment=BCD2EBFE-9BB6-456C-AB39-7056D9B0C0E1
Fields in the XML-feed
The XML feed contains the following types of information.
Job list XML
Within the <Assignments> element, you can find all the published vacancies. Each vacancy includes key data to build the vacancy list on the client’s site.
Example
<Assignment AssignmentId="87">
<Guid>00000000-0000-0000-0000-000000000000</Guid>
<AccountId>4</AccountId>
<AccountName>Test Customer</AccountName>
<PublishStartDate>CCYY-MM-DDThh:mm:ss</PublishStartDate>
<PublishEndDate>CCYY-MM-DDThh:mm:ss</PublishEndDate>
<ApplicationEndDate>CCYY-MM-DDThh:mm:ss</ApplicationEndDate>
<EmploymentStartDate>CCYY-MM-DDThh:mm:ss</EmploymentStartDate>
<EmploymentEndDate>CCYY-MM-DDThh:mm:ss</EmploymentEndDate>
<Created>CCYY-MM-DDThh:mm:ss</Created>
<Modified>CCYY-MM-DDThh:mm:ss</Modified>
<RefNo>C93</RefNo>
<NumberOfJobs>1</NumberOfJobs>
<ReadMoreUrl/>
<IsInternal>0</IsInternal>
<UseSimplifiedAd>0</UseSimplifiedAd>
<Localization>
<AssignmentLoc LocId="1" AssignmentLocId="86">
<! -- Can appear multiple times if the vacancy exists in multiple languages -->
<LocalizationCode>sv-SE</LocalizationCode>
<Municipality MunicipalityId="16">
<Name>Stockholm</Name>
</Municipality>
<County CountyId="21">
<Name>Stockholms län</Name>
</County>
<Country CountryId="203">
<Name>Sverige</Name>
</Country>
<EmploymentType EmploymentTypeId="1">
<Name>Tillsvidareanställning</Name>
</EmploymentType>
<EmploymentGrade EmploymentGradeId="1">
<Name>Heltid</Name>
</EmploymentGrade>
<SalaryType SalaryTypeId="1">
<Name>Månadslön</Name>
</SalaryType>
<EmploymentDuration EmploymentDurationId="1">
<Name>Tillsvidare</Name>
</EmploymentDuration>
<WorkShift WorkShiftId="3">
<Name>Schema</Name>
</WorkShift>
<LocationPlaceOfWork>Location/Place of work</LocationPlaceOfWork>
<EmploymentStartDateDescr>Admission description</EmploymentStartDateDescr>
<EmploymentEndDateDescr>Description of time limitation</EmploymentEndDateDescr>
<AssignmentTitle>Ad title</AssignmentTitle>
<WorkDescr>Ad description</WorkDescr>
<Departments>
<Department DepartmentId="6">
<Name>Test Customer</Name>
<Level>1</Level>
<Type>Owner</Type>
<Filtering>OJ</Filtering>
</Department>
</Departments>
<OccupationClassifications>
<OccupationClassification OccupationClassificationId="4954" LevelId="2" TypeId="1">
<KeyValue>16</KeyValue>
<Name>Socialt arbete</Name>
<TypeName>Platsbanken</TypeName>
<Level>1</Level>
<RecurseDepth>2</RecurseDepth>
</OccupationClassification>
<OccupationClassification OccupationClassificationId="13773" ParentOccupationClassificationId="4954" LevelId="3" TypeId="1">
<KeyValue>5343</KeyValue>
<Name>Personliga assistenter</Name>
<TypeName>Platsbanken</TypeName>
<Level>2</Level>
<RecurseDepth>1</RecurseDepth>
</OccupationClassification>
<OccupationClassification OccupationClassificationId="8632" ParentOccupationClassificationId="13773" LevelId="4" TypeId="1">
<KeyValue>2001</KeyValue>
<Name>Ledsagare</Name>
<TypeName>Platsbanken</TypeName>
<Level>3</Level>
<RecurseDepth>0</RecurseDepth>
</OccupationClassification>
</OccupationClassifications>
<CustomClassifications>
<CustomClassification CustomClassificationId="64">
<KeyValue>TEST1</KeyValue>
<Name>Test Value</Name>
</CustomClassification>
</CustomClassifications>
<CustomClassifications2>
<CustomClassification2 CustomClassificationId="65">
<KeyValue>TEST2</KeyValue>
<Name>Test Value</Name>
</CustomClassification2>
</CustomClassifications2>
</AssignmentLoc>
</Localization>
</Assignment>
Classification list
The classification list is included within the same XML feed as the vacancy list. In addition to the <Assignments> section, you will find sections that list the different classifications used across your vacancies. These classifications are helpful for retrieving the necessary values to build filtering functionality on your webpage.
The available classifications in the feed include:
EmploymentTypes
WorkShifts
Departments
OccupationClassifications
CustomClassifications
CustomClassifications2
Important Note:
The XML feed will only include values that have been selected for at least one published advertisement. It will not contain a comprehensive list of all possible values. This ensures the feed only reflects relevant and actively used classifications.
Example values
<EmploymentTypes>
<EmploymentType EmploymentTypeId="1" LocId="1" LocalizationCode="sv-SE">
<Name>Tillsvidareanställning</Name>
</EmploymentType>
</EmploymentTypes>
<WorkShifts>
<WorkShift WorkShiftId="3" LocId="1" LocalizationCode="sv-SE">
<Name>Schema</Name>
</WorkShift>
</WorkShifts>
<Departments>
<Department DepartmentId="6" LocId="1" LocalizationCode="sv-SE">
<Name>Test Customer</Name>
<Level>1</Level>
<Filtering>OJ</Filtering>
</Department>
</Departments>
<OccupationClassifications>
<OccupationClassification OccupationClassificationId="13714" LevelId="3" TypeId="1" LocId="1" LocalizationCode="sv-SE">
<KeyValue>3514</KeyValue>
<Name>Nätverks- och systemtekniker m.fl.</Name>
<TypeName>Platsbanken</TypeName>
<Level>2</Level>
</OccupationClassification>
<OccupationClassification OccupationClassificationId="13773" LevelId="3" TypeId="1" LocId="1" LocalizationCode="sv-SE">
<KeyValue>5343</KeyValue>
<Name>Personliga assistenter</Name>
<TypeName>Platsbanken</TypeName>
<Level>2</Level>
</OccupationClassification>
</OccupationClassifications>
<CustomClassifications>
<CustomClassification CustomClassificationId="64" LocId="1" LocalizationCode="sv-SE">
<KeyValue>TEST1</KeyValue>
<Name>Test Value</Name>
</CustomClassification>
</CustomClassifications>
<CustomClassifications2>
<CustomClassification2 CustomClassification2Id="65" LocId="1" LocalizationCode="sv-SE">
<KeyValue>TEST2</KeyValue>
<Name>Test Value</Name>
</CustomClassification2>
</CustomClassifications2>
Language support
As mentioned, there may be multiple instances of <Localization> within the XML feed, depending on the languages selected for a specific vacancy. These instances allow for multilingual job advertisements, enabling you to tailor the content to the language preferences of users visiting your career page.
For example, you can display different versions of the same job advertisement based on whether the user views the page in a different language. This feature helps ensure your vacancies are accessible and relevant to a diverse audience.
Cache
The caching time for XML feeds in Talent Hire is a maximum of 15 minutes. This means any updates or changes made to an existing job in Talent Hire will be reflected in the XML feed within 15 minutes. However, if the user republishes the job manually, the changes will appear immediately.
This caching mechanism ensures near real-time accuracy of the XML feed while maintaining system efficiency.
Configuration of the application form
The application form can be configured on a department level. To do so, navigate to "Admin -> "Organisation" and the department.
Open the "Application form" tab:
On the bottom of the page, you will find the application form settings.
You can make the following changes to the application form to better align with your branding:
Header background color: Customize the header's background color using either a color picker or by entering a specific hex code.
Header text color: Choose whether the header text should appear in black or white for optimal contrast and readability.
Header background picture: Add or select an image to appear as part of the header background.
Standard Career page template
Job list and individual vacancies
The standard Career Page templates can be configured by navigating to "Admin" and then selecting "Job lists".
Click edit on the job list you wish to modify.
Here, you have the ability to adjust various aspects of the page:
General
Primary Language: Choose from Swedish, English, Finnish, Norwegian, or Dutch as your default language for the Career Page.
Favicon: Upload an icon to represent your brand, which will appear on the browser tab for the Career Page.
Appearance
Logo
Header Image
Primary color (HEX code): Determines the color of the "Apply" button. A 25% opacity of this color will be applied to the background of the vacancy's information section for a subtle effect.
Secondary color (HEX code): Affects the background color of the total number of published vacancies in the job list. Also affects the highlight color within the search field.
Header color (HEX code): Sets the color of the header
Ad List
Specify filters and search options to display in the job list by selecting from the following checkboxes:
Show search field
Show municipality filter
Show organization filter
Show employment scope filter
Ad
You can override default ad headings with your own phrasing by entering optional custom text (maximum 50 characters per heading).
Note: This only applies if the setting “Format ad text content” is disabled.
"About the Workplace" Heading
"Work Tasks" Heading
"Qualifications" Heading
"Other" Heading
Hosting environment & mail server IP’s
For information about the hosting environment and processing information, please visit Visma Trust Centre https://www.visma.com/trust-centre/. Make sure you share this information with relevant users within your IT department.
If there are any questions, please contact your Customer Success Manager, Account Manager or Support Team.