Actividad Cloud Datastore Insert Items en Jitterbit Studio

Introducción

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

Crear una actividad Cloud Datastore Insert Items

Se crea una instancia de una actividad Insert Items de Cloud Datastore a partir de una conexión de Cloud Datastore utilizando su tipo de actividad Insert 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 Insert Items de Cloud Datastore existente desde estas ubicaciones:

• El lienzo de diseño (consulta Menú de acciones de componentes en Lienzo de diseño).
• La pestaña Componentes del panel de proyecto (consulta Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

Configurar una actividad Cloud Datastore Insert Items

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

• Paso 1: Ingresa un nombre y especifica la configuración
  Proporciona un nombre para la actividad y especifica el almacenamiento de Cloud Datastore con el que interactuar.

• Paso 2: Revisa los esquemas de datos
  Se muestran los esquemas de solicitud o respuesta.

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

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

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

• Seleccionar almacenamiento existente: Selecciona de una lista de almacenamientos de Cloud Datastore existentes.
• Ingresar el nombre del almacenamiento manualmente: Ingresa manualmente el nombre del almacenamiento de Cloud Datastore.

Seleccionar almacenamiento existente

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

• Menú de punto de conexión: 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 Insert Items de Cloud Datastore y no debe contener barras diagonales / ni dos puntos :.

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

• Select a storage: Esta sección muestra los almacenamientos de Cloud Datastore disponibles para el entorno.

  • Selected storage: Después de seleccionar un almacenamiento, se lista aquí.

  • Search: 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 punto de conexión al buscar, ingresa 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 del 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 que se muestra 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.

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

  • Estrategia de inserción: Selecciona el método de inserción de datos:

    • Mantener el orden de los elementos durante la inserción (predeterminado): Cuando se selecciona durante una solicitud por lotes, se prioriza el orden de los elementos insertados. Esta opción puede resultar en tiempos de procesamiento más largos.

    • Priorizar el rendimiento con inserción por lotes (no se puede garantizar el orden de los elementos): Cuando se selecciona durante una solicitud por lotes, el orden de los elementos insertados no se prioriza y se delega al propio Cloud Datastore.

  • 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.

Introducir el nombre del almacenamiento manualmente

Si se selecciona Introducir el nombre del almacenamiento manualmente para Seleccionar almacenamiento, se presenta la interfaz descrita a continuación.

• 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 cuando pasas el cursor sobre el nombre del endpoint actual. Haz clic para editar la configuración de conexión del endpoint seleccionado actualmente.

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

• Almacenamiento: Introduce el nombre del almacenamiento con el que interactuar.

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

  • Estrategia de inserción: Selecciona el método de inserción de datos:

    • Mantener el orden de los elementos durante la inserción (predeterminado): Cuando se selecciona durante una solicitud por lotes, se prioriza el orden de los elementos insertados. Esta opción puede resultar en tiempos de procesamiento más largos.

• Prevalecer rendimiento con inserción por lotes (no se puede garantizar el orden de elementos): Cuando se selecciona durante una solicitud por lotes, el ordenamiento de los elementos insertados no se prioriza y se delega al propio Cloud Datastore.

• 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. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

• Esquemas de datos: Estos esquemas de datos se heredan mediante transformaciones adyacentes y se muestran nuevamente durante el mapeo de datos.

  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 claves	Descripción
  json	Nodo que contiene el esquema de solicitud JSON
  <custom field>	Cualquier campo personalizado definido en el almacenamiento de claves se incluye en la solicitud
  Value	El valor principal asociado con la clave en el par clave-valor. Este campo corresponde a la columna Valor en el almacenamiento de claves
  Key	El identificador principal del elemento en el par clave-valor. Este campo corresponde a la columna Clave en el almacenamiento de claves y distingue mayúsculas de minúsculas.
  AlternativeKey	Un identificador alternativo que se puede usar para buscar el mismo elemento. Este campo corresponde a la columna Clave alternativa en el almacenamiento de claves y distingue mayúsculas de minúsculas.

  Nodo o campo de solicitud de almacenamiento de estado	Descripción
  json	Nodo que contiene el esquema de solicitud JSON
  Status	El éxito o fracaso de la operación
  RetryPolicyRetryCount	(Solo para uso interno)
  RetryPolicyLastRetryDate	(Solo para uso interno)
  DuplicationControl	(Solo para uso interno)
  RetryPolicyNextRetryDate	(Solo para uso interno)
  Key	La clave de elemento proporcionada por el usuario establecida durante la creación del elemento con una [actividad Insertar elementos]
  StatusMessage	Mensaje con información sobre el estado de inserción
  MessageBody	BigText para la carga útil de la operación

[Insert Items activity]: /es/integration-studio/design/connectors/cloud-datastore/insert-items-activity/

• 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 Insert Items de Cloud Datastore, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También puedes configurar los ajustes 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.

Se puede acceder a las acciones de menú de una actividad 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 Insert Items de Cloud Datastore se pueden usar como destino con estos patrones de operación:

• Patrón de transformación
• Patrón de dos transformaciones (como primer o segundo destino)

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.