Quero cadastrar metadados para os meus usuários via CSV
Você pode cadastrar metadados para os seus usuários a qualquer momento: na criação, no convite ou na atualização via CSV. Para saber como utilizar os metadados, confere o nosso artigo clicando aqui.
Para saber como cadastrar metadados, basta seguir os exemplos:
Na hora de convidar
Deve-se usar a ação INVITE e inserir obrigatoriamente o campo email. Além disso, devem-se inserir, é claro, as colunas referentes aos metadados. No caso, estamos inserindo as informações de squad e chapter.
Exemplo:
Na linha 2, estamos convidando a usuária Gabi e já cadastrando os metadados de squad (no caso, TechOps) e chapter (no caso, CX) para ela.
Quando a Gabi aceitar o e-mail de convite, o seu usuário será criado automaticamente com esses metadados. A nomenclatura para metadados funciona assim: squad é uma das chaves do metadado e TechOps é o seu valor. Analogamente, chapter é a outra chave do metadado e CX é o seu valor.
Na hora de criar
Deve-se usar a ação CREATE e inserir obrigatoriamente os campos name, email e/ou username, password e, claro, os campos referentes aos metadados. Assim como no exemplo anterior, estamos inserindo as informações de squad e chapter (chaves).
Exemplo:
Na linha 2, estamos criando a usuária Gabi utilizando o e-mail gabriella@email.com e já cadastrando os metadados de squad (valor: TechOps) e chapter (valor: CX) para ela.
Assim que o CSV for processado, o usuário será criado automaticamente com esses metadados.
Após a criação do usuário
É possível cadastrar / atualizar metadados para um usuário mesmo após a sua criação. Basta usar a ação OVERWRITE e inserir obrigatoriamente os campos id (preenchido com o e-mail ou o username) e os campos referentes aos metadados.
Exemplo:
Na linha 2, estamos atualizando a usuária identificada pelo e-mail gabriella@email.com e cadastrando ou atualizando os seus metadados de squad e chapter.
Então, para adicionar, por exemplo, o metadado de tribe, mas manter os metadados de squad e chapter intactos, deve-se preencher o CSV da seguinte forma:
ou da seguinte forma:
Assim, o não preenchimento das células nas colunas C (squad) e D (chapter) não afetará os metadados já cadastrados.
Agora, se subirmos o arquivo seguinte:
As chaves squad e chapter serão removidas, assim como seus valores.
Se você, por algum motivo, quiser manter um a chave de um metadado com valor vazio, você pode subir o arquivo com a célula correspondente preenchida com [DELETE].
Então, por exemplo, se subirmos o arquivo seguinte:
Restará uma única chave para a gabriella@skore.io - tribe - mas no caso com um valor vazio.