Saltar al contenido

Actividad de Consulta de Square V2

Introducción

Una actividad Consulta de Square v2, usando su conexión Square v2, recupera datos de objetos específicos de Square y está diseñado para usarse como fuente para proporcionar datos en una operación.

Nota

La actividad Consulta devolverá datos de objeto que se especifican dentro de su esquema de solicitud. Para recuperar todos los datos del objeto seleccionado, utilice la Actividad de lectura.

Crear una Actividad de Consulta de Square V2

Se crea una instancia de una actividad Consulta de Square v2 a partir de una conexión de Square v2 utilizando su tipo de actividad Consulta.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o cópielo y péguelo en el tela de diseño. Para obtener más información, consulte Crear una instancia de actividad en Reutilización de componentes.

Una actividad Consulta de Square v2 existente se puede editar desde estas ubicaciones:

Configurar una Actividad de Consulta de Square V2

Siga estos pasos para configurar una actividad Consulta de Square v2:

Paso 1: Ingrese un Nombre y Seleccione un Objeto

En este paso, proporcione un nombre para la actividad y seleccione un objeto. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Paso 1 de configuración de la actividad de consulta de Square v2

  • Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Consulta de Square v2 y no debe contener barras diagonales / o dos puntos :.

  • Seleccione un objeto: Esta sección muestra los objetos disponibles en el extremo Square v2.

    • Objeto seleccionado: Después de seleccionar un objeto, aparece aquí.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. Si los objetos ya se muestran dentro de la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar objetos desde el extremo durante la búsqueda, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

    • Actualizar: Haga clic en el icono de actualización Icono de actualización o la palabra Actualizar para recargar objetos desde el extremo de Square v2. Esto puede resultar útil si se han agregado objetos a Square v2. Esta acción actualiza todos los metadatos utilizados para crear la tabla de objetos que se muestran en la configuración.

    • Seleccionar un objeto: Dentro de la tabla, haga clic en cualquier lugar de una fila para seleccionar un objeto. Sólo se puede seleccionar un objeto. La información disponible para cada objeto se obtiene del extremo de Square v2:

      • Nombre: El nombre del objeto.

      • Descripción: La descripción del objeto.

    Consejo

    Si la tabla no se completa con los objetos disponibles, la conexión Square v2 puede no tener éxito. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Límite: Especifique el número máximo de resultados por página. El valor mínimo es 1 y el máximo es 1000. Cuando este campo se deja vacío, el número máximo de resultados por página es 100.

  • Continuar en caso de error: Seleccione continuar con la ejecución de la actividad si se encuentra un error para un conjunto de datos en una solicitud lote. Si se encuentra algún error, se escribe en el registro de operación.

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración para 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 siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Seleccione un Subobjeto

En este paso, seleccione un subobjeto. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Paso 2 de configuración de la actividad de consulta de Square v2

  • Seleccione un subobjeto: Esta sección muestra los subobjetos disponibles en el extremo Square v2.

    • Objeto seleccionado: El objeto seleccionado en el paso anterior aparece aquí.

    • Seleccione un subobjeto: Después de seleccionar un subobjeto, se enumera aquí.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de subobjetos. La búsqueda no distingue entre mayúsculas y minúsculas. Si ya se muestran subobjetos dentro de la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar subobjetos desde el extremo durante la búsqueda, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

    • Actualizar: Haga clic en el icono de actualización Icono de actualización o la palabra Actualizar para recargar subobjetos desde el extremo de Square v2. Esto puede resultar útil si se han agregado subobjetos a Square v2. Esta acción actualiza todos los metadatos utilizados para crear la tabla de subobjetos que se muestran en la configuración.

    • Seleccionar un subobjeto: Dentro de la tabla, haga clic en cualquier lugar de una fila para seleccionar un subobjeto. Sólo se puede seleccionar un subobjeto. La información disponible para cada subobjeto se obtiene del extremo de Square v2:

      • Nombre: El nombre del subobjeto.

      • Descripción: La descripción del subobjeto

    Consejo

    Si la tabla no se completa con subobjetos disponibles, la conexión Square v2 puede no tener éxito. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

  • Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 3: Revisar los Esquemas de Datos

Se muestran todos los esquemas de solicitud o respuesta. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Paso 3 de configuración de la actividad de consulta de Square v2

  • Esquemas de datos: Estos esquemas de datos se heredan mediante transformaciones adyacentes y se muestran nuevamente durante asignación de transformación.

    El conector Square v2 utiliza la API de Square. Consulte la documentación API del objeto para obtener información sobre los campos y nodos del esquema:

    Nota

    El records el campo, presente en el esquema de respuesta, actúa como un contador cuando realiza más de una solicitud utilizando la actividad Consulta.

  • Actualizar: Haga clic en el icono de actualización Icono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de Square v2. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Volver: 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 para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Próximos Pasos

Después de configurar una actividad Consulta de Square v2, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujos de trabajo o en diferentes.

Se puede acceder a las acciones del menú para una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte Menú de acciones de actividad en Conceptos básicos del conector.

Las actividades Query de Square v2 se pueden usar como fuente con estos patrones de operación:

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 en la función de secuencias de comandos.

Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.