Saltar al contenido

Actividad Cloud Datastore Delete Items en Jitterbit Studio

Introducción

Una actividad Delete Items de Cloud Datastore, utilizando su conexión de Cloud Datastore, elimina datos de un almacenamiento de estado o almacenamiento de claves en Cloud Datastore y está diseñada para usarse como destino para consumir datos en una operación.

Crear una actividad Cloud Datastore Delete Items

Se crea una instancia de una actividad Delete Items de Cloud Datastore a partir de una conexión de Cloud Datastore utilizando su tipo de actividad Delete Items.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad Delete Items de Cloud Datastore existente desde estas ubicaciones:

Configurar una actividad Cloud Datastore Delete Items

Sigue estos pasos para configurar una actividad Delete Items de Cloud Datastore:

Paso 1: Ingresa un nombre y especifica la configuración

En este paso, proporciona un nombre para la actividad y especifica el almacenamiento. A continuación se describe cada elemento de la interfaz de usuario de este paso.

La interfaz utilizada en este paso de la configuración de una actividad Delete Items depende de la opción Select storage seleccionada:

Seleccionar almacenamiento existente

Si se selecciona Select existent storage para Select storage, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un icono de variable permiten usar variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que puedes elegir.

  • Menú Endpoint: Si tienes múltiples puntos de conexión del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del punto de conexión actual. Haz clic en el menú para cambiar a un punto de conexión diferente. Para más información, consulta Cambiar el punto de conexión asignado en Pantallas de configuración.

    • Editar punto de conexión: Aparece cuando pasas el cursor sobre el nombre del punto de conexión actual. Haz clic para editar la configuración de conexión del punto de conexión seleccionado actualmente.

  • Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad Delete Items de Cloud Datastore y no debe contener barras diagonales / ni dos puntos :.

  • Seleccionar almacenamiento: Selecciona la opción Seleccionar almacenamiento existente para elegir un almacenamiento existente de una lista poblada.

  • Seleccionar un almacenamiento: Esta sección muestra los almacenamientos de Cloud Datastore disponibles para el entorno.

    • Almacenamiento seleccionado: Después de seleccionar un almacenamiento, se lista aquí.

    • Búsqueda: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de almacenamientos. La búsqueda no distingue entre mayúsculas y minúsculas. Si los almacenamientos ya se muestran en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar almacenamientos desde el endpoint al buscar, ingresa los criterios de búsqueda y luego actualiza, como se describe a continuación.

    • Actualizar: Haz clic en el icono de actualización o en la palabra Actualizar para recargar elementos desde el endpoint de Cloud Datastore. Esto puede ser útil si se han añadido o editado almacenamientos en Cloud Datastore. Esta acción actualiza todos los metadatos utilizados para construir la tabla de almacenamientos mostrada en la configuración.

    • Seleccionar un almacenamiento: Dentro de la tabla, haz clic en cualquier parte de una fila para seleccionar un almacenamiento. Solo se puede seleccionar un almacenamiento. La información disponible para cada almacenamiento se obtiene del endpoint de Cloud Datastore:

      • Nombre: El nombre del almacenamiento.

      • Tipo: El tipo de almacenamiento, ya sea Búsqueda por clave (almacenamiento de clave) o Búsqueda por estado (almacenamiento de estado).

      • Descripción: La descripción del almacenamiento proporcionada durante la creación del almacenamiento.

  • Clave: Ingresa la clave del elemento a eliminar. Para almacenamientos de clave, este valor es el valor de Clave o Clave alternativa del registro (sensible a mayúsculas y minúsculas). Para almacenamientos de estado, este valor es la clave establecida durante la creación del elemento con una actividad Insertar elementos. Puedes recuperar claves existentes usando una actividad Consultar elementos. Para eliminar múltiples elementos a la vez (una solicitud por lotes), proporciona las claves en una transformación que precede a esta actividad.

  • Configuración opcional: Haz clic para expandir la configuración opcional adicional:

    • Continuar en caso de error: Selecciona para continuar la ejecución de la actividad si se encuentra un error para un conjunto de datos en una solicitud por lotes. Si se encuentran errores, se escriben en el registro de operaciones.

  • Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

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

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Ingresar nombre de almacenamiento manualmente

