WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Propriedades do Adaptador de Entrada para SAP

As propriedades do adaptador de entrada mantêm as informações de configuração de processamento de eventos de entrada para um terminal de mensagem. Essas propriedades também controlam a operação geral do adaptador. Use o assistente Conexão do Adaptador para configurar essas propriedades.

Essas propriedades são usadas durante a ativação do terminal para notificar o adaptador sobre listeners de eventos elegíveis. Durante o processamento de entrada, o adaptador utiliza estes listeners de eventos para receber eventos antes de redirecioná-los para o terminal.

A tabela a seguir lista as propriedades para o processamento de entrada configurado usando o assistente Conexão do Adaptador. Uma descrição mais detalhada de cada propriedade é fornecida nas seções que acompanham a tabela.
Tabela 1. Propriedades de Especificação de Ativação para Processamento de Entrada ALE
Nome da Propriedade Descrição
O ID do adaptador a ser utilizado para criação de log e rastreio (AdapterID) Uma implementação, ou instância, específica do adaptador
Auditoria de pacote ALE (alePacketUpdate) Especifica se o adaptador deve enviar ALEAUD por IDoc ou por pacote (TID)
Status de atualização do ALE (aleUpdateStatus) Especifica se uma trilha de auditoria é necessária para todos os tipos de mensagens

Entrega Única Garantida (AssuredOnceDelivery)

Especifica se deve fornecer entrega única garantida para eventos de entrada

Tabela de eventos de criação automática (EP_CreateTable) Especifica se o adaptador deve criar a tabela de recuperação de evento automaticamente se ela ainda não existir

Cliente (Cliente)

O número do cliente do sistema SAP ao qual o adaptador se conecta

Número da Página de Códigos (Codepage)

Indica o identificador numérico da página de códigos

Nome do esquema de banco de dados (EP_SchemaName) O esquema que é usado para criar automaticamente a tabela de recuperação de evento

Tipo de Entrega (DeliveryType)

Determina a ordem na qual os eventos são entregues pelo adaptador para o componente de exportação.

Ativar a conexão de rede segura (SncMode)

Indica se o modo de conexão de rede segura é usado

Nome da origem de dados de recuperação de evento (JNDI) (EP_SchemaName) O nome JNDI da origem de dados que é configurado para a recuperação de evento
Nome da tabela de recuperação de eventos (EP_TableName) O nome da tabela de recuperação de evento

Tipos de eventos para processamento (EventTypeFilter)

Uma lista delimitada de tipos de eventos que indica o WebSphere Adapter para SAP Software deverá entregar.

código de falha (aleFailureCode) O código de status para falha de dispatch
Falha da texto (aleFailureText) O texto descritivo para falha de dispatch

Pasta para Arquivos de Rastreio RFC (RfcTracePath)

Configura o caminho local completo para a pasta na qual os arquivos de rastreio RFC são gravados

Host gateway (GatewayHost)

O nome do host do gateway SAP

Serviço de Gateway (GatewayService)

O identificador do gateway no host do gateway que transporta os serviços RFC

Nome do Host (ApplicationServerHost)

Especifica o endereço IP ou o nome do host do servidor de aplicativos no qual o adaptador efetua logon

Tags vazias de IDoc (iDocEmptyTag)

Inclui tags vazias nos campos não preenchidos no segmento IDoc, que são enviadas a um terminal configurado, baseado na opção selecionada.

Ignorar erros de pacote IDoc (IgnoreIDocPacketErrors) Especifica o que o adaptador faz quando encontra um erro ao processar o pacote IDoc

Código de idioma (Código de idioma)

Especifica o código de idioma no qual o adaptador efetua logon para SAP

Balanceamento de carga (loadBalancing)

Especifica se sua configuração SAP usa balanceamento de carga

Nome do grupo de logon (Grupo)

Um identificador do nome do grupo de instâncias do servidor de aplicativos que foi definido no SMLG de transação e vinculado para balanceamento de carga de logon

Número máximo de eventos coletados durante cada pesquisa (PollQuantity)

O número de eventos que o adaptador entrega à exportação durante cada período de sondagem.

Host do servidor de sistema de mensagens (MessageServerHost)

Especifica o nome do host no qual o servidor de mensagens está em execução

Número de listeners (NumberOfListeners)

Especifica o número de listeners de eventos que devem ser iniciados

Conjunto de Caracteres do Parceiro (PartnerCharset)

Especifica a codificação PartnerCharset

Senha (Password)

A senha da conta do usuário do adaptador no servidor de aplicativos SAP

Senha usada para conectar-se à origem de dados do evento (EP_Password) A senha de usuário para conectar ao banco de dados

ID do programa RFC (RfcProgramID)

O identificador de chamada de função remoto sob o qual o adaptador se registra no gateway SAP

Nível de Rastreio RFC (RcfTraceLevel)

Especifica o nível de rastreio global

Rastreio RFC Ativado (RcfTraceOn)

Especifica se é necessário gerar um arquivo de texto detalhando a atividade de RFC para cada listener de evento

ID do Sistema SAP (SAPSystemID)

Especifica o ID do sistema do sistema SAP para o qual é permitido o balanceamento de carga de logon

Caminho da biblioteca de conexão de rede segura (SncLib)

Especifica o caminho para a biblioteca que fornece o serviço de conexão de rede segura

Nome de conexão de rede segura (SncMyname)

Especifica o nome da conexão de rede segura

Parceiro de conexão de rede segura (SncPartnername)

Especifica o nome do parceiro de conexão de rede segura

Nível de segurança de conexão de rede segura (SncQop)

Especifica o nível de segurança para a conexão de rede segura

Atualização seletiva (aleSelectiveUpdate) As combinações IDoc Type e MessageType qye deven ser atualizadas quando o adaptador é configurado para atualizar um código de status SAP padrão
Código de mensagem de status (aleStatusMsgCode) Se necessário, o código de mensagem a ser usado quando o adaptador posta o ALEAUD Message IDoc (ALEAUD01)

