Configure Translator App

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 any or all of the languages of your site.

It is intended to work with PointFire Translator Server if it is installed and configured, but if not it will attempt to use SharePoint Online's or SharePoint 2019's built-in Machine Translation Service, much slower and lower quality. For more information on installing and using the app, see PointFire Translator

‍

PREPARATION

The PointFire Translator app can be installed either on each workstation of those who will use it, in which case SSL is not required, or it can be shared on a single server, in which case SSL is mandatory. The non-SSL version of PointFire Translator uses port 33080, the SSL version uses port 33443. The host name that it uses, whether with SSL or without, does not need to be routable with public DNS, almost any host name can be used. That will not work from outside the intranet, for example with Power Automate.

The PointFire Translator manual has more details on configuring SSL, but for testing purposes if you would like to create a self-signed SSL certificate and install it on port 33443, you can use the “MAKECERT.PS1” script . Since this is a self-signed certificate, other workstations won’t recognize it automatically. You can use the “ROOTCERT.PS1” script and the generated file PointFire.cer to install this certificate root on other workstations.

PointFire Translator Server communicates via TCP on port 33080 or 33443. These ports are typically blocked by default rules on network and server firewalls. If the server is using Windows Firewall, you will need to create inbound rules to open those ports, using Microsoft Management Console or netsh. If the server is an Azure VM, you will also have to go to the Azure Portal on the VM's Networking tab to add inbound port rules for those two ports.

‍

INSTALLATION

Before the PointFire Translator App can be used on a SharePoint Online site, it is essential to register it and grant it the necessary permissions through the Azure Active Directory portal corresponding to the SharePoint Online tenancy.

The simplest way to do this is to using the “AppReg.ps1” script.  This script will register the PointFire Translator server for use with the PointFire Translate app, and will also carry out the steps to use it with Power Automate.  The script will log in once to register and request permissions, and a second time to grant the permissions.  If you wish to re-run the script after successfully registering the application, it will overwrite the existing “PointFire Translator” application in AzureAD.  The script saves the appropriate PointFire Translator app configuration parameters at the tenant level in SharePoint, there is no need to set those parameters at the site level unless you want to override the tenant-level parameters.

To accomplish this registration manually instead of using the script, please see the Installation Guide.

If you are installing the app for evaluation, on a single workstation, you will want to use the PointFire Translator Server Quick Installation Steps manual to guide you on the information that you will provide to the AppReg.ps1 script.

If you are installing the app for production, or want to test the Power Automate interface you will want to use the full PointFire Translator Server Installation & Configuration Manual to guide you.  This installation on a shared server is more complex, but more suitable for production.

‍

SHAREPOINT ADD-IN POST-INSTALLATION CHECK

To diagnose any issue with translating pages from the PointFire Translator Add-in, you can visit the add-in page by going to the Site Content and clickin on PointFire Translator Add-In.  You will see a page like this:

Do not change any of the configuration settings, they were set at the tenant level by the AppReg.ps1 script.

The Check server version button can be used to verify basic connectivity after the Redirect URL parameter has been set. It attempts to contact the designated PointFire Translator server (as defined in the Redirect URL above) and, if successful, shows the version number.

If it does not show the version number, then copy the version of the Redirect URL and add to it "/version" and put that URL in the same browser, which will either return the version numbers, or will show an error in connectivity or in SSL certificate for you to diagnose and resolve.