Comandos

No DataEase, cada linha no seu arquivo de importação pode incluir um comando. Este comando informa ao aplicativo o que fazer com aquela linha de dados. Ele pode atualizar um item existente, criar um novo, excluir algo ou até mesmo pular a linha completamente.

Cada tipo de dado no DataEase pode suportar comandos personalizados adicionais, que são documentados em suas páginas de entidade específicas.

---

⚙️ Comando Padrão: MERGE

• O aplicativo tentará encontrar um item existente e atualizá-lo usando os dados na linha.
• Se nenhum item for encontrado, ele criará um novo.

✅ Este é o comando mais comum e funciona tanto para atualizar quanto para adicionar novos registros.

---

✳️ Comando Criar: CREATE

• O aplicativo tentará criar um novo item.
• Se um item já existir (com o mesmo ID ou handle), a linha falhará.

✅ Use isso apenas ao importar dados completamente novos.
❌ Não use se alguns dos dados já puderem existir.

---

🔁 Comando Atualizar: UPDATE

• O aplicativo procurará um item existente e atualizá-lo.
• Se não conseguir encontrar uma correspondência, a linha falhará.

✅ Melhor para atualizar apenas registros existentes.
❌ Não cria novos itens.

---

♻️ Comando Substituir: REPLACE

• O aplicativo procurará um item existente.
• Se encontrar um, ele o excluirá.
• Em seguida, criará um novo usando apenas os dados naquela linha.

⚠️ Tenha cuidado: Se alguns dados estiverem faltando na linha, o novo item não os incluirá.

✅ Útil para reconstruir completamente registros com dados limpos.

---

❌ Comando Excluir: DELETE

• O aplicativo encontrará e excluirá o item.
• Se o item não puder ser encontrado, a linha falhará.

✅ Use isso para remover registros antigos ou incorretos.

---

⏭️ Comando Ignorar: IGNORE

• O aplicativo pulará esta linha e não fará nada com ela.

✅ Útil para remover temporariamente linhas da importação sem excluí-las do arquivo.

---

📝 Tabela Resumo de Comandos

Comando	O que faz	Cria novos itens?	Atualiza existentes?	Exclui existentes?
MERGE	Atualiza ou cria se o item não for encontrado	✅	✅	❌
CREATE	Cria apenas novos itens	✅	❌	❌
UPDATE	Atualiza apenas se o item já existir	❌	✅	❌
REPLACE	Exclui existente e cria novo com valores atuais	✅	❌	✅
DELETE	Exclui itens existentes	❌	❌	✅
IGNORE	Pula a linha completamente	❌	❌	❌

---

💡 Como Adicionar Comandos no Seu Arquivo

No seu arquivo de importação, inclua uma coluna chamada command e preencha-a com um dos valores suportados (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