input
"Boîte" d'entrée dans schema.x.element.form
Description
Lorsque l'attribut field est spécifié, cette entrée peut convertir les termes associés à cette zone dans une requête structurée. Sinon, une paire nom/valeur CGI sera uniquement ajoutée à l'URL.
Si l'attribut field-value est spécifié, une seule valeur sera prise en charge. Les requêtes plus complexes que les termes uniques peuvent être converties à l'aide de ce paramètre en fonction de l'attribut syntax.
Attributs
- async (booléen Valeur par défaut : true) - Traitement asynchrone. Pour les balises d'analyse, indique si la demande doit être ajoutée à la file d'attente (false) ou traitée avant l'élément apparenté suivant. Pour les autres éléments, cet attribut ne fait la différence que s'ils contiennent des demandes asynchrones qui doivent être traitées avant le traitement de l'élément. Dans ce cas, lorsque l'attribut est défini sur false, l'élément apparenté suivant de l'élément ne sera traité qu'après l'élément en cours ; lorsqu'il est défini sur true, Watson Explorer n'attend pas que l'élément en cours soit traité avant de traiter son élément apparenté suivant.
- elt-id (entier) - Utilisation : Interne
- max-elt-id (entier) - Utilisation : Interne
- execute-acl (Texte)
- process (Texte) - Expression XPath qui détermine les attributs et/ou les enfants à traiter. Seuls "", "*", "@*" et "*|@*" sont actuellement pris en charge.
- size
- cols
- rows
- remove-from-new-query
- display-name
- name (Texte) - Nom du paramètre CGI associé
- value (Texte) - Valeur fixe pour ce paramètre.
- xpath-value (Texte) - Post-traitement XPath de la valeur. Utilisez @value pour accéder à la valeur & @name au nom de cette entrée (interprété dans le contexte correspondant à un schema.x.element.parse-param avant d'envoyer la demande).
- field (De type Texte) - Zone associée à ce paramètre.
- field-value (Texte) - Spécifie une valeur de zone qui sera la seule prise en charge.
- syntax (Texte) - Liste de noms schema.x.element.operator séparés par des espaces pris en charge dans cette entrée.
- offset (entier) - Lors de la conversion d'une zone numérique, ajoutez ce nombre au paramètre CGI (particulièrement utile pour les zones spéciales start et page, lorsque la source distante débute son décompte à 1 au lieu de 0).
- next-only (next-only uniquement dans certains cas) - Ce paramètre n'est ajouté que pour les pages suivantes. Approprié aux sites qui marquent l'URL "suivante" avec un ensemble spécifique de paramètres qui ne peuvent pas être utilisés pour la première page.
- min (entier) - Valeur minimale prise en charge pour une zone numérique.
- max (entier) - Valeur maximale prise en charge pour une zone numérique.
- max-instances (entier) - Nombre maximal de termes pouvant être convertis dans cette entrée.
- logic (Texte Valeur par défaut : and) - Logique par défaut prise en charge.
- all ou and : "tous les mots".
- any ou or : "n'importe quel mot".
- not ou none : "aucun des mots".
- phrase : "phrase exacte".
- Chaîne vide : aucune logique par défaut, seuls les termes seront pris en charge à moins que des opérateurs soient spécifiés dans l'attribut syntax.
- term-logic (De type NMToken) - Utilisation : Interne
- delimiters (Texte Valeur par défaut : ) - Caractères qui délimitent les termes. Watson Explorer utilise ces informations pour déterminer s'il est nécessaire d'utiliser un opérateur phrase (c.-à-d. des guillemets). Par exemple, elles peuvent permettre de demander à Watson Explorer de considérer "a'b" comme un seul mot et d'indiquer à Watson Explorer que la source distante le considérera comme deux mots (et nécessitera ainsi un opérateur phrase afin de le considérer comme une phrase). La valeur par défaut (que vous ne pouvez pas "visualiser" ici car elle prend l'apparence d'espaces) est l'espace, le retour à la ligne, la tabulation et le retour chariot.
- word-chars (Texte) - Par défaut, lorsqu'une entrée prend en charge les opérateurs phrase, n'importe quel terme contenant un caractère non alphanumérique est placé entre guillemets. Cet attribut vous permet d'étendre la liste de caractères considérés comme alphanumériques.
- disable-auto-quotes (disable-auto-quotes uniquement dans certains cas) - Désactive l'ajout automatique de guillemets autour des termes contenant des caractères non alphanumériques.
- position (entier) - Position du paramètre associé dans l'URL générée. Certaines applications Web accordent de l'importance à l'ordre des paramètres CGI. Utilisez cet attribut pour appliquer l'ordre de votre choix.
- priority (entier Valeur par défaut : 0) - Priorité qui sera associée à cette entrée pour gérer les termes de requête. Ainsi, si un terme de requête peut être pris en charge par plusieurs entrées/sélections, celui dont la priorité est la plus élevée sera utilisé.
- method (GET, POST, HEAD, GET-POST, POST-XML ou POST-SOAP) - Méthode (GET ou POST) grâce à laquelle ce paramètre sera transmis.
- submit-xml (submit-xml uniquement dans certains cas) - Si cet attribut est spécifié, il permet de soumettre les éléments de requête au format XML plutôt que de les convertir en chaîne.
- required (required uniquement dans certains cas) - N'émettez pas de requête à cette source si ce paramètre n'est pas spécifié.
- type (hidden ou textarea) - Par défaut,
spécifie le type d'élément de formulaire en "texte libre" qui sera utilisé pour l'affichage. La valeur par défaut est une boîte d'entrée de texte standard.
- hidden : entrée masquée
- textarea : zone de texte
Enfants
- Choisissez un nombre dans n'importe quel ordre.
- operator : (Zéro ou plus) - Définition d'opérateur logique
Exemples
Exemple d'entrée :
<field name="query" record="record"/> <param name="q" value="test"/> <form name="vivisimo"> <input name="q" field="query"/> </form> <query form="vivisimo"/>
Exemple de sortie :
<param name="q" value="test"/> <meta query=" test "/> <field name="query" record="record"/> <form name="vivisimo"> <input name="q" field="query"/> </form> <query> <operator logic="and"> <term field="query" str="test" position="0"/> </operator> </query>
Exemple d'entrée :
<field name="query" record="record"/>
<field name="title" record="record"/>
<field name="date"/>
<operator name="OR" middle-string="OR" logic="or"/>
<operator name="parenthesis" start-string="(" end-string=")" logic="bracket"/>
<operator name="AND" middle-string="AND" logic="and" precedence="1"/>
<operator name="squot" start-string="'" end-string="'" logic="phrase"/>
<operator name="not" start-string="-" logic="not"/>
<operator name="title" start-string="title:" field="title"/>
<operator name="author" end-string="[au]" field="author"/>
<operator name="date" start-string="[date[" end-string="]]" field="date"/>
<operator name="near" start-string="{" middle-string="," end-string="}" logic="near"/>
<param name="query" value="'r s' 't u OR v"/>
<param name="query" value="-w"/>
<param name="query" value="x-y"/>
<param name="query" value="-title:'z a'"/>
<param name="query" value="b[au] c [au]"/>
<param name="query" value="[date[d]]"/>
<param name="query" value="{e,f} {g , h}"/>
<param name="query" value="-[au] -AND -OR -- "/>
<param name="query" value="-- "/>
<form name="f">
<input name="query" field="query" syntax="OR AND parenthesis wildcard squot not title author date near"/>
</form>
<query form="f"/>
Exemple de sortie :
<param name="query" value="'r s' 't u OR v"/>
<param name="query" value="-w"/>
<param name="query" value="x-y"/>
<param name="query" value="-title:'z a'"/>
<param name="query" value="b[au] c [au]"/>
<param name="query" value="[date[d]]"/>
<param name="query" value="{e,f} {g , h}"/>
<param name="query" value="-[au] -AND -OR -- "/>
<param name="query" value="-- "/>
<meta query=" r s 't u | v w x-y z a b c e f g h [au] AND OR - - "/>
<field name="query" record="record"/>
<field name="title" record="record"/>
<field name="date"/>
<operator name="OR" middle-string="OR" logic="or"/>
<operator name="parenthesis" start-string="(" end-string=")" logic="bracket"/>
<operator name="AND" middle-string="AND" logic="and" precedence="1"/>
<operator name="squot" start-string="'" end-string="'" logic="phrase"/>
<operator name="not" start-string="-" logic="not"/>
<operator name="title" start-string="title:" field="title"/>
<operator name="author" end-string="[au]" field="author"/>
<operator name="date" start-string="[date[" end-string="]]" field="date"/>
<operator name="near" start-string="{" middle-string="," end-string="}" logic="near"/>
<form name="f">
<input name="query" field="query" syntax="OR AND parenthesis wildcard squot not title author date near"/>
</form>
<query>
<operator logic="and">
<term field="query" str="r s" phrase="phrase" position="0"/>
<term field="query" str="'t" position="1"/>
<operator name="OR" middle-string="OR" logic="or">
<term field="query" str="u" position="2"/>
<term field="query" str="v" position="3"/>
</operator>
<operator name="not" start-string="-" logic="not">
<term field="query" str="w" position="4"/>
</operator>
<term field="query" str="x-y" position="5"/>
<operator name="not" start-string="-" logic="not">
<term field="title" str="z a" phrase="phrase" position="6"/>
</operator>
<term field="author" str="b" position="7" processing="strict"/>
<term field="author" str="c" position="8" processing="strict"/>
<term field="date" str="d" position="9"/>
<operator name="near" start-string="{" middle-string="," end-string="}" logic="near">
<term field="query" str="e" position="10"/>
<term field="query" str="f" position="11"/>
</operator>
<operator name="near" start-string="{" middle-string="," end-string="}" logic="near">
<term field="query" str="g" position="12"/>
<term field="query" str="h" position="13"/>
</operator>
<operator name="not" start-string="-" logic="not">
<term field="query" str="[au]" position="14"/>
</operator>
<operator name="not" start-string="-" logic="not">
<term field="query" str="AND" position="15"/>
</operator>
<operator name="not" start-string="-" logic="not">
<term field="query" str="OR" position="16"/>
</operator>
<operator name="not" start-string="-" logic="not">
<term field="query" str="-" position="17"/>
</operator>
<operator name="not" start-string="-" logic="not">
<term field="query" str="-" position="18"/>
</operator>
</operator>
</query>
Exemple d'entrée :
<operator name="any" logic="or"/> <field name="query" record="record"/> <query> <operator logic="and"> <term str="a" field="query"/> <term str="b" field="query"/> </operator> </query> <submit num="50"> <form action="http://test"> <input name="i" field="query"> <operator middle-string="AND" logic="and"/> <operator logic="or"/> </input> </form> </submit> <submit num="50"> <form action="http://test"> <input name="i" field="query" syntax=""/> </form> </submit> <submit num="30"> <form action="http://test"> <input name="i" field="query"> <operator middle-string="AND" logic="and"/> </input> </form> </submit> <submit num="20"> <form action="http://test"> <input name="i" field="query"> <operator logic="or"/> </input> </form> </submit> <submit num="10"> <form action="http://test"> <input name="i" field="query"> <operator logic="phrase"/> </input> <input name="j" field="query"> <operator logic="phrase"/> </input> </form> </submit>
Exemple de sortie :
<meta query=" a b "/> <operator name="any" logic="or"/> <field name="query" record="record"/> <query> <operator logic="and"> <term str="a" field="query"/> <term str="b" field="query"/> </operator> </query> <submit num="50" status="translated" last-rank="50" last-page="1"> <form action="http://test" normalized="normalized" status="trans-succeeded"> <input name="i" field="query" logic="or" delimiters=" 	　" position="0" value="a AND b"> <operator middle-string="AND" logic="and"/> </input> <input field="per"/> </form> </submit> <scope max="50" orig-tag="submit"> <parse url="http://test/?i=a_AND_b" per="50" page="0" start="0" parser="#vxml#" ref="0"/> </scope> <submit num="50" status="translated" last-rank="50" last-page="1"> <form action="http://test" normalized="normalized" status="trans-succeeded"> <input name="i" field="query" syntax="" logic="and" delimiters=" 	　" position="0" value="a b"/> <input field="per"/> </form> </submit> <scope max="50" orig-tag="submit"> <parse url="http://test/?i=a_b" per="50" page="0" start="0" parser="#vxml#" ref="1"/> </scope> <submit num="30" status="translated" last-rank="30" last-page="1"> <form action="http://test" normalized="normalized" status="trans-succeeded"> <input name="i" field="query" logic="and" delimiters=" 	　" position="0" value="a b"> <operator middle-string="AND" logic="and"/> </input> <input field="per"/> </form> </submit> <scope max="30" orig-tag="submit"> <parse url="http://test/?i=a_b" per="30" page="0" start="0" parser="#vxml#" ref="2"/> </scope> <submit num="20" status="translation-failed"> <form action="http://test" normalized="normalized" status="trans-failed"> <input name="i" field="query" logic="or" delimiters=" 	　" position="0"/> </form> <contextual-msg name="bad-sub-query"> <msg time="5" date="1170291631" cputime="0" id="QUERY_NO_CONVERT" function="vivisimo_input_xml" fid="0">The query has not been converted because of sub-query <xmlnode> <term str="b" field="query"/> </xmlnode> </msg> <term str="b" field="query"/> </contextual-msg> </submit> <submit num="10" status="translated" last-rank="10" last-page="1"> <form action="http://test" normalized="normalized" status="trans-succeeded"> <input name="i" field="query" delimiters="" logic="and" position="0" value="a"/> <input name="j" field="query" delimiters="" logic="and" position="1" value="b"/> <input field="per"/> </form> </submit> <scope max="10" orig-tag="submit"> <parse url="http://test/?i=a&j=b" per="10" page="0" start="0" parser="#vxml#" ref="3"/> </scope>Conversion de requête "or"
Exemple d'entrée :
<field name="query" record="record"/> <query> <operator logic="or"> <term str="a" field="query"/> <term str="b" field="query"/> </operator> </query> <submit> <form action="http://test.com"> <input name="i" field="query"> <operator middle-string="OR" logic="or"/> <operator logic="and"/> </input> </form> </submit>
Exemple de sortie :
<meta query=" a | b "/> <field name="query" record="record"/> <query> <operator logic="or"> <term str="a" field="query"/> <term str="b" field="query"/> </operator> </query> <submit status="translated" num="50" last-rank="50" last-page="1"> <form action="http://test.com" normalized="normalized" status="trans-succeeded"> <input name="i" field="query" logic="and" delimiters=" 	　" position="0" value="a OR b"> <operator middle-string="OR" logic="or"/> </input> <input field="per"/> </form> </submit> <scope max="50" orig-tag="submit"> <parse url="http://test.com/?i=a_OR_b" per="50" page="0" start="0" parser="#vxml#" ref="0"/> </scope>Le premier format prenant en charge une syntaxe de requête est utilisé pour la soumission. Dans le cas suivant, le second format sera utilisé :
Exemple d'entrée :
<query> <operator logic="and"> <term str="ibm.com" field="host"/> <term str="ibm.com" field="query"/> </operator> </query> <submit> <form action="http://se.com/search?"> <input name="query" field="query"/> </form> <form action="http://se.com/advsearch?"> <input name="query" field="query"/> <input name="host" field="host"/> </form> </submit>
Exemple de sortie :
<meta query=" ibm.com ibm.com "/> <query> <operator logic="and"> <term str="ibm.com" field="host" processing="strict"/> <term str="ibm.com" field="query" processing="strict"/> </operator> </query> <submit status="translated" num="50" last-rank="50" last-page="1"> <form action="http://se.com/search?" normalized="normalized" status="trans-failed"> <input name="query" field="query" logic="and" delimiters=" 	　" position="0"/> </form> <form action="http://se.com/advsearch?" normalized="normalized" status="trans-succeeded"> <input name="query" field="query" logic="and" delimiters=" 	　" position="0" value="ibm.com"/> <input name="host" field="host" logic="and" delimiters=" 	　" position="1" value="ibm.com"/> <input field="per"/> </form> </submit> <scope max="50" orig-tag="submit"> <parse url="http://se.com/advsearch?query=ibm.com&host=ibm.com" per="50" page="0" start="0" parser="#vxml#" ref="0"/> </scope>