Pare o adaptador quando um erro é encontrado durante a sondagem (StopPollingOnError)

Especifica se o adaptador pára a sondagem de eventos quando encontrar um erro durante a sondagem.

Código de sucesso (aleSuccessCode) O código de status de sucesso para o Documento do Aplicativo Postado
Texto do sucesso (aleSuccessText) O texto descritivo para o Documento do Aplicativo Postado bem-sucedido

Número do Sistema (SystemNumber)

O número do sistema do servidor de aplicativos SAP

Tempo entre pesquisa para eventos (PollPeriod)

O período de tempo que o adaptador aguarda entre os períodos de sondagem.

Tempo entre novas tentativas em caso de falha de conexão do sistema (RetryInterval)

O período de tempo que o adaptador aguarda entre as tentativas de estabelecer uma nova conexão após um erro durante as operações de entrada.

Cortar dados do campo ALE Idoc (trimAleData)

Especifica se os espaços em branco à esquerda devem ser cortados pelo adaptador antes de enviá-los ao terminal.

Nome de Usuário (userName)

A conta do usuário para o adaptador no servidor SAP

Nome de usuário utilizado para conectar-se à origem de dados do evento (EP_UserName) O nome de usuário para conectar ao banco de dados

Certificado X509 (X509cert)

Especifica o certificado X509 a ser usado como chamado de logon

O ID do adaptador a ser utilizado para criação de log e rastreio (AdapterID)

Esta propriedade identifica uma implementação específica, ou instância, do adaptador.

Tabela 2. ID do Adaptador a Ser Utilizado para Criação de Log e Rastreio
Exigido Sim
Default 001
Tipo de Propriedade String
Uso Essa propriedade identifica a instância do adaptador nos arquivos de log e de rastreio e também ajuda a identificar a instância do adaptador enquanto monitora adaptadores. O ID do adaptador é usado com um identificador específico do adaptador, SAPRA, para formar o nome do componente usado pela ferramenta Log and Trace Analyzer. Por exemplo, se a propriedade do ID do adaptador for configurada como 001, o ID do componente será SAPRA001.

Se você executar várias instâncias do mesmo adaptador, certifique-se de que os oito primeiros caracteres da propriedade do ID do adaptador sejam exclusivos para cada instância para que seja possível correlacionar as informações de log e rastreio com uma instância particular do adaptador. Ao tornar exclusivos os sete primeiros caracteres de uma propriedade do ID do adaptador, o ID do componente para várias instâncias desse adaptador também é exclusivo, permitindo que você correlacione as informações de log e rastreio com uma instância particular de um adaptador.

Por exemplo, quando você configura a propriedade do ID do adaptador de duas instâncias do WebSphere Adapter para SAP Software como 001 e 002. Os IDs do componente para essas instâncias, SAPRA001 e SAPRA002, são curtos o suficiente para permanecerem exclusivos, permitindo distingui-los como instâncias separadas do adaptador. Entretanto, as instâncias com propriedades do ID do adaptador mais longas não podem ser distinguidas umas das outras. Se configurar as propriedades do ID do adaptador de duas instâncias como Instance01 e Instance02, você não conseguirá examinar as informações de log e rastreio para cada instância do adaptador porque o ID do componente para ambas as instâncias está truncado como SAPRAInstance.

Para processamento de entrada, esta propriedade é recuperada das propriedades do adaptador de recursos. Para processamento de saída, ela é recuperada das propriedades do connection factory gerenciado.

Globalizado Sim
Bidirecional suportado Não

Auditoria de Pacote ALE

A atualização ALE por pacote indica se o adaptador deve enviar ALEAUD audit IDocs por pacote ou por IDoc.

Tabela 3. Detalhes de Auditoria do Pacote ALE
Requerido Não
Padrão False (enviar ALEAUD por IDoc).
Tipo de Propriedade Boolean
Utilização

Você poderá ativar e desativar essa propriedade apenas se a propriedade de status de atualização ALE for configurada como True.

Quando você configura esta propriedade como true, o adaptador envia um ALEAUD por pacote IDoc que contém confirmações para todos os IDocs no pacote.

Quando você configura esta propriedade como false, o adaptador envia um ALEAUD para cada IDoc recebido no adaptador.

Globalizado Não
Bidirecional suportado Não

Status de atualização do ALE (aleUpdateStatus)

Esta propriedade especifica se é necessária uma trilha de auditoria para todos os tipos de mensagens.

Tabela 4. Detalhes do Status de Atualização ALE
Requerido SIM
Valores possíveis

True
False

Padrão False
Tipo de Propriedade Boolean
Utilização Configure esta propriedade para True se você deseja que o adaptador atualize um código de status SAP padrão depois que o módulo ALE tiver recuperado um objeto IDoc para o processamento de evento.
Se você configurar este valor para True, também deve configurar as seguintes propriedades:
  • Código de Falha ALE
  • Código de Sucesso ALE
  • Texto de Falha ALE
  • Texto de Sucesso ALE.
Globalizado Não
Bidirecional suportado Não

Entrega Única Garantida (AssuredOnceDelivery)

Esta propriedade especifica se é necessário fornecer entrega única garantida para eventos de entrada.

Tabela 5. Detalhes da Entrega Única Garantia
Requerido Sim
Padrão True
Tipo de Propriedade Booleana
Uso

Quando esta propriedade é configurada como True, o adaptador fornece a entrega de evento único garantida, para que cada evento seja entregue apenas uma vez. Um valor igual a False não fornece entrega de evento único garantida, mas fornece melhor desempenho.

Quando esta propriedade for configurada como True, o adaptador tentará armazenar as informações de transação (XID) no armazenamento de eventos. Se estiver configurada como False, o adaptador não tentará armazenar as informações.

Esta propriedade será utilizada apenas se o componente de exportação for transacional. Se o componente de exportação for não transaciona, nenhuma transação poderá ser utilizada, independentemente do valor desta propriedade.

Globalizado Não
Bidirecional suportado Não
Nota: A propriedade Garantia de entrega apenas uma vez se aplica apenas para o processamento do RFC transacional assíncrono.

