IBM FileNet P8, Versión 5.2.1            

Función Partner Links (Enlaces de socio)

La función Partner Links en el diálogo Creador de expresiones muestra la cabecera Partner Link para Invocar enlaces de socio.

La cabecera Partner Link está almacenada en un campo generado en el momento de la transferencia y que se denomina F_EndPointRef<partner-link-name>. Puede modificar la cabecera modificando el campo generado F_EndPointRef<partner-link-name> para llevar a cabo las siguientes tareas.

  • El Servicio Web representado por la cabecera necesita una cabecera SOAP. Por ejemplo, si utiliza la función de autenticación, la cabecera contiene una sección de seguridad. En esta sección necesitará insertar el nombre de usuario y la contraseña apropiados.
  • El Servicio Web representado por la cabecera contiene el punto final especificado en el WSDL. Puede modificar dicho punto final insertando un punto final diferente en la sección Dirección. Esto le permite invocar otro punto final para el mismo servicio.
Cabecera del mensaje

En el ejemplo de cabecera que se ha mostrado anteriormente, el nombre del Invoke Partner Link es InvAuth1. Para modificar la cabecera, utilice la función del sistema Asignar o Asignación en un paso para asignar una cabecera modificada a la referencia de punto final de Partner; en este caso, F_EndPointRefInvAuth1.

Codificación

Si necesita colocar información sensible en F_EndPointRef<partner-link-name>, debería utilizar la función encode() para codificar la información sensible. El sistema de flujo de trabajo decodificará la información que ha sido codificada antes de enviar el mensaje.

Autenticación

En el ejemplo de cabecera que se ha mostrado anteriormente, el servicio que se invoca necesita autenticación, por lo que se incluye la sección Seguridad en la cabecera. En general, reemplazará USERNAME y PASSWORD con variables y el usuario introducirá dichos valores en algún paso antes del paso Invocar. Para insertar esos valores en una cabecera, se utiliza una asignación.

  1. En una función del sistema Asignar o una Asignación en una paso general antes del paso Invocar, introduzca cualquier nombre temporal para la asignación y, a continuación, abra el Creador de expresiones.
  2. En el Creador de expresiones, edite la cabecera del modo siguiente para convertirla en una expresión de serie válida:
    1. Corte el nombre (en el portapapeles) (en este ejemplo, F_EndPointRefInvAuth1) del principio del mensaje. Lo pegaremos como el nombre de la asignación.
    2. Si no está definiendo un punto final variable, elimine la línea Dirección SOAP final opcional que se muestra en el recuadro.
    3. Añada comillas dobles (") a todas las comillas dobles existentes y al principio y al final del mensaje.
    4. Reemplace USERNAME y PASSWORD con los nombres de campo apropiados (por ejemplo, MyUserName y MyPassword) y agregue las comillas de apertura y cierre y los signos positivos para insertar los nombres de campo en la expresión de serie.
          "<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. Cierre el Creador de expresiones y, a continuación, pegue el nombre de la referencia de punto final (en este ejemplo, F_EndPointRefInvAuth1) en el campo Nombre de la asignación.
Consejo: En el caso poco probable de que desee introducir el nombre de usuario y la contraseña directamente en el mensaje, introduzca las series sin comillas ni signos positivos.

Punto final alternativo

Punto final alternativo

El WSDL del Servicio Web invocado especifica el punto final. Puede especificar un punto final diferente utilizando el siguiente procedimiento. Reemplazará la OPTIONAL_SOAP_ADDRESS en la cabecera con un nuevo punto final. Tenga en cuenta que el servicio proporcionado por el punto final alternativo debe tener exactamente los mismos requisitos de entrada y de salida.

  1. En una función del sistema Asignar o una Asignación en una paso general antes del paso Invocar, introduzca cualquier nombre temporal para la asignación y, a continuación, abra el Creador de expresiones.
  2. En el Creador de expresiones, edite la cabecera del modo siguiente para convertirla en una expresión de serie válida:
    1. Corte el nombre (en el portapapeles) (en este ejemplo, F_EndPointRefInvAuth1) del principio del mensaje. Lo pegaremos como el nombre de la asignación.
    2. Sustituya la OPTIONAL_FINAL_SOAP_ADDRESS con la nueva serie de punto final (sin comillas) o inserte una variable previamente definida con el valor, utilizando comillas dobles y signos positivos según sea necesario.
    3. Añada comillas dobles (") a todas las comillas dobles existentes y al principio y al final del mensaje.
  3. Cierre el Creador de expresiones y, a continuación, pegue el nombre de la referencia de punto final (en este ejemplo, F_EndPointRefInvAuth1) en el campo Nombre de la asignación.


Última actualización: Marzo de 2016
bpfe011.htm

© Copyright IBM Corp. 2016.