Automatização de transferência de dados de objetos

O V5R1 Client Access Express fornece Automation Objects o que permite acessar a funcionalidade da transferência de dados. Os objetos fornecem um alto nível e um baixo nível de interface. A interface de alto nível fornece métodos básicos de transferência de dados, com um resultado limitado de customização. A interface de alto nível é simplificada para uso. A interface de baixo nível permite grande customização de pedido de transferência de dados.

Interface de Alto Nível

O propósito da automatização de objetos é permitir a transferência de dados para serem controlados com qualquer linguagem ou aplicação que suporte automatização de ActiveX.

Várias vantagens de usar a automatização de objetos incluem o seguinte:

1 Melhor tratamento de erro

Arquivos bacth DOS que são usados para executar pedidos que não suportam tratamento de erros da automatização de objetos.

2 Pode ser usado com system services

Informação de user ID e senha podem ser configurados programaticamente. Isto é usado para declarações onde o preparo de informação de segurança não é possível.

3 Processo assíncrono

Pedidos de transferência devem ser entrados assíncronamente.

Alto Nível de Automatização de Transferência de Dados de Objetos:

DatabaseTransfer

Interface de alto nível de objeto primário

Fornece métodos para upload, download, e pedidos salvos executados anteriormente.

Erros

Contêm coleção na transferência do objeto que fornece informação de erro (severidade e texto de erro)

DatabaseTransferResults

Acessado como uma propriedade do objeto DatabaseTransfer.

Fornece sumário detalhado de resultados do último pedido de transferência.

DatabaseDataErrors

Contêm coleção por resultados de objetos que descrevem onde ocorreram os erros de dados.

Ponteiros para o local (linha, coluna) do erro e tipo de erro (truncation, rounding, translation, missing data).

O objeto DatabaseTransfer fornece três métodos para transferência de dados To e From:

Download

Método básico para fazer download de um arquivo.

Os parâmetros requeridos são o system name, file to download e PC file.

O tipo do PC file pode ser especificado como um parâmetro opcional.

Upload

Método básico para fazer upload de um arquivo.

Os parâmetros requeridos são system name, destination file, PC file e file description file.

Transfer

Método fornecido para executar um pedido anteriormente salvo.

Somente o parâmetro do nome do arquivo do pedido de transferência (download ou upload)

Notas:

O protótipo da função de download é:

- DatabaseTransfer.Download(String system, String hostFile, string pcFile, cwbdtFile TypeEnum file Type)

Código mínimo no Visual Basic para download do arquivo:

Dim dt As New cwbx.DatabaseTransfer

dt.Download “MYSYSTEM”, “QIWS/QCUSTCDT”, “C:\MyFile.txt”

 

O protótipo da função Upload é:

DatabaseTransfer.Upload(String system, String hostFile, String pcFile, String fileDescriptionFile)

O protótipo da função Transfer é:

DatabaseTransfer.Transfer(String requestFile)

Após qualquer um destes métodos serem chamados, o objeto DatabaseTransferResults pode ser usado para retornar estatísticas de transferência incluindo:

Tempo de Conclusão – Hora e data que o transfer completou.

Linhas Transferidas – Número total de linhas transferidas num pedido anterior.

DataErros – Tipo de erro e local.

Cada erro na coleção contêm três propriedades:

. Linha – Linha na qual o erro de dado foi encontrado.

. Coluna – Coluna na qual o erro de dado foi encontrado.

. ErrorType – Typo de erro de dado que foi encontrado.

Adicionalmente a estas propriedades, o DatabaseTransferResults permite fornecer propriedades Booleanas para indicar erros ou uma atenção que tenha ocorrido.

DataErrorsOccurred

DataWarningsOccurred

Aplicações serão checadas para ver se erros tiveram ocorridos baseados nestas propriedades. Se sim, então a coleção de erros indagada para detalhes.

Interface de Baixo Nível

A interface de baixo nível deverá ser usada quando as opções padrões de interface de alto nível não são suficientes. O menor nível de automatização de objetos fornece acesso para aproximadamente toda a funcionabilidade da aplicação Client Access Express Data Transfer incluindo transferência assíncrona. Aplicações podem monitorar eventos fora de transferencias assíncronas e responder apropriadamente.

