Retroalimentação (Online e Offline)

O que é retroalimentação?

A retroalimentação na plataforma uMov.me consiste na atualização de campos em diversas entidades do sistema. A plataforma oferece retroalimentação tanto online quanto offline, permitindo que campos em entidades como Local, Tarefa, Item, Meus Cadastros e Agente sejam preenchidos por meio de informações fornecidas em atividades.

Por exemplo, em uma atividade de Pesquisa de Preços em Mercados, é possível configurar uma seção com itens e campos para preenchimento. Se for necessário que o campo de "último preço" seja enviado para a entidade Item, onde há um campo customizável para armazenar esse valor, a retroalimentação permitirá que, na próxima vez que o item for preenchido, o último preço registrado esteja disponível na atividade para que o usuário visualize essa informação.

Qual a diferença entre Retroalimentação Online e Offline?

Retroalimentação Online:

- Necessário sincronismo para alimentar o campo;

- O valor do campo alimentado na entidade é visível no center;

- O valor alimentado persiste na base/center mesmo que o usuário saia do aplicativo;

Retroalimentação Offline:

- Não é necessário sincronismo para alimentar o campo;

- O valor do campo alimentado na entidade não é visível no center;

- O valor alimentado não persiste na base/center se o usuário sair do aplicativo;

Como configurar uma retroalimentação?

Para configurar a retroalimentação, você precisará preencher uma das planilhas abaixo com as informações correspondentes.

Ao trabalhar com retroalimentação, é necessário especificar a entidade que receberá os dados, conforme mencionado: Local, Tarefa, Item, Meus Cadastros ou Agente. Cada entidade requer informações específicas, e por esse motivo existem duas planilhas diferentes para atender a cada necessidade. Por favor, certifique-se de utilizar a planilha correta de acordo com a entidade desejada.

Observação: As planilhas já possuem alguns valores preenchidos como exemplo. Ao acessá-las, faça uma cópia para poder realizar as edições necessárias.

Planilha para retroalimentar as entidades Local, Tarefa, Item e Agente:

Planilha Local, Tarefa, Item e Agente

Planilha para retroalimentar a entidade Meus Cadastros:

Mais adiante na documentação, há uma explicação detalhada sobre como preencher essa planilha.

Planilha Meus Cadastros

- código ambiente: Para pegar o código do ambiente, basta ir na engrenagem na parte superior direita do Center > API > copiar os 5 primeiros dígitos.

- código atividade origem, código campo origem e código campo destino: Extrair essas informações de dois modelos de exportação Cadastral(caso não encontre um destes modelos, entre em contato com o nosso Atendimento).

'Cadastro_Campos_Customizados' para campos customizados de entidades.

'Cadastro_Campos_Atividades' para campos de atividades.

Ensinando

- entidade a ser retroalimentada: A entidade a ser retroalimentada seria as citadas no início deste artigo, para qual entidade o valor do campo da atividade irá? Local? Tarefa? Item? Meus Cadastros? Agente?

Quando trabalhamos com retroalimentação em Meus Cadastros, algumas informações adicionais são necessárias. Ao criar um registro, precisamos definir dois campos na atividade: Descrição e Identificador (podendo ser o mesmo campo para ambos).

Ao atualizar, é necessário indicar qual campo servirá como referência para localizar o identificador do registro que será modificado.

Se a atividade permite tanto criação quanto atualização de registros, o sistema precisa de parâmetros para determinar o comportamento. Um campo na atividade servirá como identificador e descrição do registro. Esse campo será usado para verificar se o registro já existe no dataset. Se o identificador for encontrado, o registro será atualizado; caso contrário, um novo registro será criado.

Exemplo:

Evelyn está executando uma atividade que criará ou editará um registro. Ao executar a atividade, o sistema utilizará um campo que contém a palavra "EvelynNovoRegistro", que serve como identificador para verificar se o registro já existe. Caso o registro exista, o sistema o atualizará; caso contrário, será criado um novo.

Na planilha(Meus Cadastros), já existem duas linhas preenchidas como exemplo, apenas para referência dos campos Descrição e Identificador do Registro.

‘Regras:

Criar: É obrigatório informar os campos Descrição e Identificador.

Criar/Atualizar: É obrigatório informar os campos Descrição e Identificador. O Identificador será utilizado como critério para localizar e atualizar o registro existente.

Atualizar: É obrigatório informar o campo Identificador, que será utilizado como critério para localizar e atualizar o registro.

Concluindo o preenchimento da planilha, basta enviar a mesma para o ajuda@umov.me com o assunto 'Configurar retroalimentação' que o time do Suporte irá efetuar as configurações necessárias para que a retroalimentação seja feita.