Transformación de datos en Zendesk (versión preliminar) mediante 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 más 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 Zendesk (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 de Zendesk 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 Zendesk mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado de Zendesk 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 Zendesk (versión preliminar) y seleccione el conector correspondiente.
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 Zendesk.

Propiedades del servicio vinculado

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

Propiedad	Descripción	Obligatorio
type	La propiedad type debe establecerse en Zendesk.	Sí
url	La dirección URL base del servicio Zendesk.	Sí
authenticationType	El tipo de autenticación usado para conectarse al servicio Zendesk. Los valores permitidos son: básica y token. Haga referencia a las siguientes secciones correspondientes para obtener más información sobre propiedades y ejemplos, respectivamente.	Sí

Autenticación básica

Establezca la propiedad authenticationType en basic. Además de las propiedades genéricas descritas en las secciones anteriores, especifique las siguientes:

Propiedad	Descripción	Obligatorio
userName	Nombre de usuario utilizado para iniciar sesión en Zendesk.	Sí
password	Especifique la contraseña de la cuenta de usuario que se especificó para el nombre de usuario. 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": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Autenticación por tokens

Establezca la propiedad authenticationType en token. Además de las propiedades genéricas descritas en las secciones anteriores, especifique las siguientes:

Propiedad	Descripción	Requerido
apiToken	Especifique un token de API para Zendesk. 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": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "token",
            "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 Zendesk. 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 indican las propiedades que admite un origen de Zendesk. 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
Entidad	El nombre lógico de la entidad de Zendesk.	Sí cuando se usa el modo alineado	`activities` `group_memberships` `groups` `organizations` `requests` `satisfaction_ratings` `sessions` `tags` `targets` `ticket_audits` `ticket_fields` `ticket_metrics` `tickets` `triggers` `users` `views`	Entidad

Ejemplos de script de origen de Zendesk

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'zendesk',
	format: 'rest',
	entity: 'tickets') ~> ZendeskSource

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.