Manual Recurso Code Implementation. FullCopyConvert Data

Transcrição

1 Manual Recurso Code Implementation. FullCopyConvert Data Revisão: Novembro / 2016

2 Sumário Bem-vindo ao FullCopyConvert Data! Estas instruções irão guiá-lo para utilizar o recurso Code Implementetion(Implementação de Código). Sobre o FullCopyConvert Data Contato Code Implementation - Inicio Code Implementation Criando Funções próprias Edição: Suporte Técnico FullCopyConvert Data 2

3 Sobre o FullCopyConvert Data. FullCopyConvert é uma ferramenta especializada em conversão e migração de dados, oferece uma forma confortável e fácil de converter suas informações de um banco de dados para outro. Com o FullCopyConvert você poderá converter as informações das seguintes bases de dados disponíveis. Contato. O suporte do FullCopyConvert Data é feito através de . É necessário apenas enviar um para suporte@fullcopyconvert.com.br relatando o problema o ocorrido ou mesmo uma dúvida. Edição: Suporte Técnico FullCopyConvert Data 3

4 1 Code Implementation - Inicio. O FullCopyConvert conta com um recurso de implementação de código pascal. Onde você poderá utilizar funções nativas do FullCopyConvert ou mesmo poderá criar suas próprias funções. Este recurso é bastante útil principalmente nas importações de arquivos csv, excel e access, pois conta com pouquíssimas funções para realização de tratamentos dos dados. Mas nada impede que esse recurso possa ser utilizado para outros tipos de bases de dados que se deseja realizar a migração ou conversão dos dados. 1. Agora vamos ver um pouco na prática como iremos utilizar esse recurso no FullCopyConvert. Abra o FullCopyConvert e vá até a 4 (quarta etapa). Selecione uma tabela que deseja trabalhar e depois de informar os dados da Aba 2 SQL/Tabela Origem, clique na aba 3 Mapeamento de Campos. Localize o campo que deseje realizar um tratamento e clique com o botão direito do mouse e selecione a opção Code Implementation ou mesmo pressione Ctrl + E. Como demonstra imagem abaixo: 2. Após acessar a opção mencionada anteriormente note que irá abrir a seguinte tela. E já irá retornar uma função chamada fmain. Essa função é o ponto de entrada de cada coluna que se deseja realizar o tratamento. A função fmain não pode ser alterada e não poderá acrescentar mais parâmetros de entrada nesta função. A função fmain serve como um ponto Edição: Suporte Técnico FullCopyConvert Data 4

5 de entrada do FullCopyConvert. A cada passada de registro nesta determinada coluna o FullCopyConvert irá realizar a chamada da função fmain e irá retornar os dados que da própria função gerar. É muito importante que exista o ponto de retorno da função no caso Result. Veja abaixo a função original sem alteração na mesma. 3. Vamos a um pequeno exemplo do que podemos fazer nessa função. Veja os comentários. 4. No exemplo da tela acima podemos ver que fizemos alguns tratamentos: se o valor for vazio, se for MT ou se não entrou em algumas das condições, iremos remover qualquer número que retornar no valor. Veja um exemplo de como será gerado o script. Edição: Suporte Técnico FullCopyConvert Data 5

6 2 Code Implementation Criando Funções próprias. Além de utilizar as funções nativas no FullCopyConvert, você poderá criar suas próprias funções. E poderá utiliza-las na chamada da função fmain. 1. Agora vamos ver um pouco na prática como iremos utilizar esse recurso no FullCopyConvert. Acesse a opção de Code Implementatin como relatado no item 1.1 anteriormente. Expanda o treeview Function e irá notar o item Mine, que corresponde as funções próprias. Edição: Suporte Técnico FullCopyConvert Data 6

7 2. Note na imagem acima que você pode escolher em criar uma função public ou private. Public Funções públicas podem ser reaproveitadas em outros projetos de conversão e migração. Private Funções privadas podem ser somente utilizadas no projeto de conversão atual. 3. Selecione em qual irá se enquadrar sua função e clique com o botão direito do mouse e selecione a opção Criar Função Como demostra a imagem do item Como podemos observar na imagem acima o FullCopyConvert já criou uma estrutura de código, mas nada impede que possa ser alterada. Porém temos que atentar a um detalhe bastante importante: O nome da função não pode ser iniciado com a letra f, pois todas as funções nativas do FullCopyConvert iniciam com a letra f. 5. Segue um exemplo de Função criada mudamos para o nome ValidaCNPJ. Note que mudamos o nome da função e mudamos também os parâmetros de entrada e o retorno da função. Edição: Suporte Técnico FullCopyConvert Data 7

8 6. Criada nossa função agora podemos utiliza-la na chamada da função principal fmain. Segue um print do exemplo da chamada da função. 7. Agora vamos analisar como será gerado o script. Observação: Note que nosso parâmetro de entrada é do tipo Variant e nosso parâmetro de entrada da Função ValidaCNPJ é do tipo String. Caso retorne Null você deverá converter para String o variant. Fazendo um VarToStr. Exemplo: if (ValidaCNPJ(VarToStr(_AValue)) = False) then. Caso não realize o tratamento poderá gerar a seguinte exceção: Could not convert variant of type (Null) into type (OleStr). Os tratamentos para os tipos correspondente é muito importante para não gerar exceções desnecessárias. Edição: Suporte Técnico FullCopyConvert Data 8

9 Dúvidas entre em contato. Questões gerais Vendas questões relacionadas Apoiar Problemas com o uso de nossos programas ou questões simplesmente técnicas? suporte@fullcopyconvert.com.br Edição: Suporte Técnico FullCopyConvert Data 9

10 Edição: Suporte Técnico FullCopyConvert Data 10