Compartir a través de

Conector de Microsoft Graph para elementos de trabajo de Azure DevOps

  • Artículo

El conector de Microsoft Graph de Elementos de trabajo de Azure DevOps permite a su organización indexar elementos de trabajo en su instancia del servicio Azure DevOps. Después de configurar el conector, los usuarios finales pueden buscar elementos de trabajo de Azure DevOps en Microsoft Search y Microsoft 365 Copilot.

Este artículo está destinado a administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector de Microsoft Graph de Elementos de trabajo de Azure DevOps.

Importante

El conector de Microsoft Graph de Elementos de trabajo de Azure DevOps solo admite el servicio en la nube de Azure DevOps. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 y TFS 2013 no son compatibles con este conector.

Capacidades

  • Indexación de elementos de trabajo de Azure DevOps
  • Permitir que los usuarios finales hagan preguntas relacionadas con los elementos de trabajo.
  • Use la búsqueda semántica en Copilot para permitir a los usuarios encontrar contenido relevante basado en palabras clave, preferencias personales y conexiones sociales.

Limitaciones

  • El conector solo indexa una organización de ADO por conexión.

Requisitos previos

  • Debe ser el administrador de búsqueda del inquilino de Microsoft 365 de su organización.

  • Para permitir que el conector se conecte a la organización de Azure DevOps, debe habilitar el acceso a aplicaciones de terceros a través de OAuth. Consulte la documentación de Azure DevOps para administrar directivas de seguridad para obtener más información.

    Captura de pantalla que muestra el acceso a aplicaciones de terceros a través de OAuth.

  • Cuenta de servicio: para conectarse a Azure DevOps y permitir que Microsoft Graph Connector actualice los elementos de trabajo con regularidad, necesita una cuenta de servicio con los siguientes permisos concedidos.

    Nombre del permiso Tipo de permiso Requerido para
    Visualización de información de nivel de proyecto Permiso de proyecto Rastreo de elementos de trabajo de Azure DevOps. Este permiso es obligatorio para los proyectos que deben indexarse.
    Ver análisis Permiso de proyecto Rastreo de elementos de trabajo de Azure DevOps. Este permiso es obligatorio para los proyectos que deben indexarse.
    Visualización de elementos de trabajo en este nodo Ruta de acceso de área Rastrear elementos de trabajo en una ruta de acceso de área. Este permiso es opcional. Solo se rastrean las rutas de acceso de área para las que la cuenta de usuario tiene permiso.

    Importante

    La cuenta de servicio debe tener el nivel de acceso Básico . Para más información sobre los niveles de acceso en Azure DevOps, lea los niveles de acceso admitidos.

Introducción

Captura de pantalla que muestra la pantalla de creación de conexiones del conector de Microsoft Graph para elementos de trabajo de Azure DevOps.

1. Nombre para mostrar

Se usa un nombre para mostrar para identificar cada cita en Copilot, lo que ayuda a los usuarios a reconocer fácilmente el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza. El nombre para mostrar también se usa como filtro de origen de contenido. Hay un valor predeterminado para este campo, pero puede personalizarlo para un nombre que los usuarios de su organización reconozcan.

2. Organización de ADO

El conector de Azure DevOps permite la indexación de una organización por conexión. Para conectarse al servicio Azure DevOps, proporcione el nombre de la organización que se va a indexar.

3. Tipo de autenticación

Para autenticar y sincronizar elementos de trabajo desde Azure DevOps, elija uno de los dos métodos admitidos:

Importante

a. Microsoft Entra ID OAuth

Asegúrese de que la organización de ADO está conectada a Microsoft Entra

El conector de Azure DevOps Graph solo indexa el contenido de una organización de ADO conectada con Microsoft Entra del inquilino. Para asegurarse de que la organización de ADO está conectada con Microsoft Entra cuenta, siga estos pasos.

  1. Vaya a Azure DevOps y seleccione la organización necesaria.
  2. Seleccione Organization settings.
  3. En el panel de navegación izquierdo, seleccione Microsoft Entra en el encabezado "General".
  4. Asegúrese de que la organización está conectada a la cuenta de Microsoft Entra del inquilino.

Creación de una aplicación en Microsoft Entra ID

  1. Vaya al Azure Portal e inicie sesión con las credenciales de administrador del inquilino.
  2. Vaya a Microsoft Entra ID ->Identity ->Applications ->Registros de aplicaciones en el panel de navegación y seleccione Nuevo registro.
  3. Proporcione un nombre para la aplicación y seleccione Registrar.
  4. Anote el identificador de aplicación (cliente). Este identificador se usa para conceder a la aplicación Microsoft Entra acceso a los proyectos de la organización de ADO.
  5. Abra permisos de API en el panel de navegación y seleccione Agregar un permiso.
  6. Seleccione Azure DevOps y, después, Permisos delegados.
  7. Busque los siguientes permisos en vso y seleccione Agregar permisos.
    a. vso.analytics : análisis (lectura)
    b. vso.graph : gráfico (lectura)
    c. vso.identity : identidad (lectura)
    d. vso.project : proyecto y equipo (lectura)
    e. vso.variablegroups_read: Grupos de variables (lectura)
    f. vso.work : elementos de trabajo (lectura)
  8. Seleccione Conceder consentimiento de administrador para [TenantName] y confirme seleccionando Sí.
  9. Compruebe que los permisos están en el estado "Concedido".
  10. Abra Autenticación en el panel de navegación. Seleccione Add a platform y elija Web. Agregue uno de los siguientes URI en "URI de redirección":
    • Para M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback
    • Para M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback
  11. En Concesión implícita y flujos híbridos, compruebe la opción ID tokens (used for implicit and hybrid flows) y haga clic en Configurar.
  12. En el panel de navegación, seleccione Certificados y secretos en Administrar.
  13. Seleccione Nuevo secreto de cliente y seleccione un período de expiración para el secreto. Copie el secreto generado (Valor) y guárdelo porque no se muestra de nuevo.
  14. Use este secreto de cliente y el identificador de aplicación para configurar el conector.

