Wix Blocks: crear y administrar colecciones
3 min de lectura
Wix Blocks está abierto a todos los usuarios de Wix Studio. Para acceder a Blocks, únete a Wix Studio.
Wix Blocks te permite agregar colecciones (bases de datos) a tu app. Administrar las colecciones en Blocks es similar a administrar colecciones en los sitios de Wix. Sin embargo, hay algunos puntos que son muy diferentes. Consúltalos en este artículo.
Consejo
Presta atención a los permisos de la colección y sus pautas de seguridad.
Una colección de Blocks es un marcador de posición
Lo más importante que debes entender sobre una colección de Blocks es que es un marcador de posición para los datos de cualquier sitio en el que esté instalada. Esto se debe a que una colección de Blocks puede usarse en varios sitios, incluso en miles de ellos. Estos sitios pueden ser muy diferentes entre sí y tener sus propias bases de datos. Piensa en una colección que contenga información de los clientes. Cada sitio puede tener una lista de sus propios clientes, y tu widget puede aplicarse a todos ellos.
Cuando creas una colección en Blocks, defines los campos de la colección y haces posible la referencia a ella en el código de la app. También puedes agregar datos predeterminados en Blocks, pero no es obligatorio. Si agregas datos predeterminados, se instalan automáticamente en el sitio junto con la app y pueden reemplazarse más tarde por datos de cualquier sitio en el que esté instalada la app.
Si cambias la estructura de una colección en Wix Blocks en una versión futura de tu app, esto afectará a cualquier sitio en el que esté instalada. Por lo tanto, trabaja con precaución y no realices cambios que puedan romper los sitios.
Nota
Las colecciones de Blocks se cuentan dentro del límite de ítems y colecciones del CMS.
Acerca de los datos predeterminados
Los datos que agregues a tus colecciones de Blocks se importarán al sitio en el que esté instalada tu app. Esto proporcionará a los creadores de tu sitio los datos predeterminados para tu app. Si eliges agregar datos predeterminados, ten en cuenta lo siguiente:
- El sitio en el que está instalada tu app puede cambiar esos datos más adelante.
- Los datos predeterminados solo se importarán en la primera instalación. Si lanzas una nueva versión de tu app y cambias los datos de la colección, no se anularán los datos que ya existen en cualquier sitio en el que esté instalada tu app.
Para agregar una colección a tu app
- Haz clic en el icono Base de datos
en el menú de la izquierda de tu app. - Haz clic en Nueva colección.
- Crea un espacio de nombres para tu app si aún no lo has hecho. Haz que el espacio de nombres sea significativo y claro (si aún no has nombrado tu app, se te indicará que le pongas un nombre en ese momento).
- Asígnale un nombre a la colección.
- Define la estructura de tu colección en el CMS.
- Opcional: agrega ítems a la colección. Estos datos predeterminados se importarán junto con tu app a cualquier sitio en el que esté instalada
Ver tu colección en el Editor
Cuando importas a tu sitio una app de Blocks que tiene una colección, la colección aparecerá en la sección CMS 
, debajo de Tus colecciones. El espacio de nombres de tu app aparecerá junto a esta colección para indicar que es de Blocks. A partir de ahora, puedes administrar la colección como en cualquier otro sitio de Wix.
, debajo de Tus colecciones. El espacio de nombres de tu app aparecerá junto a esta colección para indicar que es de Blocks. A partir de ahora, puedes administrar la colección como en cualquier otro sitio de Wix. Importante
Si eliminas la app del sitio, la colección también se eliminará.
Acceder a los datos de la colección a través del código
Primero, escribe esta declaración de importación en el código de tu widget:
1import wixData from 'wix-data';Para acceder a tu colección y realizar varias acciones, como consultar, insertar, etc., usa la siguiente sintaxis con cualquier API de wix-data. Por ejemplo, así es como consultas una colección (obtén más información sobre tu espacio de nombres):
1wixData.query("<yourAppNamespace>/<yourCollectionName>")
2 .find()
3 .then( (results) => {
4 //your code using the "results";
5 });Más información sobre cómo trabajar con la API de Wix Data
¿Te ha sido útil?
|