Tabela de eventos de criação automática (EP_CreateTable)

Esta propriedade determina se a tabela de eventos é criada automaticamente.

Tabela 6. Detalhes da Criação Automática da Tabela de Eventos
Requerido Sim se Entrega de evento assegurada apenas uma vez estiver configurado como True; caso contrário, não.
Valores possíveis

True
False

Padrão True
Tipo de Propriedade Boolean
Utilização Esta propriedade indica se o adaptador deve criar a tabela de recuperação de eventos automaticamente se ela ainda não existir.

Se você especificar um valor de True para criar a tabela automaticamente, deverá especificar informações sobre a tabela de eventos (como o nome da tabela de recuperação de eventos).

O valor que é fornecido na propriedade Nome da Tabela de Recuperação de Evento é utilizado para criar a tabela.

Globalizado Não
Bidirecional suportado Não

Cliente

Esta propriedade é o número do cliente do sistema SAP ao qual o adaptador se conecta.

Tabela 7. Detalhes do Cliente
Requerido Sim
Valores possíveis Você pode digitar uma série de valores de 000 a 999.
Padrão 100
Tipo de Propriedade Inteiro
Uso

Quando um aplicativo tenta efetuar logon no servidor SAP, o aplicativo deve ter um número de Cliente associado a ele. O valor da propriedade do Cliente identifica o cliente (o adaptador) que está tentando efetuar logon no servidor SAP.

Globalizado Não
Bidirecional suportado Não

Número da Página de Códigos (Codepage)

O identificador numérico da página de códigos.

Tabela 8. Detalhes do Número da Página de Códigos
Requerido Não
Valores possíveis Você pode digitar uma série de valores de 0000 a 9999.

Para obter uma listagem completa de idiomas e números de página de códigos associados que são suportados pelo SAP, consulte a Nota 7360 do SAP.

Padrão O valor padrão para esta propriedade é determinado condicionalmente pelo valor configurado para a propriedade do Código de Idioma.
Tipo de Propriedade Inteiro
Uso

O valor que é designado para Número da Página de Códigos define a página de códigos a ser utilizada e possui um relacionamento um-para-um com o valor que é configurado para a propriedade Código do Idioma. O Número da Página de Códigos establelece uma conexão com o idioma apropriado.

Cada valor de código de idioma possui um valor de número de página de códigos associado a ele. Por exemplo, o código de idioma para inglês é EN. Se você selecionar EN (Inglês) como seu código do idioma, o número da página de códigos será configurado automaticamente com o valor numérico associado a EN (Inglês). O número da página de códigos SAP para EN (Inglês) é 1100.

Exemplo:

Se o Código de Idioma estiver configurado como JA (Japonês), o Número da Página de Códigos será configurado como 8000.

Globalizado Não
Bidirecional suportado Não

Nome do esquema de banco de dados (EP_SchemaName)

Esta propriedade é o esquema que é utilizado para criação automática da tabela de recuperação de eventos.

Tabela 9. Detalhes do Nome do Esquema do Banco de Dados
Requerido Não
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Especifica o nome do esquema para o banco de dados utilizado pelo recurso de persistência do evento do adaptador.
Exemplo: ALE_SCHEMA
Globalizado SIM
Bidirecional suportado Não

Tipo de Entrega (DeliveryType)

Esta propriedade especifica a ordem na qual os eventos são entregues pelo adaptador para o componente da exportação.

Tabela 10. Detalhes do Tipo de Entrega
Exigido Não
Valores possíveis

ORDERED
UNORDERED

Default ORDERED
Tipo de Propriedade Sequência
Uso Os seguintes valores são suportados:
  • ORDERED: O adaptador entrega os eventos para o componente da exportação um por vez.
  • UNORDERED: O adaptador entrega todos os eventos para o componente da exportação de uma vez.

Se você configurar esta propriedade como UNORDERED, as propriedades Mínimo de conexões e Máximo de conexões deverão ser maiores que 1.

Globalizado Não
Bidirecional suportado Não

Ativar a Conexão de Rede Segura

Esta propriedade indica se o modo de conexão de rede segura está ativado.

Tabela 11. Detalhes de Ativar Conexão de Rede Segura
Requerido Não
Valores possíveis

0 (desligado)
1 (ligado)

Padrão 0
Tipo de Propriedade Seqüência de caracteres
Utilização Configure o valor como 1 (ligado) se você desejar utilizar a conexão de rede segura.
Se você configurar este valor como 1, também deverá configurar as seguintes propriedades:
  • Caminho da Biblioteca de Conexão de Rede Segura
  • Nome da Conexão de Rede Segura
  • Parceiro da Conexão de Rede Segura
  • Nível de Segurança da Conexão de Rede Segura
Globalizado Não
Bidirecional suportado Não

Nome da origem de dados de recuperação de eventos (JNDI) (EP_DataSource_JNDIName)

Esta propriedade é o nome JNDI da origem de dados que é configurada para a recuperação de eventos.

Tabela 12. Detalhes do Nome da Origem de Dados de Recuperação do Evento (JNDI)
Requerido SIM
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Utilizado no processamento de recuperação de eventos. A origem de dados deve ser criada em WebSphere Message Broker. O adaptador utiliza a origem de dados para persistir o estado do evento.
Exemplo: jdbc/DB2
Globalizado Não
Bidirecional suportado Não

Nome da tabela de recuperação de eventos (EP_TableName)

Esta propriedade é o nome da tabela de recuperação de eventos.

Tabela 13. Detalhes do Nome da Tabela de Recuperação de Eventos
Requerido SIM
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Utilizado no processamento de recuperação de eventos. Consulte a documentação do banco de dados para obter informações sobre as convenções de nomenclatura.

Configure uma tabela de recuperação de evento separado para cada terminal. A mesma origem de dados pode ser utilizada para reter todas as tabelas de recuperação de eventos.

Exemplo: EVENT_TABLE
Globalizado Não
Bidirecional suportado Não

Tipos de eventos para processamento (EventTypeFilter)

