Conexión a Cloud Firestore

Introducción

Una conexión a Cloud Firestore, creada utilizando el conector de Cloud Firestore, establece acceso a Google Cloud Firestore. Una vez que se configura una conexión, se pueden crear instancias de actividades de Cloud Firestore asociadas con esa conexión para ser utilizadas 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 a Cloud Firestore

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

La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).

Una conexión existente a Cloud Firestore se puede editar desde estas ubicaciones:

La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
La pestaña Componentes del panel del proyecto (ver Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).

Configurar una conexión a Cloud Firestore

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

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes para elegir.

Nombre de la conexión: 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 punto final de Cloud Firestore, que se refiere tanto a una conexión específica como a sus actividades.
ID del proyecto: Ingresa el project_id proporcionado por el archivo JSON de credenciales, como se describe en prerrequisitos de Cloud Firestore.
Correo electrónico del cliente: Ingresa el client_email proporcionado por el archivo JSON de credenciales, como se describe en prerrequisitos de Cloud Firestore.
ID del cliente: Ingresa el client_id proporcionado por el archivo JSON de credenciales, como se describe en prerrequisitos de Cloud Firestore.
ID de la clave privada: Ingresa el private_key_id proporcionado por el archivo JSON de credenciales, como se describe en prerrequisitos de Cloud Firestore.
Clave privada: Ingresa la private_key proporcionada por el archivo JSON de credenciales, como se describe en prerrequisitos de Cloud Firestore. La clave privada debe ingresarse en este formato:

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

Nota

Cualquier carácter de nueva línea (\n) presente en la cadena private_key debe ser reemplazado por un retorno de carro en el campo Clave privada. De lo contrario, se producirá un error al probar la conexión.
Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar actualización automática del conector.
Guardar cambios: Haz clic para guardar y cerrar la configuración de la conexión.
Descartar cambios: Después de realizar cambios en 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 remoció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 se está utilizando sea la 10.60 o posterior.
`An error occurred: java.io.IOException: Invalid PKCS#8 data`	Los caracteres de nueva línea (`\n`) están presentes en la Clave Privada.	Reemplaza cualquier carácter de nueva línea con un retorno de carro.

Próximos pasos

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

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

Consulta: Consulta documentos dentro de una colección en Cloud Firestore y está destinada a ser utilizada como fuente en una operación.
Crear: Crea documentos dentro de una colección en Cloud Firestore y está destinada a ser utilizada como objetivo en una operación.
Actualizar: Actualiza documentos dentro de una colección en Cloud Firestore y está destinada a ser utilizada como objetivo en una operación.
Eliminar: Elimina documentos dentro de una colección de Cloud Firestore y está destinada a ser utilizada como objetivo en una operación.