Dashboards - Replace Dashboards

Referencia

Servicio:: Dashboard

Versión de la API:: 7.1-preview.3

Actualice el nombre y la posición de los paneles en el grupo proporcionado y quite los paneles omitidos. No modifica el contenido del panel.

PUT https://dev.azure.com/{organization}/{project}/{team}/_apis/dashboard/dashboards?api-version=7.1-preview.3

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	Nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
team	path		string	Id. de equipo o nombre del equipo
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1-preview.3" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
dashboardEntries	DashboardGroupEntry[]	Lista de paneles mantenidos por el grupo de paneles
permission	GroupMemberPermission	En desuso: el modelo de permisos anterior que describe el nivel de permisos para el equipo actual. Pre-M125.
teamDashboardPermission	TeamDashboardPermission	Máscara de bits de permisos que describe los permisos de seguridad del equipo actual para los paneles. Cuando este permiso es el valor None, use GroupMemberPermission. Los permisos se evalúan en función de la presencia de un valor distinto de None; de lo contrario, se guardará GroupMemberPermission.
url	string

Respuestas

Nombre	Tipo	Description
200 OK	DashboardGroup	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Ámbitos

Nombre	Description
vso.dashboards_manage	Concede la capacidad de administrar la información del panel del equipo

Ejemplos

Solicitud de ejemplo

HTTP

PUT https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/dashboard/dashboards?api-version=7.1-preview.3

{
  "widgets": []
}

Respuesta de muestra

status code:: 200

{
  "widgets": [],
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf"
    },
    "group": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/Groups/999ef3b4-93e1-4086-86c2-5e8bd24512c7"
    }
  },
  "id": "7562562a-4f9f-4258-94a9-b048b1c817cf",
  "name": "Dashboard98",
  "position": 2,
  "refreshInterval": 5
}

Definiciones

Nombre	Description
Dashboard	Modelo de un panel.
DashboardGroup	Describe una lista de paneles asociados a un propietario. Actualmente, los equipos poseen grupos de paneles.
DashboardGroupEntry	Entrada del grupo de paneles, ajuste alrededor del panel (¿es necesario?)
DashboardScope	Ámbito del panel. Puede ser Project o Project_Team
GroupMemberPermission	En desuso: el modelo de permisos anterior que describe el nivel de permisos para el equipo actual. Pre-M125.
LightboxOptions	Configuración de Lightbox
ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
SemanticVersion	control de versiones de un artefacto tal como se describe en: http://semver.org/, con el formato major.minor.patch.
TeamDashboardPermission	Máscara de bits de permisos que describe los permisos de seguridad del equipo actual para los paneles. Cuando este permiso es el valor None, use GroupMemberPermission. Los permisos se evalúan en función de la presencia de un valor distinto de None; de lo contrario, se guardará GroupMemberPermission.
Widget	Datos del widget
WidgetPosition
WidgetSize

Dashboard

Object

Modelo de un panel.

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
dashboardScope	DashboardScope	Entidad a la que se limita el panel.
description	string	Descripción del panel.
eTag	string	Valor de seguimiento de versiones definido por el servidor, que se usa para la detección de colisiones de edición.
groupId	string (uuid)	Identificador del grupo de un panel. En el caso de los paneles con ámbito de equipo, este es el identificador único del equipo asociado al panel. En el caso de los paneles con ámbito de proyecto, esta propiedad está vacía.
id	string (uuid)	Id. del panel. Proporcionado por el servicio en el momento de la creación.
lastAccessedDate	string (date-time)	Fecha de último acceso al panel.
modifiedBy	string (uuid)	Identificador de la persona que modificó el panel.
modifiedDate	string (date-time)	Fecha de última modificación del panel.
name	string	Nombre del panel.
ownerId	string (uuid)	Identificador del propietario de un panel. En el caso de los paneles con ámbito de equipo, este es el identificador único del equipo asociado al panel. En el caso de los paneles con ámbito de proyecto, este es el identificador único de la identidad de usuario asociada al panel.
position	integer (int32)	Posición del panel, dentro de un grupo de paneles. Si no se establece en el momento de la creación, el servicio decide la posición.
refreshInterval	integer (int32)	Intervalo para que el cliente actualice automáticamente el panel. Expresado en minutos.
url	string
widgets	Widget[]	Conjunto de widgets en el panel.

DashboardGroup

Object

Describe una lista de paneles asociados a un propietario. Actualmente, los equipos poseen grupos de paneles.

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
dashboardEntries	DashboardGroupEntry[]	Lista de paneles mantenidos por el grupo de paneles
permission	GroupMemberPermission	En desuso: el modelo de permisos anterior que describe el nivel de permisos para el equipo actual. Pre-M125.
teamDashboardPermission	TeamDashboardPermission	Máscara de bits de permisos que describe los permisos de seguridad del equipo actual para los paneles. Cuando este permiso es el valor None, use GroupMemberPermission. Los permisos se evalúan en función de la presencia de un valor distinto de None; de lo contrario, se guardará GroupMemberPermission.
url	string

DashboardGroupEntry

Object