Esta propriedade fornece uma lista delimitada de tipos de objetos de negócios para os quais o adaptador deverá entregar objetos.

Tabela 14. Detalhes do Filtro de Tipo de Eventos
Requerido Não
Valores possíveis Uma lista delimitada por vírgulas (,) dos tipos de objetos de negócios.
Padrão null
Tipo de Propriedade Seqüência de caracteres
Utilização Se esta propriedade for configurada, o adaptador usará a lista delimitada como um filtro, entregando eventos apenas para os tipos de objetos de negócios contidos na lista. Se a lista estiver vazia (nula), o adaptador não aplica a filtragem, e entrega eventos para todos os tipos de objetos de negócios.
Globalizado Não
Bidi suportado Não

código de falha (aleFailureCode)

Esta propriedade determina como o adaptador atualiza o código de status de falha SAP depois do módulo ALE ter recuperado um objeto IDoc para o processamento de eventos.

Tabela 15. Detalhes do Código de Falha ALE
Requerido Sim se AleUpdateStatus estiver configurado como True; caso contrário, não.
Valores possíveis

68
58
51

Padrão 51
Tipo de Propriedade Número Inteiro
Utilização Configure um valor para esta propriedade apenas se você configurar o valor para a propriedade de status de atualização ALE como True.

Especifique um valor igual a 68 para esta propriedade para fazer com que o adaptador atualize o código de status da falha SAP depois do módulo ALE ter recuperado um objeto IDoc para processamento de eventos. O SAP converte este valor em 40 (Documento do Aplicativo não criado no sistema de recebimento).

Ao configurar a propriedade AleUpdateStatus para True, o adaptador atualiza o código de status SAP padrão depois que o adaptador recupera um objeto IDoc para processamento de eventos. Um IDoc que não é enviado com êxito para o terminal é considerado como uma falha. Use a propriedade do código de falha ALE para especificar o código que é usado para representar esta falha.

Globalizado Não
Bidirecional suportado Não

Falha da texto (aleFailureText)

A propriedade especifica o texto que aparece quando um IDoc não é enviado com êxito para o terminal.

Tabela 16. Detalhes do Texto de Falha ALE
Requerido Sim se AleUpdateStatus estiver configurado como True; caso contrário, não.
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Use esta propriedade apenas se tiver configurado a propriedade de status de atualização ALE como True.

O comprimento da cadeia de texto não pode exceder 70 caracteres.

Ao configurar a propriedade AleUpdateStatus para True, o adaptador atualiza o código de status SAP padrão depois que o adaptador recupera um objeto IDoc para processamento de eventos. Um IDoc que não é enviado com êxito para o terminal é considerado como uma falha. Utilize a propriedade de texto de falha ALE para especificar o texto descritivo utilizado para representar esta falha.

Exemplo: Falha de Dispatch ALE
Globalizado SIM
Bidirecional suportado Não

Pasta para Arquivos de Rastreio RFC (RfcTracePath)

Esta propriedade configura o caminho local completo até a pasta na qual gravar os arquivos de rastreio RFC.

Tabela 17. Pasta para Detalhes de Arquivos de Rastreio RFC
Requerido Não
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso Identifica o caminho local completo no qual os arquivos de rastreio RFC serão gravados.

Se o Rastreio do RFC estiver configurado como False (não selecionado), você não poderá configurar um valor na propriedade Pasta para Arquivos de Rastreio do RFC.

Exemplo: c:\temp\rfcTraceDir
Globalizado Sim
Bidirecional suportado Não

Host gateway (GatewayHost)

Esta propriedade é o nome do host do Gateway. Digite o endereço IP ou o nome do host do Gateway. Consulte seu administrador SAP para obter informações sobre o nome do host do Gateway.

Tabela 18. Detalhes do Host de Gateway
Requerido Sim
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso

Esta propriedade é o nome do host do gateway SAP. O gateway ativa a comunicação entre processos de trabalho no sistema SAP e programas externos.

O host identificado é utilizado como o gateway para o adaptador de recursos.

Comprimento máximo de 20 caracteres. Se o nome do computador tiver mais de 20 caracteres, defina um nome simbólico na tabela THOSTS.

Globalizado Não
Bidirecional suportado Não

Serviço de Gateway (GatewayService)

Esta propriedade é o identificador do gateway no host do gateway que executa serviços RFC.

Tabela 19. Detalhes de Serviço de Gateway
Requerido Sim
Padrão sapgw00
Tipo de Propriedade Cadeia
Uso

Estes serviços ativam a comunicação entre processos de trabalho do servidor SAP e programas externos. O serviço geralmente possui o formato sapgw00, em que 00 é o número do sistema SAP.

Máximo de 20 caracteres.

Globalizado Não
Bidirecional suportado Não

Nome do Host (ApplicationServerHost)

Especifica o endereço IP ou o nome do host do servidor de aplicativos no qual o adaptador efetua logon.

Tabela 20. Detalhes do Nome do Host
Requerido Sim (quando o balanceamento de carga não for utilizado).
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso

Quando o adaptador é configurado para execução sem balanceamento de carga, esta propriedade especifica o endereço IP ou o nome do servidor de aplicativos no qual o adaptador efetua logon.

Exemplo: sapServer
Globalizado Não
Bidirecional suportado Não

Tags Vazias IDoc

Esta propriedade inclui tags vazias nos campos não preenchidos no segmento IDoc, que são enviadas a um terminal configurado, baseado na opção selecionada.

Tabela 21. Tags Vazias IDoc
Requerido Não
Valores Possíveis

BEFORE_AND_AFTER

ONLY_BEFORE

ALL_UNPOPULATED_FIELDS_SEGMENTS

Padrão ONLY_BEFORE
Tipo de Propriedade Cadeia
Uso

Use esta propriedade para selecionar as seguintes opções de tag vazia de IDoc:

  • BEFORE_AND_AFTER - Inclua tags vazias nos campos não preenchidos antes e depois dos campos preenchidos dentro dos segmentos IDoc.
  • ONLY_BEFORE - Inclua dados vazios para os campos não preenchidos em um segmento IDoc antes do campo preenchido.
  • ALL_UNPOPULATED_FIELDS_SEGMENTS - Inclua tags vazias nos campos não preenchidos em todos os segmentos IDoc.
