IBM FileNet P8, Version 5.2.1            

Funktionen Partnerlink

Funktionen Partnerlink i dialogboksen Oprettelsesfunktion til udtryk viser sidehovedet Partnerlink for Kald-partnerlink.

Partnerlinksidehovedet er lagret i et felt, der genereres på overførselstidspunktet og kaldes F_EndPointRef<navn_på_partnerlink>. Du kan ændre sidehovedet ved at ændre det genererede felt F_EndPointRef<navn_på_partnerlink> for at udføre følgende opgaver.

  • Den webservice, som sidehovedet repræsenterer, kræver et SOAP-sidehoved. Hvis du f.eks. bruger valideringsfunktionen, indeholder sidehovedet et sikkerhedsafsnit, og du skal indsætte de relevante brugernavne og kodeord i dette afsnit.
  • Den webservice, som sidehovedet repræsenterer, indeholder det slutpunkt, der er angivet i WSDL. Du kan ændre dette slutpunkt ved at indsætte et andet slutpunkt i adresseafsnittet. Herved kan du kalde et andet slutpunkt for samme service.
Meddelelsessidehoved

I ovenstående eksempel er navnet på det kaldende partnerlink InvAuth1. Hvis du vil ændre sidehovedet, skal du bruge enten systemfunktionen Assign eller Assignment i et trin for at tildele et ændret sidehoved til referencen til partnerslutpunktet - i dette tilfælde F_EndPointRefInvAuth1.

Kodning

Hvis du skal anbringe følsomme oplysninger i F_EndPointRef<navn_på_partnerlink>, skal du bruge funktionen encode(), så følsomme oplysninger kodes. Arbejdsgangssystemet afkoder de oplysninger, der er blevet kodet, før meddelelsen sendes.

Validering

I sidehovedeksemplet ovenfor kræver den kaldte service validering, så afsnittet Security inkluderes i sidehovedet. Generelt skal du erstatte USERNAME og PASSWORD med variabler, og brugeren skal angive disse værdier på et trin før kaldtrinnet. Du bruger en tildeling til at indsætte disse værdier i sidehovedet.

  1. Angiv et midlertidigt navn på tildelingen i en Assign-systemfunktion eller en tildeling i et generelt trin før kaldtrinnet, og åbn Oprettelsesfunktion til udtryk.
  2. I oprettelsesfunktionen til udtryk redigerer du sidehovedet på følgende måde, så det bliver et gyldigt strengudtryk:
    1. Klip navnet til udklipsholderen (i dette eksempel F_EndPointRefInvAuth1) fra starten af meddelelsen. Det skal indsættes som navnet på tildelingen.
    2. Hvis du ikke definerer et variabelt endeligt slutpunkt, skal du slette den valgfrie endelige SOAP-addresselinje, der vises i feltet.
    3. Tilføj dobbelte anførselstegn (") til alle eksisterende dobbelte anførselstegn samt i starten og slutningen af meddelelsen.
    4. Erstat USERNAME og PASSWORD med de relevante feltnavne (f.eks. MitBrugernavn og MitKodeord), og tilføj start- og slutanførselstegn og plusser for at indsætte feltnavne i strengudtrykket.
          "<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>" + MitBrugernavn + "</wsse:Username>                               
                                      <wsse:Password>" + MitKodeord + "</wsse:Password>                       
                               </wsse:UsernameToken>          
                         </wsse:Security>     
                 </wsa:ReferenceProperties>
          </wsa:EndPointReference>"
  3. Luk oprettelsesfunktionen til udtryk, og indsæt navnet på slupunktsreferencen (i dette eksempel F_EndPointRefInvAuth1) i navnefeltet for tildelingen.
Tip: Hvis du skulle have behov for at angive brugernavnet og kodeordet direkte i meddelelsen, skal du angive strengene uden anførselstegn og plustegn.

Alternativt slutpunkt

Alternativt slutpunkt

WSDL i den kaldte webservice angiver slutpunktet. Du kan angive et andet slutpunkt ved at følge nedenstående procedure. Erstat OPTIONAL_SOAP_ADDRESS i sidehovedet med et nyt slutpunkt. Bemærk, at den service, som det alternative slutpunkt leverer, skal have nøjagtigt samme krav til input og output.

  1. Angiv et midlertidigt navn på tildelingen i en Assign-systemfunktion eller en tildeling i et generelt trin før kaldtrinnet, og åbn Oprettelsesfunktion til udtryk.
  2. I oprettelsesfunktionen til udtryk redigerer du sidehovedet på følgende måde, så det bliver et gyldigt strengudtryk:
    1. Klip navnet til udklipsholderen (i dette eksempel er navnet F_EndPointRefInvAuth1) fra starten af meddelelsen. Det skal indsættes som navnet på tildelingen.
    2. Erstat OPTIONAL_FINAL_SOAP_ADDRESS med den nye slutpunktstreng (ingen anførselstegn), eller indsæt en tidligere defineret variabel med værdien vha. dobbelte anførselstegn og plusser efter behov.
    3. Tilføj dobbelte anførselstegn (") til alle eksisterende dobbelte anførselstegn samt i starten og slutningen af meddelelsen.
  3. Luk oprettelsesfunktionen til udtryk, og indsæt navnet på slupunktsreferencen (i dette eksempel F_EndPointRefInvAuth1) i navnefeltet for tildelingen.


Senest opdateret: Marts 2016
bpfe011.htm

© Copyright IBM Corp. 2016.