Conceder acceso a la aplicación Microsoft Entra a los proyectos de la organización de ADO

Debe proporcionar a la aplicación Microsoft Entra el acceso necesario a los proyectos que deben indexarse mediante los pasos siguientes:

  1. Vaya a Azure DevOps y seleccione la organización necesaria.
  2. Seleccione Organization settings.
  3. En el panel de navegación izquierdo, seleccione Users en el encabezado "General".
  4. Seleccione Add users.
  5. Copie el identificador de aplicación (cliente) obtenido de la aplicación en "Usuarios o entidades de servicio".
  6. Conceda el nivel de Basic acceso y seleccione los proyectos para permitir el acceso al índice. Agregue también al Project Reader grupo de Azure DevOps (o equivalente) para garantizar el acceso. Anule la selección de la opción para enviar una invitación por correo electrónico a los usuarios. Haga clic en Agregar.

b. Azure DevOps OAuth

Para conectarse a la instancia de Azure DevOps, necesita el nombre de la organización de Azure DevOps, su identificador de aplicación y el secreto de cliente para la autenticación de OAuth.

Registrar una aplicación

Registre una aplicación en Azure DevOps para que la aplicación Microsoft Search y Microsoft 365 Copilot puedan acceder a la instancia. Para más información, consulte la documentación de Azure DevOps sobre cómo registrar una aplicación.

En la tabla siguiente se proporcionan instrucciones sobre cómo rellenar el formulario de registro de aplicaciones:

Campos obligatorios Descripción Valor recomendado
Nombre de la compañía Nombre de la empresa. Uso de un valor adecuado
Nombre de la aplicación Valor único que identifica la aplicación que está autorizando. Búsqueda de Microsoft
Sitio web de la aplicación Dirección URL de la aplicación que solicita acceso a la instancia de Azure DevOps durante la instalación del conector. (Obligatorio). Para M365 Enterprise: https:// gcs.office.com/,
para M365 Government: https:// gcsgcc.office.com/
Dirección URL de devolución de llamada de autorización Dirección URL de devolución de llamada necesaria a la que redirige el servidor de autorización. Para M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback,
Para M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback
Ámbitos autorizados Ámbito de acceso de la aplicación Seleccione los ámbitos siguientes: Identidad (lectura), Elementos de trabajo (lectura), Variable Grupos (lectura), Proyecto y equipo (lectura), Grafo (lectura), Análisis (lectura)

Importante

Los ámbitos autorizados que seleccione para la aplicación deben coincidir con los ámbitos exactamente como se ha indicado anteriormente. Si omite uno de los ámbitos autorizados de la lista o agrega otro ámbito, se producirá un error en la autorización.

Al registrar la aplicación, obtendrá el identificador de la aplicación y el secreto de cliente que se usan para configurar el conector.

Nota:

Para revocar el acceso a cualquier aplicación registrada en Azure DevOps, vaya a Configuración de usuario en la parte superior derecha de la instancia de Azure DevOps. Seleccione Perfil y, a continuación, seleccione Autorizaciones en la sección Seguridad del panel lateral. Mantenga el puntero sobre una aplicación OAuth autorizada para ver el botón Revocar en la esquina de los detalles de la aplicación.

4. Lanzamiento a audiencia limitada

Implemente esta conexión en una base de usuarios limitada si desea validarla en Copilot y en otras superficies de búsqueda antes de expandir el lanzamiento a una audiencia más amplia. Para obtener más información sobre el lanzamiento limitado, consulte Lanzamiento preconfigurado.

En este momento, está listo para crear la conexión para los elementos de trabajo de Azure DevOps. Puede hacer clic en Crear para publicar los elementos de trabajo de conexión e índice de la organización de Azure DevOps.

Para otras configuraciones, como permisos de acceso, reglas de inclusión de datos, esquema, frecuencia de rastreo, etc., tenemos valores predeterminados basados en lo que funciona mejor con los datos de ADO. Puede ver los valores predeterminados siguientes:

