Como automatizar a criação de itens via arquivo CSV ?

Além da forma tradicional de criação de itens (pelo bucket, com o formulário de criação) é possível subir em uma categoria,  um conjunto de dados em um arquivo CSV que possibilitará a criação automática dos itens. 

Essa automação na criação de itens via CSV é ideal para aqueles momentos em que você tem muitos itens de uma mesma categoria para serem criados. Podemos até dizer que é uma criação de itens em massa!

A automação de cadastro via CSV acontece em três passos:

1º Passo: Criação do CSV de acordo com as especificações da categoria em que os itens serão criados;

2º Passo: Subir o CSV na plataforma;

3º Passo: Associar os ativos ao item criado.

1º Passo - Criação do CSV
1 - Primeiro, é necessário você saber em qual estrutura hierárquica você deseja cadastrar os itens. Considere: 

• Divisão : divisão do item;
• Segmento: segmento do item;
• Categoria: categoria do item;
• Nome: nome que o item terá na plataforma;
• Descrição: texto que descreve o item;
• Metadados: todos os metadados que existem na categoria em que você criará os itens precisam ser considerados. 

Por exemplo:

Desejo criar 5 itens na categoria Campanhas: 2 itens na estrutura de Recursos Humanos (divisão) > Seleção e Recrutamento (segmento) e os outros 3 itens na estrutura de Marketing (divisão) > Produtos (segmento). 

A categoria Campanhas possui dois metadados a serem preenchidos: Ano e Cor.

Além dessas informações estruturais, no CSV devemos definir o nome e a descrição do item. 

2 - Todos os dados descritos acima devem ser iguais aos dados que estarão no CSV e na plataforma, ou seja:

• Se na categoria no DAM está escrito Campanhas , no CSV deve estar escrito Campanhas.
• Se na categoria no DAM está escrito CAMPANHAS, no CSV deve estar escrito CAMPANHAS.

3 - Os valores de metadados, quando metadado for do tipo Lista, devem estar cadastrados previamente no DAM e deve ser iguais a sua correspondência no CSV.  Ou seja:

• Se no metadado Ano não tiver valor "2023"  no DAM e esse valor existir como valor do metadado Ano CSV, o item não será criado. 
• É necessário garantir que todos os valores de metadados de lista estarão cadastrados em seus respectivos metadados. 
• Se um metadado não possuir um valor e este não for um metadado obrigatório, o valor poderá ser vazio. 

4 - Metadados do tipo texto, número e data podem ser acrescentados normalmente no CSV, pois eles não possuem cadastro prévio no DAM.

5 - Para criar um CSV, você pode adicionar todos os dados em um planilha e salvá-la como CSV com separador com " , " (vírgula)

• Na planilha: 
• Transformando em um arquivo CSV separado por vírgula

Anexo ao artigo, há o arquivo CSV que poderá ser utilizado como base :) 

6 - Certifique-se que não há quebras de linhas ou espaços não preenchidos. E que o CSV está na versão UTF-8 Feito isso, estamos prontos para o próximo passo!

2º Passo - Subir o CSV para criar os itens

1 - É verdade que a criação do CSV é mais detalhada, porque os dados precisam estar certinhos para subirmos o CSV e criarmos o item na plataforma. Mas, com o CSV criado, basta acessar o menu de Configurações, navegar até o menu Categorias e buscar pela categoria em que você criará os itens. 

2 - No nosso exemplo, vamos criar os itens na categoria Campanhas. Para isso, clique no botão "Criar itens"

 3 - E, em seguida, defina a publicação dos itens que será aplicada a toda a lista e arraste o CSV da sua máquina ou clicar para localizá-lo:

 4 - Aguarde, seu upload está em andamento e você será notificado na área de Notificações da plataforma quando for concluído:

 5 - Ao abrir os detalhes como sugerido acima, podemos checar se os itens foram criados ou se houve algum erro. 

• Se houve algum erro, será informado e nenhum item será criado. Neste caso, é necessário checar o CVS para analisar o erro e corrigi-lo. 
• Se não houver nenhum erro, todos os itens foram criados em Rascunhos, sem ativos associados e como despublicados, mas com todos os dados que estavam no CSV. 

6 - Em nosso exemplo, os itens foram criados com Sucesso, veja o log!

7 - Consultando no DAM, todos os itens são exibidos em Rascunhos e foram criados na estrutura e com os dados configurados no CSV:

8 - Yap! Estamos prontos para associar os ativos!

3º Passo: Associar os ativos ao item criado

1 - Há algumas formas de associar um ativo a um item criado: 

• Pelo Gerenciar Ativos, onde você primeiro sobe os ativos no bucket e, no Gerenciador de Ativos, você acessa o bucket e faz a associação. 
• Por uma automação de associação de ativos, configurada por chave secundária nas categorias. 
• Por um automação via API (consulte nosso time de suporte, no suporte@yapoli.com,  para abordarmos as possibilidades).
• Arrastando os ativos para dentro do item

2 - Ao associar um ativo a um item (por um dos caminhos acima citados) este item sai da área de rascunhos e é exibido na estrutura na qual ele foi criado. 

Ah, e não esqueça de publicar seu item para que fique visível para todos os usuários :)