Operações e Verbos dos Objetos de Negócios BAPI

Os objetos de negócios BAPI suportam operações e verbos. A operação de um objeto de negócios BAPI especifica a chamada da BAPI para ser executada no sistema SAP para aquele objeto. O método BAPI determina a operação associada a ele. O verbo de um objeto de negócios BAPI especifica o estado do objeto.

Operações Suportadas

As operações de um objeto de negócios são chamadas pelo componente do cliente que faz chamadas para o SAP por meio do adaptador. As APIs SAP JCo são utilizadas para fazer a chamada para o sistema SAP.

A tabela a seguir define operações que o adaptador suporta.
Nota: As definições listadas na tabela são as utilizações esperadas para as operações. A ação realizada no aplicativo SAP é baseada no significado do da própria BAPI.
Tabela 1. Operações Suportadas: Objetos de Negócios BAPI
Operação Definição
After-Image Create Cria uma nova entidade no SAP que corresponde aos dados e à estrutura do objeto de negócios de entrada. O objeto de negócios retornado por esta operação reflete a entidade recém-criada no SAP.
After-Image Update with Delete Um formato especial da operação UpdateWithDelete que fornece melhor desempenho. Ela também requer um ChangeSummary, que deve incluir informações sobre as criações e as exclusões de nível do objeto de negócios. Isto permite que o adaptador desempenhe operações sem a sobrecarga de recuperar as entidades existentes do SAP e de fazer comparações, porque ChangeSummary indica o que precisa ser feito. Se ChangeSummary estiver vazio, o adaptador não executa nenhuma ação no pedido.
Recuperação Reconstrói a hierarquia completa do objeto de negócios. O adaptador garante que o objeto de negócios hierárquico retornado corresponde exatamente ao estado do banco de dados da entidade do aplicativo. Valores diferentes de chave podem ser utilizados como critérios.

Aceita um after-image ou um objeto de negócios. A comparação em ambos os casos será apenas por igualdade.

O objeto de negócios de pedido pode conter qualquer um dos itens a seguir:

  • Um objeto de negócios de nível superior, mas nenhum objeto-filho, embora a definição do objeto de negócios inclua filhos
  • Um objeto de negócios que contém o objeto de negócios de nível superior e alguns de seus filhos definidos
  • Um objeto de negócios hierárquico completo que contém todos os objetos de negócios filho

A recuperação tem o objetivo de retornar um objeto de negócios único e exclusivo que atenda aos critérios definidos pelo usuário. O requisito para desempenhar a operação de recuperação é totalmente dependente da BAPI. O que BAPI considera como “exigido” é o que permite que a recuperação tenha sucesso.

After-Image Delete Remove uma entidade existente do SAP e quaisquer entidades filhas contidas. Note que SAP tem o conceito de uma exclusão lógica, segundo a qual o registro é marcado como excluído, mas a entidade ainda existe. Isso é feito em alguns casos para manter a integridade do banco de dados, porque a entidade “excluída” é referenciada em outras entidades. Portanto, o comportamento de After-Image Delete depende da chamada da BAPI.

Para uma operação que não é suportada ou não corresponde ao verbo no gráfico de negócios, o adaptador registra o erro apropriado e gera uma ResourceException.

Verbos Suportados

A tabela a seguir lista os verbos que o adaptador suporta para objetos de negócios BAPI.

Tabela 2. Verbos Suportados: Objetos de Negócios BAPI
Verbo Definição
Criar O objeto de negócios de nível superior e todos os filhos contidos foram criados, se este for um evento de entrada, ou devem ser criados no SAP, se este for um pedido de saída.
UpdateWithDelete O objeto de negócios de nível superior foi ou deve ser modificado; isso pode incluir a adição ou exclusão de filhos.
Excluir O objeto de negócios de nível superior e quaisquer filhos contidos foram ou deverão ser excluídos.

Para verbos que não são suportados, o adaptador gera um erro ResourceException.


Termos de Utilização |


(c) Copyright IBM Corporation 2005, 2006.
Este centro de informações foi desenvolvido por tecnologia Eclipse (http://www.eclipse.org)