Etapa 2: Expor um ponto de extremidade de retransmissão para chamar operações no ORDERS05 IDOC

Atualizado: maio de 2015

Há duas etapas principais necessárias para expor um artefato do SAP como uma operação que pode ser chamada enviando uma mensagem em Barramento do Serviço – criar um Destino de LOB e um Retransmissão de LOB.

  • Um Destino de LOB define como um aplicativo Azure se comunica com o sistema LOB (de linha de negócios). O Destino de LOB controla o URI de conexão do sistema LOB, a operação a ser executada e as credenciais de conexão.

  • Um Retransmissão de LOB é um serviço WCF executado em um firewall de organizações e escuta um ponto de extremidade de retransmissão no Barramento do Serviço. Como sugere o nome, o Retransmissão de LOB atua como uma retransmissão entre o ponto de extremidade de retransmissão Barramento do Serviço e o sistema LOB. Ele recebe a mensagem no ponto de extremidade de retransmissão Barramento do Serviço e passa-a para o sistema LOB relevante usando a configuração de Destino de LOB.

Para obter mais informações, consulte Arquitetura de serviço do adaptador de BizTalk. Neste tópico, criaremos um Destino de LOB e um Retransmissão de LOB para expor a operação Enviar em ORDERS05 IDOC.

  1. Abra o Visual Studio (como um administrador), crie um novo Projeto do Serviço BizTalk e nomeie-o como SAPIntegration.

  2. Comece com a adição de um servidor de Serviço de adaptador do BizTalk. Esse é o servidor em que você instalou o componente de tempo de execução de Serviço de adaptador do BizTalk. Para adicionar um servidor de Serviço de adaptador do BizTalk, no Gerenciador de Servidores no Visual Studio, clique com o botão direito do mouse em Serviço de adaptador do BizTalks e selecione Adicionar Serviço de adaptador do BizTalk. Na caixa de diálogo Adicionar Serviço de adaptador do BizTalk, insira a URL do serviço WCF que monitora esse serviço de retransmissão de Barramento do Serviço e selecione OK:

    Adicionar servidor de conexão do Barramento do Serviço

    Como você tem todos os componentes do Serviço de adaptador do BizTalk instalados no mesmo computador, a URL desse serviço será http://localhost:8080/BAService/ManagementService.svc/.

    noteObservação
    Se tiver instalado o componente de tempo de execução Serviço de adaptador do BizTalk em um computador separado, será necessário substituir “localhost” na URL anterior pelo nome desse computador.

  3. Neste tutorial, estamos criando um aplicativo para integração com o SAP, portanto, devemos adicionar um destino SAP. Expanda o servidor Tipos de LOB recém-adicionado, clique com o botão direito do mouse em SAP e selecione Adicionar Destino do SAP:

    Adicionar um destino SAP

    O assistente Adicionar um Destino é iniciado. Execute as seguintes etapas para criar um Destino de LOB.

    1. Leia as informações na página Antes de começar e selecione Avançar.

    2. Na página Parâmetros de Conexão, especifique os detalhes para a conexão do SAP Server e as credenciais a serem usadas na conexão. Selecione Avançar.

    3. Na página Operações, expanda a categoria ORDERSO5 IDOC (em \IDOC\ORDERS\). Há várias versões de IDOC disponíveis. Para este tutorial, selecionaremos ORDERS05.V3(700). Expanda esse IDOC, selecione Enviar e selecione a seta para a direita para adicioná-lo à caixa Operações Selecionadas:

      Adicionar operação de envio para IDOC

      Selecione Avançar.

    4. Na página Segurança de Tempo de Execução, especifique o mecanismo de segurança a ser usado pelo servidor LOB para autenticar o recurso de destino quando uma mensagem chega de um cliente. Para este tutorial, selecione Nome de Usuário Fixo e especifique as credenciais para se conectar ao servidor SAP.

    5. Na página Implantação, crie uma Retransmissão de LOB e um Destino de LOB para fornecer conectividade para seus aplicativos LOB locais na nuvem.

      Selecione a opção Criar novo para criar uma nova retransmissão e forneça os seguintes valores:

       

      Nome Descrição

      Namespace

      Especifique o namespace Barramento do Serviço em que o ponto de extremidade de retransmissão LOB é criado.

      Nome do emissor

      Especifique o nome do emissor para o namespace Barramento do Serviço.

      Segredo do emissor

      Especifique o segredo do emissor para o namespace Barramento do Serviço.

      Caminho de retransmissão

      Especifique um nome para a retransmissão. Para este tutorial, insira sapintegration01.

      Subcaminho de destino

      Insira um subcaminho para tornar esse destino exclusivo. Para este tutorial, insira pedidos.

      A propriedade somente leitura URL de tempo de execução de destino exibe a URL em que a retransmissão é implantada no Barramento do Serviço. Esse é o caminho onde você pode enviar uma mensagem a ser inserida no SAP Server no local. Em nosso cenário, é aqui que a ponte envia a mensagem.

      Selecione Avançar.

    6. Na página Resumo, examine os valores especificados nas etapas anteriores e selecione Criar.

    7. Quando o assistente for concluído, selecione Concluir.

      No Gerenciador de Servidores do Visual Studio, agora você tem uma entrada no nó SAP. Isso representa o ponto de extremidade de retransmissão criado no Barramento do Serviço para retransmitir as mensagens de PO que vêm da nuvem para o sistema SAP.

  1. Depois de adicionar o ponto de extremidade de retransmissão a um sistema SAP, você deve adicionar os esquemas para enviar mensagens de ORDERS05 PO ao servidor SAP. Para adicionar os esquemas, clique com o botão direito do mouse no ponto de extremidade de retransmissão e selecione Adicionar esquemas a SAPIntegration. Na caixa de diálogo, faça o seguinte:

    • Insira um prefixo de nome de arquivo que será incluído no nome de cada arquivo de esquema que será gerado. Para este tutorial, especifique-o como SAPIntegration_.

    • Digite um nome de pasta que será adicionado à solução em que todos os esquemas serão adicionados. Para este tutorial, especifique o nome da pasta como Esquemas de LOB.

    • Insira as credenciais para se conectar a um sistema SAP.

    Adicionar esquemas ao projeto

    Selecione OK. Os esquemas são adicionados ao projeto em uma pasta Esquemas de LOB.

  1. Clique com o botão direito do mouse em qualquer ponto da área de design de Projeto do Serviço BizTalk, selecione Propriedades e atualize a propriedade URL do Serviço BizTalk para incluir o nome do Serviços BizTalk. Este é o nome fornecido no Portal de Gerenciamento do Azure ao provisionar o Serviços BizTalk.

  2. Definir a propriedade de segurança para o ponto de extremidade de retransmissão:

    1. Clique com o botão direito do mouse no Destino de LOB no Gerenciador de Servidores e selecione Propriedades.

    2. Na grade Propriedades, selecione as reticências (…) na propriedade Segurança de Tempo de Execução.

    3. Na caixa de diálogo Editar Segurança, selecione Nome de Usuário Fixo e insira o nome de usuário e a senha para se conectar ao servidor SAP.

    4. Selecione OK.

  3. Arraste e solte o Destino de LOB na área de design. Observe a propriedade Nome da Entidade do Destino de LOB. O valor padrão é Relay-Path_target-sub-path. Se estiver usando os exemplos acima, o valor será sapintegration01_orders.

  4. Abra o arquivo .config para o Destino de LOB, que geralmente tem a convenção de nomenclatura como YourRelayPath_target-sub-path.config. Especifique o nome do emissor Barramento do Serviço e o segredo do emissor, conforme mostrado a seguir:

    <tokenProvider>
      <sharedSecret issuerName="owner" issuerSecret="issuer_secret" />
    </tokenProvider>
    

    Salve as alterações no arquivo de configuração.

Consulte também

Mostrar: