PARTE 2 -Manipulando dados do Preactor - Treinamento Preactor

Nessa segunda parte do treinamento iremos aprender a ler e escrever dados nas tabelas do Preactor utilizando a API do Preactor. Para essa parte do treinamento eu preciso que você faça download do modelo que iremos utilizar, para isso clique aqui.

Faça Download do arquivo "Preactor.prtdf" e o coloque na pasta do modelo que estamos trabalhando (C:\Users\Public\Documents\Preactor Configurations\Preferred Sequence (400 & 500 APS) v11.2).

O que há de diferente nesse arquivo é uma nova tabela que foi criada de nome Apontamento, ela possui a seguinte estrutura:
Apontamento,,0,600:
   Number,0,INTEGER,
      PRIMARY KEY
      HIDDEN:
   Ordem,"",STRING,
      FREE FORMAT (30):
   Recurso,"",STRING,
      FREE FORMAT (30):
   Status,"1",STRING,
      FREE FORMAT (30):
   Data de Início,-1,TIME,
      SHOW DATE:
   Data de Fim,-1,TIME,
      SHOW DATE:
   Import Marker,-1,INTEGER,
      DIALOG LEVEL 99
      DIALOG ONLY
      READ ONLY
      IMPORT MARKER;

O que podemos aprender ao ver o código da tabela:

Cabeçalho: "Apontamento,,0,600:"
Table: Apontamento
Total de Registros permitido pela tabela: 600
Fields: Number, Ordem, Recurso, Status, Data de Início, Data de Fim, Import Marker;

Iremos utilizar essas informações para podermos ler e gravar dados na tabela Apontamento.

Abra o Preactor para que as alterações do arquivo "preactor.prtdf" sejam incorporadas ao modelo.

Clique em sim.

Criando um novo registro, lendo e escrevendo dados no Preactor

Esse nosso primeiro contato com o API da Preactor será em torno de três funções básicas que são responsáveis por grande parte de nosso trabalho ao customizar um software, Ler dados, escrever e Criar novos registros. 

A sintaxe é bem simples, vejam os código logo abaixo:

public int Run(ref PreactorObj preactorComObject, ref object pespComObject)
        {
            IPreactor preactor = PreactorFactory.CreatePreactorObject(preactorComObject);
            
            //CRIAR UM NOVO REGISTRO NA TABELA DE APONTAMENTOS
            int record = preactor.CreateRecord("Apontamento");
            
            //ESCREVER NA TABELA APONTAMENTOS
            preactor.WriteField("Apontamento", "Ordem", record, "ORD-001");
            //obs:
            //A Função WriteField possui 4 parametros básicos
            // 1º - Tabela, 
            // 2º - Campo da tabela(Field), 
            // 3º - Numero do Registro, 
            //4 - Valor que vamos escrever no banco de dados
            preactor.WriteField("Apontamento", "Recurso", record, "Packing Line 2");
            preactor.WriteField("Apontamento", "Status", record, "Iniciada");
            preactor.WriteField("Apontamento", "Data de Início", record, new DateTime(2000,10,01,11,00,00));
            preactor.WriteField("Apontamento", "Data de Fim", record, new DateTime(2000, 10, 01, 12, 30, 00));
            //OBSERVAÇÃO, OS CAMPOS Number, e Import Marker são de uso do Preactor, 
            //não precisamos preencher esses campos;

            //VAMOS SALVAR OS DADOS NA TABELA DO PREACTOR
            preactor.Commit("Apontamento");
            return 0;
        }


