Soap

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > Altri servizi >

Soap

Descrizione

I metodi di questo connettore consentono di invocare un servizio SOAP. L'interpretazione del descrittore WSDL del servizio SOAP è soggetta alla validazione del parser WSDL di Jamio openwork. Non tutti i descrittori WSDL sono supportatati, compresi alcuni generati da Microsoft a partire dal servizio WCF.

 

Proprietà

Proprietà utili alla connessione e al login al servizio SOAP di tipo DataSet.

 

Il Dataset contiene i seguenti campi (tutti opzionali se non diversamente specificato):

Name

Description

Type

Optional

WsdlUrl

Url of the service WSDL (ex.: “http://www.webservicex.net/CurrencyConvertor.asmx?WSDL”).

String

 

ServiceAddress

Service address, if different from the address contained in the wsdlUrl or in the WSDL (ex.: “http://www.webservicex.net/CurrencyConvertor.asmx”).

String

 

OperationName

Soap operation name (ex.: “ConversionRate”).

String

 

FieldToReturn

Name of the root field to return (optional) (ex.: “ConversionRateResult”): the type of the field to return is a dataset, its Key/Value pairs will be put in the returned dataset; if the type of the field to return is NOT a dataset, the returned dataset will contain a Key/Value pair with the name and value of the specified field.

String

 

FieldsToDiscard

A list containing the names of fields to discard from the resulting dataset (at any level); a null or empty list implies that all fields (from the root field) are returned.

ArrayValue

 

ValuesIfNull

A Key/Value pair collection containing values to assign to the specified fields if their returned value is null.

Ex.: if valuesIfNull contains:

“first_name”, “”

“trim_user”, false

the returned dataset will have any field named “first_name” (at any level) valued with “” instead of null, and any field named “trim_user” (at any level) valued with false instead of null.

DataSet

 

UserAgent

The user-agent header value (ex.: “.NET Framework Test Client”)

String

 

Timeout

The number of milliseconds to wait before the request times out

Int32

 

WsdlCacheTime

WSDL cache dureation in minutes; defaults to 1440 (1 day)

Int32

 

CredentialsType

Type of the authentication credentials associated with the request:

1 = None (credentials not required)

2 = NetworkCredentials (“UserName” and “Password” must be specified)

3 = DefaultNetworkCredentials (the network credentials of the current security context)

4 = DefaultCredentials (the system credentials of the application)

5 = WSSE Security ("UserName" and "Password" must be specified)

Int32

 

UserName

User name (required if “CredentialsType” = 2 or “CredentialsType” = 5)

String

 

Password

Password (required if “CredentialsType” = 2 or “CredentialsType” = 5)

String

 

SoapHeaderName

Name of a custom Soap header (ex.: “AuthHeader”)

String

 

SoapHeaderValues

Key/value pairs of the custom Soap header; for example, it can contain the “UserName” and “PassWord” header fields for authentication.

DataSet

 

 

Metodi

I metodi previsti sono riportati nell’elenco seguente:

Version

Restituisce la versione del connettore.

AddText

Aggiunge al testo di partenza il contenuto un altro testo dopo aver sostituito in esso tutti i token con i corrispondenti valori specificati nel parametro values del metodo.

Base64StringToStream

Converte una stringa a base64 nella reference dell’allegato dell’istanza di processo.

Invoke

Invoca una operazione WSDL.

GetComplexTypeInfo

Restituisce la definizione di un tipo complesso.

GetWsdlInfo

Restituisce un WSDL semplificato.

GetStructure

Restituisce la struttura di un dataset.

GetValueList

Restituisce la lista dei valori di un dataset come lista di oggetti.

StreamToBase64String

Converte la reference di un allegato in una stringa a base64.

StreamToString

Converte la reference di un allegato in una stringa.

StringToStream

Converte una stringa nella reference dell’allegato dell’istanza di processo.

XmlInvoke

Invoca una operazione WSDL che restituisce in output un file XML.

XmlToDictionary

Converte una stringa in formato Xml in un Dataset.