21. Manage Page Labels
Manage Page Labels
You are able to tailor (Edit) the Users Planner 1-2-3 Guidance Steps for both the Skills Profile and Action Plan pages from the default label descriptions and hover over text, including the language translations, to suit your organizational requirements using Manage Page Labels. These are provided in the table on the page for in-situ changes.
You are also able to:
Export All translations for all Planner page Items, buttons etc, including the 1-2-3 Guidance Steps mentioned above, to an Excel Workbook, use the workbook to make changes to the translations, and Import All Translations with an updated set of translations to suit your organization.
Export All Value Translations, which are the translations associated with an individuals personal details drop-down values lists in their Planner, usually initially captured via the self-assessment surveys.
Language Selection: You can select any of the standard SFIA languages (Default English)
Changing the 2 Planner 1-2-3 Guidance steps in-situ:
Skills Profile:
Action Plan:
Changing (editing) the text
Select the language for the text you wish to change from the language selection at the top (default is English) . e.g.
Note: If English is selected the Translation column will (usually) be empty
Select the edit icon in the Action column of the Name of the component you wish to change. (Refer to the Component Reference table for a description of how the Components are named)
Edit the Content as required. Note that the text is HTML format, and you are able to include links as per the example above for the Action Plan Step1 Hover-over text
Both the English Content and the selected language Translation text are able to be changed as required
Save your changes or Cancel if you wish to abandon the changes
Use the Refresh Button to display the changes in the table and make the changes active
If English is selected, usually the Translation panel will only contain the word “Translation”. If you wish to retain the original English Content as a reference, you can Copy/Paste the Content into the Translation panel, then make whatever text changes you require in the Translation panel, and Save & Refresh. When English is selected (In the Planner), it will use the Translation text.
To revert back to the Original Content just edit again and delete what is in the Translation panel, Save & Refresh etc
Changing the Colour of Steps panels
This is managed using the 18. Manage Features/Settings | Step Panel Colour settings function.
On this page:
Table Reference
Column Name | Description |
---|---|
Action | Edit Icon available only |
Name | Component Reference to the 1-2-3 Guidance steps in the following format: PageNameStepNumberType (refer Component Reference below) |
Content | The current text (HTML format) of the Component Reference |
Translation | The current text (HTML format) of the Component Reference in the language selected from the Language Selection Note: will be blank if the Language Selection = English |
Component Reference
Reference | Options | Description |
---|---|---|
PageName |
|
|
StepNumber |
| The steps |
Type |
|
|
Export/Import
This feature can be used to manage all translations available over and above the Guidance steps (All Translations), as well as translations of the Personal Details drop-down lists (Value Translations).
Export All Translations and Export All Value Translations
To Export the translations to an Excel Workbook:
Select the Language (e.g. German):
Select the Export All Translations or Export All Value Translations button
Examples:
Making changes to the Translations in the Workbooks
To make changes to the translations:
Open the Workbook in edit mode and set it up to your requirements
There are 4 columns for each Translation workbook:
Page - For the All Translations This indicates which Planner pages the Item is situated on (Planner Tabs)
SfiaAll - All Planner Pages
SfiaProfile and SfiaProfileTooltip - Skills Profile
SfiaPlan and SfiaPlanTootip - Action Plan
SfiaEvidence - Evidence
SfiaManage - My People
RptJobProfile - Requirements Reports
Page - For the All Values Translations this indicates the specific Drop-Down list
SFIA_Status - The persons status in the organization
SFIA_YearRangeJob - How long the person has been in their current role/job
SFIA_YearRangeOrg - How long the person has been with the organization
Contract_Type - Their Employment contract type
Name - This is the name of the Item and the key that will be recognized by the Import function
These should never be changed!
ContentText - This the the default English (UK) Text version for the Item as a reference.
ContentTextTranslation - This is the selected language translation of the English Text in the language you have downloaded. This is is able to be changed to suit your environment and organization.
For All Translations, Generally the Named Item will be a Button or Text reference on the page.
Except if it is referenced as a Tooltip. These will be associated with an Item, and have the same Name as the Item but Suffixed with Tooltip. These are Hover-Overs. i.e. When the User hovers over the Item (e.g. Button), the Tooltip contents will be displayed.
Example:
The Tooltip content in the 2nd row will be displayed when the User hovers-over the Request Approval (English) and Genehmigung anfordern (German) button.
For All Value Translations, the Named Item is an item in a list.
Note1: Descriptions and Hover-Overs for the 1-2-3 Guidance Steps, which can be changed in-situ, are included in the Workbook, but have a slightly different format. i.e. The Hover-Overs are not listed as Tooltips, but clearly masked as a Hover. e.g. SfiaProfileStep1Hover
Note2: In cases where there is no ContentTextTranslation present, i.e. a Blank cell, the system will default to the English version.
However you cannot Import a file with blank translations, the Import will fail indicating a blank cell.
Make your changes as required
This usually includes text, but in some instances such as for hover-overs, basic HTML coding.
We recommend that you remove any rows from the Workbook that you have not changed in readiness for Importing.
Note3: Updates are made using the Name as the key, and removing the row will NOT remove the original translation etc.
Save you your changed Workbook to a new alternative file name.
Due to the unpredictability of what maybe be added by clients, in terms of HMTL and text , there is very limited checking able to be carried out of the file when importing. Therefore the following are our recommendations when making changes to translations:
Retain the original Exported file as a back-up, to allow you to restore the translations back to a known state
Do not introduce any special (often hidden) characters that will not be translatable during the import, and which can result in a corrupted file. Such as:
If copying/pasting from another source, ensure you paste text only, and remove any special characters such as line or page throws.
Blank translations may be rejected. We suggest you should remove those rows from the Import file to circumvent the error.
If including HTML code to help readability, ensure it is valid and correct, including paired quotes, ampersands etc.
After you have Imported the changes, Export a new translation Excel Workbook, and ensure it can be opened in Excel. If you find that the file cannot be opened, and indicates it is corrupted, then there is a good chance it is a result of issues described in (2. & 3.) above.
If it results in a corrupt file, Import the original from (1.), and investigate/fix your changes, before trying again.
Importing Translation
To Import your changes select the appropriate Import button and be sure to select the language required.
Use the standard Select Files dialogue to select the file you saved with your changes e.g.
Use the Process Upload button to Import your changes once the file is selected.
You will get a brief Green prompt in the top RHS to indicate success
Or if there have been any issues with the Import you will instead get an Red/Pink prompt indicating what the problem is.
Blank translations will be rejected. We suggest you should remove those rows from the Import file to circumvent the error.
As per our Warning Recommendations above Export your new version of translations and Open the Excel file to ensure it is a valid file and not corrupted.
Related Help pages