Globalizado Não
Bidi suportado Não

Ignorar erros de pacote IDoc (IgnoreIDocPacketErrors)

Esta propriedade determina se os erros de pacote IDoc devem ser ignorados.

Tabela 22. Detalhes ao Ignorar de Erros do Pacote IDOC
Requerido Não
Valores possíveis

True
False

Padrão False
Tipo de Propriedade Boolean
Utilização
Se o adaptador encontrar um erro ao processar o pacote de IDocs, ele poderá se comportar de duas maneiras diferentes.
  • Quando esta propriedade estiver configurada como False, o adaptador parará de processar IDocs adicionais nesse pacote e relatará um erro ao sistema SAP.
  • Quando esta propriedade é configurada como True, o adaptador registra um erro e continua a processar o restante dos IDocs no pacote.

    O status da transação é marcado como INPROGRESS. O log do adaptador exibe os números do IDoc que falharam e você precisa submeter novamente esses IDocs individuais separadamente. Você precisa manter manualmente estes registros na tabela de recuperação de eventos.

Esta propriedade não é utilizada para IDocs únicos e para pacote de IDocs não-divididos.

Globalizado Não
Bidirecional suportado Não

Código de linguagem

Esta propriedade especifica o código de Idioma no qual o adaptador efetua logon.

Tabela 23. Detalhes do Código do Idioma
Requerido Sim
Valores possíveis

Para obter uma listagem completa de idiomas e números de página de códigos associados que são suportados pelo SAP, consulte a Nota 7360 do SAP.

Padrão O valor padrão para a propriedade Código de Idioma é baseado no código de idioma do sistema.
Tipo de Propriedade Cadeia
Uso

Cada um dos idiomas suportados é precedido por um código de idioma de dois caracteres. O idioma em si é exibido entre parênteses.

Se você digitar um código de idioma manualmente, não é necessário digitar o idioma entre parênteses.

Os códigos de idioma listados representam o conjunto padrão SAP de 41 idiomas para sistemas não-Unicode mais Árabe.

O valor que você selecionar determina o valor da propriedade Número da Página de Códigos.

Exemplo:

Se o código de idioma do sistema estiver em inglês, o valor para esta propriedade será EN (English).

Globalizado Não
Bidirecional suportado Não

Balanceamento de Carga

Esta propriedade especifica se sua configuração SAP usa o balanceamento de carga

Tabela 24. Detalhes do Balanceamento de Carga
Requerido Sim
Valores possíveis

True
False

Padrão False
Tipo de Propriedade Booleana
Uso

Este valor deverá ser configurado como true se a configuração SAP usar o balanceamento de carga. Se configurado como true, o host do servidor de Mensagem, o grupo de Logon e o ID do sistema SAP precisam ser especificados.

Globalizado Não
Bidi suportado Não

Nome do Grupo de Logon

Esta propriedade é um identificador para o nome do grupo de instâncias do servidor de aplicativos que foram definidas na transação SMLG e vinculadas para balanceamento de carga de logon.

Tabela 25. Detalhes do Grupo de Logon
Requerido Sim (se o balanceamento de carga for utilizado)
Valores possíveis Consulte a documentação SAP para obter informações sobre a criação de grupos de Logon e sobre a chamada da transação SMLG.
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso

Quando o adaptador estiver configurado para balanceamento de carga, esta propriedade representará o nome do grupo de instâncias do servidor de aplicativos que foram definidas na transação SMLG e vinculadas para balanceamento de carga de logon.

O balanceamento de carga de logon permite a distribuição dinâmica de conexões de logon com instâncias do servidor de aplicativos.

Máximo de 20 caracteres. Na maioria dos sistemas SAP, o grupo de logon SPACE é reservado pelo SAP.

Globalizado Não
Bidirecional suportado Não

Número Máximo de Eventos Coletados Durante Cada Sondagem

Esta propriedade especifica o número de eventos que o adaptador entrega ao componente de exportação durante cada período de sondagem.

Tabela 26. Detalhes do Número Máximo de Eventos Coletados Durante Cada Sondagem
Requerido SIM
Padrão 10
Tipo de Propriedade Número Inteiro
Utilização Este valor deve ser maior do que 0
Globalizado Não
Bidi suportado Não

Número Máximo de Novas Tentativas no Caso de Falha na Conexão do Sistema

Esta propriedade especifica o número de vezes em que o adaptador tenta reiniciar os listeners de eventos.

Tabela 27. Detalhes do Número Máximo de Novas Tentativas no caso de Falha no Sistema
Requerido Sim
Padrão 0
Tipo de Propriedade Inteiro
Uso
Quando o adaptador encontra um erro relacionado à conexão de entrada (se o aplicativo do SAP não estiver sendo executado, por exemplo), esta propriedade especifica o número de vezes que o adaptador tenta reiniciar os listeners de evento. Um valor 0 indica um número infinito de novas tentativas.
Nota: Configure o Tempo entre novas tentativas no caso de falha da conexão do sistema (milissegundos) apropriadamente quando tentar novamente infinitamente.

Para cada nova tentativa, o adaptador aguarda com base no intervalo de tempo que é especificado no Tempo entre novas tentativas no caso de falha de conexão do sistema (milissegundos).

Nota: Se todas as novas tentativas falharem, o adaptador registrará as mensagens e eventos de CEI relevantes e parará de tentar recuperar o listener de evento. Se você atingir este ponto, poderá precisar reiniciar o aplicativo manualmente.
Globalizado Não
Bidirecional suportado Não

Host do servidor de sistema de mensagens (MessageServerHost)

Esta propriedade especifica o nome do host no qual o servidor de mensagens está sendo executado.

Tabela 28. Detalhes do Host do Servidor de Mensagens
Requerido Sim (se o balanceamento de carga for utilizado)
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso

