For additional support,
create a ticket
This add-in creates machine translations of any compatible document, page, or item in your libraries and lists, into all of the languages of
your site.
It will work either alone, in which case it will use the Azure Translations
Text service, or use PointFire Translator Server if it is installed and configured.
For better quality translations of a wider range of document and page types, see PointFire Translator Server
PointFire Translator will not only translate the document, it will
also translate the document title, and all text metadata columns.
For list items, it will translate all the text columns.
PointFire Translator is compatible with PointFire 365 and with the SharePoint
Multilingual Page Publishing feature. If you
are using PointFire 365, the lists and libraries that have been made
multilingual will also be multilingual for the purpose of PointFire
365. In that case, when you go back to the site you will only see
documents or items in your own language, you will not see the
translated documents or items unless you change your language or turn
off filtering. In the case of pages in a page library, if you
follow a link to a page that is not in your language and a page in your
language exists, you will see the page in your own language instead.
Translation
After installing, go to the default app page, which should be called "PointFire Translator" in the navigation.
Select "this page" link to navigate to your site’s language setting and add the languages that you want. You must be signed in as a site owner or site collection administrator to choose language settings for a site.
Now navigate to the document library that you want to translate.
Whether it's using Modern or Classic experience, you can see the
"PointFire Translator" menu item and also in the ribbon menu. This
works for libraries and for lists.
And if you have set classic view for your list you can see the following entries on your site.
Now select on the document that you want to translate and click on
"PointFire Translator". The translator page will open if you are using
modern libraries or it will open as a modal popup.
If your library is not
multilingual then click on the button "Make Library Multilingual Now!"
to make your list or library multilingual. A multilingual
list or library is one that has two extra metadata columns: "Item Language" and
"Source Item". Item Language will have a list of possible values
that is taken from the list of alternate languages of the site.
And if your list is already multilingual it will show you the following
options. Select the language of the item, which will set the Item
Language of the selected item. In this case English is selected.
The document will be translated into all the other languages of the
site. If the item has already been translated into some languages, it
will not be translated again unless that translation is deleted.
After selecting the language now click on the "Start Translation"
button to start the translation and you can see the following message
on your page.
Note:- Do not close this page or refresh while translation are in progress.
After completion of translation you can see the following message on
your page and now yo can go back to your document to see all the
translation by simply clicking on the "Go back to site" button.
And if translation job fails for any cause the following message will appear on your page.
You can also see whether it has used the Machine Translation Service or PointFire Power Translator.
And now go back to your list to see the results. PointFire Translator
will add all the translation of your document to your document library
as below:-
If you select on “PointFire Translator” without selecting an item you will get this following message.
You can not select two items at a single time for translation. If you
will select then you will see the following message on translation
page.
If you select a document/item that has already been translated into all
the site language then you will get following message when you select
on the "Start Translation" button.
And if you try to translate a document that is a translation of another
document, not the original, then you will get following message on your
screen.
Installation
In the app page, you can see two options “PointFire
Translator Server configuration settings” and “Azure
Document Translator configuration settings”. If you want to use
this add-in without the PointFire Translator Server, you need to first
configure the “Azure Document Translator configuration settings”.
This consists of several tasks:
A) Create an Azure Storage
Account
B) Create "source" Container and generate SAS tokens
C)
Create "target" Container and generate SAS tokens
D) Get the Azure
Storage Blob Service endpoint
E) Add required values in the Resource
sharing (CORS)
F) Get the value of Azure Translator key and Azure
Translator Document Translation endpoint.
G) Configure setting in the
PoinFire Translator Add-in page.
A) Create Azure Storage accounts:
Step 1:
Go to “https://portal.azure.com”
Step 2:
In Azure portal
Home
page, click on the menu option and click on “Storage
accounts”.
Step 3:
Then
click on
Create.
Step 4
To
Create a Storage account,
you need to fill all the required information.
Under Project details,
select the
Resource group
value as an existing or new group. In this case, we are using "Cognitive",
the same group as the Translator API instance, but that is not
mandatory.
.
Step 5:
Enter the
Storage account name
and
Region.
Then click on
Next: Advanced >
Step 6:
Under
Advanced
tab,
please check all the values as shown in the image below and then
click on
Next: Networking>.
Step 7:
Under
Networking
tab, the values must same as shown in the image below and then click on
Next: Data protection >.
Step 8:
Under
Data protection
tab, the values must same as shown in the image below and then click on
Next: Encryption >.
Step 9:
Under
Encryption
tab, check the values and click on
Next: Tags >.
Step 10:
Under
Tags
tab click on
Next: Review > and
then
wait for some time.
Step 11:
Then
Click on
Create.
Step 12:
After clicking on
Create
wait for some time when the
Deployment is in progress.
Step 13:
After successful deployment, it will show a complete message as shown in
the below image.
B) Create source Container and generate SAS token:
We need to create two containers
“source” and “target”.
Please follow the below steps to create the
Containers
in
storage account.
Step 1:
Under the newly created storage account, click on
Containers.
Step 2:
Click on
“+ Container”
as shown in the below image.
Add the name as
source
and then click on
Create.
Note: The name of the must be “source” as shown in the image.
Step 3:
When the source
container
is created, then click on the option menu by selecting the container.
Then click on
Generate SAS.
Step 4:
A pane will open, please change the
Permissions
values, and select the required values as shown in the below image.
Step 5:
Change the
Expiry
date value as per your requirement.
Step 6:
After changing all the required values like
Permissions
and
Expiry,
click on
Generate SAS token and URL.
Step 7:
After the values are generated
,
copy the
Blob SAS token
value and save it.
Note:
The
source Blob token
value is same as the value of
"source" Container SAS token.
C) Create target Container and generate SAS token:
Like
step B, source
container we need to create another container named
target.
Step 1:
Click on add
Container.
Put the Name as
target.
Click on
Create.
Note:
This container name must be
target
Step 2:
After creating the
target container
click on the option menu and then click on the
Generate SAS.
Step 3:
A pane will open, please change the
Permissions
values, and select the required values as shown in the below image.
Step 4:
Change the
Expiry
date value. After changing all the required values like Permissions and
Expiry, click on
Generate SAS token and URL
After the values are generated, copy the Blob SAS token value, and save
it.
Note: The
target
Blob SAS token
value is same as the value of
"target" Container SAS token.
D)
Get the Azure Storage Blob Service endpoint:
Step 1:
Click on the option menu of any one of containers and then click on
Container properties
as shown in the below image.
Step 2:
Copy
the
URL
value up to the
/,
refer the below image for more details. Here we have copied the below
value for
Azure Storage Blob Service endpoint.
“https://azuredoctranslation.blob.core.windows.net/”
E) Add required values in the Resource sharing (CORS)
Step 1:
Under the storage account search for
“Resource sharing (CORS)”.
Then
click on the
Resource sharing (CORS)
option.
Step 2:
In the boxes enter the required values as below and then click on
Save.
For more details refer the below image.
Allowed origins
value is
*
In
Allowed methods,
select all the options except
“OPTIONS”.
Allowed headers
value is
*
Exposed headers
value is
*
Max age
value is
86400
Step 3:
After
successful saving the values you will get a success message as shown in
the image.
F)
Get the value of Azure Translator key and Azure Translator Document
Translation endpoint.
Note:
You need to create the Azure Document Translator resource for
obtaining these values.
Note:
To create the resource, please refer to the section “Obtaining Azure
Translator Keys” in the “PFTQuickInstallationGuide.pdf”
Step 1:
In the Azure portal, go to
All resources.
Step 2:
Click on the
Translator resource
you have
created before.
Step 3:
Then click on the
Keys and Endpoint.
Step 4:
Copy the value of any one of the
KEY
values.
Also copy the value of
Document Translation
Note
: The value of the key will be the
Azure Translator key
value
and the value of
Document Translation
value will be the
Azure Translator Document Translation endpoint
value.
G) Configure setting in the PointFire Translator add-in page.
After installing the app to the site, go to the default app page, which
should be called "PointFire Translator Add in" in the navigation.
Select "this page" link to navigate to your site’s language setting and
add the languages that you want.
In the app page, you can see two options “PointFire Translator Server
configuration settings” and “Azure Document Translator
configuration settings”. You need to first configure the “Azure
Document Translator configuration settings”.
Enter the values of all the
parameters and then save the settings.
Enter the values of all the parameters and then save the
settings.