Power BI — Locations
Four queries are available: Locations, Customers, Location Roles, and Location Categories. These are typically used as dimension/lookup tables in a Power BI data model.
How to Set Up
- Follow the setup steps to configure privacy settings
- In Power BI Desktop, open Transform data → Transform data
- Click New Source → Blank Query, then open Advanced Editor
- Paste one of the queries below
- In the code, replace
your@email.comandYourPassword123!at the top with your Xemelgo credentials - Click Done and rename the query (e.g.,
Xemelgo Locations)
Repeat for each query you need.
Query 1 — Locations
let
Email = Binary.ToText(Text.ToBinary("your@email.com", TextEncoding.Utf8), BinaryEncoding.Base64),
Password = Binary.ToText(Text.ToBinary("YourPassword123!", TextEncoding.Utf8), BinaryEncoding.Base64),
Token = Json.Document(
Web.Contents("https://rest.api.xemelgo.com/login", [
Headers = [#"Content-Type" = "application/json"],
Content = Json.FromValue([email = Email, password = Password])
])
)[IdToken],
FetchPage = (nextToken as nullable text) =>
let
Resp = Json.Document(
Web.Contents("https://api.xemelgo.com/graphql", [
Headers = [Authorization = Token, #"Content-Type" = "application/json"],
Content = Json.FromValue([
query = "query($n: String) {
locations(input: { nextToken: $n }) {
locations {
id name description categoryId roleId
parentLocationId childLocationIds
}
nextToken
}
}",
variables = [n = nextToken]
])
])
)[data][locations]
in [items = Resp[locations], nextToken = Resp[nextToken]],
Pages = List.Generate(
() => FetchPage(null),
each _ <> null,
each if _[nextToken] = null then null else FetchPage(_[nextToken]),
each _[items]
),
All = List.Combine(Pages),
Tbl = Table.FromList(All, Splitter.SplitByNothing()),
Expanded = Table.ExpandRecordColumn(Tbl, "Column1",
{"id","name","description","categoryId","roleId","parentLocationId","childLocationIds"},
{"ID","Name","Description","Category ID","Role ID","Parent Location ID","Child Location IDs"})
in
Expanded
Columns returned: ID, Name, Description, Category ID, Role ID, Parent Location ID, Child Location IDs
Query 2 — Customers
let
Email = Binary.ToText(Text.ToBinary("your@email.com", TextEncoding.Utf8), BinaryEncoding.Base64),
Password = Binary.ToText(Text.ToBinary("YourPassword123!", TextEncoding.Utf8), BinaryEncoding.Base64),
Token = Json.Document(
Web.Contents("https://rest.api.xemelgo.com/login", [
Headers = [#"Content-Type" = "application/json"],
Content = Json.FromValue([email = Email, password = Password])
])
)[IdToken],
FetchPage = (nextToken as nullable text) =>
let
Resp = Json.Document(
Web.Contents("https://api.xemelgo.com/graphql", [
Headers = [Authorization = Token, #"Content-Type" = "application/json"],
Content = Json.FromValue([
query = "query($n: String) {
customers(input: { nextToken: $n }) {
customers { id name description customProperties }
nextToken
}
}",
variables = [n = nextToken]
])
])
)[data][customers]
in [items = Resp[customers], nextToken = Resp[nextToken]],
Pages = List.Generate(
() => FetchPage(null),
each _ <> null,
each if _[nextToken] = null then null else FetchPage(_[nextToken]),
each _[items]
),
All = List.Combine(Pages),
Tbl = Table.FromList(All, Splitter.SplitByNothing()),
Expanded = Table.ExpandRecordColumn(Tbl, "Column1",
{"id","name","description","customProperties"},
{"ID","Name","Description","Custom Properties"})
in
Expanded
Columns returned: ID, Name, Description, Custom Properties
Query 3 — Location Roles
let
Email = Binary.ToText(Text.ToBinary("your@email.com", TextEncoding.Utf8), BinaryEncoding.Base64),
Password = Binary.ToText(Text.ToBinary("YourPassword123!", TextEncoding.Utf8), BinaryEncoding.Base64),
Token = Json.Document(
Web.Contents("https://rest.api.xemelgo.com/login", [
Headers = [#"Content-Type" = "application/json"],
Content = Json.FromValue([email = Email, password = Password])
])
)[IdToken],
Resp = Json.Document(
Web.Contents("https://api.xemelgo.com/graphql", [
Headers = [Authorization = Token, #"Content-Type" = "application/json"],
Content = Json.FromValue([
query = "{ locationRoles { locationRoles { id name description } } }"
])
])
)[data][locationRoles][locationRoles],
Tbl = Table.FromList(Resp, Splitter.SplitByNothing()),
Expanded = Table.ExpandRecordColumn(Tbl, "Column1",
{"id","name","description"}, {"ID","Name","Description"})
in
Expanded
Columns returned: ID, Name, Description
Query 4 — Location Categories
let
Email = Binary.ToText(Text.ToBinary("your@email.com", TextEncoding.Utf8), BinaryEncoding.Base64),
Password = Binary.ToText(Text.ToBinary("YourPassword123!", TextEncoding.Utf8), BinaryEncoding.Base64),
Token = Json.Document(
Web.Contents("https://rest.api.xemelgo.com/login", [
Headers = [#"Content-Type" = "application/json"],
Content = Json.FromValue([email = Email, password = Password])
])
)[IdToken],
Resp = Json.Document(
Web.Contents("https://api.xemelgo.com/graphql", [
Headers = [Authorization = Token, #"Content-Type" = "application/json"],
Content = Json.FromValue([
query = "{ locationCategories { locationCategories { id name description } } }"
])
])
)[data][locationCategories][locationCategories],
Tbl = Table.FromList(Resp, Splitter.SplitByNothing()),
Expanded = Table.ExpandRecordColumn(Tbl, "Column1",
{"id","name","description"}, {"ID","Name","Description"})
in
Expanded
Columns returned: ID, Name, Description
Tip — Build a Full Location Dimension Table
Load all four queries, then use Merge Queries in Power Query to join role and category names into the Locations table:
- In the
Locationsquery, click Merge Queries → Merge Queries as New - Join
Role IDtoLocation Roles[ID]— expand to getRole Name - Repeat: join
Category IDtoLocation Categories[ID]— expand to getCategory Name