> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Módulo Entities > Operaciones CRUD en modelos de datos. Accede mediante base44.entities.EntityName.method(). Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la [documentación para desarrolladores](/developers). # Módulo Entities Operaciones CRUD en modelos de datos. Accede mediante `base44.entities.EntityName.method()`. ## Contenido * [Métodos](#methods) * [Ejemplos](#examples) (Create, Bulk Create, List, Filter, Get, Update, Delete, Subscribe) * [Entidad User](#user-entity) * [Acceso de rol de servicio](#service-role-access) * [Permisos](#permissions) ## Métodos **Nota:** El límite máximo para `list()` y `filter()` es 5.000 elementos por solicitud. | Método | Firma | Descripción | | ---------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------ | | `create(data)` | `Promise` | Crea un registro | | `bulkCreate(dataArray)` | `Promise` | Crea varios registros | | `list(sort?, limit?, skip?, fields?)` | `Promise[]>` | Obtiene todos los registros (paginado) | | `filter(query, sort?, limit?, skip?, fields?)` | `Promise[]>` | Obtiene registros que coinciden con las condiciones | | `get(id)` | `Promise` | Obtiene un solo registro por ID | | `update(id, data)` | `Promise` | Actualiza registro (actualización parcial) | | `updateMany(query, data)` | `Promise` | Actualiza todos los registros coincidentes usando operadores de actualización de MongoDB | | `bulkUpdate(dataArray)` | `Promise` | Actualiza varios registros por ID, cada uno con sus propios datos | | `delete(id)` | `Promise` | Elimina registro por ID | | `deleteMany(query)` | `Promise` | Elimina todos los registros coincidentes | | `importEntities(file)` | `Promise>` | Importa desde CSV (solo frontend) | | `subscribe(callback)` | `() => void` | Suscribe a actualizaciones en tiempo real (devuelve función de cancelación de suscripción) | ## Ejemplos ### Crear ```javascript theme={null} const task = await base44.entities.Task.create({ title: "Complete documentation", status: "pending", dueDate: "2024-12-31" }); ``` ### Crear en masa ```javascript theme={null} const tasks = await base44.entities.Task.bulkCreate([ { title: "Task 1", status: "pending" }, { title: "Task 2", status: "pending" } ]); ``` ### Listar con paginación ```javascript theme={null} // Obtener los primeros 10 registros, ordenados por created_date descendente (máx. 5.000 por solicitud) const tasks = await base44.entities.Task.list( "-created_date", // orden (SortField: prefijo con - para descendente) 10, // límite 0 // saltar ); // Obtener siguiente página const page2 = await base44.entities.Task.list("-created_date", 10, 10); ``` ### Filtrar ```javascript theme={null} // Filtro simple const pending = await base44.entities.Task.filter({ status: "pending" }); // Múltiples condiciones const myPending = await base44.entities.Task.filter({ status: "pending", assignedTo: userId }); // Con orden, límite, salto (máx. 5.000 por solicitud) const recent = await base44.entities.Task.filter( { status: "pending" }, "-created_date", // orden (SortField: prefijo con - para descendente) 5, 0 ); // Seleccionar campos específicos const titles = await base44.entities.Task.filter( { status: "pending" }, null, null, null, ["id", "title"] ); ``` ### Obtener por ID ```javascript theme={null} const task = await base44.entities.Task.get("task-id-123"); ``` ### Actualizar ```javascript theme={null} // Actualización parcial - solo cambian los campos especificados await base44.entities.Task.update("task-id-123", { status: "completed", completedAt: new Date().toISOString() }); ``` ### Eliminar ```javascript theme={null} // Registro único const result = await base44.entities.Task.delete("task-id-123"); console.log("Deleted:", result.success); // Varios registros que coinciden con la consulta const manyResult = await base44.entities.Task.deleteMany({ status: "archived" }); console.log("Deleted:", manyResult.deleted); ``` ### Actualizar varios (estilo MongoDB) ```javascript theme={null} // Actualizar todas las tareas pendientes a estado "in-progress" const result = await base44.entities.Task.updateMany( { status: "pending" }, // consulta: qué registros actualizar { $set: { status: "in-progress" } } // operador de actualización de MongoDB ); console.log("Updated:", result.updated); // Incrementar un campo contador await base44.entities.Task.updateMany( { category: "bugs" }, { $inc: { priority: 1 } } ); ``` ### Actualización en masa (por ID) ```javascript theme={null} // Actualizar varios registros, cada uno con datos diferentes const updated = await base44.entities.Task.bulkUpdate([ { id: "task-1", status: "done", completedAt: new Date().toISOString() }, { id: "task-2", status: "in-progress", assignedTo: userId }, { id: "task-3", priority: 5 } ]); ``` ### Importar desde archivo ```javascript theme={null} // Solo frontend: importar desde CSV/archivo const result = await base44.entities.Task.importEntities(file); if (result.status === "success" && result.output) { console.log(`Imported ${result.output.length} records`); } else { console.error(result.details); } ``` ### Suscribirse a actualizaciones en tiempo real ```javascript theme={null} // Suscribirse a todos los cambios en la entidad Task const unsubscribe = base44.entities.Task.subscribe((event) => { console.log(`Task ${event.id} was ${event.type}:`, event.data); // event.type es "create", "update" o "delete" }); // Más tarde: cancelar suscripción para dejar de recibir actualizaciones unsubscribe(); ``` **Estructura del evento:** ```javascript theme={null} { type: "create" | "update" | "delete", data: { ... }, // los datos de la entidad id: "entity-id", // el ID de la entidad afectada timestamp: "2024-01-15T10:30:00Z" } ``` ## Entidad User Cada app tiene una entidad `User` integrada con reglas especiales: * Los usuarios regulares solo pueden leer/actualizar **su propio** registro * No se pueden crear usuarios mediante `entities.create()` - usa `auth.register()` en su lugar * El rol de servicio tiene acceso completo a todos los registros de usuario ```javascript theme={null} // Obtener el registro del usuario actual const me = await base44.entities.User.get(currentUserId); // Rol de servicio: obtener cualquier usuario const anyUser = await base44.asServiceRole.entities.User.get(userId); ``` ## Acceso de rol de servicio Para operaciones de nivel administrador (evitar permisos de usuario): ```javascript theme={null} // Solo backend const allTasks = await base44.asServiceRole.entities.Task.list(); const allUsers = await base44.asServiceRole.entities.User.list(); ``` ## Permisos (RLS y FLS) El acceso a datos está controlado por reglas de **Row Level Security (RLS)** y **Field Level Security (FLS)** definidas en los esquemas de entidad. 1. **Nivel de autenticación**: anónimo, autenticado o rol de servicio 2. **Reglas RLS**: Controlan qué registros (filas) pueden crear/leer/actualizar/eliminar los usuarios 3. **Reglas FLS**: Controlan qué campos pueden leer/escribir los usuarios dentro de los registros accesibles Las operaciones tienen éxito o fallan según estas reglas - no hay resultados parciales. RLS y FLS se configuran en los archivos de esquema de entidad (`base44/entities/*.jsonc`). Consulta [entities-create.md](https://docs.base44.com/developers/skills/base44-sdk/references/../../base44-cli/references/entities-create.md#row-level-security-rls) para detalles de configuración. **Nota:** `asServiceRole` establece el rol del usuario a `"admin"` pero NO evita RLS. Tus reglas RLS deben incluir acceso de administrador (por ejemplo, `{ "user_condition": { "role": "admin" } }`) para que las operaciones de rol de servicio tengan éxito. ## Definiciones de tipos ### RealtimeEvent ```typescript theme={null} /** Tipos de eventos para actualizaciones de entidad en tiempo real. */ type RealtimeEventType = "create" | "update" | "delete"; /** Carga útil recibida cuando ocurre un evento en tiempo real. */ interface RealtimeEvent { /** El tipo de cambio que ocurrió. */ type: RealtimeEventType; /** Los datos de la entidad. */ data: T; /** El identificador único de la entidad afectada. */ id: string; /** Marca de tiempo ISO 8601 de cuándo ocurrió el evento. */ timestamp: string; } /** Función de callback invocada cuando ocurre un evento en tiempo real. */ type RealtimeCallback = (event: RealtimeEvent) => void; ``` ### Tipos de resultado ```typescript theme={null} /** Resultado devuelto al actualizar varias entidades. */ interface UpdateManyResult { /** Si la actualización fue exitosa. */ success: boolean; /** Número de entidades que se actualizaron. */ updated: number; } /** Resultado devuelto al eliminar una sola entidad. */ interface DeleteResult { /** Si la eliminación fue exitosa. */ success: boolean; } /** Resultado devuelto al eliminar varias entidades. */ interface DeleteManyResult { /** Si la eliminación fue exitosa. */ success: boolean; /** Número de entidades que se eliminaron. */ deleted: number; } /** Resultado devuelto al importar entidades desde un archivo. */ interface ImportResult { /** Estado de la operación de importación. */ status: "success" | "error"; /** Mensaje de detalles, por ejemplo, "Successfully imported 3 entities with RLS enforcement". */ details: string | null; /** Array de objetos de entidad creados cuando tiene éxito, o null en error. */ output: T[] | null; } ``` ### SortField y campos del servidor ```typescript theme={null} /** * Tipo de campo de ordenación para consultas de entidad. * Admite ordenación ascendente (sin prefijo o '+') y descendente ('-'). * Ejemplo: 'created_date', '+created_date', '-created_date' */ type SortField = (keyof T & string) | `+${keyof T & string}` | `-${keyof T & string}`; /** Campos añadidos por el servidor a cada registro de entidad. */ interface ServerEntityFields { id: string; created_date: string; updated_date: string; created_by?: string | null; created_by_id?: string | null; is_sample?: boolean; } ``` ### Registro de tipos (para entidades tipadas) **Cómo obtener entidades tipadas:** La CLI de Base44 puede generar interfaces de entidad y una augmentación de `EntityTypeRegistry` desde tu proyecto. Para saber cómo ejecutarlo, usa la habilidad **base44-cli**. ```typescript theme={null} /** * Registro que mapea nombres de entidad a sus tipos TypeScript. * Aumenta esta interfaz con tu esquema de entidad (solo campos definidos por el usuario). * Normalmente lo rellena el generador de tipos de la CLI de Base44. */ interface EntityTypeRegistry {} /** * Tipo de registro completo para cada entidad: campos de esquema + campos inyectados por el servidor. */ type EntityRecord = { [K in keyof EntityTypeRegistry]: EntityTypeRegistry[K] & ServerEntityFields; }; ``` ### EntityHandler ```typescript theme={null} /** Manejador de entidad que proporciona operaciones CRUD para un tipo de entidad específico. */ interface EntityHandler { /** Lista registros con paginación y ordenación opcionales. Máx. 5.000 por solicitud. */ list( sort?: SortField, limit?: number, skip?: number, fields?: K[] ): Promise[]>; /** Filtra registros basados en una consulta. Máx. 5.000 por solicitud. */ filter( query: Partial, sort?: SortField, limit?: number, skip?: number, fields?: K[] ): Promise[]>; /** Obtiene un solo registro por ID. */ get(id: string): Promise; /** Crea un nuevo registro. */ create(data: Partial): Promise; /** Actualiza un registro existente. */ update(id: string, data: Partial): Promise; /** Elimina un solo registro por ID. */ delete(id: string): Promise; /** Elimina varios registros que coinciden con una consulta. */ deleteMany(query: Partial): Promise; /** Crea varios registros en una sola solicitud. */ bulkCreate(data: Partial[]): Promise; /** * Actualiza varios registros que coinciden con una consulta usando operadores de actualización de MongoDB. * @param query - Filtro para seleccionar qué registros actualizar. * @param data - Objeto de operador de actualización de MongoDB (por ejemplo, `{ $set: { field: value } }`). */ updateMany(query: Partial, data: Record>): Promise; /** Actualiza varios registros por ID, cada uno con sus propios datos de actualización. */ bulkUpdate(data: (Partial & { id: string })[]): Promise; /** Importa registros desde un archivo (solo frontend). */ importEntities(file: File): Promise>; /** Suscribe a actualizaciones en tiempo real. Devuelve una función de cancelación de suscripción. */ subscribe(callback: RealtimeCallback): () => void; } ``` ### EntitiesModule ```typescript theme={null} /** Módulo Entities: las claves de registro tipadas obtienen manejadores tipados; el acceso dinámico permanece sin tipar. */ type EntitiesModule = TypedEntitiesModule & DynamicEntitiesModule; type TypedEntitiesModule = { [K in keyof EntityTypeRegistry]: EntityHandler; }; type DynamicEntitiesModule = { [entityName: string]: EntityHandler; }; ``` Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).