query-search

Synopsis

query-results nodeset query-search(query, query-object, 
query-condition-object, query-condition-xpath, query-modification-macros, 
sources, start, syntax-operators, syntax-repository-node, 
syntax-field-mappings, sort-by, sort-xpaths, sort-score-xpath, 
sort-num-passages, rank-decay, num, num-over-request, 
num-per-source, num-max, browse, browse-num, browse-start, 
browse-clusters-num, term-expand-max-expansions, term-expand-error-when-exceeds-limit, 
spelling-enabled, spelling-configuration, dict-expand-dictionary, 
dict-expand-max-expansions, dict-expand-stem-enabled, dict-expand-stem-stemmers, 
dict-expand-wildcard-enabled, dict-expand-wildcard-min-length, dict-expand-wildcard-segmenter, 
dict-expand-wildcard-delanguage, dict-expand-regex-enabled, arena, 
output-contents-mode, output-contents, output-summary, output-score, 
output-shingles, output-duplicates, output-key, output-cache-references, 
output-cache-data, output-sort-keys, output-axl, output-bold-contents, 
output-bold-contents-except, output-bold-class-root, output-query-node, 
output-display-mode, authorization-rights, authorization-username, 
authorization-password, collapse-xpath, collapse-num, collapse-binning, 
collapse-sort-xpaths, binning-state, binning-mode, binning-configuration, 
force-binning, fetch, fetch-timeout, aggregate, 
aggregate-max-passes, cluster, cluster-near-duplicates, cluster-kbs, 
cluster-stemmers, cluster-segmenter, efficient-paging, 
efficient-paging-n-top-docs-to-cluster, debug, profile, extra-xml);
string query;
operator nodeset query-object;
operator nodeset query-condition-object;
string query-condition-xpath;
string query-modification-macros;
string sources;
int start;
string syntax-operators;
string syntax-repository-node;
field-map nodeset syntax-field-mappings;
string sort-by;
sort nodeset sort-xpaths;
string sort-score-xpath;
int sort-num-passages;
double rank-decay;
int num;
double num-over-request;
int num-per-source;
int num-max;
boolean browse;
int browse-num;
int browse-start;
int browse-clusters-num;
int term-expand-max-expansions;
boolean term-expand-error-when-exceeds-limit;
boolean spelling-enabled;
spelling-correction nodeset spelling-configuration;
string dict-expand-dictionary;
int dict-expand-max-expansions;
boolean dict-expand-stem-enabled;
string dict-expand-stem-stemmers;
boolean dict-expand-wildcard-enabled;
int dict-expand-wildcard-min-length;
string dict-expand-wildcard-segmenter;
boolean dict-expand-wildcard-delanguage;
boolean dict-expand-regex-enabled;
string arena;
enum output-contents-mode;
string output-contents;
boolean output-summary;
boolean output-score;
boolean output-shingles;
boolean output-duplicates;
boolean output-key;
boolean output-cache-references;
boolean output-cache-data;
boolean output-sort-keys;
nodeset output-axl;
string output-bold-contents;
boolean output-bold-contents-except;
string output-bold-class-root;
boolean output-query-node;
enum output-display-mode;
string authorization-rights;
string authorization-username;
string authorization-password;
string collapse-xpath;
int collapse-num;
boolean collapse-binning;
sort nodeset collapse-sort-xpaths;
string binning-state;
enum binning-mode;
binning-setnodeset binning-configuration;
boolean force-binning;
boolean fetch;
int fetch-timeout;
boolean aggregate;
int aggregate-max-passes;
boolean cluster;
double cluster-near-duplicates;
string cluster-kbs;
string cluster-stemmers;
string cluster-segmenter;
boolean efficient-paging;
int efficient-paging-n-top-docs-to-cluster;
boolean debug;
boolean profile;
nodeset extra-xml;

Paramètres