Para ler os dados Gravados na tabela iremos utilizar duas funções, uma para contar o número total de registros da tabela e a outra para ler os dados da tabela.
  public int Lendo(ref PreactorObj preactorComObject, ref object pespComObject)
        {
            IPreactor preactor = PreactorFactory.CreatePreactorObject(preactorComObject);

            //CRIAR UM NOVO REGISTRO NA TABELA DE APONTAMENTOS
            int count = preactor.RecordCount("Apontamento");

            IList ordens = new List();
            //VAMOS LER TODAS AS ORDENS E GRAVAR SEU VALOR NA LISTA
            for (int record = 1; record <= count; record++)
            {
                //VAMOS LER OS DADOS DA TABELA (parametros: tabela, campo, número do registro)
                string ordem = preactor.ReadFieldString("Apontamento", "Ordem", record);
                ordens.Add(ordem);
                //OS DADOS SÃO SALVOS DE FORMA SEQUENCIAL, MESMO EXCLUINDO
                //UM REGISTRO DO MEIO DA FILA, A FILA É REORDENADA
                //NÃO DEIXANDO BURRACOS
            }
            MessageBox.Show("O número de registros lidos:" + ordens.Count());
            return 0;
        }


Outras funções de Manipulação de dados:


public void DeletarRegistro(IPreactor preactor, int record)
{
            //EXCLUI UM ÚNICO REGISTRO
            preactor.DeleteRecord("Apontamento", record);

            //PARA LIMPAR A TABELA EXCLUINDO TODOS OS REGISTROS
            preactor.Clear("Apontamento");
}

Mas para frente abordaremos como busca uma string dentro de um campo de uma tabela.

WorkShop 01

Faça uma função que importe um arquivo CSV (download arquivo CSV ) de apontamentos, e salve os dados na tabela "Apontamento" do Preactor. Mas antes de salvar limpe sempre a tabela.

tente fazer o workshop sem olhar a resposta (workShop 01)

SAP .Net Connector 3.0 - Net Framework 4.0 - Executando uma RFC e lendo os dados de uma tabela - Parte 3

Parte 3

Para encerrar o tutorial veremos como acessar os dados de uma RFC e como gravar dados em uma tabela dentro da RFC. Para isso daremos continuidade ao nosso projeto.

Serei bem direto nessa etapa pois creio que o código fonte fala por si só.

Lendo os dados de uma tabela

1º criei um classe de nome Material para receber os dados da tabela que iremos ler:

Public Class Material
    Private _code As String
    Private _descricao As String
    Private _quantidade As Double

    Public Property Code As String
        Get
            Return _code
        End Get
        Set(value As String)
            _code = value
        End Set
    End Property

    Public Property Descricao As String
        Get
            Return _descricao
        End Get
        Set(value As String)
            _descricao = value
        End Set
    End Property

    Public Property Quantidade As Double
        Get
            Return _quantidade
        End Get
        Set(value As Double)
            _quantidade = value
        End Set
    End Property
End Class

2º criei um método dentro da classe RfcTableReader de nome getMateriais, onde iremos ler os dados da tabela SAP e montar uma lista de materias:


Public Function getMateriais(ByRef rfcFunction As IRfcFunction) As IList(Of Material)
        Try
            'RECUPERANDO A TABELA TB_MATERIAIS DA RFC
            Dim rfcTabMateriais As IRfcTable = rfcFunction.GetTable("TB_MATERIAIS")
            'CRIANDO UMA LISTA QUE IRÁ CONTER DOS DADOS LIDOS DA RFC-TABLE
            Dim itens As IList(Of Material) = New List(Of Material)

            'EXECUTANDO O LOOP DOS DADOS DA TABELA SAP
            For Each row As IRfcStructure In rfcTabMateriais
                Dim it As New Material
                'TESTANDO SE O EXISTE VALOR NA VARIAVEL SAP
                If Not (IsDBNull(row.GetValue("DSCODE"))) Then
                    it.Code = row.GetString("DSCODE")
                End If
                If Not (IsDBNull(row.GetValue("DSDESCRIPT"))) Then
                    it.Descricao = row.GetString("DSDESCRIPT")
                End If
                If Not (IsDBNull(row.GetValue("DSQUANT"))) Then
                    it.Quantidade = row.GetString("DSQUANT")
                End If
                'VERIFICANDO SE O MATERIAL POSSUI CÓDIGO
                If Not String.IsNullOrEmpty(it.Code) Then
                    itens.Add(it) 'ADD REGISTRO A LISTA
                End If
            Next
            Return itens
        Catch exSap As RfcAbapRuntimeException
            Throw New Exception("ABAP error run Time: " & exSap.Message)
        Catch exSap As RfcAbapBaseException
            Throw New Exception("ABAP base error" & exSap.Message)
        Catch ex As Exception
            Throw
        End Try
    End Function

