IBM FileNet P8, Version 5.2.1            

Partnerlinkfunktion

Die Partnerlinkfunktion im Expression Builder-Dialog zeigt den Partnerlink-Header für Aufrufpartnerlinks an.

Der Partnerlink-Header wird in einem Feld gespeichert, das bei der Übertragung generiert wird, und hat den Namen F_EndPointRef<Partnerlinkname>. Sie können den Header ändern, indem Sie das generierte Feld F_EndPointRef<Partnerlinkname> ändern, um die folgenden Aufgaben auszuführen.

  • Der vom Header dargestellte Web-Service erfordert einen SOAP-Header. Wenn Sie z. B. die Authentifizierungsfunktion nutzen, enthält der Header einen Sicherheitsabschnitt und Sie müssen den entsprechenden Benutzernamen und das entsprechende Kennwort in diesen Abschnitt eintragen.
  • Der vom Header dargestellte Web-Service enthält einen in der WSDL angegebenen Endpunkt. Sie können diesen Endpunkt ändern, indem Sie einen anderen Endpunkt in den Adressabschnitt einfügen. Dadurch können Sie einen anderen Endpunkt für denselben Service aufrufen.
Nachrichtenheader

Im oben dargestellten Beispielheader lautet der Name des Aufrufpartnerlinks InvAuth1. Wenn Sie den Header ändern wollen, verwenden Sie entweder die Zuordnungssystemfunktion (Assign) oder die Zuordnung in einem Schritt, um der Partnerendpunktreferenz einen modifizierten Header zuzuweisen - in diesem Fall F_EndPointRefInvAuth1.

Codierung

Wenn Sie sensible Informationen in F_EndPointRef<Partnerlinkname> speichern müssen, sollten Sie die Funktion encode() verwenden, damit die sensiblen Informationen codiert werden. Das Workflowsystem decodiert die Informationen, die vor dem Senden der Nachricht codiert wurden.

Authentifizierung

Im Beispielheader oben setzt der aufgerufene Service Authentifizierung voraus. Deshalb ist der Sicherheitsabschnitt im Header enthalten. Im Allgemeinen ersetzen Sie USERNAME und PASSWORD durch Variablen und der Benutzer gibt diese Werte in einem Schritt vor dem Aufrufschritt in. Sie verwenden eine Zuordnung, um diese Werte in den Header einzufügen.

  1. Geben Sie in einer Zuweisungssystemfunktion (Assign) oder in einer Zuordnung in einem allgemeinen Schritt vor dem Aufrufschritt einen temporären Namen für die Zuordnung ein und öffnen Sie Expression Builder.
  2. In Expression Builder bearbeiten Sie den Header wie folgt, um einen gültigen Zeichenfolgeausdruck zu erstellen:
    1. Schneiden Sie den Namen (in diesem Beispiel:F_EndPointRefInvAuth1) vom Anfang der Nachricht (in die Zwischenablage) aus. Dieser wird dann als Name der Zuordnung eingefügt.
    2. Wenn Sie keinen finalen Endpunkt für die Variable definieren, löschen Sie die Zeile OPTIONAL_FINAL_SOAP_ADDRESS.
    3. Fügen Sie jedem vorhandenen Anführungszeichen sowie jeweils am Anfang und Ende der Nachricht Anführungszeichen (") hinzu.
    4. Ersetzen Sie USERNAME und PASSWORD durch die entsprechenden Feldnamen (z. B. MyUserName und MyPassword) und fügen Sie die öffnenden und schließenden Anführungszeichen und Pluszeichen hinzu, um die Feldnamen in den Zeichenfolgeausdruck einzufügen.
          "<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. Schließen Sie Expression Builder und fügen Sie den Namen der Endpunktreferenz (in diesem Beispiel: F_EndPointRefInvAuth1 in das Namensfeld der Zuordnung ein.
Tipp: Im unwahrscheinlichen Fall, dass Sie den Benutzernamen und das Kennwort direkt in die Nachricht eingeben wollen, würden Sie die Zeichenfolgen ohne Anführungszeichen und ohne Pluszeichen eingeben.

Alternativer Endpunkt

Alternativer Endpunkt

Die WSDL des aufgerufenen Web-Service gibt den Endpunkt an. Sie können mit der folgenden Vorgehensweise einen anderen Endpunkt angeben. Sie ersetzen OPTIONAL_SOAP_ADDRESS im Header durch einen neuen Endpunkt. Der vom alternativen Endpunkt bereitgestellte Service muss genau dieselben Ein- und Ausgabeanforderungen haben.

  1. Geben Sie in einer Zuweisungssystemfunktion (Assign) oder in einer Zuordnung in einem allgemeinen Schritt vor dem Aufrufschritt einen temporären Namen für die Zuordnung ein und öffnen Sie Expression Builder.
  2. In Expression Builder bearbeiten Sie den Header wie folgt, um einen gültigen Zeichenfolgeausdruck zu erstellen:
    1. Schneiden Sie den Namen (in diesem Beispiel: F_EndPointRefInvAuth1) vom Anfang der Nachricht (in die Zwischenablage) aus. Dieser wird dann als Name der Zuordnung eingefügt.
    2. Ersetzen Sie OPTIONAL_FINAL_SOAP_ADDRESS durch die Zeichenfolge für den neuen Endpunkt (ohne Anführungszeichen) oder fügen Sie eine vorab definierte Variable mit dem Wert mit doppelten Anführungszeichen und Pluszeichen (soweit erforderlich) ein.
    3. Fügen Sie jedem vorhandenen Anführungszeichen sowie jeweils am Anfang und Ende der Nachricht Anführungszeichen (") hinzu.
  3. Schließen Sie Expression Builder und fügen Sie den Namen der Endpunktreferenz (in diesem Beispiel: F_EndPointRefInvAuth1) in das Namensfeld der Zuordnung ein.


Letzte Aktualisierung: März 2016
bpfe011.htm

© Copyright IBM Corp. 2016.