Power BI
O Power BI é um conjunto de ferramentas de análise de negócios para analisar dados e compartilhar insights. Conecte-se para obter acesso fácil aos dados em seus painéis, relatórios e conjuntos de dados do Power BI.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate |
| Aplicativos Lógicos | Standard | Todas as regiões de Aplicativos Lógicos |
| Power Apps | Standard | Todas as regiões do Power Apps |
| Power Automate | Standard | Todas as regiões do Power Automate |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://powerbi.microsoft.com/en-us/support/ |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://powerbi.microsoft.com/ |
| Política de privacidade | https://privacy.microsoft.com/privacystatement |
| Categorias | Business Intelligence; Site |
Para usar essa integração, você precisará de acesso a uma conta do Power BI. Para fazer uma conexão, selecione Entrar. Você será solicitado a fornecer sua conta, seguir o restante das telas para criar uma conexão.
Ao usar a conexão, talvez seja necessário ter determinadas configurações em sua conta do Power BI. Por exemplo, para usar os gatilhos de alerta controlados por dados, você já deve ter um alerta controlado por dados configurado.
Agora você está pronto para começar a usar essa integração.
Problemas e limitações conhecidos
Não há suporte para o conector do Power BI para clusters de nuvem soberana do Power BI (ou seja, clusters da China, Alemanha e governo dos EUA).
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adicionar linhas a um conjunto de dados |
Use a API REST do Power BI para adicionar linhas a um conjunto de dados. |
| Adicionar uma anotação a um check-in (versão prévia) |
Acrescenta uma nova anotação a um check-in de uma meta do Power BI. |
| Atualizar um check-in (versão prévia) |
Atualiza um check-in de meta do Power BI. |
| Atualizar um conjunto de dados |
Use a API REST do Power BI para atualizar um conjunto de dados do Powerbi. |
| Atualizar uma meta (versão prévia) |
Atualiza o estado da meta do Power BI. |
| Criar um check-in (versão prévia) |
Cria um check-in de meta do Power BI. |
| Criar um scorecard (versão prévia) |
Cria um scorecard para metas do Power BI. |
| Criar uma meta (versão prévia) |
Cria uma meta do Power BI no scorecard especificado. |
| Executar uma consulta em um conjunto de dados |
Use a API REST do Power BI para executar uma consulta. |
| Executar uma consulta json em um conjunto de dados |
Use a API REST do Power BI para executar uma consulta no formato json. |
| Exportar para arquivo para relatórios do Power BI |
Usar a API Rest do Power BI para inititar a exportação para relatórios do Power BI |
| Exportar para arquivo para relatórios paginados |
Usar a API Rest do Power BI para inititar a exportação para relatórios paginados |
| Obter check-ins de meta (versão prévia) |
Obtenha todos os check-ins em uma meta do Power BI. |
| Obter scorecards (versão prévia) |
Obtém uma lista de scorecards do Power BI no workspace especificado. |
| Obter um check-in de meta (versão prévia) |
Obtenha um check-in em uma meta do Power BI. |
| Obter uma meta (versão prévia) |
Obtém a meta especificada do Power BI em um scorecard. |
| Obter várias metas (versão prévia) |
Obtenha uma lista de metas do Power BI no scorecard especificado. |
Adicionar linhas a um conjunto de dados
Use a API REST do Power BI para adicionar linhas a um conjunto de dados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
|
Table
|
tablename | True | string |
O nome da tabela. |
|
Conteúdo a ser enviado
|
Payload | dynamic |
Adicionar uma anotação a um check-in (versão prévia)
Acrescenta uma nova anotação a um check-in de uma meta do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Data de check-in
|
goalCheckin | True | date |
Exemplo: 2021-07-21 |
|
Observação
|
note | True | string |
Pode ser texto de várias linhas |
Atualizar um check-in (versão prévia)
Atualiza um check-in de meta do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Data de check-in
|
goalCheckin | True | date |
Exemplo: 2021-07-21 |
|
Value
|
value | number | ||
|
Situação
|
status | string |
Status da meta. |
Atualizar um conjunto de dados
Use a API REST do Power BI para atualizar um conjunto de dados do Powerbi.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
Atualizar uma meta (versão prévia)
Atualiza o estado da meta do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Nome
|
name | string |
Se fornecido, o novo nome da meta. |
|
|
Proprietário
|
owner |
Se fornecido, o endereço de email do novo proprietário da meta. |
||
|
Valor atual
|
value | number |
Se fornecido, define o novo valor da meta. |
|
|
Valor-alvo
|
target | number |
Se fornecido, define o novo destino de meta. |
|
|
Situação
|
status | string |
Se fornecido, define o novo status da meta. |
|
|
Data de início
|
startDate | date |
Se fornecida, a nova data de início da meta. Exemplo: 2021-07-15. |
|
|
Data de conclusão
|
completionDate | date |
Se fornecida, a nova data para a meta a ser concluída. Exemplo: 2021-07-29. |
Criar um check-in (versão prévia)
Cria um check-in de meta do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Date
|
timestamp | True | date |
Data de check-in. Exemplo: 2021-07-21 |
|
Value
|
value | number | ||
|
Situação
|
status | string |
Status da meta. |
|
|
Observação
|
note | string |
Pode ser texto de várias linhas |
Criar um scorecard (versão prévia)
Cria um scorecard para metas do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
Nome
|
name | True | string |
Nome do scorecard |
|
Description
|
description | string |
Descrição do scorecard |
Retornos
Scorecard criado.
- Scorecard criado
- CreatedScorecard
Criar uma meta (versão prévia)
Cria uma meta do Power BI no scorecard especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Nome
|
name | True | string |
O nome da meta. |
|
Proprietário
|
owner |
O endereço de email do proprietário da meta. Exemplo: foo@bar.com |
||
|
Valor atual
|
value | string |
O valor atual da meta que está sendo rastreada. |
|
|
Valor-alvo
|
target | string |
O valor de destino da meta. |
|
|
Situação
|
status | string |
O status atual da meta. |
|
|
Data de início
|
startDate | date |
A data de início da meta. Exemplo: 2021-07-15. |
|
|
Data de conclusão
|
completionDate | date |
A data para a meta a ser concluída. Exemplo: 2021-07-29. |
|
|
Observação
|
note | string |
Observe a anexação ao check-in inicial na criação da meta. Pode ser texto de várias linhas |
|
|
ID da meta pai
|
parentId | string |
Se essa meta for um subgol, a ID exclusiva de sua meta pai. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador exclusivo da meta. |
Executar uma consulta em um conjunto de dados
Use a API REST do Power BI para executar uma consulta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
|
Texto da consulta
|
query | True | string |
O texto da consulta. Pode ser texto de várias linhas. |
|
Nulos incluídos
|
includeNulls | boolean |
Os valores nulos devem ser incluídos nos resultados. O padrão é Não. |
|
|
Representar usuário
|
impersonatedUserName | string |
Uma identidade de usuário no formato UPN para executar a consulta como outro usuário. |
Retornos
Resultados da execução da consulta.
- Corpo
- QueryExecutionResults
Executar uma consulta json em um conjunto de dados
Use a API REST do Power BI para executar uma consulta no formato json.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
Retornos
- response
- object
Exportar para arquivo para relatórios do Power BI
Usar a API Rest do Power BI para inititar a exportação para relatórios do Power BI
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
Relatório
|
reportid | True | string |
O identificador exclusivo de um relatório pbi. |
|
Formato de exportação
|
format | True | string |
O formato de exportação para o relatório do Power BI. Os formatos com suporte são: PPTX (PowerPoint), PDF e PNG |
|
Local
|
locale | string |
A localidade a ser aplicada |
|
|
Incluir páginas ocultas
|
includeHiddenPages | boolean |
Um sinalizador que indica se as páginas ocultas devem ser incluídas ao exportar todo o relatório (ao passar páginas específicas, essa propriedade será ignorada). Se não for fornecido, o comportamento padrão será excluir páginas ocultas |
|
|
Nome do indicador
|
name | string |
O nome do indicador |
|
|
Estado do indicador
|
state | string |
O estado do indicador |
|
|
Filter
|
filter | string |
O filtro a ser aplicado |
|
|
pageName
|
pageName | string |
O nome da página |
|
|
visualName
|
visualName | string |
(Opcional) Nome do visual a ser exportado |
|
|
Nome do indicador
|
name | string |
O nome do indicador |
|
|
Estado do indicador
|
state | string |
O estado do indicador |
|
|
Nome de usuário
|
username | True | string |
O nome de usuário efetivo refletido por um token para aplicar regras RLS (modelo For OnPrem, nome de usuário pode ser composto de caracteres alfa-numéricos ou qualquer um dos seguintes caracteres '.', '-', '_', '!', '#', '^', '~', '\', '@', também o nome de usuário não pode conter espaços. Para o modelo de nuvem, o nome de usuário pode ser composto por todos os caracteres ASCII. o nome de usuário deve ter até 256 caracteres) |
|
Datasets
|
datasets | array of string |
Uma matriz de conjuntos de dados para os quais essa identidade se aplica |
|
|
Funções
|
roles | array of string |
Uma matriz de funções RLS refletida por um token ao aplicar regras RLS (a identidade pode conter até 50 funções, a função pode ser composta por qualquer caractere além de '', e deve ter até 50 caracteres) |
|
|
CustomData
|
customData | string |
O valor de customdata a ser usado para aplicar regras RLS. Só há suporte para conexões dinâmicas com o Azure Analysis Services. |
|
|
Valor do Blob
|
value | True | string |
Token de acesso OAuth2 para SQL Azure |
|
Reports
|
reports | array of string |
Uma matriz de relatórios para os quais essa identidade se aplica, com suporte somente para relatórios paginados |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Exportar para arquivo para relatórios paginados
Usar a API Rest do Power BI para inititar a exportação para relatórios paginados
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
Relatório
|
reportid | True | string |
O identificador exclusivo de um relatório paginado. |
|
Formato de exportação
|
format | True | string |
O formato de exportação para o relatório paginado. Os formatos com suporte são: PPTX (PowerPoint), PDF, ACCESSIBLEPDF (PDF acessível), XLSX (Excel), DOCX (Word), CSV, XML, MHTML e Imagem (BMP, EMF, GIF, JPEG, PNG ou TIFF). |
|
Nome de usuário
|
username | True | string |
O nome de usuário efetivo refletido por um token para aplicar regras RLS (modelo For OnPrem, nome de usuário pode ser composto de caracteres alfa-numéricos ou qualquer um dos seguintes caracteres '.', '-', '_', '!', '#', '^', '~', '\', '@', também o nome de usuário não pode conter espaços. Para o modelo de nuvem, o nome de usuário pode ser composto por todos os caracteres ASCII. o nome de usuário deve ter até 256 caracteres) |
|
Datasets
|
datasets | array of string |
Uma matriz de conjuntos de dados para os quais essa identidade se aplica |
|
|
Funções
|
roles | array of string |
Uma matriz de funções RLS refletida por um token ao aplicar regras RLS (a identidade pode conter até 50 funções, a função pode ser composta por qualquer caractere além de '', e deve ter até 50 caracteres) |
|
|
CustomData
|
customData | string |
O valor de customdata a ser usado para aplicar regras RLS. Só há suporte para conexões dinâmicas com o Azure Analysis Services. |
|
|
Valor do Blob
|
value | True | string |
Token de acesso OAuth2 para SQL Azure |
|
Reports
|
reports | array of string |
Uma matriz de relatórios para os quais essa identidade se aplica, com suporte somente para relatórios paginados |
|
|
FormatSettings
|
formatSettings | object |
Dicionário de configurações de formato. As chaves são os nomes de propriedade de informações do dispositivo para o formato de arquivo solicitado. |
|
|
nome
|
name | string |
O nome do parâmetro de relatório |
|
|
value
|
value | string |
O valor do parâmetro de relatório |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Obter check-ins de meta (versão prévia)
Obtenha todos os check-ins em uma meta do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Check-ins
|
value | array of object |
Lista de check-ins. |
|
Date
|
value.timestamp | datetime |
A data em que o check-in foi feito. |
|
Value
|
value.value | number |
O valor no momento do check-in. |
|
Situação
|
value.status | string |
O status da meta no momento do check-in. |
|
Anotações
|
value.notes | GoalNotes |
A lista de anotações. |
Obter scorecards (versão prévia)
Obtém uma lista de scorecards do Power BI no workspace especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
Retornos
Corpo inteiro da resposta.
- Recuperados
- ListedScorecards
Obter um check-in de meta (versão prévia)
Obtenha um check-in em uma meta do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Data de check-in
|
goalCheckin | True | date |
Exemplo: 2021-07-21 |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Date
|
timestamp | date |
A data em que o check-in foi feito. |
|
Value
|
value | number |
O valor no momento do check-in, se definido. |
|
Situação
|
status | string |
O status da meta no momento do check-in. |
|
Anotações
|
notes | GoalNotes |
A lista de anotações. |
Obter uma meta (versão prévia)
Obtém a meta especificada do Power BI em um scorecard.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
Retornos
Informações de meta.
- Goal
- FetchedGoal
Obter várias metas (versão prévia)
Obtenha uma lista de metas do Power BI no scorecard especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
Retornos
Corpo inteiro da resposta.
- Recuperados
- FetchedGoals
Gatilhos
| Botão do Power BI clicado |
Esse gatilho permite que você execute um fluxo quando um botão do Power BI é clicado. (Disponível apenas para o Power Automate.) |
| Quando alguém adiciona ou edita um check-in de meta (versão prévia) |
Dispare para algumas alterações de verificação de meta ou de anotação do Power BI. |
| Quando alguém atribui um novo proprietário a uma meta (versão prévia) |
Quando alguém atribui um novo proprietário a uma meta do Power BI. |
| Quando o status de uma meta é alterado (versão prévia) |
Quando o status de alguma meta do Power BI é alterado. |
| Quando o valor atual de uma meta é alterado (versão prévia) |
Quando o valor atual de alguma meta do Power BI é alterado. |
| Quando um alerta controlado por dados é disparado |
Retorne os detalhes do alerta controlado por dados especificado do Power BI quando o alerta for disparado. |
| Quando uma atualização de dados para uma meta falha (versão prévia) |
Quando uma atualização de dados para uma meta do Power BI falha. |
| Quando uma meta é alterada (versão prévia) |
Quando uma propriedade de alguma meta do Power BI é alterada. |
Botão do Power BI clicado
Esse gatilho permite que você execute um fluxo quando um botão do Power BI é clicado. (Disponível apenas para o Power Automate.)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
hospedar
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
headersSchema
|
headersSchema | object | ||
|
esquema
|
schema | object |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Linhas
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
Email do usuário
|
headers.x-ms-user-email-encoded | byte |
O endereço de email do usuário que disparou o fluxo. |
|
Nome de usuário
|
headers.x-ms-user-name-encoded | byte |
O nome de exibição do usuário que disparou o fluxo. |
|
Timestamp
|
headers.x-ms-user-timestamp | string |
A hora em que o fluxo foi disparado. |
|
Identificação de usuário
|
headers.x-ms-user-id | guid |
O identificador exclusivo do usuário que disparou o fluxo no AAD. |
Quando alguém adiciona ou edita um check-in de meta (versão prévia)
Dispare para algumas alterações de verificação de meta ou de anotação do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Intervalo de sondagem (s)
|
pollingInterval | True | number |
Número de segundos entre verificações de novos dados. O mínimo é 300. |
Retornos
Check-ins ou anotações de metas adicionadas ou alteradas.
- Meta atualizada
- GoalValueOrNoteUpserted
Quando alguém atribui um novo proprietário a uma meta (versão prévia)
Quando alguém atribui um novo proprietário a uma meta do Power BI.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Proprietário
|
owner |
Email de um proprietário. Pode ser seu. Pode estar vazio ao rastrear qualquer proprietário. |
||
|
Intervalo de sondagem (s)
|
pollingInterval | True | number |
Número de segundos entre verificações de novos dados. O mínimo é 300. |
Retornos
Informações de metas atribuídas.
- Atribuído
- GoalsAssigned
Quando o status de uma meta é alterado (versão prévia)
Quando o status de alguma meta do Power BI é alterado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Intervalo de sondagem (s)
|
pollingInterval | True | number |
Número de segundos entre verificações de novos dados. O mínimo é 300. |
Retornos
Propriedades de meta alteradas.
- Meta alterada
- GoalStatusChanged
Quando o valor atual de uma meta é alterado (versão prévia)
Quando o valor atual de alguma meta do Power BI é alterado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Intervalo de sondagem (s)
|
pollingInterval | True | number |
Número de segundos entre verificações de novos dados. O mínimo é 300. |
Retornos
Propriedades de meta alteradas.
- Meta alterada
- GoalValueChanged
Quando um alerta controlado por dados é disparado
Retorne os detalhes do alerta controlado por dados especificado do Power BI quando o alerta for disparado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do alerta
|
alertId | True | string |
A ID do alerta a ser rastreada. |
Retornos
- Corpo
- EvaluatedAlert
Quando uma atualização de dados para uma meta falha (versão prévia)
Quando uma atualização de dados para uma meta do Power BI falha.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Controlar a origem de destino
|
trackTargetSource | True | string |
Acompanhará o link para o destino da meta. |
|
Controlar fonte de valor
|
trackValueSource | True | string |
Acompanhará o link para o valor da meta. |
|
Intervalo de sondagem (s)
|
pollingInterval | True | number |
Número de segundos entre verificações de novos dados. O mínimo é 300. |
Retornos
Problemas de falha de atualização de meta.
- Falha na atualização
- GoalRefreshIssues
Quando uma meta é alterada (versão prévia)
Quando uma propriedade de alguma meta do Power BI é alterada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
O identificador exclusivo do workspace. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
ID da meta
|
goalId | True | string |
O identificador exclusivo da meta. |
|
Intervalo de sondagem (s)
|
pollingInterval | True | number |
Número de segundos entre verificações de novos dados. O mínimo é 300. |
Retornos
Propriedades de meta alteradas.
- Meta alterada
- GoalChanged
Definições
QueryExecutionResults
Resultados da execução da consulta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Primeiras linhas de tabela
|
firstTableRows | array of object |
Consultar resultados como uma matriz de linhas. |
CreatedScorecard
Scorecard criado.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador exclusivo do scorecard. |
ListedScorecards
Corpo inteiro da resposta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Quadros de Avaliação
|
value | array of ListedScorecard |
A lista de scorecards. |
ListedScorecard
Indicador.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador exclusivo do scorecard. |
|
Nome
|
name | string |
O nome do scorecard. |
|
Contato
|
contact | string |
Informações de contato para o scorecard. |
FetchedGoals
Corpo inteiro da resposta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Objetivos
|
value | array of FetchedGoal |
A lista de metas. |
FetchedGoal
Informações de meta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador exclusivo da meta. |
|
Nome
|
name | string |
O nome da meta. |
|
Proprietário
|
owner |
O endereço de email do proprietário da meta. |
|
|
Data de início
|
startDate | date |
A data de início da meta. Exemplo: 2021-07-15. |
|
Data de conclusão
|
completionDate | date |
A data de conclusão da meta a ser concluída. Exemplo: 2021-07-29. |
|
ID da meta pai
|
parentId | string |
Se essa meta for um subgol, a ID exclusiva de sua meta pai. |
|
Valor atual
|
currentValue | number |
O valor atual da meta que está sendo rastreada. |
|
Carimbo de data/hora de valor atual
|
currentValueTimestamp | date |
O carimbo de data/hora em que o valor atual da meta foi definido. |
|
Valor-alvo
|
targetValue | number |
O valor de destino da meta. |
|
Carimbo de data/hora de valor de destino
|
targetValueTimestamp | date |
O carimbo de data/hora em que o valor de destino da meta foi definido. |
|
Situação
|
status | string |
O status da meta. |
|
Carimbo de data/hora de status
|
statusTimestamp | date |
O carimbo de data/hora quando o status da meta foi definido. |
|
Frequência
|
cycle | string |
Intervalo de frequência do ciclo de acompanhamento mostrado nos visuais dessa meta. |
|
Data do ciclo de acompanhamento
|
cyclePeriod | date |
Data para descobrir propriedades extras do ciclo de acompanhamento. |
GoalChanged
Propriedades de meta alteradas.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador exclusivo da meta. |
|
Nome antigo
|
oldName | string |
O nome da meta. |
|
Antigo proprietário
|
oldOwner |
O endereço de email do proprietário da meta. |
|
|
Data de início antiga
|
oldStartDate | date |
A data de início da meta. Exemplo: 2021-07-15. |
|
Data de conclusão antiga
|
oldCompletionDate | date |
A data de conclusão da meta a ser concluída. Exemplo: 2021-07-29. |
|
ID de meta pai antiga
|
oldParentId | string |
Se essa meta for um subgol, a ID exclusiva de sua meta pai. |
|
Valor atual antigo
|
oldCurrentValue | number |
O valor atual da meta que está sendo rastreada. |
|
Valor de destino antigo
|
oldTargetValue | number |
O valor de destino da meta. |
|
Status antigo
|
oldStatus | string |
O status da meta. |
|
Frequência Antiga
|
oldCycle | string |
Intervalo de frequência do ciclo de acompanhamento antigo mostrado nos visuais dessa meta. |
|
Data do ciclo de acompanhamento antigo
|
oldCyclePeriod | date |
Data antiga para descobrir propriedades extras do ciclo de acompanhamento. |
|
Novo nome
|
newName | string |
O nome da meta. |
|
Novo proprietário
|
newOwner |
O endereço de email do proprietário da meta. |
|
|
Nova data de início
|
newStartDate | date |
A data de início da meta. |
|
Nova data de conclusão
|
newCompletionDate | date |
A data de conclusão da meta a ser concluída. |
|
Nova ID de meta pai
|
newParentId | string |
Se essa meta for um subgol, a ID exclusiva de sua meta pai. |
|
Novo valor atual
|
newCurrentValue | number |
O valor atual da meta que está sendo rastreada. |
|
Novo valor de destino
|
newTargetValue | number |
O valor de destino da meta. |
|
Novo status
|
newStatus | string |
O status da meta. |
|
Nova Frequência
|
newCycle | string |
Novo intervalo de ciclo de acompanhamento mostrado nos visuais dessa meta. |
|
Nova data do ciclo de acompanhamento
|
newCyclePeriod | date |
Nova data para descobrir propriedades extras do ciclo de acompanhamento. |
|
Lista de alterações
|
changeList | string |
Lista separada por vírgulas de alterações. Exemplo: 'status,currentValue'. |
GoalStatusChanged
Propriedades de meta alteradas.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador exclusivo da meta. |
|
Status antigo
|
oldStatus | string |
O status da meta. |
|
Novo status
|
newStatus | string |
O status da meta. |
GoalValueChanged
Propriedades de meta alteradas.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador exclusivo da meta. |
|
Valor atual antigo
|
oldCurrentValue | number |
O valor atual da meta que está sendo rastreada. |
|
Novo valor atual
|
newCurrentValue | number |
O valor atual da meta que está sendo rastreada. |
GoalRefreshIssues
Problemas de falha de atualização de meta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Problemas
|
issues | array of GoalRefreshIssue |
Problemas de atualização de meta. |
GoalRefreshIssue
Problema de atualização de meta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tipo de conexão
|
connectionType | string |
O tipo de conexão, Atual ou Destino. |
|
Timestamp
|
timestamp | string |
O carimbo de data/hora de quando a atualização com falha aconteceu. |
|
Mensagem de erro
|
message | string |
Descrição do erro. |
GoalsAssigned
Informações de metas atribuídas.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Objetivos
|
assignedGoals | array of object |
A lista de metas atribuídas ao novo proprietário. |
|
ID
|
assignedGoals.id | string |
ID exclusiva da meta. |
|
ID do scorecard
|
assignedGoals.scorecardId | string |
O identificador exclusivo do scorecard. |
|
Nome
|
assignedGoals.name | string |
O nome da meta. |
|
Proprietário
|
assignedGoals.owner | string |
O novo proprietário ao qual a meta foi atribuída. |
|
Última modificação por
|
assignedGoals.lastModifiedBy | string |
O usuário que modificou a meta pela última vez. |
|
Data de início
|
assignedGoals.startDate | date |
A data de início da meta. |
|
Data de conclusão
|
assignedGoals.completionDate | date |
A data para a meta a ser concluída. |
GoalValueOrNoteUpserted
Check-ins ou anotações de metas adicionadas ou alteradas.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Check-ins
|
values | array of object |
Check-ins adicionados ou atualizados. |
|
Date
|
values.timestamp | date |
A data em que o check-in foi feito. |
|
Value
|
values.value | number |
O valor da meta no momento do check-in. |
|
Situação
|
values.status | string |
O status da meta no momento do check-in. |
|
Anotações
|
notes | array of object |
Notas adicionadas ou alteradas. |
|
Data de check-in
|
notes.valueTimestamp | date |
A data do check-in ao qual esta anotação foi adicionada. |
|
Texto
|
notes.body | string |
Texto da anotação recém-adicionada. |
|
Tempo de criação
|
notes.createdTime | datetime |
A data em que a anotação foi criada. |
GoalNotes
A lista de anotações.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto
|
body | string |
O conteúdo da anotação. |
|
Tempo de criação
|
createdTime | datetime |
A data em que a anotação foi criada. |
EvaluatedAlert
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Título do alerta
|
alertTitle | string |
O título do alerta. |
|
Limite de alerta
|
alertThreshold | number |
O limite no qual o alerta é disparado. |
|
O alerta é disparado
|
isAlertTriggered | boolean |
Um valor booliano (true, false) que determina se o alerta foi disparado ou não. |
|
URL do bloco
|
tileUrl | string |
URL vinculando ao bloco do painel em que o alerta está configurado. |
|
Valor do bloco
|
tileValue |
O valor do bloco. |
binário
Esse é o tipo de dados básico 'binary'.
objeto
Esse é o tipo 'object'.