Actividad de Actualización de Harmony Square¶
Introducción¶
Una actividad de Actualización de Square actualiza a un cliente existente en una conexión de Square y está diseñada para usarse como objetivo para consumir datos en una operación. Después de configurar una conexión Square, puede configurar tantas actividades Square como desee para cada conexión Square.
Crear una Actividad Square¶
Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.
Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.
Una actividad existente se puede editar desde estas ubicaciones:
- El tela de diseño (vea Menú de acciones de componentes en Tela de Diseño).
- La pestaña Componentes del panel del proyecto (vea Menú de acciones de componentes en Ficha Componentes del panel Proyecto).
Configurar una Actividad de Actualización de Square¶
Siga estos pasos para configurar una actividad de Actualización de Square:
Paso 1: Ingrese un Nombre y Especifique la Configuración¶
-
Nombre: Ingrese un nombre para usar para identificar la actividad de Actualización de Square. El nombre debe ser único para cada Actividad de actualización y no debe contener barras diagonales (
/
) o dos puntos (:
). -
Continuar con error: Seleccione para continuar con la ejecución de la actividad si se encuentra un error para un conjunto de datos en una solicitud lote. Si se encuentran errores, se escriben en el registro de operación.
-
Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.
-
Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el próximo paso. El la configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.
-
Descartar cambios: Después de realizar cambios, haga clic en Descartar cambios para cerrar la configuración sin guardar cambios realizados en cualquier paso. Un mensaje le pedirá que confirme que desea descartar los cambios.
Paso 2: Revisar los Esquemas de Datos¶
-
Esquema de datos: Se mostrarán los esquemas de datos de solicitud y respuesta para Square. Si la operación utiliza una transformación, los esquemas de datos se volverán a mostrar más adelante durante el proceso de asignación de la transformación, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.
El conector de Square usa la API REST de Square. Consulte la documentación de la API para obtener información sobre los campos del esquema.
-
Solicitud:
Solicitar campo/nodo de esquema Notas cliente Nodo del cliente IDcliente ID del cliente específico nombre dado El nombre de pila del cliente (primer nombre) nombre de familia El nombre (apellido) de la familia del cliente nombre de la empresa La empresa del cliente apodo El apodo del cliente dirección de correo electrónico La dirección de correo del cliente número de teléfono El teléfono del cliente ID de referencia ID de referencia del cliente nota Una nota sobre el cliente cumpleaños El cumpleaños del cliente -
Respuesta:
Campo/nodo del esquema de respuesta Notas actualizar Nodo de la actualización está actualizado Si se actualizó el registro del cliente ( true
) o no actualizado (false
)mensaje Mensaje de la actividad Crear cliente Nodo del cliente nombre dado El nombre de pila del cliente (primer nombre) nombre de familia El nombre (apellido) de la familia del cliente nombre de la empresa La empresa del cliente apodo El apodo del cliente dirección de correo electrónico La dirección de correo del cliente número de teléfono El teléfono del cliente
-
-
Actualizar: Haz clic en el icono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo. Esta acción también regenera el esquema en otras ubicaciones a lo largo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.
-
Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
-
Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.
-
Descartar cambios: Después de realizar cambios, haga clic en Descartar cambios para cerrar la configuración sin guardar cambios realizados en cualquier paso. Un mensaje le pedirá que confirme que desea descartar los cambios.
Próximos Pasos¶
Después de configurar una actividad de Actualización de Square, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de operación. También puede configurar la operación de una operación configuraciones, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo o en diferentes flujos de trabajo.
Después de crear una actividad de Square, se puede acceder a las acciones del menú para esa actividad desde el panel del proyecto en las pestañas Flujos de Trabajo o Componentes, y desde el tela de diseño. Ver Menú de acciones de actividad para detalles.
Las actividades de Square Update se pueden usar como objetivo con estos patrones de operación: - Patrón de transformación - Patrón de dos transformaciones (como primer o segundo objetivo)
Otros patrones no son válidos con las actividades de Actualización de Square. Consulte los patrones de validación en el Validez de la operación página.
Un caso de uso típico es usar una actividad de Actualización de Square en el Patrón de dos transformaciones. En este ejemplo, el La primera transformación (Solicitud de actualización de Square) crea una estructura de solicitud que se pasa a la Actualización de Square actividad. La segunda transformación (Respuesta de actualización cuadrada) recibe la estructura de respuesta, que luego se escrito en una variable por una actividad de escritura variable (Escribir respuesta de actualización Square) y luego se registra un mensaje por el secuencia de comandos _Escribir en el registro de operaciones:
Para usar la actividad con funciones de secuencias de comandos, escriba los datos en una ubicación temporal y luego use esa ubicación temporal. ubicación en la función de secuencias de comandos.
Cuando esté listo, desplegar y ejecute la operación y valide el comportamiento comprobando los registros de la operación.