# 22. Virtuoso Functions Guide - BPEL.BPEL.plink_set_option

Chapter Contents | Prev | Next
Keyword Search:
www.openlinksw.com
docs.openlinksw.com
Book Home
Contents
Preface
Virtuoso Functions Guide
Administration
Aggregate Functions
Array Manipulation
BPEL APIs
bpel.bpel.compile_sc...
bpel.bpel.copy_scrip...
bpel.bpel.getvariabl...
bpel.bpel.get_partne...
bpel.bpel.import_scr...
bpel.bpel.instance_d...
bpel.bpel.plink_get_...
bpel.bpel.plink_set_...
bpel.bpel.purge_inst...
bpel.bpel.script_del...
bpel.bpel.script_obs...
bpel.bpel.script_sou...
bpel.bpel.script_upl...
bpel.bpel.setvariabl...
bpel.bpel.wsdl_uploa...
Backup
Compression
Cursor
Date & Time Manipulation
Debug
Dictionary Manipulation
Encoding & Decoding
File Manipulation
Free Text
Hashing / Cryptographic
LDAP
Locale
Mail
Miscellaneous
Number
Remote SQL Data Source
Replication
SOAP
SQL
String
Transaction
Type Mapping
UDDI
User Defined Types & The CLR
Virtuoso Java PL API
Virtuoso Server Extension Interface (VSEI)
Web Server & Internet
XML
XPATH & XQUERY
Functions Index

## BPEL.BPEL.plink_set_option

set value of a partner link option
BPEL.BPEL.plink_set_option (in script varchar, in plink varchar, in opt varchar, in val any);
Parameters
script – varchar name of a process that partner link belongs to
plink – varchar name of the partner link
opt – varchar name of the options to be set
val – any value of the option to be set
Return Types

The function has no return value

Description

BPEL.BPEL.plink_set_option

This function is used to set an option of the specified partner link. The options are used to configure WS-Security, WS-Addressing and WS-Reliable Messaging protocols for sending and receiving messages to the given partner.

- wsa the version of namespace value for WS-Addressing protocol.
- http-auth-uid user name for basic HTTP authentication
- http-auth-pwd password for HTTP authentication
- wss-priv-key name of the private key to be used for signing the requests
- wss-pub-key name of the partner's public key to be used for encryption of the requests
- wss-in-encrypt incoming message XML data encryption policy
- wss-in-signature incoming messages XML signature policy
- wss-in-signers list of public key names which are trusted (empty list mean all are trusted)
- wss-out-encrypt-key type of the session key for outgoing message encryption
- wss-out-signature-type XML signature template type for signing the outgoing messages
- wss-out-signature-function in case of custom signature this option is a name of the PL function producing the template for XML signature
- wsrm-in-type WS-Reliable Messaging protocol usage for incoming messages
- wsrm-out-type WS-Reliable Messaging protocol usage for outgoing messages

Examples
Simple example

    SQL> BPEL.BPEL.plink_set_option  ('WSSecho', 'service', 'wss-in-encrypt', 'Mandatory');

    Done. -- 16 msec.