Wiki

End of Support - Internet Explorer

Arnaud Simon — Mon, 17 Jun 2024 09:49:09 GMT

Current Revision posted to Wiki by Arnaud Simon on 6/17/2024 9:49:09 AM

Internet Explorer has been retired and is out of support since June 2022.

Please see the Microsoft communication at https://blogs.windows.com/windowsexperience/2022/06/15/internet-explorer-11-has-retired-and-is-officially-out-of-support-what-you-need-to-know/

Language Weaver has also dropped official support for Internet Explorer.

The supported browsers are:

Chrome - version 67 and higher
Mozilla Firefox - version 60 and higher
Safari - version 11 and higher
Microsoft Edge - version 42.171134 and higher

If users are still accessing the Language Weaver portal using Internet Explorer, the following message will be displayed:

Thank you

End of Support Notices

Arnaud Simon — Mon, 17 Jun 2024 09:42:38 GMT

Current Revision posted to Wiki by Arnaud Simon on 6/17/2024 9:42:38 AM

This page is listing the different end of support notices that apply to Language Weaver. This can apply to specific connectors or browsers that are used to access the Language Weaver Platform.

Language Weaver introduces Multilingual Content Insights

Ruxandra Grosan — Fri, 25 Nov 2022 11:21:42 GMT

Current Revision posted to Wiki by Ruxandra Grosan on 11/25/2022 11:21:42 AM

Hi all,

We are happy to inform you that we recently added a new, expanded capability to Language Weaver, Multilingual Content Insights.

Multilingual Content Insights provides a dynamic, automatic summary of any document or a set of documents, in any language, right within the Language Weaver environment. Typically, to get to this level of comprehension, you would need to read the full document – whether two pages or 200 and extract the relevant sections. Now this can be done instantly, making work easier, faster and leading to better decision making.

This article describes how the feature works and offers information about how to request access to it.

Here's everything you need to know about Content Insights works

When you upload a file for translation, next to the ‘Translate’ button you’ll see a new option for Content Insights. By clicking on the ‘Content Insights’ button, the system will process the document and will extract the key topics and ideas. Once done, you can immediately access its summary.

Content Insights is dynamic: use the slider to reduce the focus or broaden it to show a fuller view of the content.

Useful to know:

Content Insights works for any of our supported languages and file types. To generate instant summaries in your desired language, first translate your document, then click on “Content Insights”.
When working with a group of files, the software will generate a summary that combines all documents. In the ‘Overview’ tab below, the dynamic summary has extracted the topics and relevant snippets from our two documents. You can still review the individual documents, by clicking on each file name.

The handy ‘Copy to clipboard’ functionality (available for the entire summary and for individual segments) can help you easily reuse the content offline or share with others

Monitoring volumes

You can easily monitor volumes processed with Content Insights from the ‘Reports’ tab. The reporting Dashboard will show you the total volumes processed on your account:

To get a detailed breakdown of the volumes processed for each language, user and API credentials, go to the ‘Custom Report’ page and select the ‘Content Insights’ tab:

How to access Content Insights

Content Insights is included with all Language Weaver subscriptions and can be easily enabled for you. Please note that the source characters processed with Content Insights consume from the yearly Language Weaver character allowance. To access this feature, please raise a request through our customer support portal at https://gateway.sdl.com/ and we will be happy to enable it for you!

Thank you and we hope you enjoy using Content Insights!

The Language Weaver Team

Language Weaver introduces Multilingual Content Insights

Ruxandra Grosan — Fri, 25 Nov 2022 10:26:43 GMT

Revision 5 posted to Wiki by Ruxandra Grosan on 11/25/2022 10:26:43 AM

Hi all,

We are happy to inform you that we recently added a new, expanded capability to Language Weaver, Multilingual Content Insights.

This article describes how the feature works and offers information about how to request access to it.

How it works

Here's everything you need to know about Content Insights works.

Content Insights is dynamic: use the slider to reduce the focus or broaden it to show a fuller view of the content.

Useful to know:

Content Insights works for any of our supported languages and file types. To generate instant summaries in your desired language, first translate your document, then click on “Content Insights”.
When working with a group of files, the software will generate a summary that combines all documents. In the ‘Overview’ tab below, the dynamic summary has extracted the topics and relevant snippets from our two documents. You can still review the individual documents, by clicking on each file name.

The handy ‘Copy to clipboard’ functionality (available for the entire summary and for individual segments) can help you easily reuse the content offline or share with others