Si se selecciona Ingresar nombre de almacenamiento manualmente para Seleccionar almacenamiento, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú que lista las variables existentes para elegir.

  • Menú de endpoint: Si tienes múltiples endpoints del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del endpoint actual. Haz clic en el menú para cambiar a un endpoint diferente. Para más información, consulta Cambiar el endpoint asignado en Pantallas de configuración.

  • Editar endpoint: Aparece al pasar el cursor sobre el nombre del endpoint actual. Haz clic para editar la configuración de conexión del endpoint seleccionado.

  • Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad Cloud Datastore Delete Items y no debe contener barras diagonales / ni dos puntos :.

  • Storage: Ingresa el nombre del almacenamiento con el que deseas interactuar.

  • Key: Ingresa la clave del elemento a eliminar. Para almacenamientos de clave, este valor es el valor de Key o Alternative Key del registro (sensible a mayúsculas). Para almacenamientos de estado, este valor es la clave establecida durante la creación del elemento con una actividad Insert Items. Puedes recuperar claves existentes usando una actividad Query Items. Para eliminar varios elementos a la vez (una solicitud por lotes), proporciona las claves en una transformación que preceda a esta actividad.

  • Configuración opcional: Haz clic para expandir la configuración opcional adicional:

    • Continuar en caso de error: Selecciona esta opción para continuar la ejecución de la actividad si se encuentra un error en un conjunto de datos en una solicitud por lotes. Si se encuentran errores, se escriben en el registro de operaciones.

  • Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

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

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 2: Revisar los esquemas de datos

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

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

    Nota

    Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

    Los esquemas de datos de solicitud y respuesta constan de estos nodos y campos:

    Nodo o campo de solicitud de almacenamiento de clave Descripción
    json Nodo que contiene el esquema de solicitud JSON
    request Nodo que contiene la solicitud
    keys Nodo que contiene los valores de Key o Alternative Key de elementos a eliminar
    item Nodo que contiene un valor de clave
    #text El valor de Key o Alternative Key del elemento a eliminar (sensible a mayúsculas)
    ids Nodo que contiene los valores de Key o Alternative Key de elementos a eliminar
    item Nodo que contiene un valor de clave
    #text El valor de Key o Alternative Key del elemento a eliminar (sensible a mayúsculas)

    Nota

    Tanto los arreglos keys como ids aceptan los mismos datos: valores de Key o Alternative Key de tu almacenamiento de clave. Cuando ambos arreglos se proporcionan en la solicitud, los valores se combinan y todos los elementos especificados se envían para eliminación.

    Nodo o campo de solicitud de almacenamiento de estado Descripción
    json Nodo que contiene el esquema de solicitud JSON
    page El número de páginas a devolver
    limit El número de elementos devueltos por página
Nodo o campo de respuesta de almacenamiento de claves Descripción
json Nodo que contiene el esquema de respuesta JSON
responses Nodo que contiene las respuestas
item Nodo que contiene información sobre cada elemento de almacenamiento eliminado
deleted Booleano que representa si al menos un elemento se eliminó correctamente. Debido a limitaciones de la API, si al menos un elemento en la solicitud se elimina correctamente, todos los campos deleted en la respuesta se establecen en true. Si no se elimina ningún elemento, todos los campos deleted se establecen en false.
id El ID del elemento de almacenamiento
key La clave del elemento eliminado
errors Nodo que contiene cualquier error
item Nodo que contiene mensajes de error
message Un mensaje de error
Nodo o campo de respuesta de almacenamiento de estado Descripción
json Nodo que contiene el esquema de respuesta JSON
responses Nodo que contiene las respuestas
item Nodo que contiene información sobre cada elemento de almacenamiento eliminado
deleted Booleano que representa si al menos un elemento se eliminó correctamente. Debido a limitaciones de la API, si al menos un elemento en la solicitud se elimina correctamente, todos los campos deleted en la respuesta se establecen en true. Si no se elimina ningún elemento, todos los campos deleted se establecen en false.
id El ID del elemento de almacenamiento
key La clave del elemento eliminado
errors Nodo que contiene cualquier error
item Nodo que contiene información de error
message El mensaje de error
pagination Nodo que contiene información sobre la paginación de la respuesta
page El número de páginas devueltas
limit El número de elementos devueltos por página
sortBy El campo ordenado
sortDir La dirección de ordenamiento, ya sea asc (ascendente) o desc (descendente)
totalItems El número de elementos eliminados
totalPages El número de páginas devueltas

  • Actualizar: Haz clic en el icono de actualización o en la palabra Actualizar para regenerar esquemas desde el endpoint de Cloud Datastore. 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.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

  • Finalizado: Haz 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, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Próximos pasos

Después de configurar una actividad Eliminar elementos de Cloud Datastore, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los parámetros de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en los mismos flujos de trabajo o en flujos de trabajo diferentes.

Las acciones de menú de una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para obtener más detalles, consulta Menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades Eliminar elementos de Cloud Datastore se pueden usar como destino con estos patrones de operación:

Para usar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego usa esa ubicación temporal en la función de scripting.

Cuando esté listo, implementa y ejecuta la operación y valida el comportamiento verificando los registros de operación.