1957 Iniciar Smart Component
Neste recurso são utilizados os 1947_Smart_Component para importação de dados, execução de tarefas, dentre outros.
Fluxo Principal
- Pesquise o 1947_Smart_Component
- Selecione o perfil de uso [Opcional]. Ao selecionar um perfil de uso, os ultimos dados utilizados, os parâmetros são recuperados e setados nos respectivos parâmetros.
- Informe os valores para cada parâmetro do Smart Component.
Posteriormente, você terá, com base nas opções 3 possíveis uso:
- Pré Visualizar: Se informado no 1947_Smart_Component que permite pré-visualização, esta opção estará visivel. Como exemplo, em Smart Components de importação de dados, é gerado uma planilha com os dados a serem preenchidos. É importante frisar que não são todos os Smart Components que terão esta opção ativada, mesmo os de importação. Alguns destes Smarts de importação, podem trabalhar com arquivos em XML ou JSON, que são formatos específicos. Neste caso é recomendável consultar a documentação técnica do Smart.
- Executar Smart Component: habilitado somente para smarts do tipo execução. Estes são Smarts que realizam operações especificas, como por exemplo enviar emails de cobrança para clientes com titulos vencidos.
- Importar Dados: habilitado somente para smarts do tipo importação. Por este botão, realiza-se o upload do arquivo de importação de dados a ser analisado e importado.
Problemas e Soluções
Opção de Pré-visualização não aparece
Deve estar marcado em 1947_Smart_Component a opção de pre-visualizar. Vale lembrar que não são todos os Smarts que possuem esta opção. É importante consultar a documentação técnica dele para mais detalhes sobre o suporte a esta opção. A grande maioria dos Smarts de importação suportam esta opção. Por outro lado, os de importação sobre layout especificos não suportam, como por exemplo um Smart que importa XML de notas fiscais. Afinal o arquivo a ser importado é o próprio XML da nota fiscal.
Parâmetros não são memorizados
Somente são memorizados os parametros se selecionado um perfil, e posteriormente ser realizado alguma ação sobre o smart: pre-visualizar, executar ou importar.
Reimportação e Integridade de Dados
Ao utilizar Smart Components de importação, é comum que ocorram erros parciais (ex: algumas linhas importam e outras não). Para garantir a integridade e evitar duplicidade, siga estas diretrizes:
- Sempre utilize a última planilha de retorno: Se o sistema gerou um erro, ele disponibiliza uma planilha com os logs. Utilize este arquivo específico para correções, pois ele contém a coluna de "Status de Importação" que o sistema utiliza como referência. Faça as devidas correções nesse mesmo arquivo se possível.
- Inteligência de Status (Coluna de Status):
- Status 1 (Sucesso): O sistema ignora automaticamente essas linhas em uma nova carga. Mantenha-os na planilha, isso evita que dados já existentes sejam sobrescritos ou duplicados.
- Status 0 ou Vazio (Erro/Pendente): O sistema tentará processar apenas estas linhas. Faça as devidas correções conforme o erro específico apontado na primeira tentativa, em caso de dúvidas sobre a mensagem de erro, entre em contato com um desenvolvedor(gestão interna) ou através do suporte da Touch Comp.
- Adicionando novas linhas: Se precisar incluir novos dados em uma planilha que já foi parcialmente processada, basta adicionar as novas linhas ao final do arquivo e deixar a coluna de Status vazia. O sistema entenderá que são novos registros e tentará a importação.
- Importante: Nunca apague ou altere a estrutura de cabeçalho da planilha de retorno, pois o Smart Component depende dela para identificar onde cada dado deve ser gravado.