Monitoring volumes

You can easily monitor volumes processed with Content Insights from the ‘Reports’ tab. The reporting Dashboard will show you the total volumes processed on your account:

To get a detailed breakdown of the volumes processed for each language, user and API credentials, go to the ‘Custom Report’ page and select the ‘Content Insights’ tab:

How to access Content Insights

Thank you and we hope you enjoy using Content Insights!

The Language Weaver Team

Language Weaver introduces Multilingual Content Insights

Ruxandra Grosan — Fri, 25 Nov 2022 10:25:05 GMT

Revision 4 posted to Wiki by Ruxandra Grosan on 11/25/2022 10:25:05 AM

Hi all,

We are happy to inform you that we recently added a new, expanded capability to Language Weaver, Multilingual Content Insights.

This article describes how the feature works and offers information about how to request access to it.

How it works

Here's everything you need to know about Content Insights works.

Content Insights is dynamic: use the slider to reduce the focus or broaden it to show a fuller view of the content.

Useful to know:

Content Insights works for any of our supported languages and file types. To generate instant summaries in your desired language, first translate your document, then click on “Content Insights”.
When working with a group of files, the software will generate a summary that combines all documents. In the ‘Overview’ tab below, the dynamic summary has extracted the topics and relevant snippets from our two documents. You can still review the individual documents, by clicking on each file name.

The handy ‘Copy to clipboard’ functionality (available for the entire summary and for individual segments) can help you easily reuse the content offline or share with others

Monitoring volumes

You can easily monitor volumes processed with Content Insights from the ‘Reports’ tab. The reporting Dashboard will show you the total volumes processed on your account:

To get a detailed breakdown of the volumes processed for each language, user and API credentials, go to the ‘Custom Report’ page and select the ‘Content Insights’ tab:

How to access Content Insights

Thank you and we hope you enjoy using Content Insights!

The Language Weaver Team

Language Weaver introduces Multilingual Content Insights

Ruxandra Grosan — Fri, 25 Nov 2022 10:24:12 GMT

Revision 3 posted to Wiki by Ruxandra Grosan on 11/25/2022 10:24:12 AM

Hi all,

We are happy to inform you that we recently added a new, expanded capability to Language Weaver, Multilingual Content Insights.

This article describes how the feature works and offers information about how to request access to it.

How it works

Here's everything you need to know about Content Insights works.

Content Insights is dynamic: use the slider to reduce the focus or broaden it to show a fuller view of the content.

Useful to know:

Content Insights works for any of our supported languages and file types. To generate instant summaries in your desired language, first translate your document, then click on “Content Insights”.
When working with a group of files, the software will generate a summary that combines all documents. In the ‘Overview’ tab below, the dynamic summary has extracted the topics and relevant snippets from our two documents. You can still review the individual documents, by clicking on each file name.

The handy ‘Copy to clipboard’ functionality (available for the entire summary and for individual segments) can help you easily reuse the content offline or share with others

Monitoring volumes

You can easily monitor volumes processed with Content Insights from the ‘Reports’ tab. The reporting Dashboard will show you the total volumes processed on your account:

To get a detailed breakdown of the volumes processed for each language, user and API credentials, go to the ‘Custom Report’ page and select the ‘Content Insights’ tab:

How to access Content Insights

To access this feature, please raise a request through our customer support portal at https://gateway.sdl.com/ and we will be happy to enable it for you!

Thank you and we hope you enjoy using Content Insights!

Language Weaver Team

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Fri, 14 Oct 2022 16:11:23 GMT

Current Revision posted to Wiki by Pablo Perez-Pineiro on 10/14/2022 4:11:23 PM

You can follow the steps below to connect Power BI to Language Weaver.

Full details on the Language Weaver API can be found in the Cloud API documentation.

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Blank query.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"
Client IDs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace YourAccountID with the real account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", clientIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "client", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "client", {"name", "clientId"}) in #"Expanded reports3"

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Tue, 06 Sep 2022 07:39:29 GMT

Revision 7 posted to Wiki by Pablo Perez-Pineiro on 9/6/2022 7:39:29 AM

You can follow the steps below to connect Power BI to Language Weaver.

Full details on the Language Weaver API can be found in the Cloud API documentation.

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Blank query.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Mon, 05 Sep 2022 15:26:16 GMT

Revision 6 posted to Wiki by Pablo Perez-Pineiro on 9/5/2022 3:26:16 PM

