Power BI
Power BI es un conjunto de herramientas de análisis empresarial para analizar datos y compartir información. Conéctese para obtener acceso sencillo a los datos en los paneles, informes y conjuntos de datos de Power BI.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps |
| Power Apps | Estándar | Todas las regiones de Power Apps |
| Power Automate | Estándar | Todas las regiones de Power Automate |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL | https://powerbi.microsoft.com/en-us/support/ |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://powerbi.microsoft.com/ |
| Directiva de privacidad | https://privacy.microsoft.com/privacystatement |
| Categorías | Business Intelligence; Sitio web |
Para usar esta integración, necesitará acceso a una cuenta de Power BI. Para establecer una conexión, seleccione Iniciar sesión. Se le pedirá que proporcione su cuenta, siga el resto de las pantallas para crear una conexión.
Al usar la conexión, es posible que tenga que tener determinadas configuraciones en la cuenta de Power BI. Por ejemplo, para usar los desencadenadores de alertas controladas por datos, ya debe tener configurada una alerta controlada por datos.
Ya está listo para empezar a usar esta integración.
Problemas y limitaciones conocidos
El conector de Power BI no es compatible con los clústeres de nube soberana de Power BI (es decir, China, Alemania y los clústeres de la Administración Pública de Estados Unidos).
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualización de una comprobación (versión preliminar) |
Actualiza una comprobación de objetivos de Power BI. |
| Actualizar un conjunto de datos |
Use la API rest de Power BI para actualizar un conjunto de datos de Powerbi. |
| Actualizar un objetivo (versión preliminar) |
Actualiza el estado del objetivo de Power BI. |
| Adición de filas a un conjunto de datos |
Use la API REST de Power BI para agregar filas a un conjunto de datos. |
| Agregar una nota a una entrada (versión preliminar) |
Anexa una nueva nota a una comprobación de un objetivo de Power BI. |
| Creación de un objetivo (versión preliminar) |
Crea un objetivo de Power BI en el cuadro de mandos especificado. |
| Creación de una comprobación (versión preliminar) |
Crea una comprobación de objetivos de Power BI. |
| Crear un cuadro de mandos (versión preliminar) |
Crea un cuadro de mandos para los objetivos de Power BI. |
| Ejecución de una consulta en un conjunto de datos |
Use la API rest de Power BI para ejecutar una consulta. |
| Ejecución de una consulta json en un conjunto de datos |
Use la API REST de Power BI para ejecutar una consulta en formato json. |
| Exportar a archivo para informes de Power BI |
Uso de la API rest de Power BI para iniciar la exportación de informes de Power BI |
| Exportar a archivo para informes paginados |
Uso de la API rest de Power BI para iniciar la exportación de informes paginados |
| Obtención de las comprobaciones de objetivos (versión preliminar) |
Obtenga todas las comprobaciones en un objetivo de Power BI. |
| Obtención de una comprobación de objetivos (versión preliminar) |
Obtenga un registro en un objetivo de Power BI. |
| Obtener cuadros de mandos (versión preliminar) |
Obtiene una lista de cuadros de mandos de Power BI en el área de trabajo especificada. |
| Obtener un objetivo (versión preliminar) |
Obtiene el objetivo de Power BI especificado en un cuadro de mandos. |
| Obtener varios objetivos (versión preliminar) |
Obtenga una lista de objetivos de Power BI en el cuadro de mandos especificado. |
Actualización de una comprobación (versión preliminar)
Actualiza una comprobación de objetivos de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Fecha de registro
|
goalCheckin | True | date |
Ejemplo: 2021-07-21 |
|
Importancia
|
value | number | ||
|
Estado
|
status | string |
Estado del objetivo. |
Actualizar un conjunto de datos
Use la API rest de Power BI para actualizar un conjunto de datos de Powerbi.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Dataset
|
datasetid | True | string |
Identificador único del conjunto de datos. |
Actualizar un objetivo (versión preliminar)
Actualiza el estado del objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Nombre
|
name | string |
Si se proporciona, el nuevo nombre del objetivo. |
|
|
Propietario
|
owner |
Si se proporciona, la dirección de correo electrónico del nuevo propietario del objetivo. |
||
|
Valor actual
|
value | number |
Si se proporciona, establece el nuevo valor del objetivo. |
|
|
Valor del objetivo
|
target | number |
Si se proporciona, establece el nuevo destino de objetivo. |
|
|
Estado
|
status | string |
Si se proporciona, establece el nuevo estado del objetivo. |
|
|
Fecha de inicio
|
startDate | date |
Si se proporciona, la nueva fecha de inicio del objetivo. Ejemplo: 2021-07-15. |
|
|
Fecha de finalización
|
completionDate | date |
Si se proporciona, la nueva fecha para que el objetivo se complete. Ejemplo: 2021-07-29. |
Adición de filas a un conjunto de datos
Use la API REST de Power BI para agregar filas a un conjunto de datos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Dataset
|
datasetid | True | string |
Identificador único del conjunto de datos. |
|
Table
|
tablename | True | string |
Nombre de la tabla. |
|
Carga que se va a enviar
|
Payload | dynamic |
Agregar una nota a una entrada (versión preliminar)
Anexa una nueva nota a una comprobación de un objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Fecha de registro
|
goalCheckin | True | date |
Ejemplo: 2021-07-21 |
|
Nota:
|
note | True | string |
Puede ser texto multilínea |
Creación de un objetivo (versión preliminar)
Crea un objetivo de Power BI en el cuadro de mandos especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Nombre
|
name | True | string |
Nombre del objetivo. |
|
Propietario
|
owner |
Dirección de correo electrónico del propietario del objetivo. Ejemplo: foo@bar.com |
||
|
Valor actual
|
value | string |
Valor actual del objetivo al que se realiza el seguimiento. |
|
|
Valor del objetivo
|
target | string |
Valor de destino del objetivo. |
|
|
Estado
|
status | string |
Estado actual del objetivo. |
|
|
Fecha de inicio
|
startDate | date |
Fecha de inicio del objetivo. Ejemplo: 2021-07-15. |
|
|
Fecha de finalización
|
completionDate | date |
Fecha de finalización del objetivo. Ejemplo: 2021-07-29. |
|
|
Nota:
|
note | string |
Tenga en cuenta que debe asociarse a la creación inicial del registro en el objetivo. Puede ser texto multilínea |
|
|
Id. de objetivo primario
|
parentId | string |
Si este objetivo es un subgoal, el identificador único de su objetivo primario. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del objetivo. |
Creación de una comprobación (versión preliminar)
Crea una comprobación de objetivos de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Fecha
|
timestamp | True | date |
Fecha de entrada. Ejemplo: 2021-07-21 |
|
Importancia
|
value | number | ||
|
Estado
|
status | string |
Estado del objetivo. |
|
|
Nota:
|
note | string |
Puede ser texto multilínea |
Crear un cuadro de mandos (versión preliminar)
Crea un cuadro de mandos para los objetivos de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Nombre
|
name | True | string |
Nombre del cuadro de mandos |
|
Description
|
description | string |
Descripción del cuadro de mandos |
Devoluciones
Se ha creado el cuadro de mandos.
- Cuadro de mandos creado
- CreatedScorecard
Ejecución de una consulta en un conjunto de datos
Use la API rest de Power BI para ejecutar una consulta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Dataset
|
datasetid | True | string |
Identificador único del conjunto de datos. |
|
Texto de consulta
|
query | True | string |
Texto de la consulta. Puede ser texto de varias líneas. |
|
Valores NULL incluidos
|
includeNulls | boolean |
Debe incluirse valores NULL en los resultados. El valor predeterminado es No. |
|
|
Suplantar usuario
|
impersonatedUserName | string |
Una identidad de usuario en formato UPN para ejecutar la consulta como otro usuario. |
Devoluciones
Resultados de la ejecución de la consulta.
Ejecución de una consulta json en un conjunto de datos
Use la API REST de Power BI para ejecutar una consulta en formato json.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Dataset
|
datasetid | True | string |
Identificador único del conjunto de datos. |
Devoluciones
- response
- object
Exportar a archivo para informes de Power BI
Uso de la API rest de Power BI para iniciar la exportación de informes de Power BI
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Informe
|
reportid | True | string |
Identificador único de un informe pbi. |
|
Formato de exportación
|
format | True | string |
Formato de exportación del informe de Power BI. Los formatos admitidos son: PPTX (PowerPoint), PDF y PNG |
|
Configuración regional
|
locale | string |
Configuración regional que se va a aplicar |
|
|
Incluir páginas ocultas
|
includeHiddenPages | boolean |
Marca que indica si se deben incluir páginas ocultas al exportar todo el informe (al pasar páginas específicas, se omitirá esta propiedad). Si no se proporciona, el comportamiento predeterminado es excluir páginas ocultas. |
|
|
Nombre del marcador
|
name | string |
Nombre del marcador |
|
|
Estado del marcador
|
state | string |
Estado del marcador |
|
|
Filter
|
filter | string |
Filtro que se va a aplicar |
|
|
pageName
|
pageName | string |
El nombre de la página |
|
|
visualName
|
visualName | string |
(Opcional) Nombre visual que se va a exportar |
|
|
Nombre del marcador
|
name | string |
Nombre del marcador |
|
|
Estado del marcador
|
state | string |
Estado del marcador |
|
|
Nombre de usuario
|
username | True | string |
El nombre de usuario efectivo reflejado por un token para aplicar reglas RLS (para el modelo OnPrem, el nombre de usuario puede estar compuesto por caracteres alfanuméricos o cualquiera de los siguientes caracteres '.', '-', '_', '!', '#', '^', '~', '\', '@', también el nombre de usuario no puede contener espacios. Para el modelo en la nube, el nombre de usuario se puede componer de todos los caracteres ASCII. username debe tener hasta 256 caracteres) |
|
Datasets
|
datasets | array of string |
Matriz de conjuntos de datos para los que se aplica esta identidad |
|
|
Funciones
|
roles | array of string |
Matriz de roles RLS reflejados por un token al aplicar reglas de RLS (la identidad puede contener hasta 50 roles, el rol se puede componer de cualquier carácter además de "", y debe tener hasta 50 caracteres). |
|
|
CustomData
|
customData | string |
Valor de customdata que se va a usar para aplicar reglas de RLS. Solo se admite para conexiones dinámicas a Azure Analysis Services. |
|
|
Valor de blob
|
value | True | string |
Token de acceso de OAuth2 para SQL Azure |
|
Informes
|
reports | array of string |
Matriz de informes para los que se aplica esta identidad, solo se admite para los informes paginados. |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Exportar a archivo para informes paginados
Uso de la API rest de Power BI para iniciar la exportación de informes paginados
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Informe
|
reportid | True | string |
Identificador único de un informe paginado. |
|
Formato de exportación
|
format | True | string |
Formato de exportación del informe paginado. Los formatos admitidos son: PPTX (PowerPoint), PDF, ACCESSIBLEPDF (PDF accesible), XLSX (Excel), DOCX (Word), CSV, XML, MHTML e Image (BMP, EMF, GIF, JPEG, PNG o TIFF). |
|
Nombre de usuario
|
username | True | string |
El nombre de usuario efectivo reflejado por un token para aplicar reglas RLS (para el modelo OnPrem, el nombre de usuario puede estar compuesto por caracteres alfanuméricos o cualquiera de los siguientes caracteres '.', '-', '_', '!', '#', '^', '~', '\', '@', también el nombre de usuario no puede contener espacios. Para el modelo en la nube, el nombre de usuario se puede componer de todos los caracteres ASCII. username debe tener hasta 256 caracteres) |
|
Datasets
|
datasets | array of string |
Matriz de conjuntos de datos para los que se aplica esta identidad |
|
|
Funciones
|
roles | array of string |
Matriz de roles RLS reflejados por un token al aplicar reglas de RLS (la identidad puede contener hasta 50 roles, el rol se puede componer de cualquier carácter además de "", y debe tener hasta 50 caracteres). |
|
|
CustomData
|
customData | string |
Valor de customdata que se va a usar para aplicar reglas de RLS. Solo se admite para conexiones dinámicas a Azure Analysis Services. |
|
|
Valor de blob
|
value | True | string |
Token de acceso de OAuth2 para SQL Azure |
|
Informes
|
reports | array of string |
Matriz de informes para los que se aplica esta identidad, solo se admite para los informes paginados. |
|
|
FormatSettings
|
formatSettings | object |
Diccionario de opciones de configuración de formato. Las claves son los nombres de propiedad de información del dispositivo para el formato de archivo solicitado. |
|
|
nombre
|
name | string |
Nombre del parámetro del informe |
|
|
value
|
value | string |
Valor del parámetro del informe |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Obtención de las comprobaciones de objetivos (versión preliminar)
Obtenga todas las comprobaciones en un objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Check-ins
|
value | array of object |
Lista de check-ins. |
|
Fecha
|
value.timestamp | datetime |
Fecha en que se realizó el registro de entrada. |
|
Importancia
|
value.value | number |
Valor en el momento de la entrada. |
|
Estado
|
value.status | string |
Estado del objetivo en el momento del registro de entrada. |
|
Notas
|
value.notes | GoalNotes |
Lista de notas. |
Obtención de una comprobación de objetivos (versión preliminar)
Obtenga un registro en un objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Fecha de registro
|
goalCheckin | True | date |
Ejemplo: 2021-07-21 |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Fecha
|
timestamp | date |
Fecha en que se realizó el registro de entrada. |
|
Importancia
|
value | number |
Valor en el momento de la comprobación, si se establece. |
|
Estado
|
status | string |
Estado del objetivo en el momento del registro de entrada. |
|
Notas
|
notes | GoalNotes |
Lista de notas. |
Obtener cuadros de mandos (versión preliminar)
Obtiene una lista de cuadros de mandos de Power BI en el área de trabajo especificada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
Devoluciones
Cuerpo completo de la respuesta.
- Obtenido
- ListedScorecards
Obtener un objetivo (versión preliminar)
Obtiene el objetivo de Power BI especificado en un cuadro de mandos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
Devoluciones
Información del objetivo.
- Objetivo
- FetchedGoal
Obtener varios objetivos (versión preliminar)
Obtenga una lista de objetivos de Power BI en el cuadro de mandos especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
Devoluciones
Cuerpo completo de la respuesta.
- Obtenido
- FetchedGoals
Desencadenadores
| Botón de Power BI en el que se ha clic |
Este desencadenador permite ejecutar un flujo cuando se hace clic en un botón de Power BI. (Solo disponible para Power Automate). |
| Cuando alguien agrega o edita una comprobación de objetivos (versión preliminar) |
Desencadenador para algunas comprobaciones de objetivos de Power BI o cambios en la nota. |
| Cuando alguien asigna un nuevo propietario a un objetivo (versión preliminar) |
Cuando alguien asigna un nuevo propietario a un objetivo de Power BI. |
| Cuando cambia el estado de un objetivo (versión preliminar) |
Cuando cambia el estado de algún objetivo de Power BI. |
| Cuando cambia el valor actual de un objetivo (versión preliminar) |
Cuando cambia el valor actual de algunos objetivos de Power BI. |
| Cuando cambia un objetivo (versión preliminar) |
Cuando cambia una propiedad de algún objetivo de Power BI. |
| Cuando se desencadena una alerta controlada por datos |
Devuelve los detalles de la alerta controlada por datos especificada de Power BI cuando se desencadenó la alerta. |
| Cuando se produce un error en una actualización de datos para un objetivo (versión preliminar) |
Cuando se produce un error en una actualización de datos para un objetivo de Power BI. |
Botón de Power BI en el que se ha clic
Este desencadenador permite ejecutar un flujo cuando se hace clic en un botón de Power BI. (Solo disponible para Power Automate).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
headersSchema
|
headersSchema | object | ||
|
schema
|
schema | object |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Filas
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
Correo electrónico de usuario
|
headers.x-ms-user-email-encoded | byte |
Dirección de correo electrónico del usuario que desencadenó el flujo. |
|
Nombre de usuario
|
headers.x-ms-user-name-encoded | byte |
Nombre para mostrar del usuario que desencadenó el flujo. |
|
Marca de tiempo
|
headers.x-ms-user-timestamp | string |
Hora en que se desencadenó el flujo. |
|
Id. de usuario
|
headers.x-ms-user-id | guid |
Identificador único del usuario que desencadenó el flujo en AAD. |
Cuando alguien agrega o edita una comprobación de objetivos (versión preliminar)
Desencadenador para algunas comprobaciones de objetivos de Power BI o cambios en la nota.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Intervalo de sondeo (s)
|
pollingInterval | True | number |
Número de segundos entre comprobaciones de nuevos datos. El mínimo es 300. |
Devoluciones
Se han agregado o cambiado las comprobaciones de objetivos o notas.
- Objetivo actualizado
- GoalValueOrNoteUpserted
Cuando alguien asigna un nuevo propietario a un objetivo (versión preliminar)
Cuando alguien asigna un nuevo propietario a un objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Propietario
|
owner |
Correo electrónico de un propietario. Puede ser tuyo. Puede estar vacío al realizar el seguimiento de cualquier propietario. |
||
|
Intervalo de sondeo (s)
|
pollingInterval | True | number |
Número de segundos entre comprobaciones de nuevos datos. El mínimo es 300. |
Devoluciones
Información de objetivos asignados.
- Asignado
- GoalsAssigned
Cuando cambia el estado de un objetivo (versión preliminar)
Cuando cambia el estado de algún objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Intervalo de sondeo (s)
|
pollingInterval | True | number |
Número de segundos entre comprobaciones de nuevos datos. El mínimo es 300. |
Devoluciones
Se cambiaron las propiedades del objetivo.
- Objetivo cambiado
- GoalStatusChanged
Cuando cambia el valor actual de un objetivo (versión preliminar)
Cuando cambia el valor actual de algunos objetivos de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Intervalo de sondeo (s)
|
pollingInterval | True | number |
Número de segundos entre comprobaciones de nuevos datos. El mínimo es 300. |
Devoluciones
Se cambiaron las propiedades del objetivo.
- Objetivo cambiado
- GoalValueChanged
Cuando cambia un objetivo (versión preliminar)
Cuando cambia una propiedad de algún objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Intervalo de sondeo (s)
|
pollingInterval | True | number |
Número de segundos entre comprobaciones de nuevos datos. El mínimo es 300. |
Devoluciones
Se cambiaron las propiedades del objetivo.
- Objetivo cambiado
- GoalChanged
Cuando se desencadena una alerta controlada por datos
Devuelve los detalles de la alerta controlada por datos especificada de Power BI cuando se desencadenó la alerta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de alerta
|
alertId | True | string |
Identificador de alerta que se va a realizar. |
Devoluciones
- Body
- EvaluatedAlert
Cuando se produce un error en una actualización de datos para un objetivo (versión preliminar)
Cuando se produce un error en una actualización de datos para un objetivo de Power BI.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Identificador único del área de trabajo. |
|
Id. del cuadro de mandos
|
scorecardId | True | string |
Identificador único del cuadro de mandos. |
|
Id. de objetivo
|
goalId | True | string |
Identificador único del objetivo. |
|
Seguimiento del origen de destino
|
trackTargetSource | True | string |
Realizará un seguimiento del vínculo del objetivo. |
|
Seguimiento del origen del valor
|
trackValueSource | True | string |
Realizará un seguimiento del vínculo del valor del objetivo. |
|
Intervalo de sondeo (s)
|
pollingInterval | True | number |
Número de segundos entre comprobaciones de nuevos datos. El mínimo es 300. |
Devoluciones
Problemas de error de actualización de objetivos.
- Error de actualización
- GoalRefreshIssues
Definiciones
QueryExecutionResults
Resultados de la ejecución de la consulta.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Primeras filas de tabla
|
firstTableRows | array of object |
Resultados de la consulta como una matriz de filas. |
CreatedScorecard
Se ha creado el cuadro de mandos.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del cuadro de mandos. |
ListedScorecards
Cuerpo completo de la respuesta.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tarjetas de puntuación
|
value | array of ListedScorecard |
Lista de cuadros de mandos. |
ListedScorecard
Scorecard.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del cuadro de mandos. |
|
Nombre
|
name | string |
Nombre del cuadro de mandos. |
|
Contacto
|
contact | string |
Información de contacto del cuadro de mandos. |
FetchedGoals
Cuerpo completo de la respuesta.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Objetivos
|
value | array of FetchedGoal |
Lista de los objetivos. |
FetchedGoal
Información del objetivo.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del objetivo. |
|
Nombre
|
name | string |
Nombre del objetivo. |
|
Propietario
|
owner |
Dirección de correo electrónico del propietario del objetivo. |
|
|
Fecha de inicio
|
startDate | date |
Fecha de inicio del objetivo. Ejemplo: 2021-07-15. |
|
Fecha de finalización
|
completionDate | date |
Fecha de vencimiento del objetivo que se va a completar. Ejemplo: 2021-07-29. |
|
Id. de objetivo primario
|
parentId | string |
Si este objetivo es un subgoal, el identificador único de su objetivo primario. |
|
Valor actual
|
currentValue | number |
Valor actual del objetivo al que se realiza el seguimiento. |
|
Marca de tiempo del valor actual
|
currentValueTimestamp | date |
Marca de tiempo cuando se estableció el valor actual del objetivo. |
|
Valor del objetivo
|
targetValue | number |
Valor de destino del objetivo. |
|
Marca de tiempo de valor de destino
|
targetValueTimestamp | date |
Marca de tiempo cuando se estableció el valor de destino del objetivo. |
|
Estado
|
status | string |
Estado del objetivo. |
|
Marca de tiempo de estado
|
statusTimestamp | date |
Marca de tiempo cuando se estableció el estado del objetivo. |
|
Frecuencia
|
cycle | string |
Intervalo de frecuencia del ciclo de seguimiento que se muestra en los objetos visuales de este objetivo. |
|
Fecha del ciclo de seguimiento
|
cyclePeriod | date |
Fecha para averiguar las propiedades adicionales del ciclo de seguimiento. |
GoalChanged
Se cambiaron las propiedades del objetivo.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del objetivo. |
|
Nombre antiguo
|
oldName | string |
Nombre del objetivo. |
|
Propietario anterior
|
oldOwner |
Dirección de correo electrónico del propietario del objetivo. |
|
|
Fecha de inicio anterior
|
oldStartDate | date |
Fecha de inicio del objetivo. Ejemplo: 2021-07-15. |
|
Fecha de finalización anterior
|
oldCompletionDate | date |
Fecha de vencimiento del objetivo que se va a completar. Ejemplo: 2021-07-29. |
|
Id. de objetivo primario antiguo
|
oldParentId | string |
Si este objetivo es un subgoal, el identificador único de su objetivo primario. |
|
Valor actual anterior
|
oldCurrentValue | number |
Valor actual del objetivo al que se realiza el seguimiento. |
|
Valor de destino antiguo
|
oldTargetValue | number |
Valor de destino del objetivo. |
|
Estado anterior
|
oldStatus | string |
Estado del objetivo. |
|
Frecuencia antigua
|
oldCycle | string |
Intervalo de frecuencia del ciclo de seguimiento antiguo que se muestra en los objetos visuales de este objetivo. |
|
Fecha del ciclo de seguimiento anterior
|
oldCyclePeriod | date |
Fecha antigua para averiguar propiedades adicionales del ciclo de seguimiento. |
|
Nuevo nombre
|
newName | string |
Nombre del objetivo. |
|
Nuevo propietario
|
newOwner |
Dirección de correo electrónico del propietario del objetivo. |
|
|
Nueva fecha de inicio
|
newStartDate | date |
Fecha de inicio del objetivo. |
|
Nueva fecha de finalización
|
newCompletionDate | date |
Fecha de vencimiento del objetivo que se va a completar. |
|
Nuevo identificador de objetivo primario
|
newParentId | string |
Si este objetivo es un subgoal, el identificador único de su objetivo primario. |
|
Nuevo valor actual
|
newCurrentValue | number |
Valor actual del objetivo al que se realiza el seguimiento. |
|
Nuevo valor de destino
|
newTargetValue | number |
Valor de destino del objetivo. |
|
Nuevo estado
|
newStatus | string |
Estado del objetivo. |
|
Nueva frecuencia
|
newCycle | string |
Nuevo intervalo de ciclo de seguimiento que se muestra en los objetos visuales de este objetivo. |
|
Nueva fecha del ciclo de seguimiento
|
newCyclePeriod | date |
Nueva fecha para averiguar las propiedades adicionales del ciclo de seguimiento. |
|
Lista de cambios
|
changeList | string |
Lista separada por comas de cambios. Ejemplo: "status,currentValue". |
GoalStatusChanged
Se cambiaron las propiedades del objetivo.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del objetivo. |
|
Estado anterior
|
oldStatus | string |
Estado del objetivo. |
|
Nuevo estado
|
newStatus | string |
Estado del objetivo. |
GoalValueChanged
Se cambiaron las propiedades del objetivo.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
id | string |
Identificador único del objetivo. |
|
Valor actual anterior
|
oldCurrentValue | number |
Valor actual del objetivo al que se realiza el seguimiento. |
|
Nuevo valor actual
|
newCurrentValue | number |
Valor actual del objetivo al que se realiza el seguimiento. |
GoalRefreshIssues
Problemas de error de actualización de objetivos.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Problemas
|
issues | array of GoalRefreshIssue |
Problemas de actualización de objetivos. |
GoalRefreshIssue
Problema de actualización del objetivo.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tipo de conexión
|
connectionType | string |
Tipo de conexión, actual o destino. |
|
Marca de tiempo
|
timestamp | string |
Marca de tiempo de cuando se produjo la actualización con errores. |
|
Mensaje de error
|
message | string |
Descripción del error. |
GoalsAssigned
Información de objetivos asignados.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Objetivos
|
assignedGoals | array of object |
Lista de objetivos asignados al nuevo propietario. |
|
Id
|
assignedGoals.id | string |
Identificador único del objetivo. |
|
Id. del cuadro de mandos
|
assignedGoals.scorecardId | string |
Identificador único del cuadro de mandos. |
|
Nombre
|
assignedGoals.name | string |
Nombre del objetivo. |
|
Propietario
|
assignedGoals.owner | string |
Nuevo propietario al que se asignó el objetivo. |
|
Última modificación
|
assignedGoals.lastModifiedBy | string |
Usuario que modificó por última vez el objetivo. |
|
Fecha de inicio
|
assignedGoals.startDate | date |
Fecha de inicio del objetivo. |
|
Fecha de finalización
|
assignedGoals.completionDate | date |
Fecha de finalización del objetivo. |
GoalValueOrNoteUpserted
Se han agregado o cambiado las comprobaciones de objetivos o notas.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Check-ins
|
values | array of object |
Se agregaron o actualizaron las comprobaciones. |
|
Fecha
|
values.timestamp | date |
Fecha en que se realizó el registro de entrada. |
|
Importancia
|
values.value | number |
Valor del objetivo en el momento del registro de entrada. |
|
Estado
|
values.status | string |
Estado del objetivo en el momento del registro de entrada. |
|
Notas
|
notes | array of object |
Notas agregadas o modificadas. |
|
Fecha de registro
|
notes.valueTimestamp | date |
Fecha del registro de entrada a la que se agregó esta nota. |
|
Mensaje de texto
|
notes.body | string |
Texto de la nota recién agregada. |
|
Tiempo creado
|
notes.createdTime | datetime |
Fecha en que se creó la nota. |
GoalNotes
Lista de notas.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Mensaje de texto
|
body | string |
Contenido de la nota. |
|
Tiempo creado
|
createdTime | datetime |
Fecha en que se creó la nota. |
EvaluatedAlert
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Título de la alerta
|
alertTitle | string |
Título de la alerta. |
|
Umbral de alerta
|
alertThreshold | number |
Umbral en el que se desencadena la alerta. |
|
¿Se desencadena la alerta?
|
isAlertTriggered | boolean |
Valor booleano (true, false) que determina si se desencadenó o no la alerta. |
|
Dirección URL del icono
|
tileUrl | string |
Vinculación de dirección URL al icono del panel donde se configura la alerta. |
|
Valor de icono
|
tileValue |
Valor del icono. |
binario
Este es el tipo de datos básico "binary".
objeto
Este es el tipo 'object'.