Esta propriedade especifica o nome do host que informará todos os servidores (instâncias) pertencentes a este sistema SAP da existência de outros servidores a serem utilizados para balanceamento de carga.

O host do servidor de mensagens contém as informações sobre o balanceamento de carga para clientes RFC para que um cliente RFC possa ser direcionado para um servidor de aplicativos apropriado.

Exemplo: SAPERP05
Globalizado Não
Bidirecional suportado Não

Número de Listeners

Esta propriedade especifica o número de listeners que são iniciados por um evento.

Tabela 29. Número de Detalhes de Listeners
Requerido Não
Padrão 1
Tipo de Propriedade Inteiro
Uso Para seqüência de eventos, esta propriedade deve ser configurada como 1.

Para aumentar o desempenho do adaptador você pode aumentar o número de listeners.

O adaptador não será iniciado se o número de listeners for zero (0).

Globalizado Não
Bidirecional suportado Não

Conjunto de Caracteres do Parceiro (PartnerCharset)

Esta propriedade especifica a codificação do conjunto de caracteres do parceiro.

Tabela 30. Detalhes do Conjunto de Caracteres do Parceiro
Requerido Não
Padrão

UTF-8

Tipo de Propriedade Cadeia
Uso Quando uma codificação é especificada, ela é utilizada; caso contrário, a codificação padrão é utilizada.
Globalizado Não
Bidirecional suportado Não

Senha

Esta propriedade é a senha da conta de usuário do adaptador no servidor do aplicativo do SAP.

Tabela 31. Detalhes da Senha
Requerido Sim
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso

As restrições na senha dependem da versão do SAP Web Application Server.

  • Para SAP Web Application Server versão 6.40 ou anterior, a senha:
    • Deve estar em maiúsculas
    • Deve ter 8 caracteres
  • Para versões de SAP Web Application Server posteriores à 6.40, a senha:
    • Não faz distinção entre maiúsculas e minúsculas
    • Pode ter até 40 caracteres
Globalizado Não
Bidirecional suportado Sim

Senha usada para conectar-se à origem de dados do evento (EP_Password)

Esta propriedade é a senha de usuário para conexão com o banco de dados.

Tabela 32. Senha para conectar-se aos detalhes da origem de dados do evento
Requerido Sim
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Esta propriedade especifica a senha utilizada pelo processamento de persistência de evento para obter a conexão com o banco de dados a partir da origem de dados.
Globalizado SIM
Bidirecional suportado Não

ID do Programa RFC

Esta propriedade é o identificador do programa com o qual o adaptador é registrado no gateway SAP.

Tabela 33. Detalhes do ID do Programa RFC
Requerido Sim
Valores possíveis Utilize a transação SM59 do SAP (Exibir e Manter Destinos RFC) para ver uma lista dos IDs do programa RFC disponíveis.
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Cadeia
Uso

O adaptador é registrado no gateway para que os encadeamentos do listener possam processar eventos a partir de funções ativadas para RFC. Este valor deve corresponder ao ID do programa registrado no aplicativo SAP.

O comprimento máximo é de 64 caracteres.

Globalizado Não
Bidirecional suportado Não

Nível de Rastreio RFC (RcfTraceLevel)

Esta propriedade especifica o nível de rastreio global.

Tabela 34. Detalhes do Nível de Rastreio RFC
Requerido Não
Valores possíveis

0 - Sem erro
1 - Erros e avisos
2 - Caminho de execução, erros e avisos
3 - Caminho de execução completo, erros e avisos
4 - Caminho de execução, mensagens de informações, erros e avisos
6 - Caminho de execução completo, mensagens informativas, erros e avisos
7 - Mensagens de depuração, caminho de execução completo, mensagens informativas, erros e avisos
8 - Mensagens de depuração detalhadas, caminho de execução completo, mensagens informativas, erros e avisos

Padrão 1
Tipo de Propriedade Inteiro
Uso Se Rastreio RFC ativado estiver configurado como False (não selecionado), você não poderá configurar um valor na propriedade Nível de Rastreio RFC.
Globalizado Não
Bidirecional suportado Não

Rastreio RFC Ativado (RcfTraceOn)

Esta propriedade especifica se gerar um arquivo de texto detalhando a atividade de RFC para cada listener de evento.

Tabela 35. Rastreio RFC em Detalhes
Requerido Não
Valores possíveis

True
False

Padrão False
Tipo de Propriedade Booleana
Uso Um valor True ativa o rastreio, que gera um arquivo de texto.

Este arquivo é criado no diretório em que o processo do adaptador foi iniciado. O arquivo tem um prefixo de rfx e um tipo de arquivo de trc (por exemplo, rfc03912_02220.trc).

Utilize estes arquivos de texto apenas em um ambiente de desenvolvimento, porque os arquivos podem aumentar de tamanho rapidamente.

Se Rastreio RFC ativado estiver configurado como False (não selecionado), você não poderá configurar valores nas propriedades Pasta para Arquivos de Rastreio RFC ou Nível de Rastreio RFC.

Exemplo:

Exemplos das informações no arquivo são RfcCall FUNCTION BAPI_CUSTOMER_GETLIST, seguido pelas informações para os parâmetros na interface, ou RFC Info rfctable, seguido pelos dados de uma das tabelas de interface.

O arquivo de rastreio é criado no diretório em que o processo do adaptador foi iniciado. O arquivo de rastreio tem uma extensão de arquivo .trc e o nome do arquivo iniciará com as letras rfc seguidas de um identificador exclusivo. Por exemplo, rfc03912_02220.trc.

Globalizado Não
Bidirecional suportado Não

ID do Sistema SAP (SAPSystemID)

Esta propriedade especifica o ID do sistema do sistema SAP para o qual é permitido o balanceamento de carga de logon.

Tabela 36. Detalhes do ID do Sistema SAP
Requerido Sim (quando o balanceamento de carga é utilizado)
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso O valor deve ter três caracteres
Exemplo: DYL
Globalizado Não
Bidirecional suportado Não