Language Weaver account administrators can benefit from the reporting feature. This report offers detailed information on usage by users, language pairs, dates, etc., which can be very useful to get an overview of how the account is being used. Additionally, the report can be exported to an Excel spreadsheet — something very convenient if you need to use this data in some other tool.

Likewise, if you need to connect some other reporting tool to Language Weaver, you can consider using the Language Weaver REST API to create equivalent reports as the ones you get from directly from the translation portal. You can check the Cloud API documentation, where you will find an accurate explanation and multiple examples of how to use this feature.

Also, if you use Microsoft Power BI, you can connect to Language Weaver via the user interface to create the different tables needed for your reports. You can also make changes in the queries without the need to be an experienced developer. Get on with it by following steps below!

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Blank query.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Mon, 05 Sep 2022 12:05:32 GMT

Revision 5 posted to Wiki by Pablo Perez-Pineiro on 9/5/2022 12:05:32 PM

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver Cloud.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Blank query.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Mon, 05 Sep 2022 10:10:06 GMT

Revision 4 posted to Wiki by Pablo Perez-Pineiro on 9/5/2022 10:10:06 AM

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver Cloud.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Blank query.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Mon, 05 Sep 2022 10:03:42 GMT

Revision 3 posted to Wiki by Pablo Perez-Pineiro on 9/5/2022 10:03:42 AM

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver Cloud.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Web.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 2.3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Mon, 05 Sep 2022 09:52:13 GMT

Revision 2 posted to Wiki by Pablo Perez-Pineiro on 9/5/2022 9:52:13 AM

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver Cloud.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Web.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 2.3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"

Connecting Power BI to Language Weaver

Pablo Perez-Pineiro — Mon, 05 Sep 2022 09:50:20 GMT

Revision 1 posted to Wiki by Pablo Perez-Pineiro on 9/5/2022 9:50:20 AM

1. Getting the connection details

You will need to have at hand the following information in order to establish the connection with Language Weaver Cloud.

