Atividade Enviar IDOC do SAP
Use a atividade Enviar IDOC do SAP para enviar um IDOC para o terminal SAP especificado, durante o tempo de execução.
Se enviar seus dados SAP diretamente para o sistema SAP usando uma porta RFC, você deverá usar a atividade Enviar IDOC do SAP. Se enviar seus dados SAP como um arquivo por meio de uma Porta de Arquivo SAP para o sistema SAP, você deverá usar a opção de menu da barra de ferramentas Projeto > Importar > Esquema IDOC do SAP durante o tempo de design para gerar um Esquema de Arquivo Simples para seus metadados IDOC e usar a atividade Gravar Arquivo Simples para gravar os dados SAP. Para obter informações adicionais, consulte Gerando um Esquema de Arquivo Simples a partir de um IDOC.
Para conectar-se ao Sistema SAP a partir do Studio, você deve fazer download e instalar os arquivos JAR do SAP e DLLs em sua máquina de desenvolvimento do Windows. Para obter informações adicionais, consulte Fazendo download e instalando os Arquivos Jar e os DLLs do SAP.
Durante o tempo de execução, se a atividade Enviar IDOC do SAP processar duas instâncias de um IDOC, em que ambas as instâncias possuem o mesmo número de IDOC, a atividade Enviar IDOC do SAP anexará o segmento de dados da segunda instância à primeira instância.
Incluindo uma Atividade Enviar IDOC do SAP na Orquestração
- Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta SAP.
- Arraste a atividade Enviar IDOC para a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal SAP
- Clique na tarefa Selecionar Terminal na
Lista de Verificação e selecione uma das ações a
seguir:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK. Acesse o procedimento Configurando a Atividade.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK.
- Clique em Editar. O painel Editar Terminal é exibido.
- Crie um novo terminal: Selecione Novo. O painel Criar Terminal é exibido.
- Selecione um terminal existente:
- Crie ou edite um terminal SAP.
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação. O painel Configurar é exibido.
- Clique em Procurar....
- Selecione uma linha IDOC e clique em OK. O Tipo de Mensagem, o Tipo de IDOC e o Tipo Estendido de IDOC na tarefa Configurar são preenchidos.
Especificando as Opções de Nova Tentativa
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. O painel Tentar Novamente é exibido.
- Configure as opções de nova tentativa para se conectar a um Sistema SAP. A
tabela a seguir descreve as opções de nova tentativa para se conectar a um Sistema
SAP:
Opções de Nova Tentativa Descrição 1) Aguardar ___ segundos entre cada nova tentativa. Especifica o número de segundos que o Integration Appliance aguarda antes de tentar estabelecer uma conexão com o Sistema SAP. 2) Tentar se conectar ___ vezes antes de falhar. Especifica o número máximo de vezes que o Integration Appliance tenta estabelecer uma conexão com o Sistema SAP antes de emitir um erro e parar o processamento da tarefa de orquestração atual. Se você implementar uma orquestração que contém uma atividade Enviar IDOC do SAP e o Integration Appliance não puder se conectar ao sistema SAP especificado, o Integration Appliance registrará os erros de conexão como avisos nos logs do sistema e de orquestração até o valor de contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro nos logs do sistema e da orquestração e para o processamento da tarefa de orquestração atual. Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, segundo e terceiro erros de conexão aparecem no log do sistema como avisos. O Integration Appliance registra o quarto erro de conexão como um erro e para o processamento da tarefa de orquestração atual.
Mapeando as Entradas da Atividade
- Selecione a tarefa Mapear Entradas na Lista de Verificação. O parâmetro de entrada da atividade é exibido no painel Atividade de Destino. O Esquema XML gerado a partir do Tipo de IDOC e Tipo Estendido de IDOC selecionados torna-se o parâmetro de entrada da atividade.
- Clique com o botão direito na seção Atividade de Destino e selecione Mostrar Parâmetros Opcionais.
O conector SAP também suporta uma conexão de terminal dinâmico com um sistema SAP diferente. Durante o tempo de execução, inclua parâmetros opcionais em sapConnectionProperties das entradas de mapa se quiser se conectar dinamicamente a um sistema SAP diferente do configurado no painel do terminal, se quiser se conectar ao mesmo sistema SAP com um nome de usuário e senha diferentes dos campos usados no painel do terminal ou se quiser um token de SSO diferente do incluído no painel do terminal. Os parâmetros de sapConnectionProperties estão descritos na seguinte tabela:
Tabela 1. Propriedades da Conexão Parâmetro opcional Descrição Parâmetros sapConnectionProperties hostName Especifica o Endereço IP do nome da máquina que contém o sistema SAP. systemNumber Especifica o número que identifica a instância específica do sistema SAP ao qual o Studio deve se conectar. Seu administrador SAP deve fornecer estas informações. cliente Especifica um número que identifica o Studio e o Integration Appliance como um cliente para o sistema SAP. Seu administrador SAP deve fornecer estas informações. idioma Especifica a opção de idioma da mensagem para o SAP. Por exemplo, EN é o código ISO para inglês. Parâmetros basicAuthentication username Especifica o nome de usuário a ser usado ao se conectar com o sistema SAP. password Especifica a senha para o nome de usuário ao se conectar com o sistema SAP. Parâmetros ssoAuthentication ssotoken Especifica o token de conexão única (SSO). Parâmetros sncAuthentication sncmode Especifica se o modo Conexão de Rede Segura (SNC) está ativado. sncname Especifica o nome distinto da conexão SNC. parceiro Especifica o nome distinto do parceiro SNC. qop Especifica o nível de segurança do SNC. Certificado X509 Especifica o certificado X509 a ser usado como chamado de logon. Esse campo só será opcional se Autenticação baseada em nome de usuário/senha for usado com SNC. Parâmetros connectionPool maximumConnections Especifica as conexões SAP adicionais, até a quantidade especificada, que o Integration Appliance abre com base no carregamento de mensagem. maxIdleTime Especifica o número de minutos que uma conexão SAP pode ficar aberta e inativa antes de ser encerrada pelo Integration Appliance. - Crie um mapa entre as variáveis de orquestração e os parâmetros e tabelas de entrada de IDOC. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.
Nota sobre Implementação de uma Orquestração SAP
Antes de poder implementar uma orquestração com atividades do SAP usando o Web Management Console, o Integration Appliance deve primeiro poder estabelecer uma conexão com o Sistema SAP. Se o Integration Appliance não puder estabelecer a conexão com o Sistema SAP, a orquestração não será implementada.