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.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automate |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps |
| Aplicações Power | Standard | Todas as regiões do Power Apps |
| Automatize o poder | Standard | Todas as regiões do Power Automate |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://powerbi.microsoft.com/en-us/support/ |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://powerbi.microsoft.com/ |
| Política de privacidade | https://privacy.microsoft.com/privacystatement |
| Categorias | Business Intelligence; Sítio Web |
Para usar essa integração, você precisará acessar uma conta do Power BI. Para estabelecer uma ligação, selecione Iniciar sessão. Você será solicitado a fornecer sua conta, siga 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 conhecidos e limitações
O conector do Power BI não é suportado para clusters de nuvem soberana do Power BI (ou seja, clusters do governo da China, Alemanha e EUA).
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de 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 nota a um check-in (Pré-visualização) |
Acrescenta uma nova nota a um check-in de uma meta do Power BI. |
| Atualizar um check-in (Pré-visualização) |
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 (Visualização) |
Atualiza o estado da meta do Power BI. |
| Criar um check-in (Pré-visualização) |
Cria um check-in de meta do Power BI. |
| Criar um scorecard (Pré-visualização) |
Cria um scorecard para metas do Power BI. |
| Criar uma meta (Visualização) |
Cria uma meta do Power BI no scorecard especificado. |
| Executar uma consulta em relação a 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 iniciar a exportação de relatórios do Power BI |
| Exportar para arquivo para relatórios paginados |
Usar a API Rest do Power BI para iniciar a exportação de relatórios paginados |
| Obter check-ins de metas (Pré-visualização) |
Obtenha todos os check-ins em uma meta do Power BI. |
| Obter scorecards (Pré-visualização) |
Obtém uma lista de scorecards do Power BI no espaço de trabalho especificado. |
| Obter um check-in de metas (Visualização) |
Faça um check-in em uma meta do Power BI. |
| Obter um objetivo (Pré-visualização) |
Obtém a meta especificada do Power BI em um scorecard. |
| Obter várias metas (Visualização) |
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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
|
Table
|
tablename | True | string |
O nome da tabela. |
|
Carga útil a enviar
|
Payload | dynamic |
Adicionar uma nota a um check-in (Pré-visualização)
Acrescenta uma nova nota a um check-in de uma meta do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
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 (Pré-visualização)
Atualiza um check-in de meta do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Data de check-in
|
goalCheckin | True | date |
Exemplo: 2021-07-21 |
|
Valor
|
value | number | ||
|
Situação
|
status | string |
Estatuto da meta. |
Atualizar um conjunto de dados
Use a API REST do Power BI para atualizar um conjunto de dados do powerbi.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
Atualizar uma meta (Visualização)
Atualiza o estado da meta do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Nome
|
name | string |
Se fornecido, o novo nome da meta. |
|
|
Proprietário
|
owner |
Se fornecido, o endereço de e-mail 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 a nova meta de meta. |
|
|
Situação
|
status | string |
Se fornecido, define o novo status da meta. |
|
|
Data de início
|
startDate | date |
Se fornecido, a nova data de início para a meta. Exemplo: 2021-07-15. |
|
|
Data de conclusão
|
completionDate | date |
Se fornecida, a nova data para a meta ser concluída. Exemplo: 2021-07-29. |
Criar um check-in (Pré-visualização)
Cria um check-in de meta do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Date
|
timestamp | True | date |
Data de check-in. Exemplo: 2021-07-21 |
|
Valor
|
value | number | ||
|
Situação
|
status | string |
Estatuto da meta. |
|
|
Observação
|
note | string |
Pode ser texto de várias linhas |
Criar um scorecard (Pré-visualização)
Cria um scorecard para metas do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
Nome
|
name | True | string |
Nome do scorecard |
|
Description
|
description | string |
Descrição do scorecard |
Devoluções
Scorecard criado.
- Scorecard criado
- CreatedScorecard
Criar uma meta (Visualização)
Cria uma meta do Power BI no scorecard especificado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Nome
|
name | True | string |
O nome do gol. |
|
Proprietário
|
owner |
O endereço de e-mail 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-alvo da meta. |
|
|
Situação
|
status | string |
O status atual o objetivo. |
|
|
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 ser concluída até. Exemplo: 2021-07-29. |
|
|
Observação
|
note | string |
Nota para anexar ao check-in inicial na criação de metas. Pode ser texto de várias linhas |
|
|
ID da meta pai
|
parentId | string |
Se essa meta for uma submeta, a id exclusiva de sua meta pai. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
O identificador exclusivo do objetivo. |
Executar uma consulta em relação a um conjunto de dados
Use a API REST do Power BI para executar uma consulta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
|
Texto da consulta
|
query | True | string |
O texto da consulta. Pode ser texto com várias linhas. |
|
Nulos incluídos
|
includeNulls | boolean |
Devem ser incluídos valores nulos nos resultados. O padrão é Não. |
|
|
Personificar usuário
|
impersonatedUserName | string |
Uma identidade de usuário no formato UPN para executar a consulta como outro usuário. |
Devoluções
Resultados da execução da consulta.
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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
Dataset
|
datasetid | True | string |
O identificador exclusivo do conjunto de dados. |
Devoluções
- response
- object
Exportar para arquivo para relatórios do Power BI
Usar a API Rest do Power BI para iniciar a exportação de relatórios do Power BI
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
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 suportados são: PPTX (PowerPoint), PDF e PNG |
|
Localidade
|
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 o relatório inteiro (ao passar páginas específicas, essa propriedade será ignorada). Se não for fornecido, o comportamento padrão é excluir páginas ocultas |
|
|
Nome do marcador
|
name | string |
O nome do marcador |
|
|
Estado do marcador
|
state | string |
O estado do marcador |
|
|
Filter
|
filter | string |
O filtro a aplicar |
|
|
nome_página
|
pageName | string |
O nome da página |
|
|
nome_visual
|
visualName | string |
(Opcional) Nome visual a ser exportado |
|
|
Nome do marcador
|
name | string |
O nome do marcador |
|
|
Estado do marcador
|
state | string |
O estado do marcador |
|
|
Nome de utilizador
|
username | True | string |
O nome de usuário efetivo refletido por um token para aplicar regras RLS (Para o modelo OnPrem, o nome de usuário pode ser composto por caracteres alfanuméricos ou qualquer um dos seguintes caracteres '.', '-', '_', '!', '#', '^', '~', '\', '@', também o nome de usuário não pode conter espaços. Para o modelo Cloud, o nome de usuário pode ser composto por todos os caracteres ASCII. o nome de utilizador deve ter até 256 caracteres) |
|
Conjuntos de dados
|
datasets | array of string |
Uma matriz de conjuntos de dados aos 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) |
|
|
Dados Personalizados
|
customData | string |
O valor de customdata a ser usado para aplicar regras RLS. Suporte apenas para conexões em tempo real com o Azure Analysis Services. |
|
|
Valor de Blob
|
value | True | string |
Token de acesso OAuth2 para SQL Azure |
|
Relatórios
|
reports | array of string |
Uma matriz de relatórios aos quais essa identidade se aplica, suportada apenas para relatórios paginados |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Exportar para arquivo para relatórios paginados
Usar a API Rest do Power BI para iniciar a exportação de relatórios paginados
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
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 suportados são: PPTX (PowerPoint), PDF, ACCESSIBLEPDF (PDF acessível), XLSX (Excel), DOCX (Word), CSV, XML, MHTML e Image (BMP, EMF, GIF, JPEG, PNG ou TIFF). |
|
Nome de utilizador
|
username | True | string |
O nome de usuário efetivo refletido por um token para aplicar regras RLS (Para o modelo OnPrem, o nome de usuário pode ser composto por caracteres alfanuméricos ou qualquer um dos seguintes caracteres '.', '-', '_', '!', '#', '^', '~', '\', '@', também o nome de usuário não pode conter espaços. Para o modelo Cloud, o nome de usuário pode ser composto por todos os caracteres ASCII. o nome de utilizador deve ter até 256 caracteres) |
|
Conjuntos de dados
|
datasets | array of string |
Uma matriz de conjuntos de dados aos 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) |
|
|
Dados Personalizados
|
customData | string |
O valor de customdata a ser usado para aplicar regras RLS. Suporte apenas para conexões em tempo real com o Azure Analysis Services. |
|
|
Valor de Blob
|
value | True | string |
Token de acesso OAuth2 para SQL Azure |
|
Relatórios
|
reports | array of string |
Uma matriz de relatórios aos quais essa identidade se aplica, suportada apenas para relatórios paginados |
|
|
FormatSettings
|
formatSettings | object |
Dicionário de configurações de formato. As chaves são os nomes das propriedades de informações do dispositivo para o formato de arquivo solicitado. |
|
|
nome
|
name | string |
O nome do parâmetro de relatório |
|
|
valor
|
value | string |
O valor do parâmetro de relatório |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Obter check-ins de metas (Pré-visualização)
Obtenha todos os check-ins em uma meta do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
Devoluções
| Name | 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. |
|
Valor
|
value.value | number |
O valor no momento do check-in. |
|
Situação
|
value.status | string |
O status da meta no momento do check-in. |
|
Observações
|
value.notes | GoalNotes |
A lista de notas. |
Obter scorecards (Pré-visualização)
Obtém uma lista de scorecards do Power BI no espaço de trabalho especificado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
Devoluções
Todo o corpo de resposta.
- Consultado em
- ListedScorecards
Obter um check-in de metas (Visualização)
Faça um check-in em uma meta do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Data de check-in
|
goalCheckin | True | date |
Exemplo: 2021-07-21 |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Date
|
timestamp | date |
A data em que o check-in foi feito. |
|
Valor
|
value | number |
O valor no momento do check-in, se definido. |
|
Situação
|
status | string |
O status da meta no momento do check-in. |
|
Observações
|
notes | GoalNotes |
A lista de notas. |
Obter um objetivo (Pré-visualização)
Obtém a meta especificada do Power BI em um scorecard.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
Devoluções
Informações sobre o objetivo.
- Objetivo
- FetchedGoal
Obter várias metas (Visualização)
Obtenha uma lista de metas do Power BI no scorecard especificado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
Devoluções
Todo o corpo de resposta.
- Consultado em
- FetchedGoals
Acionadores
| Botão do Power BI clicado |
Esse gatilho permite executar um fluxo quando um botão do Power BI é clicado. (Disponível apenas para Power Automate.) |
| Quando alguém adiciona ou edita um check-in de meta (Visualização) |
Gatilho para algumas alterações de metas, check-in ou anotações do Power BI. |
| Quando alguém atribui um novo proprietário a uma meta (Visualização) |
Quando alguém atribui um novo proprietário a uma meta do Power BI. |
| Quando o status de uma meta muda (Visualização) |
Quando o status de alguma meta do Power BI muda. |
| Quando o valor atual de uma meta muda (Visualização) |
Quando o valor atual de alguma meta do Power BI muda. |
| Quando um alerta orientado por dados é acionado |
Retorne os detalhes do alerta controlado por dados especificado do Power BI quando o alerta for acionado. |
| Quando uma atualização de dados para uma meta falha (Visualização) |
Quando uma atualização de dados para uma meta do Power BI falha. |
| Quando uma meta muda (Visualização) |
Quando uma propriedade de alguma meta do Power BI é alterada. |
Botão do Power BI clicado
Esse gatilho permite executar um fluxo quando um botão do Power BI é clicado. (Disponível apenas para Power Automate.)
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
alojar
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
headersSchema
|
headersSchema | object | ||
|
esquema
|
schema | object |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
linhas
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
E-mail do usuário
|
headers.x-ms-user-email-encoded | byte |
O endereço de e-mail do usuário que disparou o fluxo. |
|
Nome de utilizador
|
headers.x-ms-user-name-encoded | byte |
O nome para exibição do usuário que disparou o fluxo. |
|
Data e Hora
|
headers.x-ms-user-timestamp | string |
O tempo em que o fluxo foi acionado. |
|
ID do utilizador
|
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 (Visualização)
Gatilho para algumas alterações de metas, check-in ou anotações do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Intervalo de sondagem (seg)
|
pollingInterval | True | number |
Número de segundos entre as verificações de novos dados. O mínimo é de 300. |
Devoluções
Check-ins ou anotações de metas adicionadas ou alteradas.
- Objetivo atualizado
- GoalValueOrNoteUpserted
Quando alguém atribui um novo proprietário a uma meta (Visualização)
Quando alguém atribui um novo proprietário a uma meta do Power BI.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Proprietário
|
owner |
E-mail de um proprietário. Pode ser seu. Pode estar vazio ao rastrear qualquer proprietário. |
||
|
Intervalo de sondagem (seg)
|
pollingInterval | True | number |
Número de segundos entre as verificações de novos dados. O mínimo é de 300. |
Devoluções
Informações sobre metas atribuídas.
- Atribuído
- GoalsAssigned
Quando o status de uma meta muda (Visualização)
Quando o status de alguma meta do Power BI muda.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Intervalo de sondagem (seg)
|
pollingInterval | True | number |
Número de segundos entre as verificações de novos dados. O mínimo é de 300. |
Devoluções
Propriedades da meta alteradas.
- Objetivo alterado
- GoalStatusChanged
Quando o valor atual de uma meta muda (Visualização)
Quando o valor atual de alguma meta do Power BI muda.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Intervalo de sondagem (seg)
|
pollingInterval | True | number |
Número de segundos entre as verificações de novos dados. O mínimo é de 300. |
Devoluções
Propriedades da meta alteradas.
- Objetivo alterado
- GoalValueChanged
Quando um alerta orientado por dados é acionado
Retorne os detalhes do alerta controlado por dados especificado do Power BI quando o alerta for acionado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do alerta
|
alertId | True | string |
O id de alerta a ser rastreado. |
Devoluções
- Body
- EvaluatedAlert
Quando uma atualização de dados para uma meta falha (Visualização)
Quando uma atualização de dados para uma meta do Power BI falha.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Rastrear a origem do destino
|
trackTargetSource | True | string |
Acompanhará o link para o alvo da meta. |
|
Rastrear fonte de valor
|
trackValueSource | True | string |
Acompanhará o link para o valor da meta. |
|
Intervalo de sondagem (seg)
|
pollingInterval | True | number |
Número de segundos entre as verificações de novos dados. O mínimo é de 300. |
Devoluções
Problemas de falha de atualização de meta.
- Falha de atualização
- GoalRefreshIssues
Quando uma meta muda (Visualização)
Quando uma propriedade de alguma meta do Power BI é alterada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Espaço de trabalho
|
groupid | True | string |
O identificador exclusivo do espaço de trabalho. |
|
ID do scorecard
|
scorecardId | True | string |
O identificador exclusivo do scorecard. |
|
Id da meta
|
goalId | True | string |
O identificador exclusivo do objetivo. |
|
Intervalo de sondagem (seg)
|
pollingInterval | True | number |
Número de segundos entre as verificações de novos dados. O mínimo é de 300. |
Devoluções
Propriedades da meta alteradas.
- Objetivo alterado
- GoalChanged
Definições
QueryExecutionResults
Resultados da execução da consulta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Primeiras linhas da tabela
|
firstTableRows | array of object |
Resultados da consulta como uma matriz de linhas. |
CreatedScorecard
Scorecard criado.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
O identificador exclusivo do scorecard. |
ListedScorecards
Todo o corpo de resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Cartões de Pontuação
|
value | array of ListedScorecard |
A lista de scorecards. |
ListedScorecard
Scorecard.
| Name | 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
Todo o corpo de resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Objetivos
|
value | array of FetchedGoal |
A lista dos golos. |
FetchedGoal
Informações sobre o objetivo.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
O identificador exclusivo do objetivo. |
|
Nome
|
name | string |
O nome do gol. |
|
Proprietário
|
owner |
O endereço de e-mail 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. Exemplo: 2021-07-29. |
|
ID da meta pai
|
parentId | string |
Se essa meta for uma submeta, a id exclusiva de sua meta pai. |
|
Valor atual
|
currentValue | number |
O valor atual da meta que está sendo rastreada. |
|
Carimbo de data/hora do valor atual
|
currentValueTimestamp | date |
O carimbo de data/hora quando o valor atual da meta foi definido. |
|
Valor alvo
|
targetValue | number |
O valor-alvo da meta. |
|
Carimbo de data/hora do valor de destino
|
targetValueTimestamp | date |
O carimbo de data/hora quando o valor alvo da meta foi definido. |
|
Situação
|
status | string |
O status do objetivo. |
|
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 deste objetivo. |
|
Data do ciclo de acompanhamento
|
cyclePeriod | date |
Data para descobrir propriedades extras do ciclo de rastreamento. |
GoalChanged
Propriedades da meta alteradas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
O identificador exclusivo do objetivo. |
|
Nome antigo
|
oldName | string |
O nome do gol. |
|
Antigo proprietário
|
oldOwner |
O endereço de e-mail 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. Exemplo: 2021-07-29. |
|
ID do gol pai antigo
|
oldParentId | string |
Se essa meta for uma submeta, a id exclusiva de sua meta pai. |
|
Valor atual antigo
|
oldCurrentValue | number |
O valor atual da meta que está sendo rastreada. |
|
Valor alvo antigo
|
oldTargetValue | number |
O valor-alvo da meta. |
|
Estatuto antigo
|
oldStatus | string |
O status do objetivo. |
|
Frequência antiga
|
oldCycle | string |
Intervalo de frequência do ciclo de rastreamento antigo mostrado nos visuais deste objetivo. |
|
Data antiga do ciclo de rastreamento
|
oldCyclePeriod | date |
Data antiga para descobrir propriedades extras do ciclo de rastreamento. |
|
Novo nome
|
newName | string |
O nome do gol. |
|
Novo proprietário
|
newOwner |
O endereço de e-mail 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. |
|
Novo ID de meta pai
|
newParentId | string |
Se essa meta for uma submeta, a id exclusiva de sua meta pai. |
|
Novo valor atual
|
newCurrentValue | number |
O valor atual da meta que está sendo rastreada. |
|
Novo valor-alvo
|
newTargetValue | number |
O valor-alvo da meta. |
|
Novo estatuto
|
newStatus | string |
O status do objetivo. |
|
Nova frequência
|
newCycle | string |
Novo intervalo de ciclo de acompanhamento mostrado nos visuais deste objetivo. |
|
Nova data do ciclo de acompanhamento
|
newCyclePeriod | date |
Nova data para descobrir propriedades extras do ciclo de rastreamento. |
|
Lista de alterações
|
changeList | string |
Lista de alterações separada por vírgula. Exemplo: 'status,currentValue'. |
GoalStatusChanged
Propriedades da meta alteradas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
O identificador exclusivo do objetivo. |
|
Estatuto antigo
|
oldStatus | string |
O status do objetivo. |
|
Novo estatuto
|
newStatus | string |
O status do objetivo. |
ObjetivoValorAlterado
Propriedades da meta alteradas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
O identificador exclusivo do objetivo. |
|
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.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Issues
|
issues | array of GoalRefreshIssue |
Problemas de atualização da meta. |
GoalRefreshIssue
Problema de atualização da meta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tipo de ligação
|
connectionType | string |
O tipo de conexão, Atual ou Alvo. |
|
Data e Hora
|
timestamp | string |
O carimbo de data/hora de quando a atualização com falha aconteceu. |
|
Mensagem de erro
|
message | string |
Descrição do erro. |
MetasAtribuídas
Informações sobre metas atribuídas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Objetivos
|
assignedGoals | array of object |
A lista de metas que foram atribuídas ao novo proprietário. |
|
Id
|
assignedGoals.id | string |
Id único do gol. |
|
ID do scorecard
|
assignedGoals.scorecardId | string |
O identificador exclusivo do scorecard. |
|
Nome
|
assignedGoals.name | string |
O nome do gol. |
|
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 ser concluída até. |
GoalValueOrNoteUpserted
Check-ins ou anotações de metas adicionadas ou alteradas.
| Name | 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. |
|
Valor
|
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. |
|
Observações
|
notes | array of object |
Notas adicionadas ou alteradas. |
|
Data de check-in
|
notes.valueTimestamp | date |
A data do check-in ao qual esta nota foi adicionada. |
|
Texto
|
notes.body | string |
Texto da nota recém-adicionada. |
|
Tempo criado
|
notes.createdTime | datetime |
A data em que a nota foi criada. |
Notas de Gol
A lista de notas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto
|
body | string |
O conteúdo da nota. |
|
Tempo criado
|
createdTime | datetime |
A data em que a nota foi criada. |
AvaliadoAlert
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Título do alerta
|
alertTitle | string |
O título do alerta. |
|
Limiar de alerta
|
alertThreshold | number |
O limiar a partir do qual o alerta é acionado. |
|
O alerta é acionado
|
isAlertTriggered | boolean |
Um valor booleano (true, false) que determina se o alerta foi acionado ou não. |
|
URL do mosaico
|
tileUrl | string |
URL com ligação ao mosaico do painel onde o alerta está configurado. |
|
Valor do mosaico
|
tileValue |
O valor do bloco. |
binário
Este é o tipo de dados básico 'binário'.
objecto
Este é o tipo 'objeto'.