Incluir datos iniciales en una solución
Objetivo
Hacer que las filas que necesita una solución (datos de referencia, filas de configuración, un conjunto de ejemplo) viajen dentro del paquete de la solución, de modo que al importarla en un entorno vacío este quede listo para usarse en lugar de listo para rellenarse.
Requisitos previos
- Ha iniciado sesión con un rol de creador (o de administrador de la plataforma).
- La tabla cuyas filas deben viajar es un componente de la solución, y las filas existen en el entorno desde el que exporta.
Pasos
- Abra la tabla en Tablas y vaya a la pestaña Vistas.
- Seleccione Nuevo para abrir el diseñador de vistas.
- Escriba un nombre para mostrar (por ejemplo,
Thresholds that ship) y un nombre lógico después del prefijo del editor, por ejemploapproval_threshold_seed. - Establezca Tipo de vista en Datos iniciales y elija qué son las filas en Las
filas son:
- Configuración: filas que la solución necesita para funcionar, como umbrales de aprobación o una lista de regiones. Todas las importaciones las traen, también a Producción.
- Demostración: filas que sirven para mostrar la solución, como clientes inventados. Una importación solo las trae cuando se le pide, y nunca a Producción.
- Arrastre al encabezado de la cuadrícula todos los campos que deben viajar. Deje fuera lo que es de este entorno y no de la fila: un importe comprometido, una fecha de última ejecución, un contador.
- Agregue un filtro si solo deben viajar algunas filas; por ejemplo, Estado es igual a Activo. Sin filtro, viajan todas las filas.
- Seleccione Guardar.
- Exporte la solución desde la página Soluciones. El paquete lleva ahora un documento de datos iniciales para la tabla, con las filas que devolvió la vista.
- Importe el paquete en otro entorno. Las filas de configuración llegan con él. Si lleva filas de demostración, la importación pregunta primero: marque Incluir datos de demostración para traerlas. Cuando termina la importación, un mensaje indica cuántas filas se crearon, cuántas se actualizaron, nombra las que se omitieron e indica cuántas filas de demostración se dejaron fuera.
La configuración llega siempre; la demostración, solo cuando se pide
La opción Las filas son de la vista de datos iniciales decide qué hace una importación con las filas.
| Configuración | Demostración | |
|---|---|---|
| Es | lo que la solución necesita para funcionar: umbrales, regiones, ajustes que lee un script | lo que sirve para mostrarla: clientes inventados, un año de historial de ejemplo |
| Una importación | la trae siempre | la trae solo cuando se marca Incluir datos de demostración |
| Producción | sí | nunca: la casilla está deshabilitada y la plataforma lo rechaza |
La demostración nunca llega a Producción porque las filas importadas allí quedarían mezcladas con las de sus propios clientes sin nada que las distinguiera, y desinstalar la solución no las quitaría. La configuración llega siempre porque un entorno sin ella no funciona.
Elija Configuración solo para filas que sean iguales en todos los lugares donde se ejecuta la solución. Una fila que un entorno modifica para sí mismo se sobrescribe en la siguiente importación.
Qué ocurre entre bastidores
Una vista de datos iniciales nunca se muestra a nadie: es una pregunta que hace la exportación. Su filtro responde a qué filas y sus columnas, a qué campos. Una tabla con varias vistas de este tipo usa la marcada como predeterminada o, si no la hay, la primera por nombre lógico.
Cada fila viaja con su id, y la importación inserta o actualiza según ese id: una fila que el destino no tiene se crea con el mismo id; una fila que ya tiene se actualiza solo en las columnas empaquetadas y conserva todos los demás valores. Nunca se elimina nada. Como el id es el mismo en todos los entornos, una fila inicial puede apuntar a otra (una línea de presupuesto a su programa), y la importación escribe las tablas en el orden adecuado para que funcione. Una búsqueda que apunta a una fila de la misma tabla se rellena cuando ya existen todas las filas.
Cada fila pasa por la ruta de escritura de registros habitual: se valida contra la tabla, se atribuye a la importación, se comprueba contra las búsquedas del destino y los pasos de complemento de la tabla se ejecutan sobre ella, incluido un paso que trajo la misma solución.
Lo que una fila inicial no hace es iniciar un proceso de negocio. Un proceso que se inicia cuando se crea un registro trata de que alguien cree uno; una fila inicial es la imagen que la solución tiene de una tabla tal como quedó: una solicitud ya aprobada, otra ya rechazada. Lanzar el proceso por cada fila empaquetada iniciaría una ejecución por fila y dejaría que el primer paso del propio proceso sobrescribiera el estado con el que se envió la fila. Eso también significa que una fila inicial con un estado de espera no tiene ninguna tarea detrás: un paquete lleva filas, no ejecuciones. Si la demostración necesita una tarea real, cree un registro en el entorno importado: ese sí se enruta.
Una fila que el destino rechaza (casi siempre, una búsqueda que apunta a un registro que el destino no tiene) se omite y se nombra, por tabla, id y motivo, en lugar de hacer fallar la importación. Para entonces ya han llegado las tablas, los formularios y las vistas, y una importación que fallara por una sola fila dejaría el entorno importado a medias.
Hay cosas que deliberadamente no viajan: el propietario (los usuarios son de cada inquilino), las marcas de creación y modificación y la versión de fila (son del destino), y las columnas de archivo e imagen (sus bytes viven en el entorno de origen). Las columnas de numeración automática las genera el destino.
Solución de problemas
- La importación dice que se omitió una fila. Lea el motivo: es la misma frase que mostraría un formulario. Una búsqueda que apunta a un registro que no existe significa que al destino le falta una fila que el paquete daba por supuesta; agregue las filas de esa tabla al paquete, o el registro al destino.
- Se sobrescribió una fila que modifiqué en el destino. Eso es lo que hace volver a importar: las columnas empaquetadas son de la solución. Deje los valores propios de cada entorno fuera de las columnas de la vista de datos iniciales.
- La exportación se rechaza con «devuelve N filas». Un paquete lleva como máximo 10.000 filas por tabla. Acote el filtro de la vista (los datos iniciales son datos de referencia, no historial) o cargue las filas con una importación CSV.
- No viajó nada. Compruebe que el tipo de la vista sea Datos iniciales y que esté en una tabla que contiene la solución. Si sus filas son de Demostración, compruebe que se marcó Incluir datos de demostración en la importación.
- La casilla Incluir datos de demostración aparece atenuada. El entorno es de Producción, donde nunca se importan datos de demostración. Las filas de configuración llegan igualmente.
- Filas que la solución necesita no llegaron a Producción. Su vista de datos iniciales dice Demostración. Cámbiela a Configuración, vuelva a exportar la solución e impórtela.
- Al desinstalar la solución se quedaron las filas. Las filas de una tabla propiedad de la solución se van con la tabla. Las que agregó a una tabla que pertenece a otra solución se quedan, porque la tabla se queda.