Conexión de Cloud Firestore en Jitterbit Studio

Introducción

Una conexión de Cloud Firestore, creada mediante el conector de Cloud Firestore, establece acceso a Google Cloud Firestore. Una vez configurada una conexión, se pueden crear instancias de actividades de Cloud Firestore asociadas a esa conexión para usarlas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Cloud Firestore

Se crea una conexión de Cloud Firestore nueva mediante el conector de Cloud Firestore desde una de estas ubicaciones:

La pestaña Project endpoints and connectors (Extremos de proyecto y conectores) de la paleta del componente de diseño (consulta Design component palette).
La página Global Endpoints (Extremos globales) (consulta Crear un punto final global en Global Endpoints).

Se puede editar una conexión de Cloud Firestore existente desde estas ubicaciones:

La pestaña Project endpoints and connectors (Extremos de proyecto y conectores) de la paleta del componente de diseño (consulta Design component palette).
La pestaña Components (Componentes) del panel del proyecto (consulta Component actions menu en Project pane Components tab).
La página Global Endpoints (Extremos globales) (consulta Editar un punto final global en Global Endpoints).

Configurar una conexión de Cloud Firestore

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Cloud Firestore.

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ú con las variables existentes entre las que elegir.

Connection Name: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Cloud Firestore y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el extremo de Cloud Firestore, que hace referencia tanto a una conexión específica como a sus actividades.
Project Id: Ingresa el project_id proporcionado por el archivo JSON de credenciales, como se describe en Cloud Firestore prerequisites.
Client Email: Ingresa el client_email proporcionado por el archivo JSON de credenciales, como se describe en Cloud Firestore prerequisites.
Client ID: Ingresa el client_id proporcionado por el archivo JSON de credenciales, como se describe en Cloud Firestore prerequisites.
Private Key ID: Ingresa el private_key_id proporcionado por el archivo JSON de credenciales, como se describe en Cloud Firestore prerequisites.
Private Key: Ingresa el private_key proporcionado por el archivo JSON de credenciales, como se describe en Cloud Firestore prerequisites. El valor se enmascara conforme lo ingresas. Haz clic en el icono de mostrar para revelarlo e icono de ocultar para enmascararlo nuevamente. La clave privada debe ingresarse en este formato:

-----BEGIN PRIVATE KEY-----<private_key>-----END PRIVATE KEY-----

Nota

Cualquier carácter de salto de línea (\n) presente en la cadena private_key debe reemplazarse con un retorno de carro en el campo Private Key. De lo contrario, ocurrirá un error al probar la conexión.
Test: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, el agente o los agentes en el grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector admite suspender la descarga de la versión más reciente del conector mediante la política de organización Disable Auto Connector Update.
Guardar: Haz clic para guardar y cerrar la configuración de conexión.
Descartar cambios: Después de hacer cambios a una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.
Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y extracción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Posibles errores de conexión

Estos son los posibles errores de conexión y sus soluciones:

Error	Causa	Solución
`An error occurred: com.google.common.base.Preconditions.checkArgument(ZLjava/lang/String;CLjava/lang/Object;)V`	La versión del agente es demasiado antigua.	Asegúrate de que la versión del agente que utilizas sea la versión 10.60 o posterior.
`An error occurred: java.io.IOException: Invalid PKCS#8 data`	Hay caracteres de salto de línea (`\n`) en la Clave privada.	Reemplaza cualquier carácter de salto de línea con un retorno de carro.

Próximos pasos

Después de crear una conexión a Cloud Firestore, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilicen como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones de menú para una conexión y sus tipos de actividad desde el panel del proyecto y la paleta de componentes de diseño. Para obtener detalles, consulta Menús de acciones en Conceptos básicos de conectores.

Estos tipos de actividad están disponibles:

Consulta: Consulta documentos dentro de una colección en Cloud Firestore y está pensada para utilizarse como fuente en una operación.
Crear: Crea documentos dentro de una colección en Cloud Firestore y está pensada para utilizarse como destino en una operación.
Actualizar: Actualiza documentos dentro de una colección en Cloud Firestore y está pensada para utilizarse como destino en una operación.
Eliminar: Elimina documentos dentro de una colección de Cloud Firestore y está pensada para utilizarse como destino en una operación.