leia atentamente os comentários que estão dentro da função para que você tenha maior conhecimento da mesma, ok?

3º Executando a RFC e lendo os dados da tabela Material utilizando o que criamos até o momento:

Antes alguns detalhes importantes,

Criando uma instancia IRfcFunction, ela serve para executar todos os comandos da RFC e dentro dela estão contidas todas as tabelas, parametros etc dessa função.

No nosso exemplo iremos chamar a RFC "FRC_MATERIAL":

Dim rfcFunction As IRfcFunction = repositorio.CreateFunction("RFC_MATERIAL")

Após chamar a RFC é necessário a passagens dos parametros da função, caso necessário, como data, período, usuário, lote etc, cada RFC possui seus próprios parâmetros.

rfcFunction.SetValue("DATA", Now)

rfcFunction.SetValue("USER", "camilo.correa.silva.silva")

Para finalizar essas observações, após definir a RFC, passar os devidos parâmetros, basta invocar a função, ou executa-la. Para isso você irá utilizar a função "invoke" e passar para ela as configurações de acesso definidas na segunda parte desse tutorial [ 2ª parte ].

rfcFunction.Invoke(dest)

Veja como ficou nosso código:
   Public Sub LerDadosRFC()
        Try
            '1º - MONTAR OS PARAMETROS PARA CONEXÃO SAP
            Dim con As New SAPConnect()
            'A FUNÇÃO REGISTER ABRE A CONEXÃO COM SAP
            RfcDestinationManager.RegisterDestinationConfiguration(con)
            Dim dest As RfcDestination = RfcDestinationManager.GetDestination("homologacao")
            Dim repositorio As RfcRepository = dest.Repository
            Try
                'CHAMANDO A RFC - PASSANDO PARAMETROS
                Dim rfcFunction As IRfcFunction = repositorio.CreateFunction("RFC_MATERIAL")

                'PASSANDO OS PARAMETROS DE LEITURA DA RFC
                rfcFunction.SetValue("DATA", Now)
                rfcFunction.SetValue("USER", "camilo.correa.silva.silva")

                'EXECUTANDO A RFC
                rfcFunction.Invoke(dest)

                'CHAMANDO A FUNÇÃO QUE LÊ OS DADOS CONTIDOS NA TABLE DA RFC
                Dim materiais As IList(Of Material) = getMateriais(rfcFunction)

            Catch exSap As RfcAbapRuntimeException
                Throw New Exception("ABAP error run Time: " & exSap.Message)
            Catch exSap As RfcAbapBaseException
                Throw New Exception("ABAP base error" & exSap.Message)
            Catch ex As Exception
                Throw
            Finally
                'FECHA A CONEXÃO COM SAP
                RfcDestinationManager.UnregisterDestinationConfiguration(con)
            End Try

        Catch exSap As RfcCommunicationException
            Throw New Exception("Falha na comenicação com SAP: " & exSap.Message)
        Catch exSap As RfcLogonException
            Throw New Exception("Falha no Login: " & exSap.Message)
        Catch ex As Exception
            Throw New Exception("Erro: " & vbCrLf & ex.Message)
        End Try
    End Sub

4º Gravando dados em uma tabela do SAP

As funções para leitura e gravação são bem parecidas e intuitivas, por exemplo, para se ler um campo de uma tabela SAP getValue("NOME DO CAMPO"), para se escrever em um campo, setValue("NOME DO CAMPO", valor). 
Dito isso, existe apenas um comando a mais que deve ser inserido para gerar uma nova linha na tabela SAP antes de inserirmos os valores, que é o comando "Append()"