<Account ID>: This is the account you will report on. To find out the Account ID, log into the Language Weaver portal (https://portal.languageweaver.com/) and click on [Username] > User Details.
<Client ID> and <Client Secret>: A Client ID and a Client Secret are the equivalent to a user and a password used to connect to Language Weaver via the API. If you need to create new ones, log into the Language Weaver portal (https://portal.languageweaver.com/) as an admin user and click on Settings > API Credentials. Then click on the + Create API Credentials button to create them.

2. Creating the tables in Power BI

Follow the steps below to create a table in Power BI for each query. In each case, replace <Account ID>, <Client ID> and <Client Secret> with the actual data.

From Power BI, click on Home > Get data > Web.
In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.
In the Advanced Editor, delete the default code and paste the code from the samples below (section 2.3. Sample queries). Make sure you replace the <placeholder> tags with the actual data.
Click on Done.
Click on Edit Credentials if you are asked to specify how to connect.
Go to the Anonymous tab and click on Connect. A new table will be created with the results of the query. You can remove or reorder columns as needed.
Right click on the query and then click on Rename to assign a proper name to the query.
Repeat the previous steps for each of the reporting queries you wish to run.

3. Sample queries

Use the sample code below to create reporting queries via Power BI.

Remember to replace the following placeholder tags with the actual data:

<Client ID>
<Client Secret>
<Account ID>
<Start date>
Format: yyyy/MM/dd
Example: For 30 June 2022, use 2022/06/30
<End date>
Format: yyyy/MM/dd
Example: For 10 April 2022, use 2022/04/10

Applications
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", applicationIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "application", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "application", {"id", "name"}) in #"Expanded reports3"
Groups
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", groupIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "group", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "group", {"id", "value"}) in #"Expanded reports3"
Labels
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", labelIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "label", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "label", {"id", "value"}) in #"Expanded reports3"
Language Pairs
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", languagePairIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "languagePair", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "languagePair", {"name", "displayName", "sourceLanguageId", "targetLanguageId"}) in #"Expanded reports3"
Users
let /* Authentication / authenticationURL = "https://api.languageweaver.com/v4/token", authPostData = Json.FromValue([clientId = "<Client ID>", clientSecret = "<Client Secret>"]), / Replace with your Client ID and Client Secret / headersAuth = [#"Content-Type"="application/json"], authResponse = Web.Contents( authenticationURL, [ Headers = headersAuth, Content = authPostData ] ), authResponseJson = Json.Document(authResponse), token = "Bearer " & authResponseJson[#"accessToken"], / Call / url = "https://api.languageweaver.com/v4/accounts/<Account ID>/reports/usage/translations", / Replace with your account ID number / headers = [#"Authorization"= token, #"Content-Type"="application/json"], postData = Json.FromValue([startDate = "<Start date>", endDate = "<End date>", userIds = {"all"}]), / Change the dates as necessary / response = Web.Contents( url, [ Headers = headers, Content = postData ] ), jsonResponse = Json.Document(response), / Response */ #"Converted to Table" = Table.FromRecords({jsonResponse}), #"Expanded reports1" = Table.ExpandListColumn(#"Converted to Table", "report"), #"Expanded reports2" = Table.ExpandRecordColumn(#"Expanded reports1", "report", {"reportYear", "reportMonth", "user", "count", "inputWordCount", "inputCharCount", "outputWordCount", "outputCharCount"}), #"Expanded reports3" = Table.ExpandRecordColumn(#"Expanded reports2", "user", {"userId", "firstName", "middleName", "lastName", "email"}) in #"Expanded reports3"

How to use translation "Labels" in Language Weaver

Madalina Bardocz — Thu, 14 Jul 2022 13:33:20 GMT

Current Revision posted to Wiki by Madalina Bardocz on 7/14/2022 1:33:20 PM

Language Weaver supports translations 'Labels' for enhanced usage monitoring and reporting.

What is a label?

A label can be anything meaningful to your business needs such as a project identifier (i.e. Project Code, Project Purpose), beneficiary name etc. Once applied, Labels will allow Language Weaver account administrators to track usage based on personalized, pre-defined categories and offer an enhanced possibility to customize throughput consumption statistics.

How to use Labels

As a Language Weaver account administrator, go to 'Settings' > 'Labels' > 'Create Label':

Once 'Labels' are defined by the administrators, on the 'Translate' page, users can use the button '+Add Label' to assign one or multiple labels to their translation jobs.

Click on '+ Add Label':

Then select one or multiple labels:

Selected label(s) will automatically be assigned to the next documents submitted for translation:

Administrators can also create labels directly from the '+ Add Label' button option in the Translate page.

Useful to know:

Only Administrators can create 'Labels' while end-users (Translators and Linguists) can apply pre-defined labels.
Labels can only be assigned to Documents Translations (also known as Asynchronous Translations).
Labels must be selected before the translation is performed, they can't be removed after the translation has been done and they can’t be applied retroactively.
Deleting a label will prevent users from assigning the label to their translation jobs - but labels will still be available for selection in the reporting.

In the Custom Report, a new filter option is available to display volumes translated per label.

We hope you'll enjoy this feature!

How to use translation "Labels" in Language Weaver

Madalina Bardocz — Thu, 14 Jul 2022 13:32:34 GMT

Revision 1 posted to Wiki by Madalina Bardocz on 7/14/2022 1:32:34 PM

Language Weaver supports translations 'Labels' for enhanced usage monitoring and reporting.

What is a label? A label can be anything meaningful to your business needs such as a project identifier (i.e. Project Code, Project Purpose), beneficiary name etc. Once applied, Labels will allow Language Weaver account administrators to track usage based on personalized, pre-defined categories and offer an enhanced possibility to customize throughput consumption statistics.

How to use Labels

As a Language Weaver account administrator, go to 'Settings' > 'Labels' > 'Create Label':

Once 'Labels' are defined by the administrators, on the 'Translate' page, users can use the button '+Add Label' to assign one or multiple labels to their translation jobs.

Click on '+ Add Label':

Then select one or multiple labels:

Selected label(s) will automatically be assigned to the next documents submitted for translation:

Administrators can also create labels directly from the '+ Add Label' button option in the Translate page.

Useful to know:

Only Administrators can create 'Labels' while end-users (Translators and Linguists) can apply pre-defined labels.
Labels can only be assigned to Documents Translations (also known as Asynchronous Translations).
Labels must be selected before the translation is performed, they can't be removed after the translation has been done and they can’t be applied retroactively.
Deleting a label will prevent users from assigning the label to their translation jobs - but labels will still be available for selection in the reporting.

In the Custom Report, a new filter option is available to display volumes translated per label.

We hope you'll enjoy this feature!

Dictionaries and Brands overview

Lenka Denemark — Thu, 07 Jul 2022 13:37:28 GMT

Current Revision posted to Wiki by Lenka Denemark on 7/7/2022 1:37:28 PM

Dictionaries and Brands are the features provided by Language Weaver, enabling users to ensure and enforce that certain terms, phrases and/or brands are correctly and consistently used throughout translations.

There are some differences between these two functionalities that should not be overlooked when performing translations.

Dictionaries are Language Pair and Domain specific. For instance, in order to translate a document belonging to the Technical Domain from English into French, a dictionary with terminology specific to that particular domain should be created with the source entries in English and their translations in French. For each translation that is performed for a certain language pair, only one Dictionary can be used at a time. Dictionaries are applied only to the language pair for which they were initially created.

Unlike Dictionaries, Brand lists are not language pair specific, and they are applied across all the language pairs in an account.

Dictionaries and Brands can be used simultaneously or only one at a time. In case there is an overlap of entries in the Dictionary and the Brand list, the entries in the Dictionary will always take priority over the Brand list.

See the Language Weaver user documentation for more detailed recommendations and guidelines for creating Dictionaries: RWS Documentation

Dictionaries and Brands overview

Lenka Denemark — Thu, 07 Jul 2022 13:32:41 GMT

Revision 4 posted to Wiki by Lenka Denemark on 7/7/2022 1:32:41 PM

There are some differences between these two functionalities that should not be overlooked when performing translations.

Unlike Dictionaries, Brand lists are not language pair specific, and they are applied across all the language pairs in an account.

Dictionaries and Brands can be used simultaneously or only one at a time. In case there is an overlap of entries in the Dictionary and Brand lists, the entries in the Dictionary will always take priority over the Brand list.

See the Language Weaver user documentation for more details on recommendations and guidelines for creating Dictionaries: RWS Documentation

Dictionaries and Brands overview

Lenka Denemark — Thu, 07 Jul 2022 13:29:52 GMT

Revision 3 posted to Wiki by Lenka Denemark on 7/7/2022 1:29:52 PM

There are some differences between these two functionalities that should not be overlooked when performing translations.

For each translation that is performed for a certain language pair, only one Dictionary can be used at a time. Dictionaries are applied only to the language pair for which they were initially created.

Unlike Dictionaries, Brand lists are not language pair specific, and they are applied across all the language pairs in an account. Dictionaries and Brands can be used simultaneously or only one at a time. In case there is an overlap of entries in the Dictionary and Brand lists, the entries in the Dictionary will always take priority over the Brand list.

See the Language Weaver user documentation for more details on recommendations and guidelines for creating Dictionaries: RWS Documentation

Connect with Language Weaver Resources

Ruxandra Grosan — Mon, 07 Feb 2022 15:23:03 GMT

Current Revision posted to Wiki by Ruxandra Grosan on 2/7/2022 3:23:03 PM

Hi everyone,

We are excited to announce the release of the Connect tab in Language Weaver. Connect offers a simplified access to our out-of-the-box extensions, to new and updated developer resources and our user community. Explore the new section of the portal to find everything you need in order to connect external applications to Language Weaver.

Extensions

Our extensions offer a range of existing integrations and connectors to many popular applications such as Microsoft Office, Relativity, ServiceNow and many more.

Connect simplifies your access to Language Weaver extensions:

Account admins will find all available Language Weaver connectors under Connect > Extensions. We invite you to browse the list and download the ones you’d like to use.
In Connect > Extensions users with the Translator and Linguist roles will only see the extensions that account admins enable for them. Let’s take a closer look into how it works:
- As an account admin, chose the extensions you want to give access to your Translator and Linguist users from Settings > Extensions:

In our example below, the Translator user will find in Connect > Extensions the Language Weaver extension for Google Chrome, enabled in the previous step by the account Admin:

The Language Weaver Developer Portal

Visit the Developers section of Connect to find new and updated resources designed to help you easily integrate Language Weaver into your workflows or proprietary systems:

Our API documentation now includes cURL code snippets for all API endpoints to help you easily test all the API functionalities and visualize the server responses.
We also created a new Postman collection covering the Language Weaver API. Import the collection into your Postman app and interact with our API to get a sense of its powerful features.

The Language Weaver User Community

The Language Weaver portal now also includes easy access to our User Community! Visit the RWS Language Weaver Community to stay current on the updates we have made and are continuing to make to the product, get support and interact with your peers.

We encourage you to subscribe to the community to receive email notifications every time new content is posted.

What’s next:

The Connect hub will be updated on a regular basis with new developer resources and extensions designed to help you get the most from Language Weaver. We hope you enjoy the new feature and we are looking forward for your feedback and suggestions. Stay tuned for more!