Transformación de datos en Asana (versión preliminar) mediante Azure Data Factory o Synapse Analytics

Artículo
01/05/2024

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

En este artículo se indica cómo usar Data Flow para transformar datos en Asana (versión preliminar). Para obtener más información, lea el artículo de introducción para Azure Data Factory o Azure Synapse Analytics.

Importante

Este conector está actualmente en versión preliminar. Puede probarlo y enviarnos sus comentarios. Si desea depender de los conectores de versión preliminar en la solución, póngase en contacto con el soporte técnico de Azure.

Funcionalidades admitidas

Este conector Asana es compatible con las funcionalidades siguientes:

Funcionalidades admitidas	IR
Flujo de datos de asignación (origen/-)	6

① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado

Para obtener una lista de los almacenes de datos que se admiten como orígenes y receptores, consulte la tabla de almacenes de datos admitidos.

Creación de un servicio vinculado de Asana mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado de Asana en la interfaz de usuario de Azure Portal.

Vaya a la pestaña Administrar de su área de trabajo de Azure Data Factory o Synapse, y seleccione Servicios vinculados; a continuación, seleccione Nuevo:
- Azure Data Factory
- Azure Synapse
Busque Asana (versión preliminar) y seleccione el conector de Asana (versión preliminar).
Configure los detalles del servicio, pruebe la conexión y cree el nuevo servicio vinculado.

Detalles de configuración del conector

En las secciones siguientes se proporciona información acerca de las propiedades que se usan para definir entidades de canalización de Data Factory y Synapse específicas para Asana.

Propiedades del servicio vinculado

Se admiten las siguientes propiedades para el servicio vinculado de Asana:

Propiedad	Descripción	Obligatorio
type	La propiedad type debe establecerse en Asana.	Sí
apiToken	Especifique un token de API para Asana. Marque este campo como SecureString para almacenarlo de forma segura. O bien puede hacer referencia a un secreto almacenado en Azure Key Vault.	Sí

Ejemplo:

{
    "name": "AsanaLinkedService",
    "properties": {
        "type": "Asana",
        "typeProperties": {
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Propiedades de Asignación de instancias de Data Flow

Al transformar datos en el flujo de datos de asignación, puede leer tablas de Asana. Para más información, consulte la transformación de origen en el flujo de datos de asignación. Solo puede usar un conjunto de datos insertado como tipo de origen.

Transformación de origen

En la tabla siguiente se enumeran las propiedades que admite un origen Asana. Puede editar estas propiedades en la pestaña Source options (Opciones de origen).

Nombre	Descripción	Obligatorio	Valores permitidos	Propiedad de script de flujo de datos
Área de trabajo	Identificador del área de trabajo en Asana.	Sí	String	workspaceId
Entidad	Identificador de la entidad en Asana.	Sí	String	entityId
Tipo de entidad	Tipo de entidad en Asana.	Sí	`teams` `portfolios` `projects`	entityType

Ejemplos de script de origen de Asana

Cuando se usa Asana como tipo de origen, el script de flujo de datos asociado es el siguiente:

source(allowSchemaDrift: true,
    validateSchema: false,
    store: 'asana',
    format: 'rest',
    workspaceId: '9876543210',
    entityId: '1234567890',
    entityType: 'teams') ~> AsanaSource

Para obtener una lista de almacenes de datos que la actividad de copia admite como orígenes y receptores, vea Almacenes de datos que se admiten.