Veja logo baixo como ficou nosso código de gravação em uma tabela SAP:

 Public Sub GravarDadosRFC(ByVal materiais As IList(Of Material))
        Try

            '1º - MONTAR OS PARAMETROS PARA CONEXÃO SAP
            Dim con As New SAPConnect()
            'A FUNÇÃO REGISTER ABRE A CONEXÃO COM SAP
            RfcDestinationManager.RegisterDestinationConfiguration(con)
            Dim dest As RfcDestination = RfcDestinationManager.GetDestination("homologacao")
            Dim repositorio As RfcRepository = dest.Repository
            Try
                'CHAMANDO A RFC - PASSANDO PARAMETROS
                Dim rfcFunction As IRfcFunction = repositorio.CreateFunction("RFC_MATERIAL")

                'PASSANDO OS PARAMETROS DE LEITURA DA RFC
                rfcFunction.SetValue("DATA", Now)
                rfcFunction.SetValue("USER", "camilo.correa.silva.silva")

                'INSTANCIANDO A TABELA MATERIAL
                Dim rfcTabMateriais As IRfcTable = rfcFunction.GetTable("TB_MATERIAIS")

                'INSERINDO OS REGISTROS DA TABELA DO SAP
                For Each material As Material In materiais
                    'CRIAR UM NOVO REGISTRO NA TABELA
                    rfcTabMateriais.Append()
                    'PASSANDO OS VALORES PARA TABLE
                    rfcTabMateriais.SetValue("DSCODE", material.Code)
                    rfcTabMateriais.SetValue("DSDESCRIPT", material.Descricao)
                    rfcTabMateriais.SetValue("DSQUANT", material.Quantidade)
                Next

                'EXECUTANDO A RFC e INSERINDO OS VALORES
                rfcFunction.Invoke(dest)
              
            Catch exSap As RfcAbapRuntimeException
                Throw New Exception("ABAP error run Time: " & exSap.Message)
            Catch exSap As RfcAbapBaseException
                Throw New Exception("ABAP base error" & exSap.Message)
            Catch ex As Exception
                Throw
            Finally
                'FECHA A CONEXÃO COM SAP
                RfcDestinationManager.UnregisterDestinationConfiguration(con)
            End Try

        Catch exSap As RfcCommunicationException
            Throw New Exception("Falha na comenicação com SAP: " & exSap.Message)
        Catch exSap As RfcLogonException
            Throw New Exception("Falha no Login: " & exSap.Message)
        Catch ex As Exception
            Throw New Exception("Erro: " & vbCrLf & ex.Message)
        End Try
    End Sub



Conclusão

Podemos perceber que para fazer uma integração com SAP via RFC é bem simples. Para isso você deve saber meia dúzia de comandos e ter uma código bem estruturado.

Espero que tenha conseguido ajudar pessoas que como eu tiveram dificuldade de fazer sua primeira integração .Net com SAP.

Se existir alguma dúvida sobre meu código basta me escrever ou postar um comentário, ok?

Para finalizar, como eu havia prometido, segue o link para download da solução que desenvolvemos para esse tutorial:

[ Solução .Net 4.0, visual Studio 2010 RFC Tutorial ]
senha para desconpacta: besaleel.blogspot.com.br

SAP .Net Connector 3.0 - Net Framework 4.0 - Executando uma RFC e lendo os dados de uma tabela - Parte 2

PARTE 2

A segunda parte do tutorial trata da conexão com SAP utilizando as bibliotecas que incorporamos em nosso projeto.

De forma bem direta iremos iniciar criando em nossa solução um arquivo de configuração contendo as informações necessárias para nós realizarmos um conexão bem sucedida com SAP, ok?

Esse arquivo de configuração é o app.config, se fosse um projeto web poderia ser o web.config, ok?

Dentro das tags vamos guardar nossas informações de configuração.

Agora vamos criar as funções necessárias para se conectar com o SAP

Na realidade iremos precisar apenas de criar um classe e implementar os métodos de uma interface do sapncon de nome IDestinationConfiguration. Os métodos exigidos pela classe que iremos implementar são responsáveis pelo controle da conexão com o SAP.

