Comandos

En DataEase, cada fila en su archivo de importación puede incluir un comando. Este comando le indica a la aplicación qué hacer con esa fila de datos. Puede actualizar un elemento existente, crear uno nuevo, eliminar algo o incluso omitir la fila por completo.

Cada tipo de dato en DataEase puede admitir comandos personalizados adicionales, que se documentan en sus páginas específicas de entidad.

---

⚙️ Comando Predeterminado: MERGE

• La aplicación intentará encontrar un elemento existente y actualizarlo usando los datos en la fila.
• Si no se encuentra ningún elemento, creará uno nuevo.

✅ Este es el comando más común y funciona tanto para actualizar como para agregar nuevos registros.

---

✳️ Comando Crear: CREATE

• La aplicación intentará crear un nuevo elemento.
• Si un elemento ya existe (con el mismo ID o handle), la fila fallará.

✅ Use esto solo cuando importe datos completamente nuevos.
❌ No lo use si algunos de los datos ya podrían existir.

---

🔁 Comando Actualizar: UPDATE

• La aplicación buscará un elemento existente y lo actualizará.
• Si no puede encontrar una coincidencia, la fila fallará.

✅ Mejor para actualizar solo registros existentes.
❌ No crea nuevos elementos.

---

♻️ Comando Reemplazar: REPLACE

• La aplicación buscará un elemento existente.
• Si encuentra uno, lo elimina.
• Luego crea uno nuevo usando solo los datos en esa fila.

⚠️ Tenga cuidado: Si faltan algunos datos en la fila, el nuevo elemento no los incluirá.

✅ Útil para reconstruir completamente registros con datos limpios.

---

❌ Comando Eliminar: DELETE

• La aplicación encontrará y eliminará el elemento.
• Si no se puede encontrar el elemento, la fila fallará.

✅ Use esto para eliminar registros antiguos o incorrectos.

---

⏭️ Comando Ignorar: IGNORE

• La aplicación omitirá esta fila y no hará nada con ella.

✅ Útil para eliminar temporalmente filas de la importación sin eliminarlas del archivo.

---

📝 Tabla Resumen de Comandos

Comando	Qué hace	¿Crea nuevos elementos?	¿Actualiza existentes?	¿Elimina existentes?
MERGE	Actualiza o crea si no se encuentra el elemento	✅	✅	❌
CREATE	Crea solo nuevos elementos	✅	❌	❌
UPDATE	Actualiza solo si el elemento ya existe	❌	✅	❌
REPLACE	Elimina existentes y crea nuevos con valores actuales	✅	❌	✅
DELETE	Elimina elementos existentes	❌	❌	✅
IGNORE	Omite la fila por completo	❌	❌	❌

---

💡 Cómo Agregar Comandos en Su Archivo

En su archivo de importación, incluya una columna llamada command y llénela con uno de los valores admitidos (como MERGE, CREATE, etc.).

title,handle,price,command
"Red T-shirt","red-tee",19.99,MERGE
"Blue T-shirt","blue-tee",21.99,CREATE
"Old Product","old-handle",,DELETE