Entrada del grupo de paneles, ajuste alrededor del panel (¿es necesario?)

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
dashboardScope	DashboardScope	Entidad a la que se limita el panel.
description	string	Descripción del panel.
eTag	string	Valor de seguimiento de versiones definido por el servidor, que se usa para la detección de colisiones de edición.
groupId	string (uuid)	Identificador del grupo de un panel. En el caso de los paneles con ámbito de equipo, este es el identificador único del equipo asociado al panel. En el caso de los paneles con ámbito de proyecto, esta propiedad está vacía.
id	string (uuid)	Id. del panel. Proporcionado por el servicio en el momento de la creación.
lastAccessedDate	string (date-time)	Fecha de último acceso al panel.
modifiedBy	string (uuid)	Identificador de la persona que modificó el panel.
modifiedDate	string (date-time)	Fecha de última modificación del panel.
name	string	Nombre del panel.
ownerId	string (uuid)	Identificador del propietario de un panel. En el caso de los paneles con ámbito de equipo, este es el identificador único del equipo asociado al panel. En el caso de los paneles con ámbito de proyecto, este es el identificador único de la identidad de usuario asociada al panel.
position	integer (int32)	Posición del panel, dentro de un grupo de paneles. Si no se establece en el momento de la creación, el servicio decide la posición.
refreshInterval	integer (int32)	Intervalo para que el cliente actualice automáticamente el panel. Expresado en minutos.
url	string
widgets	Widget[]	Conjunto de widgets en el panel.

DashboardScope

Enumeración

Ámbito del panel. Puede ser Project o Project_Team

Valor	Description
collection_User	[EN DESUSO] El panel tiene como ámbito el usuario de la recopilación.
project	El panel tiene como ámbito el proyecto.
project_Team	El panel está en el ámbito del equipo.

GroupMemberPermission

Enumeración

En desuso: el modelo de permisos anterior que describe el nivel de permisos para el equipo actual. Pre-M125.

Valor	Description
edit
manage
managePermissions
none

LightboxOptions

Object

Configuración de Lightbox

Nombre	Tipo	Description
height	integer (int32)	Alto de la bandeja de luz deseada, en píxeles
resizable	boolean	True para permitir el cambio de tamaño de la caja de luz, false para no permitir el cambio de tamaño de la caja de luz, el valor predeterminado es false.
width	integer (int32)	Ancho de la bandeja de luz deseada, en píxeles

ReferenceLinks

Object

Clase que representa una colección de vínculos de referencia rest.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

SemanticVersion

Object

control de versiones de un artefacto tal como se describe en: http://semver.org/, con el formato major.minor.patch.

Nombre	Tipo	Description
major	integer (int32)	Versión principal al realizar cambios de API incompatibles
minor	integer (int32)	Versión secundaria al agregar funcionalidad de forma compatible con versiones anteriores
patch	integer (int32)	Revisión de la versión cuando se realizan correcciones de errores compatibles con versiones anteriores

TeamDashboardPermission

Enumeración

Máscara de bits de permisos que describe los permisos de seguridad del equipo actual para los paneles. Cuando este permiso es el valor None, use GroupMemberPermission. Los permisos se evalúan en función de la presencia de un valor distinto de None; de lo contrario, se guardará GroupMemberPermission.

Valor	Description
create
delete
edit
managePermissions
none
read

Object

Datos del widget

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
allowedSizes	WidgetSize[]	Hace referencia a los tamaños permitidos para el widget. Esto se rellena cuando el usuario quiere configurar el widget
areSettingsBlockedForUser	boolean	Read-Only Propiedad del servicio panel. Indica si la configuración está bloqueada para el usuario actual.
artifactId	string	Hace referencia al identificador único de un artefacto de características. Se usa para anclar y desanclar un artefacto específico.
configurationContributionId	string
configurationContributionRelativeId	string
contentUri	string
contributionId	string	Identificador de la contribución subyacente que define la configuración del widget proporcionada.
dashboard	Dashboard	Contenido de panel parcial opcional, para admitir el intercambio de ETag de versión de nivel de panel para las API de nivel de widget
eTag	string
id	string (uuid)
isEnabled	boolean
isNameConfigurable	boolean
lightboxOptions	LightboxOptions	Configuración de Lightbox
loadingImageUrl	string
name	string
position	WidgetPosition
settings	string
settingsVersion	SemanticVersion	control de versiones de un artefacto tal como se describe en: http://semver.org/, con el formato major.minor.patch.
size	WidgetSize
typeId	string
url	string

WidgetPosition

Object

Nombre	Tipo	Description
column	integer (int32)
row	integer (int32)

WidgetSize

Object

Nombre	Tipo	Description
columnSpan	integer (int32)	Ancho del widget, expresado en columnas de cuadrícula del panel.
rowSpan	integer (int32)	Alto del widget, expresado en filas de cuadrícula del panel.

Compartir a través de

Dashboards - Replace Dashboards

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

oauth2

Ámbitos

Ejemplos

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Dashboard

DashboardGroup

DashboardGroupEntry

DashboardScope

GroupMemberPermission

LightboxOptions

ReferenceLinks

SemanticVersion

TeamDashboardPermission

Widget

WidgetPosition

WidgetSize