São eles:
GetParameters(), IDestinationConfiguration_ChangeEventsSupported(), ChangeEventsSupported(), ConfigurationChanged()

Iremos trabalhar apenas no GetParameters, veja a implementação da classe logo abaixo:
Imports System.Configuration
Imports SAP.Middleware.Connector

Public Class SAPConnect
Implements IDestinationConfiguration

''' ''' Monta a estrutura de conexão com o SAP de acordo com o "DestinationName" que pode ser tratado com servidor,
''' em nosso caso temos um servidor de Homologação de dados e um de Produção.
'''
''' Nome da Instancia ou Servidor
''' Destino da conexão
''' Besaleel 2014-08-01
Public Function GetParameters(ByVal destinationName As String) As RfcConfigParameters Implements IDestinationConfiguration.GetParameters
Try
Dim conf As RfcConfigParameters = New RfcConfigParameters()
If destinationName.Equals("homologacao") Then
Dim hostH = ConfigurationManager.AppSettings.Get("ServidorSap")
Dim numbH = ConfigurationManager.AppSettings.Get("NumeroSap")
Dim sysH = ConfigurationManager.AppSettings.Get("SistemaSap")
Dim userH = ConfigurationManager.AppSettings.Get("UsuarioSAP")
Dim passH = ConfigurationManager.AppSettings.Get("PassWordSAP")
Dim clieH = ConfigurationManager.AppSettings.Get("ClienteSAP")
Dim langH = ConfigurationManager.AppSettings.Get("IdiomaSAP")


With conf
.Add(RfcConfigParameters.AppServerHost, hostH)
.Add(RfcConfigParameters.SystemNumber, numbH)
.Add(RfcConfigParameters.SystemIDs, sysH)
.Add(RfcConfigParameters.User, userH)
.Add(RfcConfigParameters.Password, passH)
.Add(RfcConfigParameters.Client, clieH)
.Add(RfcConfigParameters.Language, langH)
End With
Return conf
End If
'PRODUÇÃO
Dim host = ConfigurationManager.AppSettings.Get("ServidorSap")
Dim numb = ConfigurationManager.AppSettings.Get("NumeroSap")
Dim sys = ConfigurationManager.AppSettings.Get("SistemaSap")
Dim user = ConfigurationManager.AppSettings.Get("UsuarioSAP")
Dim pass = ConfigurationManager.AppSettings.Get("PassWordSAP")
Dim clie = ConfigurationManager.AppSettings.Get("ClienteSAP")
Dim lang = ConfigurationManager.AppSettings.Get("IdiomaSAP")


With conf
.Add(RfcConfigParameters.AppServerHost, host)
.Add(RfcConfigParameters.SystemNumber, numb)
.Add(RfcConfigParameters.SystemIDs, sys)
.Add(RfcConfigParameters.User, user)
.Add(RfcConfigParameters.Password, pass)
.Add(RfcConfigParameters.Client, clie)
.Add(RfcConfigParameters.Language, lang)
End With
Return conf
Catch ex As Exception
Throw New Exception("Falha ao abrir conexão:" & vbCrLf & ex.Message)
End Try
End Function

Public Function IDestinationConfiguration_ChangeEventsSupported() As Boolean Implements IDestinationConfiguration.ChangeEventsSupported
Return True
End Function

Public Function ChangeEventsSupported() As Boolean
Return True
End Function

Public Event ConfigurationChanged As RfcDestinationManager.ConfigurationChangeHandler Implements IDestinationConfiguration.ConfigurationChanged
End Class

Alguns comentários sobre a classe
vejam que o método GetParameters recebe uma variável "destinationName", que é responsável por dizer qual é o servidor SAP que iremos nos conectar. Em nosso exemplo apesar de recuperarmos os dados para acesso de um único lugar, eu simulei o acesso a um servidor de Homologação (Testes) e a um servidor de produção. Com isso através da variável "destinationName" você poderá ter N instancias para N servidores SAP, ok?

Conexão com SAP

'NÃO ESQUEÇA DE IMPORTAR A BIBLIOTECA SAP
Imports SAP.Middleware.Connector

Public Class RfcTableReader
    Public Sub LerDadosRFC()
        Try

            '1º - MONTAR OS PARAMETROS PARA CONEXÃO SAP
            Dim con As New SAPConnect()
            'A FUNÇÃO REGISTER ABRE A CONEXÃO COM SAP
            RfcDestinationManager.RegisterDestinationConfiguration(con)
            'MONTA OS PARAMETROS DO SERVIDOR SAP QUE IREMOS CONECTAR
            Dim dest As RfcDestination = RfcDestinationManager.GetDestination("homologacao")
            Dim repositorio As RfcRepository = dest.Repository
            Try
                'AQUI SEGUE O CÓDIGO FONTE PARA EXECUTAR A RFC
                'LER TABLES
                'GRAVAR TABLES
                'PASSAR PARAMETROS
                '...
            Catch exSap As RfcAbapRuntimeException
                Throw New Exception("ABAP error run Time: " & exSap.Message)
            Catch exSap As RfcAbapBaseException
                Throw New Exception("ABAP base error" & exSap.Message)
            Catch ex As Exception
                Throw
            Finally
                'FECHA A CONEXÃO COM SAP
                RfcDestinationManager.UnregisterDestinationConfiguration(con)
            End Try

        Catch exSap As RfcCommunicationException
            Throw New Exception("Falha na comenicação com SAP: " & exSap.Message)
        Catch exSap As RfcLogonException
            Throw New Exception("Falha no Login: " & exSap.Message)
        Catch ex As Exception
            Throw New Exception("Erro: " & vbCrLf & ex.Message)
        End Try
    End Sub

End Class
Foi utilizado try catch para controlar a conexão, para não deixarmos conexões abertas

No fim deste tutorial eu irei disponibilizar o código fonte para download.

Parte 3

SAP .Net Connector 3.0 - Net Framework 4.0 - Executando uma RFC e lendo os dados de uma tabela

Bem, resolvi escrever esse tutorial pois encontrei poucas informações precisas, e exemplos simples de como executar um RFC e ler os dados de uma tabela do SAP, realizando uma integração do SAP através da plataforna .Net, seja ela em C# ou Vb.Net.

Para isso estarei dividindo o texto em três tópicos básicos:

1. Download das bibliotecas SAPNCO 3.0 e criação de um projeto .Net;
2. Configuração e Conexão de seu projeto com o SAP;
3. Executando uma RFC e lendo os dados de um tabela;

Bem então vamos começar pelo mais simples:

Download das bibliotecas SAPNCO 3.0 e criação de um projeto .Net

Para fazer download das bibliotecas SAP .NET CONNECTOR 3.0 você poderá acessar o site: https://www.nuget.org/packages/SAPDotNetConnector3 e baixar os arquivos mais atuais direto para seu visual Studio através do Package Manager Console.

Para facilitar sua vida eu disponibilizei os arquivos no link [ clique aqui para download ] senha para descompactar o arquivo [ besaleel.blogspot.com.br ]

Com os arquivos em mãos agora precisamos criar nosso projeto, usarei nos exemplos Vb.Net, mas se desejar fazer seu projeto em C# é bem simples.

Criando um projeto Vb.Net

Criei um projeto windows forms de nome Rfc.Tutorial.

OBS importante: para SAP .Net Connector 3.0 que estamos utilizando obrigatoriamente você terá que utilizar a versão do .Net 4.0 do contrário não irá funcionar. 

Reforçando NÃO é a versão 4.0 Client ou a 3.5, ok?

Com o projeto criado iremos agora inserir a referencia das bibliotecas SAP que você baixou no início desse tutorial ( sapnco e sapnco_utils ).

Clique em "Add", no formulário de add Referencia clique em Browser, vá até a pasta lib, que se encontra dentro do arquivo que você baixou, selecione os dois arquivos e clique em "Ok".

Aqui encerramos a primeira parte do Tutorial.

parte 2