You are currently reviewing an older revision of this page.

Connecting Power BI to Language Weaver

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 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.

  1. From Power BI, click on Home > Get data > Blank query.



  2. In the Power Query Editor, right click on the newly created query and then click on Advanced Editor.



  3. 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.
  4. Click on Done.
  5. Click on Edit Credentials if you are asked to specify how to connect.



  6. 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.



  7. Right click on the query and then click on Rename to assign a proper name to the query.



  8. 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"