Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El conector de Asana Microsoft 365 Copilot integra las tareas de Asana en Microsoft 365, lo que permite a Copilot, Copilot Search y Microsoft Search exponer información de tareas pertinente directamente dentro de aplicaciones como Microsoft Teams, Outlook y SharePoint. En este artículo se describen los pasos para implementar y personalizar el conector de Asana.
Requisitos previos
Antes de implementar el conector, asegúrese de cumplir los siguientes requisitos previos:
- Debe ser administrador de Microsoft 365.
- Debes tener acceso al área de trabajo de Asana que quieres conectar.
- El entorno de Asana debe configurarse para permitir el acceso a la API.
- La asignación de identidades debe configurarse si los correos electrónicos de usuario de Asana difieren de Microsoft Entra ID nombres principales de usuario (UPN).
Implementación del conector
Para agregar el conector de Asana para su organización:
- En el Centro de administración de Microsoft 365, en el panel izquierdo, elija Conectores de Copilot>.
- Elija la pestaña Galería .
- En la lista de conectores disponibles, elige Asana.
Establecer el nombre para mostrar
El nombre para mostrar se usa para identificar referencias en las respuestas de Copilot para ayudar a los usuarios a reconocer el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza y se usa como filtro de origen de contenido.
Puedes aceptar el nombre para mostrar predeterminado de Asana o personalizar el valor para usar un nombre para mostrar que reconocen los usuarios de tu organización.
Para obtener más información sobre los nombres para mostrar y las descripciones del conector, consulte Mejora de la detección de copilot del contenido del conector.
Establecimiento de la dirección URL de la instancia
Escribe la dirección URL del área de trabajo de Asana que quieres conectar. La estructura típica es:
https://app.asana.com/
Elegir tipo de autenticación
El conector de Asana admite el siguiente tipo de autenticación:
- OAuth 2.0 (recomendado): autenticación segura y escalable mediante el flujo de OAuth de Asana.
Para usar Asana OAuth para la autenticación, un administrador de Asana debe crear una aplicación en la consola para desarrolladores de Asana.
Use la información de la tabla siguiente para completar el formulario de creación de cliente de OAuth.
| Campo | Description | Valor recomendado |
|---|---|---|
| Nombre de la aplicación | Valor único que identifica la aplicación para la que necesita acceso a OAuth. | Búsqueda de Microsoft |
| ¿Qué mejor describe lo que hará la aplicación? | Describir el propósito de la aplicación. | Obtiene datos de Asana para crear informes. |
| Dirección URL de redireccionamiento | Dirección URL de devolución de llamada necesaria a la que redirige el servidor de autorización. | Por Microsoft 365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callbackpara Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback |
| Ámbitos de permiso | Los ámbitos definen a qué puede acceder la aplicación y qué tipo de solicitudes puede realizar. | Seleccione Full permissions. |
| Administración de la distribución | Elija las áreas de trabajo que se van a distribuir. | Agregue áreas de trabajo específicas a las que el conector pueda acceder o seleccione Cualquier área de trabajo. |
Copie el id. de cliente y el secreto de cliente de la pestaña OAuth de la aplicación Asana y péguelos en los campos Id. de cliente y Secreto de cliente . Elija Autorizar y use las mismas credenciales de cuenta de administrador de Asana para autenticar el permiso para rastrear.
Nota:
Debes autorizar el acceso a la aplicación Asana en una ventana emergente. Asegúrese de que el explorador permite ventanas emergentes o concede acceso si la ventana emergente está bloqueada.
Implementación
Para implementarse en una audiencia limitada, elija el botón de alternancia situado junto a Lanzamiento a audiencia limitada y especifique los usuarios y grupos a los que se va a implementar el conector.
Elija Crear para implementar la conexión. El conector de Asana Copilot comienza a indexar contenido de inmediato.
En la tabla siguiente se enumeran los valores predeterminados que se establecen.
| Categoría | Configuración | Valor predeterminado |
|---|---|---|
| Usuarios | Permisos de acceso | Solo las personas con acceso al contenido del origen de datos. |
| Usuarios | Asignar identidades | Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra. |
| Contenido | Administrar propiedades | Para obtener información sobre las propiedades predeterminadas y su esquema, vea Personalizar la configuración de contenido. |
| Sincronizar | Rastreo incremental | Se ejecuta cada 15 minutos. |
| Sincronizar | Rastreo completo | Se ejecuta todos los días. |
Para personalizar estos valores, elija Configuración personalizada. Para obtener más información, consulte Personalización de la configuración.
Después de crear la conexión, puede revisar el estado en la sección Conectores de la Centro de administración de Microsoft 365.
Personalización de la configuración (opcional)
Puedes personalizar los valores predeterminados para la configuración del conector de Asana. Para personalizar la configuración, en la página del conector del Centro de administración, elija Configuración personalizada.
Personalización de la configuración de usuario
Permisos de acceso
El conector de Asana admite los siguientes permisos de acceso de usuario:
- Todos
- Solo las personas con acceso a este origen de datos (valor predeterminado)
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 la búsqueda para los usuarios que tengan acceso a él.
En Atlassian Asana, los permisos de seguridad se definen a través de esquemas de permisos de proyecto que contienen grupos de nivel de sitio y roles de proyecto. La seguridad de nivel de tarea también se puede definir a través de esquemas de permisos de nivel de tarea.
Asignar identidades
El método predeterminado para asignar las identidades del origen de datos con Microsoft Entra ID es comprobar que el identificador de correo electrónico de los usuarios de Asana es el mismo que el nombre principal de usuario (UPN) de los usuarios de Microsoft Entra ID. Si la asignación predeterminada no funciona para su organización, puede proporcionar una fórmula de asignación personalizada. Para obtener más información, consulte Asignación de identidades de AD que no son Azure.
Para identificar qué opción es la mejor para su organización:
- Elige la opción Microsoft Entra ID si el id. de correo electrónico de los usuarios de Asana es el mismo que el UPN en Microsoft Entra ID.
- Elige la opción No Microsoft Entra ID si el identificador de correo electrónico de los usuarios de Asana es diferente del UPN y el correo electrónico de los usuarios en Microsoft Entra ID.
Personalización de la configuración de contenido
Para poder agregar o quitar propiedades disponibles de Asana, asigna un esquema a la propiedad (define si una propiedad se puede buscar, consultar, recuperar o refinar), cambia la etiqueta semántica y agrega un alias a la propiedad.
En la tabla siguiente se enumeran las propiedades indizadas de forma predeterminada.
| Propiedad predeterminada | Etiqueta | Description |
|---|---|---|
| Assignee | assignedToPeople |
Las personas que deben completar esta tarea |
| Completado | State |
Indica si la tarea se ha completado |
| CompletedAt | ClosedDate |
Fecha y hora en que se completó la tarea |
| CompletedBy | closedBy |
La persona que completó la tarea |
| CreatedAt | createdDateTime |
Fecha y hora en que se creó la tarea |
| CreateBy | createdBy |
La persona que creó esta tarea |
| DueOn | DueDate |
Cuando se debe completar esta tarea |
| Gid | SecondaryId |
Identificador global de esta tarea |
| ModifiedAt | lastModifiedDateTime |
Fecha y hora en que se modificó la tarea |
| Nombre | Title |
Nombre de tarea |
| Notas | NA |
Descripción de la tarea (contenido) |
| ProjectIds | NA |
Identificadores de proyecto |
| ProjectNames | NA |
Nombres de proyecto |
| Etiquetas | Tags |
Etiquetas asignadas a esta tarea |
| TaskUrl | url |
Vínculo de la tarea |
| WorkspaceName | containerName |
Nombre del área de trabajo |
| Prioridad | Priority |
Prioridad de la tarea |
| Severity | Severity |
Nivel de gravedad de la tarea |
| Sections | NA |
Secciones a las que pertenece esta tarea |
| SectionIds | NA |
Identificadores de sección a los que pertenece esta tarea |
| Me gusta | NumReactions |
Número de me gusta en esta tarea |
Personalización de intervalos de sincronización
Puede configurar la frecuencia de rastreos completos e incrementales:
- Rastreo completo: se recomienda cada 24 horas para garantizar la actualización completa de los datos.
- Rastreo incremental: se recomienda cada 15 minutos para capturar los cambios recientes.
Para obtener más información, consulte Directrices para la configuración de sincronización.