Guardar y corregir un registro
Escribe un campo declarado en la entidad prevista y después vuelve a leer su valor actual y la observación que lo produjo.
Antes de una escritura estructurada
Busca la entidad existente si puede haber una y examina su esquema activo. Usa el tipo de entidad y los campos de nivel superior declarados por el esquema. store acepta entidades estructuradas mediante MCP, CLI o HTTP. La CLI admite --entities para JSON o --file para un archivo JSON; la referencia CLI completa detalla las opciones y marcas de procedencia. El contrato OpenAPI indica la forma de la solicitud HTTP.
Si el hecho procede de un archivo, conserva la fuente y registra, cuando corresponda, la vía de interpretación. Un hecho directo dado en una conversación o por una aplicación no necesita fingir que vino de un documento aparte. Elige un origen de observación que describa la clase de escritura y conserva un origen de datos útil cuando el contrato lo permita.
Comprueba el resultado
Conserva el ID de entidad devuelto. Recupera su instantánea actual y comprueba el campo y valor exactos que querías escribir. Si falta el campo, examina el esquema y los fragmentos sin procesar de la observación. Una solicitud aceptada puede conservar un campo no declarado sin proyectarlo en la instantánea de la entidad. No repitas la escritura con una identidad o clave de idempotencia nueva hasta saber si la primera llegó a guardarse.
Para corregir, lee antes el valor actual y su historial de observaciones. La acción habitual de corrección crea una observación nueva y recalcula la instantánea; no edita la observación ni la fuente anteriores. Después vuelve a leer la instantánea y compara la procedencia del campo y el historial. Si el valor previsto aún no es actual, examina la política de combinación del campo en vez de suponer que debe ganar la solicitud más reciente.
Mantén distintas las versiones
La versión 0.26.0 incluye opciones de corrección condicional y una operación de transacción atómica acotada. Las instalaciones anteriores pueden carecer de ellas. Consulta la ayuda de la CLI instalada o la descripción OpenAPI de esa instancia. Esquemas y reglas de campo explica por qué aparece un campo en la vista actual. Examinar un cambio explica cómo auditar una corrección.
Temas relacionados
Buscar y leer un registroEmpieza por la identidad y el tipo de lo que necesitas; después examina el valor actual y su evidencia.
Examinar un cambioCompara el campo actual de una entidad con las observaciones que lo produjeron antes de concluir qué cambió.
Esquemas y reglas de campoEl esquema de una entidad declara qué campos pertenecen a un tipo y cómo las observaciones de cada campo se convierten en un valor actual.