Caminho da Biblioteca de Conexão de Rede Segura (SncLib)

Esta propriedade especifica o caminho para a biblioteca que fornece o serviço de Conexão de rede segura.

Tabela 37. Detalhes do Caminho da Biblioteca de Conexão de Rede Segura
Requerido Sim, se SncMode estiver configurado como 1; caso contrário, não.
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso Se a propriedade SncMode estiver configurada como 1 (indicando que você está utilizando uma conexão de rede segura), especifique o caminho para a biblioteca que fornece o serviço.
Exemplo: /WINDOWS/system32/gssapi32.dll
Globalizado Não
Bidirecional suportado Não

Nome da Conexão de Rede Segura (SncMyname)

Esta propriedade especifica o nome da conexão de rede segura.

Tabela 38. Detalhes do Nome da Conexão de Rede Segura
Requerido Sim, se SncMode estiver configurado como 1; caso contrário, não.
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso Se a propriedade SncMode estiver configurada como 1 (indicando que você está utilizando uma conexão de rede segura), especifique um nome para a conexão.
Exemplo: DOMAINNAME/USERNAME
Globalizado Não
Bidirecional suportado Não

Parceiro da Conexão de Rede Segura (SncPartnername)

Esta propriedade especifica o nome do parceiro da conexão de rede segura.

Tabela 39. Detalhes do Parceiro de Conexão de Rede Segura
Requerido Sim, se SncMode estiver configurado como 1; caso contrário, não.
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso Se a propriedade SncMode estiver configurada como 1 (indicando que você está utilizando uma conexão de rede segura), especifique um nome para o parceiro de conexão.
Exemplo: CN=sap00.saperpdev, OU=Adapter, O=IBM, C=US
Globalizado Não
Bidirecional suportado Não

Nível de Segurança da Conexão de Rede Segura (SncQop)

Esta propriedade especifica o nível de segurança para a conexão de rede segura.

Tabela 40. Detalhes do Nível de Segurança da Conexão de Rede Segura
Requerido Sim, se SncMode estiver configurado como 1; caso contrário, não.
Valores possíveis
  • 1 (Apenas autenticação)
  • 2 (Proteção da integridade)
  • 3 (Proteção da privacidade)
  • 8 (Utilize o valor de snc/data_protection/use no servidor de aplicativos)
  • 9 (Utilize o valor de snc/data_protection/max no servidor de aplicativos)
Padrão 3 (Proteção da privacidade)
Tipo de Propriedade Cadeia
Uso Se a propriedade SncMode estiver configurada como 1 (indicando que você está utilizando uma conexão de rede segura), especifique um valor para indicar o nível de segurança para a conexão.
Globalizado Não
Bidirecional suportado Não

Atualização seletiva (aleSelectiveUpdate)

Esta propriedade especifica quais combinações de Tipo de IDoc e MessageType devem ser atualizadas.

Tabela 41. Detalhes de Atualização Seletiva ALE
Requerido Não
Padrão Nenhum Valor Padrão
Tipo de Propriedade Seqüência de caracteres
Utilização Você poderá configurar valores para esta propriedade apenas se a propriedade de status de atualização ALE for configurada como True.

Ao configurar a propriedade AleUpdateStatus para True, o adaptador atualiza o código de status SAP padrão depois que o adaptador recupera um objeto IDoc para processamento de eventos. Utilize a propriedade de atualização seletiva ALE para especificar quais combinações de Tipo de IDoc e MessageType devem ser atualizadas.

A sintaxe para esta propriedade é: IDocType: MessageType [;IDocType: MessageType [;...]] em que um delimitador barra (/) separa cada Tipo de IDoc e MessageType e um delimitador ponto-e-vírgula (;) separa as entradas em um conjunto.

Exemplo: O exemplo a seguir ilustra duas configurações. No exemplo, MATMAS03 e DEBMAS03 são os IDocs e MATMAS e DEBMAS são os tipos de mensagens:

MATMAS03/MATMAS;DEBMAS03/DEBMAS

Globalizado Não
Bidirecional suportado Não

Código de mensagem de status (aleStatusMsgCode)

Esta propriedade especifica o código de mensagem a ser utilizado quando o adaptador postar o ALEAUD01 IDoc com o tipo de mensagem ALEAUD.

Tabela 42. Detalhes do Código de Mensagem de Status ALE
Requerido Não
Valores possíveis Para obter uma lista de códigos disponíveis, consulte a tabela SAP TEDS1.
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Você poderá configurar um valor para esta propriedade apenas se a propriedade de status de atualização ALE tiver sido configurada como True.

Você deve configurar este código da mensagem no perfil do parceiro de recebimento no SAP.

Globalizado Não
Bidirecional suportado Não

Pare o adaptador quando um erro é encontrado durante a sondagem (StopPollingOnError)

Esta propriedade especifica se o adaptador pára a sondagem para eventos quando encontra um erro durante a sondagem.

Tabela 43. Detalhes Sobre a Parada do Adaptador Quando um Erro é Encontrado Durante a Sondagem
Exigido Não
Valores possíveis

True
False

Default False
Tipo de Propriedade Booleana
Uso

Se esta propriedade estiver configurada como True, o adaptador parará a sondagem quando encontrar um erro.

Se esta propriedade estiver configurada como False, o adaptador registrará em log uma exceção quando encontrar um erro durante a sondagem e continuar a sondagem.

Globalizado Não
Bidirecional suportado Não

Código de sucesso (aleSuccessCode)

Esta propriedade especifica o código de êxito ALE para a postagem bem-sucedida de um IDoc.

Tabela 44. Detalhes do Código de Sucesso ALE
Requerido Sim se AleUpdateStatus estiver configurado como True; caso contrário, não.
Valores possíveis

39
41
55

Padrão 55 - Documento do aplicativo postado
Tipo de Propriedade Número Inteiro
Utilização Use esta propriedade apenas se tiver configurado a propriedade de status de atualização ALE como True.