Usuarios Descripción
Permisos de acceso Solo las personas con acceso al contenido en el origen de datos.
Identidades de mapa Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.
Contenido Descripción
Projects Todos los proyectos están indexados.
Administrar propiedades Para comprobar las propiedades predeterminadas y su esquema, consulte el contenido.
Sincronizar Descripción
Rastreo incremental Frecuencia: Cada 15 minutos
Rastreo completo Frecuencia: todos los días

Si desea editar cualquiera de estos valores, debe elegir la opción "Configuración personalizada".

Configuración personalizada

La configuración personalizada es para aquellos administradores que quieren editar los valores predeterminados de la configuración enumerada en la tabla anterior. Una vez que haga clic en la opción "Configuración personalizada", verá tres pestañas más: Usuarios, Contenido y Sincronización.

Usuarios

Captura de pantalla que muestra la pestaña Usuarios donde puede configurar los permisos de acceso.

Permisos de acceso

El conector de Elementos de trabajo de Azure DevOps admite permisos de búsqueda visibles para todos los usuarios o solo personas con acceso a este origen de datos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios. Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de búsqueda de los usuarios que tengan acceso a ellos.

Nota:

Novedades a grupos que rigen los permisos de acceso solo se sincronizan en rastreos completos. Los rastreos incrementales no admiten el procesamiento de actualizaciones de permisos.

Contenido

Captura de pantalla que muestra la pestaña Contenido donde puede configurar proyectos y esquema de conexión.

Elección de proyectos

En este paso, especificará el ámbito de los datos que desea indexar mediante el conector de Microsoft Graph de Elementos de trabajo de Azure DevOps. A continuación, puede elegir la conexión para indexar toda la organización o proyectos específicos dentro de la organización seleccionada.

Si decide indexar toda la organización, los elementos de trabajo de todos los proyectos de la organización se indizan. Los nuevos proyectos y elementos de trabajo se indexan durante el siguiente rastreo después de crearlos.

Si decide indexar proyectos individuales, solo se indizan los elementos de trabajo de los proyectos seleccionados.

Nota:

Los proyectos de Azure DevOps se pueden rastrear después de conceder los permisos Ver información de nivel de proyecto y Ver análisis .

Administrar propiedades

Aquí puede agregar o quitar propiedades disponibles del origen de datos de Azure DevOps, asignar un esquema a la propiedad (definir si una propiedad se puede buscar, consultar, recuperar o refinar), cambiar la etiqueta semántica y agregar un alias a la propiedad. Las propiedades seleccionadas de forma predeterminada se enumeran a continuación.

Source (propiedad) Etiqueta Descripción Esquema
AreaPath Ruta de acceso de área al elemento de trabajo Consulta, recuperación y búsqueda
AssignedTo Nombre de la persona a la que se asigna el elemento de trabajo Consulta, recuperación y búsqueda
Autores Autores Recuperar
ChangedBy Última modificación Nombre de la persona que modificó por última vez el elemento de trabajo Consulta, recuperación
ChangedDate Fecha de la última modificación Consulta, recuperación
CreatedBy Creada por Nombre de persona que creó el elemento de trabajo Consulta, recuperación y búsqueda
CreatedDate Fecha y hora de creación Marca de tiempo cuando se creó el elemento de trabajo Consulta, recuperación
Descripción Contenido Descripción del elemento de trabajo Búsqueda
IconUrl IconUrl Recuperar
Id Identificador de elemento de trabajo Consulta, recuperación y búsqueda
Prioridad Prioridad del elemento de trabajo Consulta, recuperación
ReproSteps Pasos para reproducir una condición descrita en el elemento de trabajo
Estado Estado actual del elemento de trabajo Consulta, recuperación y búsqueda
Etiquetas Consulta, recuperación y búsqueda
TeamProject Recuperar
Título Título Título del elemento de trabajo Recuperar, buscar
URL url Dirección URL del elemento de trabajo Recuperar
WorkItemType Consulta, recuperación y búsqueda

Vista previa de datos

Use el botón vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas.

Sincronizar

Captura de pantalla que muestra la pestaña Sincronizar donde puede configurar la frecuencia de rastreo.

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector de Graph. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, vea Actualizar configuración.

Puede cambiar los valores predeterminados del intervalo de actualización desde aquí si lo desea.

Sugerencia

Tipo de resultado predeterminado

  • El conector de Microsoft Graph de Elementos de trabajo de Azure DevOps registra automáticamente un tipo de resultado una vez publicado el conector. El tipo de resultado usa un diseño de resultados generado dinámicamente en función de los campos seleccionados en el paso 3.
  • Para administrar el tipo de resultado, vaya a Tipos de resultado en el Centro de administración de Microsoft 365. El tipo de resultado predeterminado se denomina "ConnectionIdDefault". Por ejemplo, si el identificador de conexión es AzureDevOps, el diseño del resultado se denomina: "AzureDevOpsDefault"
  • Además, puede elegir crear su propio tipo de resultado si es necesario.

Solución de problemas

Después de publicar la conexión, puede revisar el estado en la pestaña Orígenes de datos del Centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector. Puede encontrar pasos de solución de problemas para los problemas más vistos aquí.

Si tiene problemas o quiere proporcionar comentarios, póngase en contacto con Microsoft Graph | Soporte técnico.