O baixo nível de interface fornece um upload e um download transfer object.

Notas:

A interface de baixo nível permite o usuário alterar aproximadamente todos os parâmetros do pedido de transferência de dados. Itens como file type, file options e data format podem ser manipulados usando os objetos fornecidos.

Funções Client Access Express Data Transfer que não são fornecidas:

Habilidade de navegar em bibliotecas para procura de arquivos.

Construtor de interface Query, que ajuda o usuário na transferência de dados selecionando o dado desejado.

Data Transfer Upload Wizard, que examina um PC file e cria um arquivo no host para upload.

Para informação detalhada sobre a interface de baixo nível, a documentação do Express toolkit deve ser revisada.

DatabaseDownloadRequest Object

DatabaseDownload Objects

DatabaseAS400File:

Contêm informação sobre como o arquivo deve ser selecionado.

DatabaseFormatOptions:

Especifica como o dado deverá ser formatado durante a trannsferência. Isto inclui informação de data, hora e separadores decimais.

DatabaseDownloadPCFile:

Determina o nome do arquivo para ser criado no PC, tal como opções de tipo e formato.

Também inclui opções de objeto que são especifico para o tipo de arquivo que será feito download.

DatabaseQuerySettings:

Fornece habilidade para configurar critérios de seleções (Select, Where, Join, Group) do pedido de download e somente é usado se o pedido for processado como um data transfer (não Native SQL).

AS400System:

Determina qual servidor atenderá o pedido a ser enviado.

DatabaseTransferResults:

Sumariza as estatísticas do último download processado, e fornece informação sobre erros nos dados.

DatabaseUserLibraryList:

Especifica que bibliotecas serão procuradas se o nome do arquivo no banco de dados não for indicado.

Errors:

Coleção de erros de objetos que contêm Client Access return codes e mensagens.

Notas:

O objeto DatabaseDownloadRequest é o objeto primário que precisa ser criado. Os outros objetos poderão ser criados com os valores padrões, que podem ser alterados.

Código mínimo no Visual Basic para downalod usando a interface de baixo nível:

Dim dlr as cwbx.DatabaseDownloadRequest

Set dlr.System = new cwbx.AS400System

dlr.System.Define “MYAS400″

dlr.AS400File.Name = “MYAS400″

dlr.AS400File.Name = “MYLIB/MYFILE”

dlr pc.File.Name = “C:\MyFile.txt”

dlr.Download

Database UploadRequest Object

DatabaseUpload Object

DatabaseAS400File

Isto contem informação sobre o destino do arquivo, incluindo informação da criação e nome do arquivo.

DatabaseUploadPCFile

Contêm informação sobre o arquivo para ser feito upload, incluindo a informação do nome e descrição do arquivo. Inclui um objeto que contêm opções especificas de tipos de arquivos.

AS400System

Usado para especificar qual servidor terá o pedido enviado.

DatabaseTransferResults

Objeto que contêm os resultados do último data transfer, incluindo linhas transferidas e qualquer erro que tenha ocorrido.

DatabaseUserLibraryList

Contêm uma lista das bibliotecas para serem procuradas quando executar um pedido com um nome de tabela não qualificado.

Errors

Coleção de erros que ocorreram durante o processamento de um pedido.

Capacidades e Limitações

O que a automatização de objetos pode fazer:

Download para um PC file.

Download para html.

Executar pedidos de transfer salvos anteriormente.

Salvar pedidos de transfer data para uso futuro.

 

 

O que a automatização de objetos não pode fazer:

Download para o display.

Download para uma printer.

Não suporta construção de query GUI.

Navegar em bibliotecas de arquivos.

Recursos

Maiores informações sobre a automatização de objetos podem ser localizadas no Express Toolkit fornecido com o Client Access. O Toolkit contêm código simples de Visual Basic para cada propriedade e método de cada objeto.

Na janela toolkit, escolha o seguinte:

Database

ActiveX

Selecione o link Data Transfer Automation Objects

Para informação de como usar o Data Transfer Automation Objects com Windows Scripting Host, veja o comento 21115031 da Rochester Support Knowledgebase, Alternatives to Batch Data Transfer: Data Transfer automation objects; Import files with QNTC; ADO and Windows Scripting Host.