Ao configurar a propriedade AleUpdateStatus para True, o adaptador atualiza o código de status SAP padrão depois que o adaptador recupera um objeto IDoc para processamento de eventos. Utilize a propriedade de código de êxito ALE para especificar o código para IDoc postado como 53.

Quando o IDoc for enviado para o terminal, o status desse IDoc permanecerá como 03 (IDoc postado na porta) no SAP. Depois de postar o IDoc, o adaptador postará o IDoc de auditoria com o número do IDoc atual e o status como 53. O SAP converte o status do IDoc atual em 41 (Documento do Aplicativo Criado no Sistema de Recebimento).

Globalizado Não
Bidirecional suportado Não

Texto do sucesso (aleSuccessText)

Esta propriedade especifica o texto que aparece quando um documento do aplicativo é postado com êxito.

Tabela 45. Detalhes do Texto de Sucesso ALE
Requerido Sim se AleUpdateStatus estiver configurado como True; caso contrário, não.
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Use esta propriedade apenas se tiver configurado a propriedade de atualização de status ALE como True.

Ao configurar a propriedade AleUpdateStatus para True, o adaptador atualiza o código de status SAP padrão depois que o adaptador recupera um objeto IDoc para processamento de eventos. Utilize a propriedade de texto de êxito ALE para especificar o texto descritivo utilizado para representar o Documento do Aplicativo Postado.

Exemplo: Dispatch ALE Bem-sucedido
Globalizado SIM
Bidirecional suportado Não

Número do Sistema (SystemNumber)

Esta propriedade é o número do sistema do servidor de aplicativos do SAP.

Tabela 46. Detalhes do Número do Sistema
Requerido Sim
Valores possíveis Você pode digitar uma série de valores de 00 a 99
Padrão 00
Tipo de Propriedade Inteiro
Uso

O número do sistema identifica melhor o serviço de Gateway.

Globalizado Não
Bidirecional suportado Não

Tempo entre a sondagem para eventos (milissegundos)

Esta propriedade especifica o período de tempo que o adaptador espera entre períodos de polling.

Tabela 47. Tempo entre a sondagem para eventos (milissegundos)
Requerido SIM
Valores possíveis Números inteiros maior que ou igual a 0.
Padrão 2000
Unidade de medida Milissegundos
Tipo de Propriedade Número Inteiro
Utilização O intervalo de tempo entre os eventos de sondagem é estabelecido como uma taxa fixa, o que significa que se a execução do ciclo de sondagem for atrasada por qualquer razão (por exemplo, se um ciclo de sondagem anterior demorar mais do que o esperado para terminar), o próximo ciclo de sondagem ocorre imediatamente para compor o tempo que é perdido por causa do atraso.
Globalizado Não
Bidi suportado Não

Tempo entre as Novas Tentativas no Caso de Falha na Conexão do Sistema (Milissegundos) (ConnectionRetryInterval)

Esta propriedade especifica o intervalo de tempo entre as tentativas de reiniciar os listeners de evento.

Tabela 48. Detalhes do Tempo entre as Novas Tentativas no Caso de Falha na Conexão do Sistema
Requerido Não
Valores possíveis Número Inteiro Positivo
Padrão 60000
Unidade de medida Milissegundos
Tipo de Propriedade Inteiro
Uso Quando o adaptador encontra um erro relacionado à conexão de entrada, esta propriedade especifica o intervalo de tempo que o adaptador aguarda entre as tentativas de reiniciar os listeners de eventos.
Globalizado Não
Bidirecional suportado Não

Cortar Dados do Campo ALE Idoc

Esta propriedade especifica se os espaços em branco à esquerda são cortados pelo adaptador antes de enviá-lo ao terminal.

Tabela 49. Cortar Dados do Campo ALE Idoc
Requerido Não
Valores Possíveis

True

False

Padrão True
Tipo de Propriedade Booleana
Uso

Se desejar que os espaços em branco à esquerda sejam cortados pelo adaptador antes de enviá-los ao terminal, configure essa propriedade como True. Por padrão, a propriedade é configurada como True.

Se você não quiser que os espaços em branco à esquerda sejam cortados pelo adaptador, configure o valor como False.

Globalizado Não
Bidi suportado Não

Nome de Usuário (userName)

Esta propriedade é a conta de usuário para o adaptador no servidor SAP.

Tabela 50. Detalhes de Nome de Usuário
Requerido Sim
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso Comprimento máximo de 12 caracteres. O nome de usuário não faz distinção entre maiúsculas e minúsculas.

Recomenda-se que você configure uma conta de usuário CPIC no aplicativo SAP e que forneça a esta conta os privilégios necessários para manipular os dados necessários pelos objetos de negócios suportados pelo adaptador. Por exemplo, se o adaptador tiver que executar determinadas transações de negócios SAP, a conta do adaptador no aplicativo SAP deve ter permissões configuradas para permitir que execute essas transações.

Exemplo: SapUser
Globalizado Sim
Bidirecional suportado Sim

Nome de usuário utilizado para conectar-se à origem de dados do evento (EP_UserName)

Esta propriedade é o nome de usuário para conexão com o banco de dados.

Tabela 51. Nome do usuário para conectar-se aos detalhes da origem de dados do evento
Requerido SIM
Padrão Nenhum Valor Padrão.
Tipo de Propriedade Seqüência de caracteres
Utilização Nome de usuário utilizado pela persistência de eventos para obter a conexão do banco de dados da origem de dados. Consulte a documentação do banco de dados para obter informações sobre as convenções de nomenclatura.
Globalizado SIM
Bidirecional suportado Não

Certificado X509 (X509cert)

Esta propriedade especifica o certificado X509 a ser utilizado como o bilhete de logon.

Tabela 52. Detalhes do Certificado X509
Requerido Não
Padrão Nenhum Valor Padrão
Tipo de Propriedade Cadeia
Uso Se a propriedade SncMode estiver configurada como 1 (indicando que você está utilizando uma conexão de rede segura), você poderá fornecer um valor para o certificado X509.
Globalizado Não
Bidirecional suportado Não
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:32:01


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | rbp_sap_inbound_props_WMB