• string query - Chaîne de requête qui sera analysée à l'aide de syntax-operators. Elle permet de transférer des requêtes générées par un utilisateur.
• operator nodeset query-object - Objet de requête (identique à celui obtenu en analysant la chaîne de requête conformément à la syntaxe). Il permet de transférer des requêtes générées à l'aide d'un programme. Lorsqu'une chaîne de requête et un objet de requête sont spécifiés, ils sont combinés à un opérateur « and ». Il est tout à fait possible de spécifier les deux (pour combiner une requête générée par un utilisateur à la condition d'un programme, par exemple).
• operator nodeset query-condition-object - Objet de requête (identique à celui obtenu en analysant la chaîne de requête conformément à la syntaxe) qui sera interprété en tant que condition avant query et query-object, mais qui servira uniquement à limiter les résultats sans les classer.
• string query-condition-xpath - Langage XPath servant à limiter l'ensemble des résultats (sans les classer) associé à d'autres paramètres de requête.
• string query-modification-macros - Liste de macros, séparées par des espaces, servant à modifier la requête d'origine.
• string sources - Liste des sources, séparées par des espaces, à interroger. Si aucune liste n'est indiquée, alors aucune source ne sera interrogée (ce qui peut se révéler pratique lorsque vous essayez de comprendre comment une requête est analysée et/ou étendue sans l'exécuter).
• int start - Rang du premier document renvoyé par chaque source/collection (commence à la valeur 0). Il n'est utile qu'en la présence d'une seule collection. Si vous regroupez plusieurs sources, vous devrez utiliser browse-start. Si vous regroupez uniquement des collections de recherche, il est possible d'obtenir plus rapidement l'ensemble des résultats « suivants » en activant le paramètre start pour chaque collection (en tant que zone) en fonction de ce qui aura été extrait lors de la première requête. Valeur par défaut : 0.
• string syntax-operators - Liste de noms d'opérateurs, séparés par des espaces. Ces opérateurs doivent être définis dans le nœud du référentiel de syntaxe indiqué ici. Vous pouvez uniquement utiliser query-search pour analyser une requête en la soumettant sans avoir sélectionné de source. Valeur par défaut : AND and () CONTAINING CONTENT %field%: + NEAR - NOT NOTCONTAINING NOTWITHIN OR0 quotes regex stem THRU BEFORE FOLLOWEDBY weight wildcard wildchar WITHIN WORDS site less-than less-than-or-equal greater-than greater-than-or-equal equal range.
• string syntax-repository-node - Nom d'un nœud de syntaxe (contenant la définition des opérateurs de syntaxe) qui sera chargé à partir du référentiel. Valeur par défaut : custom.
• field-map nodeset syntax-field-mappings - Ensemble de mappages de zones.
• string sort-by - Liste de valeurs de zones de tri (c'est-à-dire, v.sort-by), séparées par des espaces, utilisées pour le tri (elles devront être mappées vers une formule de tri dans chaque source cible).
• sort nodeset sort-xpaths - Ensemble de nœuds de tri composés d'un langage XPath de tri et d'un ordre de tri. Voir aussi sort-score-xpath et sort-by. Si sort-by est spécifié alors il sera associé aux principales clés de tri.
• string sort-score-xpath - Score qui sera généré pour chaque résultat (voir output-score). Il s'agit de la formule de tri par défaut si aucun autre tri n'est spécifié. Vous pouvez indiquer une expression XPath personnalisée qui utilise les variables $score, $la-score et tout autre nom de contenu que vous avez sélectionné pour faire l'objet d'une indexation rapide (dans la configuration de l'indexation de la collection et signalé dans le statut de l'index). Le score est toujours numérique, par conséquent le résultat de l'évaluation de la formule peut être obtenu sous la forme d'un nombre, le cas échéant. Si des conditions de tri et sort-score-xpath sont indiqués, les conditions de tri seront prioritaires. Sachez que ce langage XPath sera évalué pour chaque résultat de recherche (c'est-à-dire, potentiellement des millions de fois). Une partie des opérateurs et fonctions XPath a été optimisée pour éviter toute manipulation de lourdes structures XPath. Il est recommandé de limiter votre formule à ces opérateurs dans le cas de collections étendues (pour éviter des temps de réponse trop longs). Consultez la documentation pour obtenir la liste actuelle des opérateurs et fonctions XPath optimisés.
• int sort-num-passages - Nombre de passages correspondants pris en compte lors du calcul de la pertinence naturelle (c'est-à-dire, $score). Définissez cette valeur sur 0 pour améliorer les performances et ne pas utiliser $score pour le tri. Si vous n'indiquez aucune valeur, celle définie au niveau de la collection sera utilisée.
• double rank-decay - Lors du classement, le nième meilleur passage va déterminer sa valeur à la puissance n. Définissez la valeur sur 1 pour traiter tous les passages comme étant de valeur égale.
• int num - Lorsque ce paramètre est indiqué, Watson Explorer va essayer d'adapter le nombre de résultats extraits de chaque source pour arriver à ce total. En mode Agrégat, un retour à certaines sources peut être nécessaire pour obtenir davantage de résultats. Valeur par défaut : 10.
• double num-over-request - Lorsque deux ou plusieurs sources sont interrogées simultanément et que des doublons sont supprimés, le nombre total de résultats pourrait être inférieur à celui prévu. Ce paramètre va multiplier le nombre total de résultats demandés pour compenser cette perte. En mode Agrégat, il permet d'éviter de revenir trop de fois à une source. Valeur par défaut : 1.3.
• int num-per-source - Nombre de résultats demandés pour chaque source. Ce paramètre est prioritaire sur num lorsqu'il est spécifié.
• int num-max - Nombre maximum de meilleurs résultats classés pour chaque collection. Ce nombre doit être supérieur à celui demandé et n'est utile que du point de vue de l'optimisation de la mémoire cache (lorsque vous essayez d'obtenir plus de résultats auprès d'une source, la mémoire cache initiale peut uniquement être utilisée si le meilleur classement demandé est inférieur à num-max).
• boolean browse - Lorsque ce paramètre est activé, les résultats seront enregistrés dans un fichier temporaire pour être consultés ultérieurement. Il est surtout utile lors du regroupement de résultats. Valeur par défaut : false.
• int browse-num - En mode Parcourir, seul le nombre de résultats indiqué sera initialement renvoyé. Valeur par défaut : 10.
• int browse-start - Sur le nombre de résultats extraits, seuls ceux ayant un classement supérieur à browse-start (commence à 0) seront renvoyés. Valeur par défaut : 0.
• int browse-clusters-num - Seul ce nombre de clusters sera renvoyé en mode Parcourir. Valeur par défaut : 10.
• int term-expand-max-expansions - Lorsque ce paramètre est activé, la collection de recherches va limiter le nombre de termes étendus à cette valeur. Les termes les plus fréquemment rencontrés seront triés en premier dans les expansions.
• boolean term-expand-error-when-exceeds-limit - Lorsque ce paramètre est activé, si un terme dispose d'un nombre d'expansions supérieur à la valeur autorisée, la collection de recherches renverra un message d'erreur au lieu de renvoyer des résultats.
• boolean spelling-enabled - Lorsque ce paramètre est activé, une version corrigée de l'orthographe du nœud de requête sera renvoyée avec les résultats. Valeur par défaut : false.
• spelling-correction nodeset spelling-configuration - Options de configuration du correcteur orthographique. Utilisez ce paramètre si vous devez correctement orthographier des zones autres que celles par défaut ou utiliser un autre dictionnaire.
• string dict-expand-dictionary - Nom du dictionnaire à utiliser pour réaliser des expansions basées sur ce dictionnaire.
• int dict-expand-max-expansions - Nombre maximum d'expansions vers lesquelles chaque terme peut être étendu.
• boolean dict-expand-stem-enabled - Lorsque ce paramètre est activé, les termes utilisant l'opérateur de radical seront remplacés par tous les termes ayant un radical identique.
• string dict-expand-stem-stemmers - Lors d'une expansion de radical, cet analyseur morphologique sera utilisé pour rechercher des mots associés.
• boolean dict-expand-wildcard-enabled - Lorsque ce paramètre est activé, les termes utilisant l'opérateur caractère générique ou l'opérateur générique strict seront remplacés par tous les termes correspondant à l'expression générique.
• int dict-expand-wildcard-min-length - Lors de l'exécution d'une expansion de caractère générique, le terme doit contenir au moins un nombre de caractères non génériques égal au nombre de caractères génériques.
• string dict-expand-wildcard-segmenter - Lors de l'exécution d'une expansion de caractère générique, cet outil de segmentation permet de segmenter un terme avant de rechercher des correspondances.
• boolean dict-expand-wildcard-delanguage - Lors de l'exécution d'une expansion de caractère générique, ce paramètre va désidiomatiser un terme avant de rechercher des correspondances.
• boolean dict-expand-regex-enabled - Lorsque ce paramètre est activé, les termes utilisant l'opérateur regex seront remplacés par tous ceux correspondant à l'expression régulière.
• string arena - Indique le périmètre à interroger dans search-collections.
• enum output-contents-mode - Indique comment le paramètre output-contents est interprété : defaults : le paramètre est ignoré, les valeurs par défaut de chaque collection sont utilisées. list : extrait le contenu dont les noms répertoriés (pour n'extraire aucun contenu, activez cette option en laissant la zone vide dans output-contents). except : extrait le contenu dont les noms ne sont pas répertoriés (pour extraire tous les contenus, activez cette option en laissant la zone vide dans output-contents, généralement il convient d'exclure tout fragment pour éviter d'extraire l'intégralité du texte des documents). Valeur par défaut : defaults. Valeurs possibles : defaults|list|except.
• string output-contents - Liste des noms de contenu, séparés par des espaces, à extraire ou pas selon la valeur indiquée dans output-contents-mode.
• boolean output-summary - Lorsque ce paramètre est activé, des récapitulatifs seront générés pour chaque résultat (en fonction du contenu sélectionné dans la configuration de la collection). Ces récapitulatifs fournissent généralement une meilleure expérience utilisateur et un meilleur regroupement, mais peuvent représenter un coût d'entrée-sortie conséquent (il est donc conseillé de les désactiver lors de l'extraction d'un grand nombre de résultats).
• boolean output-score - Génère le score calculé par le moteur de recherche pour chaque résultat, mais pas le score défini dans la couche de fédération. Il est conseillé d'activer ce paramètre lors du regroupement de plusieurs collections. Dans le cas contraire, la valeur par défaut de chaque source sera utilisée.
• boolean output-shingles - Génère des tuiles permettant de regrouper les résultats de recherche issus de plusieurs collections afin de supprimer celles en double dans les collections (voir paramètre aggregate). Il est conseillé de désactiver ce paramètre lorsque vous interrogez une seule collection. Dans le cas contraire, la valeur par défaut de chaque source sera utilisée.
• boolean output-duplicates - Lorsque des faux doublons sont supprimés de chaque collection de recherches en fonction des tuiles.
• boolean output-key - Génère une clé (basée sur le paramètre vse-key normalisé) qui sera utilisée pour la fédération pour supprimer des doublons dans les collections (ce paramètre doit toujours être désactivé lorsque vous interrogez une seule collection). Si ce paramètre n'est pas spécifié, la valeur par défaut de chaque source sera utilisée.
• boolean output-cache-references - Génère des références à la mémoire cache pour chaque document obtenu afin de référencer les données de la mémoire cache correspondante. Si ce paramètre n'est pas spécifié, la valeur par défaut de chaque source sera utilisée.
• boolean output-cache-data - Génère des données dans la mémoire cache pour chaque résultat. Ce paramètre peut générer d'importants volumes de données et est normalement utilisé pour un seul document à la fois.
• boolean output-sort-keys - Lorsque des formules de tri sont utilisées, leurs valeurs générées permettent de procéder à un tri croisé entre les collections. Il est conseillé de désactiver ce paramètre lorsque vous n'interrogez qu'une seule collection à la fois et de l'activer lorsque vous regroupez plusieurs collections. Si ce paramètre n'est pas spécifié, la valeur par défaut de chaque source sera utilisée.
• nodeset output-axl - Code AXL utilisé pour indiquer le résultat des collections de recherche.
• string output-bold-contents - Liste des noms de contenu, séparés par des espaces, à mettre en gras (ou pas selon la valeur du paramètre output-bold-contents-except) avec les mots de la requête.
• boolean output-bold-contents-except - Si ce paramètre est défini sur « true », la liste des contenus sera considérée comme étant une liste d'exclusion des contenus à ne pas mettre en gras. Valeur par défaut : false.
• string output-bold-class-root - Si ce paramètre n'est pas spécifié, une balise <b> standard sera utilisée pour la mise en gras. Dans le cas contraire, une balise <span> sera associée à un nom de classe qui va utiliser cette racine concaténée avec un nombre correspondant à chaque mot-clé.
• boolean output-query-node - Renvoie le nœud de requête utilisé pour effectuer les recherches. Ce nœud peut être différent du nœud de requête fourni en tant que paramètre. Valeur par défaut : true.
• enum output-display-mode - L'utilisation du mode « Limité » va renvoyer un sous-ensemble de données XML renvoyées en mode « Normal ». Ce sous-ensemble est optimisé pour les applications utilisant l'API d'application de sorte à renvoyer des ensembles de données volumineux. Valeur par défaut : default. Valeurs possibles : default|limited.
• string authorization-rights - Liste de groupes de sécurité (les collections cibles doivent contenir ces ACL utilisant ces mêmes groupes), séparés par des retours à la ligne.
• string authorization-username - Nom d'utilisateur à utiliser pour la sécurité d'une liaison tardive.
• string authorization-password - Mot de passe à utiliser pour la sécurité d'une liaison tardive.
• string collapse-xpath - Cette expression XPath sera évaluée pour chaque document qui répond à une requête et les documents partageant la même valeur seront regroupés dans un seul résultat de recherche.
• int collapse-num - Lors de la réduction d'une vue hiérarchique, nombre maximum de documents secondaires à générer par clé. Si vous indiquez la valeur 0, seul le meilleur document évalué sera généré pour chaque clé.
• boolean collapse-binning - Par défaut, le regroupement en catégories est appliqué à chaque document. Si vous activez cette option, le regroupement en catégories ne sera alors effectué que sur les meilleurs documents de chaque ensemble dont la vue hiérarchique a été réduite. Dans ce mode, il est possible de définir une valeur inférieure à celle demandée pour le nombre de documents à renvoyer.
• sort nodeset collapse-sort-xpaths - Cette expression XPath sera évaluée pour chaque document répondant à une requête et les documents partageant une valeur de clé identique verront leur vue hiérarchique réduite dans le même résultat de recherche.
• string binning-state - Composante de chaîne à transmettre lors d'une interaction avec le regroupement en catégories.
• enum binning-mode - off : désactive le mode Regroupement en catégories. normal : calcule toutes les catégories pour l'état en cours. double : calcule les mêmes informations que le mode Normal, mais calcule aussi les catégories pour l'état complet sans restrictions. Valeur par défaut : defaults. Valeurs possibles : defaults|off|normal|double.
• binning-set nodeset binning-configuration - Toute configuration supplémentaire que vous souhaitez utiliser pour améliorer la configuration du regroupement en catégories de la collection. En général, elle est uniquement transmise lorsqu'un traitement supplémentaire est requis selon l'utilisateur.
• boolean force-binning - En général, aucune donnée de regroupement en catégories n'est générée lorsque le paramètre start est défini sur une valeur autre que zéro. Ceci permet d'éviter tout résultat incorrect lors de l'utilisation d'une collection à des fins de regroupement. Si aucun regroupement n'est effectué, vous pouvez forcer la génération de données de regroupement en catégories en activant cette option. Valeur par défaut : false.
• boolean fetch - Si ce paramètre est défini sur « true », alors les requêtes éloignées seront recherchées. Ce paramètre doit toujours être activé, sauf si vous souhaitez afficher le jeu de références source entièrement développé sans faire la moindre demande (ce qui peut être utile lors de la création d'un formulaire avancé). Valeur par défaut : true.
• int fetch-timeout - Délai d'attente au bout duquel la demande sera abandonnée. Valeur par défaut : 60000.
• boolean aggregate - Lorsque ce paramètre est activé, toutes les sources interrogées devront se comporter comme une source unique. Il devra être activé lorsque vous interrogez un ensemble de collections de recherche qui devra se comporter comme s'il s'agissait d'une collection unique. Si vous activez ce paramètre, assurez-vous d'activer output-score, output-shingles, output-key et output-sort-keys. Valeur par défaut : false.
• int aggregate-max-passes - En mode Agrégat, ce paramètre permet de revenir plusieurs fois à une source donnée afin d'obtenir le nombre de résultats adéquats (lorsque vous interrogez plusieurs sources simultanément, Watson Explorer ignore, avant d'afficher les résultats, laquelle d'entre elles dispose de scores de résultats faibles/élevés et il est possible qu'il doive les consulter plusieurs fois pour rechercher les meilleurs résultats dans l'ensemble des sources). Valeur par défaut : 3.
• boolean cluster - Permet le regroupement les résultats d'une recherche. Seul un contenu affichant des pondérations supérieures à 0 et une action par défaut ou une action « cluster » sera pris en compte. Valeur par défaut : false.
• double cluster-near-duplicates - Les documents plus similaires entre eux qu'à x (soit un pourcentage de contenu différent) seront considérés comme étant des doublons. Seule une instance d'un document en double apparaîtra dans les résultats (avec plusieurs sources). Si vous définissez cette option sur 1, tous les documents seront des doublons les uns par rapport aux autres. Si vous définissez cette option sur 0, seuls les documents contenant exactement le même texte indexé seront marqués comme étant des doublons. Si vous définissez cette option sur -1, la détection des quasi-doublons sera complètement désactivée. Valeur par défaut : -1.
• string cluster-kbs - Liste des bases de connaissances, séparées par un espace, à utiliser pour le regroupement et la déduplication proche (prédéfinie ou définie par l'utilisateur). Si un même mot apparaît dans plusieurs bases de connaissances, celle répertoriée en dernier dans la liste sera utilisée. Par exemple, les deux bases de connaissances anglais-allemand contiennent le terme « die », mais l'entrée dans la base de connaissances en langue allemande sera prioritaire car elle apparaît en dernier dans la liste. Pour obtenir la liste des bases de connaissances actuellement prédéfinies, consultez la documentation principale. Valeur par défaut : core web english custom.
• string cluster-stemmers - Liste d'analyseurs morphologiques, séparés par des espaces, à utiliser pour le regroupement et la déduplication proche. Il est possible de combiner plusieurs analyseurs morphologiques. Par exemple : néerlandais français appliquera l'analyseur morphologique néerlandais, puis, s'il n'a pas identifié le radical du terme en question, l'analyseur morphologique français. Pour obtenir la liste des analyseurs morphologiques actuellement pris en charge, consultez la documentation principale. Valeur par défaut : delanguage english depluralize.
• string cluster-segmenter - Indique l'outil de segmentation à utiliser pour le regroupement et la déduplication proche. Un outil de segmentation permet de prendre des énoncés séquentiels dans des langues non segmentées (par exemple : le japonais ou le chinois) et de diviser l'énoncé en composants (ou mots) individuels. Pour obtenir la liste des outils de segmentation actuellement pris en charge, consultez la documentation principale. Valeur par défaut : none.
• boolean efficient-paging - Extrait plus efficacement des documents dans les sources, permettant ainsi de renvoyer un plus grand nombre de documents. Cette fonction est incompatible avec certaines autres fonctions de Watson Explorer. Valeur par défaut : false.
• int efficient-paging-n-top-docs-to-cluster - Lorsque la pagination efficace est activée, seule une partie des documents sera directement extraite et ne pourra donc pas être regroupée. Cette option contrôle le nombre de documents les mieux classés à extraire et à utiliser pour le regroupement. Valeur par défaut : 200.
• boolean debug - Lorsque ce paramètre est défini sur « true », Watson Explorer va créer un journal de débogage qui pourra être consulté via l'outil d'administration (Management > Debugging). Veillez à ne jamais activer cette option en production car elle aura une incidence sur les performances. Valeur par défaut : false.
• boolean profile - Lorsque ce paramètre est défini sur « true », Watson Explorer va procéder à un léger débogage afin de pouvoir utiliser le journal de débogage pour le profilage. Notez que le débogage doit être activé pour que cette option fonctionne correctement. Valeur par défaut : false.
• nodeset extra-xml - Code AXL supplémentaire traité préalablement à la soumission d'une requête. Ce paramètre peut être utilisé pour ajouter davantage d'options avancées ou des variables personnalisées.

Valeur de retour

• query-results nodeset

Exceptions

• Il n'existe aucune exception spécifique à cette fonction.

Authentification

Comme toutes les fonctions de l'API de Watson Explorer Engine, à l'exception de ping, la fonction query-search requiert une authentification.

Lorsque vous utilisez l'interface REST, vous pouvez simplement transmettre v.username et v.password comme paramètres CGI via le protocole HTTP ou HTTPS afin d'authentifier l'appel REST pour la fonction query-search.

Lorsque vous utilisez l'API SOAP, vous pouvez transmettre les données d'identification comme paramètres à un nœud final ou utiliser la méthode d'authentification prise en charge par toutes les fonctions de Watson Explorer Engine. Chacune fournit une méthode setAuthentication qui peut être transmise comme objet d'authentification afin de fournir le nom d'utilisateur et le mot de passe sous lesquels s'exécute une fonction. Par exemple, dans Java, pour adresser un appel SOAP à la fonction query-search, la méthode d'authentification sera la suivante :

    Authentication authentication = new Authentication();
    authentication.setUsername("joe-user");
    authentication.setPassword("joes-password");

    QuerySearch foo = new QuerySearch();
    foo.setAuthentication(authentication);

Un objet d'authentification unique est généralement réutilisé dans chaque application individuelle.