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. Para más información sobre el modelo de extensibilidad de Azure DevOps, consulte el modelo de contribución.

La extensión De la Guía de contribuciones es una extensión de ejemplo. 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 origen 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 concentrador. El centro de archivos, por ejemplo, pertenece al grupo del centro de Azure Repos de 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 a los que puede contribuir.

Nombre	ID	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	ms.vss-build-web.build-release-hub-group	Proyecto o equipo
Azure Test Plans	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 el tipo de esta contribución. Este tipo se define en la vss-web extensión publicada en el ms publicador. 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 vss-code-web extensión publicada en el ms publicador
• 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, por lo que se puede usar directamente por nombre.

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

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

Uso del 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 informació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 teams de información general 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 elemento de trabajo	ms.vss-work-web.query-result-work-item-menu
Pestaña 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 dinámico de placa 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ú Tarjeta	ms.vss-work-web.backlog-board-card-item-menu
Pestaña Trabajo pendiente del producto	ms.vss-work-web.product-backlog-tabs
Pestaña trabajo pendiente de iteración	ms.vss-work-web.iteration-backlog-tabs
Panel trabajo pendiente de cartera	ms.vss-work-web.portfolio-backlog-toolpane
Panel trabajo pendiente 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 de resultados de pruebas	ms.vss-test-web.test-results-actions-menu
Pestaña Detalles del resultado de la prueba	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 realizan el trabajo en una compilación o versión. Para obtener más información, obtenga información sobre cómo contribuir a una tarea de compilación o versión.

Menú y barra de herramientas de Azure Repos

Nombre	Id. de destino	Imagen de vista previa
Menú Elemento de origen (cuadrícula)	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ú Cambiar 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ú acciones de solicitud de incorporación de cambios de Git	ms.vss-code-web.pull-request-action-menu
Pestañas de solicitud de incorporación de cambios de Git (dinamizaciones)	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ú Probar cuadrícula de ejecución	ms.vss-test-web.test-run-grid-menu
Menú de árbol de conjuntos 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 de consumidor. Estos servicios se configuran mediante un usuario (o mediante programación) para enviar eventos a ese servicio. Para más información, consulte Contribución de un consumidor de enlaces de servicio.
• Características:

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