Diferencias

Muestra las diferencias entre dos versiones de la página.

--- usu:doc:firesinc [2023/05/04 17:45] – creado stefan
+++ usu:doc:firesinc [2025/01/17 12:16] (actual) – stefan
@@ Línea 32: / Línea 32: @@
 Añadimos una nueva cuenta desde el enlace //+ CREAR CREDENCIALES//:
+{{ :usu:doc:googlecloudconsolecuentaservicio.png?600 |Cuentas de servicio}}
+{{ :usu:doc:googlecloudconsolesa1.png?600 |Añadir cuenta paso 1}}
+{{ :usu:doc:googlecloudconsolesa2.png?600 |Añadir cuenta paso 2}}
+Ahora podemos ya dar en el botón //Listo// para crear la cuenta:
+{{ :usu:doc:googlecloudconsolesa3.png?600 |Nueva cuenta de servicio}}
+Desde el menú de acciones de la nueva cuenta escogemos //Administrar claves// y luego //Agregar clave/Crear clave nueva/JSON//.
+{{ :usu:doc:googlecloudconsolesa4.png?600 |Clave nueva}}
+Al dar en //Crear// se nos baja un fichero JSON que contiene la clave para usar la cuenta de servicio desde nuestro programa //firesinc//. Se lo tenemos que pasar a Smart de forma segura.
+===== Configuración en SmartOffice =====
+En SmartOffice, menú //Herramientas/Sincronización//, tenemos que crear una orden de sincronización con código ''FS'', que define todas las tablas (o vistas) que queremos sincronizar.
+{{ :usu:doc:firesincordensinc.png?600 |Orden de sincronización}}
+Empezamos creando las tablas, //Herramientas/Sincronización/Tablas//, que deben de tener ciertas características:
+  * Tienen que tener un campo para guardar la fecha y hora de sincronización (ej .''FECHA_SINC''), cuyo nombre de campo se apunta en la columna correspondiente de la rejilla.
+  * Cuando se inserta o modifica un registro hay que poner el campo ''FECHA_SINC'' en nulo, por ejemplo en el trigger "Before update or insert".
+  * Tienen que disponer de un campo para marcar un registro borrado, ej. ''BORRADO'', de tipo ''SINO''. En lugar de borrar un registro en la tabla, lo que hay que hacer es poner ese campo en ''S''. Luego se encarga nuestro programa de sincronización //FireSinc// de borrar el registro tanto en la nube como en Smart.\\ El nombre del campo se anota en la columna correspondiente en la rejilla de las tablas de sincronización.
+  * En los triggeres "After update, insert, delete" se tiene que incluir el envío de una notificación al programa //FireSinc//, para que se incicie la sincronización.
+Después de crear las tablas hay que crear una tarea por tabla en //Herramientas/Sincronización/Tareas//. Cada tarea hace referencia a una tabla, y además se tiene que comprobar los siguientes campos:
+  * //Dir. cliente a servidor//: ''S''-Sincronizar de la nube a Smart.\\ ''N''-Sincronizar de Smart a la nube.\\ Si además se pone ''S'' en el campo //Bidireccional//, entonces este campo solamente define la dirección que se sincroniza primero.
+  * //Bidireccional//: ''S''-Sincronizar en ambas direcciones.
+Finalmente se añade la tarea a la orden de sincronización, //Herramientas/Sincronización/Ordenes//, poniendo ''S'' en el campo //Activo// para activarla.
+===== Campos blob (imagenes etc.) =====
+Cada campo en la nube (en Cloud Firestore) solamente puede guardar 1.048.487 bytes, ver [[https://firebase.google.com/docs/firestore/quotas#collections_documents_and_fields]]. Por esta limitación tenemos que dividir los campos blob en varios trozos. En las siguientes imágenes vemos como se guarda una imagen en el campo ''DOC''.
+{{ :usu:doc:blob1.jpg?800 |Blob 1}}
+{{ :usu:doc:blob2.jpg?800 |Blob 2}}
+En el campo en si, ''DOC'', solamente se guarda un valor //hash// de la imagen (''gjoz5g==''). Los datos mismos se guardan en la colección //DOC//, que contiene los documentos ''0'', ''1'', ''2'', etc. cada uno con un solo campo ''blob'' llenado con un trozo de 1.048.487 bytes.
+Para tratar de forma fácil estos documentos tipo blob existen dos clases en el fichero ''src/firestore.ts'' de nuestro proyecto en git //firesinc//:
+  * FSBlobWriter extends Writable: Para guardar un blob en la nube.
+  * FSBlobReader extends Readable: Para leer un blob de la nube.
+El uso se puede ver en los dos ficheros ''sinc.ts'' y ''firebird.ts''.
+  [...]
+  const docRef = that.fsdb.doc(`${that.claveInst}/${t.nomTabla}/DATOS/${id}`);
+  const fsBlob = new FSBlobWriter(fstr, docRef, 'DOC');
+  fsBlob.Write(...)
+  [...]