Puntos de extensibilidad

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Las extensiones mejoran la experiencia del usuario de Azure DevOps mediante la contribución de nuevas funcionalidades. En este artículo se resaltan los puntos de extensibilidad más comunes que la extensión puede tener como destino. Los puntos de extensibilidad permiten a los paquetes agregar funcionalidad de una manera definida por el sistema operativo. Para más información sobre el modelo de extensibilidad de Azure DevOps, consulte el modelo de contribución.

La extensión de ejemplo de Guía de contribuciones es una extensión. Instale esta extensión en su organización. Una vez instalado, verá los puntos de extensibilidad que están disponibles. Se recomienda instalar esta extensión en una organización personal o de prueba. El código fuente de esta extensión también está disponible.

Para obtener más información, consulte las referencias siguientes:

• azure-devops-extension-api
• azure-devops-extension-sdk
• azure-devops-extension-sample
• API de extensión instalada

Centros de conectividad y grupos de concentradores

Los centros de conectividad y los grupos de concentradores son los elementos de navegación principales de Azure DevOps. Los archivos, las versiones, los trabajos pendientes y las consultas son ejemplos de centros. Un centro pertenece a un grupo de centros. El centro de Archivos, por ejemplo, pertenece al grupo de centros de Azure Repos a nivel de proyecto. Los grupos concentradores pueden existir en el nivel de organización o colección o en el nivel de proyecto. La mayoría de las extensiones contribuyen al nivel de proyecto.

En la tabla siguiente se describen los grupos de concentradores más comunes de Azure DevOps, donde puede contribuir a los centros.

Nombre	identificación	Nivel	Imagen de vista previa
Azure Boards	ms.vss-work-web.work-hub-group	Proyecto o equipo
Azure Repos	ms.vss-code-web.code-hub-group	Proyecto o equipo
Azure Pipelines (Canales de Azure)	ms.vss-build-web.build-release-hub-group	Proyecto o equipo
Azure Test Plans (Planes de prueba de Azure)	ms.vss-test-web.test-hub-group	Proyecto o equipo
Configuración del proyecto	ms.vss-web.project-admin-hub-group	Proyecto
Configuración de organización	ms.vss-web.collection-admin-hub-group	Organización o recopilación

Ejemplo

En el ejemplo siguiente se muestra cómo contribuir un centro al grupo centro de código:

{
    ...
    "contributions": [
        {
            "id": "my-custom-hub",
            "type": "ms.vss-web.hub",
            "targets": [
                "ms.vss-code-web.code-hub-group"
            ],
            "properties": {
                "name": "Code Hub",
                "order": 30,
                "uri": "/views/code/custom.html"
            }
        }
    ]
}

• ms.vss-web.hub es este tipo de contribución. Este tipo se define en la extensión vss-web publicada bajo el editor ms. Este tipo declara las propiedades opcionales y necesarias que requieren las contribuciones de este tipo (por ejemplo, nombre, orden, etc.).
• ms.vss-code-web.code-hub-group es el identificador completo de la contribución del grupo concentrador que este centro tiene como destino. Esta contribución se declara en la extensión vss-code-web publicada por el editor ms.
• my-custom-hub es el identificador corto de esta contribución; {publisherId}.{extensionId}.my-custom-hub es el identificador completo.

Agregar un icono a su menú o barra de herramientas

Agregue una propiedad de icono, para que se pueda usar directamente por nombre.

Se recomienda proporcionar su propio icono. Usando su propio ejemplo de icono:

           "name": "Sample hub",
           "uri": "dist/Hub/Hub.html",
           "icon": "asset://static/sample-icon.png",
           "supportsMobile": true
       }

Usando el ejemplo de Iconos de Office UI Fabric:

            "iconName": "Code",
            "name": "Code Hub",
            "order": 30,
            "uri": "/views/code/custom.html"
        }

Configuración de menús y barras de herramientas

Nombre	Id. de destino
Barra de herramientas de visión general de la organización y recopilación	ms.vss-admin-web.collection-overview-toolbar-menu
Cuadrícula de proyectos de información general de colecciones	ms.vss-admin-web.projects-grid-menu
Barra de herramientas de información general del proyecto	ms.vss-admin-web.project-overview-toolbar-menu
Cuadrícula de equipos de resumen del proyecto	ms.vss-admin-web.teams-grid-menu

Menú y barra de herramientas de Azure Boards

Nombre	Id. de destino	Imagen de vista previa
Menú de consulta de elemento de trabajo	ms.vss-work-web.work-item-query-menu
Menú de la barra de herramientas de resultados de consulta de elementos de trabajo	ms.vss-work-web.work-item-query-results-toolbar-menu
Elemento de menú de resultados de consulta de tarea	ms.vss-work-web.query-result-work-item-menu
Pestaña de los resultados de la consulta de elementos de trabajo	ms.vss-work-web.query-tabs
Elemento de trabajo para el menú contextual	ms.vss-work-web.work-item-toolbar-menu
Menú elemento de trabajo pendiente	ms.vss-work-web.backlog-item-menu
Menú de filtro pivot del tablero de sprint	ms.vss-work-web.sprint-board-pivot-filter-menu
Menú de filtro dinámico de placa	ms.vss-work-web.backlog-board-pivot-filter-menu
Menú de Tarjetas	ms.vss-work-web.backlog-board-card-item-menu
Pestaña Backlog del producto	ms.vss-work-web.product-backlog-tabs
Pestaña de trabajo pendiente de iteración	ms.vss-work-web.iteration-backlog-tabs
Panel de acumulación de cartera	ms.vss-work-web.portfolio-backlog-toolpane
Panel de la lista de pendientes del producto	ms.vss-work-web.requirement-backlog-toolpane
Panel de trabajo pendiente de iteración	ms.vss-work-web.iteration-backlog-toolpane

Menú y barra de herramientas de Azure Pipelines

Nombre	Id. de destino	Vista previa
Menú de compilación completado	ms.vss-build-web.completed-build-menu
Acción de la barra de herramientas para resultados de pruebas	ms.vss-test-web.test-results-actions-menu
Resultados de la prueba pestaña Detalles	ms.vss-test-web.test-result-details-tab-items
Menú contextual del Explorador de canalizaciones de versión	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
Vista de detalles de la canalización, botón de encabezado	ms.vss-build-web.pipelines-header-menu
Vista de detalles de la canalización, menú contextual de carpeta	ms.vss-build-web.pipelines-folder-menu

Tareas de Azure Pipelines

Las tareas ejecutan el trabajo en una compilación o un lanzamiento. Para obtener más información, consulte Agregar una extensión de tarea de canalizaciones personalizadas.

Menú y barra de herramientas de Azure Repos

Nombre	Id. de destino	Imagen de vista previa
Menú del elemento de origen (rejilla)	ms.vss-code-web.source-grid-item-menu
Menú Elemento de origen (árbol)	ms.vss-code-web.source-tree-item-menu
Menú Elemento de origen (cuadrícula y árbol)	ms.vss-code-web.source-item-menu
Menú Cambiar elemento de lista	ms.vss-code-web.change-list-item-menu
Menú de cambio del elemento de resumen de lista	ms.vss-code-web.change-list-summary-item-menu
Menú de árbol de ramas de Git	ms.vss-code-web.git-branches-tree-menu
Menú de acciones en pull requests de Git	ms.vss-code-web.pull-request-action-menu
Pestañas de solicitudes de extracción de Git (pivotes)	ms.vss-code-web.pr-tabs
Menú de lista de confirmaciones de Git	ms.vss-code-web.git-commit-list-menu
Menú de detalles de confirmación de Git	ms.vss-code-web.git-commit-details-menu

Menú y barra de herramientas de Azure Test Plans

Nombre	Id. de destino	Imagen de vista previa
Menú de la cuadrícula de prueba	ms.vss-test-web.test-run-grid-menu
Menú de árbol de suites de planes de prueba	ms.vss-test-web.test-plans-suites-context
Pestaña dinámica del centro de plan de prueba	ms.vss-test-web.test-plan-pivot-tabs

Otros puntos de extensibilidad

• Widget de panel: una extensión puede contribuir a un nuevo tipo de widget que los usuarios pueden agregar a un panel. Obtenga información sobre cómo contribuir a un widget de panel.
• Formulario de elemento de trabajo: el formulario de elemento de trabajo se mejora mediante extensiones con nuevas secciones, pestañas, acciones y representadores de campos personalizados. Para obtener más información, obtenga información sobre cómo extender el formulario de elemento de trabajo.
• Enlaces de servicio: un consumidor es el servicio al que se envían eventos en enlaces de servicio. Una extensión puede contribuir a los servicios al consumidor. Estos servicios se configuran mediante un usuario (o mediante programación) para enviar eventos a ese servicio. Para obtener más información, consulte Crear un consumidor personalizado para enlaces de servicio.

• Características: Nombre: característica de vista previa (solo hospedada)
  Identificador de destino: ms.vss-web.managed-features