IBM FileNet P8, Version 5.2.1            

Função de Links de Parceiros

A função Links de Parceiros no diálogo Construtor de Expressões exibe o cabeçalho Link de Parceiro para Invocar links de parceiros.

O cabeçalho de Link de Parceiro é armazenado em um campo gerado no momento da transferência e é denominado F_EndPointRef<partner-link-name>. É possível modificar o cabeçalho modificando o campo gerado F_EndPointRef<partner-link-name> para executar as seguintes tarefas.

  • O Serviço da Web representado pelo cabeçalho exige um cabeçalho SOAP. Por exemplo, se você utilizar o recurso de autenticação, o cabeçalho contém uma seção de segurança e você precisará inserir os nomes de usuário e senhas adequados nessa seção.
  • O Serviço da Web representado pelo cabeçalho contém o terminal especificado no WSDL. É possível modificar esse terminal inserindo um terminal diferente na seção Endereço. Isso permite que você invoque outro terminal para o mesmo serviço.
Cabeçalho da mensagem

No exemplo de cabeçalho mostrado acima, o nome do Invocar Link de Parceiro é InvAuth1. Para modificar o cabeçalho, você utiliza a função de sistema Designar ou Designação em uma etapa para designar um cabeçalho modificado para a referência de terminal Parceiro, que nesse caso é F_EndPointRefInvAuth1.

Codificação

Se precisar colocar informações sensíveis no F_EndPointRef<partner-link-name>, você deve utilizar a função encode() para as informações sensíveis serem codificadas. O sistema de fluxo de trabalho decodificará as informações que foram codificadas antes de enviar a mensagem.

Autenticação

No exemplo de cabeçalho acima, o serviço invocado exige autenticação, assim a seção Segurança está incluída no cabeçalho. Em geral, você substituirá USERNAME e PASSWORD por variáveis, e o usuário digitará esses valores em alguma etapa antes da etapa Invocar. Utilizar uma designação para inserir valores no cabeçalho.

  1. Em uma função de sistema Designar ou Designação em uma etapa geral antes da etapa Invocar, digite qualquer nome temporário para a designação, então abra o Construtor de Expressões.
  2. No Construtor de Expressões, é possível editar o cabeçalho da seguinte forma para torná-lo uma expressão de cadeia válida:
    1. Recorte o nome (para a área de transferência) (neste exemplo F_EndPointRefInvAuth1) a partir do início da mensagem. Nós iremos colá-lo como o nome da designação.
    2. Se não estiver definindo um terminal final variável, exclua a linha Endereço SOAP Final Opcional mostrada na caixa.
    3. Inclua aspas duplas (") em cada aspas duplas existentes e no início e final da mensagem.
    4. Substitua USERNAME e PASSWORD pelos nomes de campo adequados (por exemplo, MyUserName e MyPassword) e inclua as aspas de fechamento e abertura e sinais de mais para inserir os nomes de campos na expressão de cadeia.
          "<wsa:EndPointReference
    xmlns:wsa=""http://schemas.xmlsoap.org/ws/2003/03/addressing"">    
                  <wsa:ReferenceProperties>           
                         <wsse:Security
    xmlns:wsse=""http://schemas.xmlsoap.org/ws/2002/12/secext"">      
                               <wsse:UsernameToken>                           
                                      <wsse:Username>" + MyUserName
    + "</wsse:Username>                               
                                      <wsse:Password>" + MyPassword
    + "</wsse:Password>                       
                               </wsse:UsernameToken>          
                         </wsse:Security>     
                 </wsa:ReferenceProperties>
          </wsa:EndPointReference>"
  3. Feche o Construtor de Expressões e, em seguida, cole o nome da referência de terminal (que é, neste exemplo, F_EndPointRefInvAuth1) no campo Nome da designação.
Dica: No caso improvável de você desejar inserir o nome de usuário e a senha diretamente na mensagem, insira as cadeias sem aspas e sem sinais de mais.

Terminal Alternativo

Terminal Alternativo

O WSDL do Serviço da Web invocado especifica o terminal. É possível especificar um terminal diferente utilizando o seguinte procedimento. Você substituirá o OPTIONAL_SOAP_ADDRESS no cabeçalho por um novo terminal. Observe que o serviço fornecido pelo terminal alternativo deve ter exatamente os mesmos requisitos de entrada e saída.

  1. Em uma função de sistema Designar ou Designação em uma etapa geral antes da etapa Invocar, digite qualquer nome temporário para a designação, então abra o Construtor de Expressões.
  2. No Construtor de Expressões, é possível editar o cabeçalho da seguinte forma para torná-lo uma expressão de cadeia válida:
    1. Recorte (para a área de transferência) o nome (neste exemplo F_EndPointRefInvAuth1) a partir do início da mensagem. Nós iremos colá-lo como o nome da designação.
    2. Substitua OPTIONAL_FINAL_SOAP_ADDRESS pela nova cadeia de terminal (sem aspas), ou insira uma variável previamente definida pelo valor utilizando aspas duplas e sinais de mais conforme adequado.
    3. Inclua aspas duplas (") em cada aspas duplas existentes e no início e final da mensagem.
  3. Feche o Construtor de Expressões e, em seguida, cole o nome da referência de terminal (neste exemplo F_EndPointRefInvAuth1) no campo Nome da designação.


Last updated: March 2016
bpfe011.htm

© Copyright IBM Corporation 2016.