Documentation SDX-2 Télécharger Installer Présentation Configuration Indexation Recherche OAI Javadoc Référence API-XSP Pages XSP Paramètres SDX Vue d'ensemble Structure Paramètres et flux Identification Droits Localisation Pipelines Thesaurus Indexation Recherche Documents Liste alphabétique Migration Schemas Performances | # Localisation des applications, bases de documents et entrepôts Liste des actions décrites dans cette page : `sdx:location` ; `sdx:locations` ; `sdx:app` ; `sdx:base` ; `sdx:bases` ; `sdx:repo`. ## Concepts clés (CHECK) SDX offre plusieurs outils de contextualisation et d'identification des documents, ce que nous réunissons sous le titre générique "localisation". Hormis `sdx:id`, l'ensemble des actions décrites ici sont le fruit de l'architecture multi-applications et multi-bases de SDX (voir la section sur l'architecture de SDX) : il serait effectivement inutile de préciser l'application sur laquelle on souhaite travailler dans le cas où l'on possède une seule application, a fortiori une base de document ! Il devient donc possible d'exécuter une requête dans plusieurs bases de documents, au sein d'une même application ou sur différents serveur SDX. De même, on peut répartir le stockage de documents XML dans plusieurs entrepôts ou ouvrir des droits à l'utilisateur d'une autre application (CHECK). ## `sdx:location`(CHECK) `sdx:location` permet de redéfinir complètement le contexte d'une action, depuis l'hôte du serveur SDX jusqu'à la base de documents, en passant par l'application. On peut dire qu'elle est le générique de `sdx:app`, `sdx:base` et `sdx:repo` dont le rayon d'action est respectivement limité à l'application, la base de documents et l'entrepôt.
Code implémentant cette action | `sdx-parameters.xsl`
Contexte d'utilisation | `sdx:location` s'emploie avec tous les types d'exécution de requête (`sdx:terms` et l'ensemble des `sdx:execute*Query`) ainsi qu'avec la suppression de documents par lots (`sdx:deleteDocuments`).
Contenu éventuel | Aucun.
Tableau 1. Paramètres spécifiques
Nom | Description |
--- | --- | ---
`host` | L'hôte du serveur SDX. (CHECK) | Facultatif
`port` | Le port du serveur SDX. (CHECK) | Facultatif
Tableau 2. Paramètres communs
Nom | Description |
--- | --- | ---
`app` | L'identifiant de l'application. | Facultatif
`appbypath` | Indique la partie de l'URL qui suit "`sdx/`" dans une installation standard, par exemple "`sdxtest`". | Facultatif
`base` | L'identifiant de la base de documents. | Facultatif
L'action `sdx:location` n'emploie aucun paramètre commun. Exemple 1. Effectuer une recherche sur plusieurs bases de documents Dans l'exemple suivant, on souhaite retrouver les termes d'un index `auteur` qui existe dans deux bases de documents différentes. Le fait que l'on ne précise pas l'application SDX implique que l'on travaille sur deux bases de documents de l'application courante. Corollaire : les deux bases sont gérées par la même application.
    <sdx:page>
      <sdx:terms field="auteur" hpp="-1">
        <sdx:location base="base1"/>
        <sdx:location base="base2"/>
      </sdx:terms>
    </sdx:page>
Voici le résultat de la requête :
    ...
      <sdx:terms qid="q35" page="1" hpp="32" pages="1" nb="32" start="1"
        end="32"
        id="q4"
        currentPage="1"
        nbPages="1">

        <sdx:term no="1" value="Zola" escapedValue="Zola" field="auteur"
          docs="1"
          id="article_326554"
          base="base1"
          app="fr.culture.sdx.adfi"
          docId="article_326554"
          docFreq="1"/>

        <sdx:term no="2" value="Verne" escapedValue="Verne" field="auteur"
          docs="1"
          id="these_41579"
          base="base2"
          app="fr.culture.sdx.adfi"
          docId="these_326554"
          docFreq="1"/>
        ...
      </sdx:terms>
    ...
Noter que les 2 premiers termes figurent bien dans les 2 bases d'une même application. ## `sdx:locations`(CHECK) `sdx:locations` est le conteneur de `sdx:location` multiples (CHECK).
Code implémentant cette action | `sdx-parameters.xsl`
Contexte d'utilisation | Idem `sdx:location`.
Contenu éventuel | Un ou plusieurs `sdx:location`.
## `sdx:app`(CHECK) `sdx:app` peut être considérée comme une action spécifique de `sdx:location`. Comme cette dernière, elle permet de modifier le contexte de travail ; son rayon d'action s'arrête toutefois à l'identification de l'application.
Code implémentant cette action | `sdx-parameters.xsl`
Contexte d'utilisation | `sdx:app` s'emploie avec les actions d'identification `sdx:login` et `sdx:logout`, les actions de gestion des droits `sdx:userIsAdmin`, `sdx:userIsMember`, `sdx:userIsAdminOrSu`, la gestion de thesauri `sdx:thesaurus`, enfin avec les actions de localisation des bases de documents `sdx:base` et `sdx:bases`.
Contenu éventuel | Aucun.
Tableau 3. Paramètres spécifiques
Nom | Description |
--- | --- | ---
app | Identifiant de l'application | Obligatoire
appbypath | Indique la partie de l'URL qui suit "`sdx/`" dans une installation standard, par exemple "`sdxtest`". | Facultatif
L'action `sdx:app` n'emploi aucun paramètre commun. ## `sdx:base`(CHECK) `sdx:base` peut être considéré comme une action spécifique de `sdx:location`. Comme cette dernière, elle permet de modifier le contexte d'application d'une action ; son rayon d'action s'arrête toutefois à l'identification d'une base de documents (voir le chapitre sur les bases de documents pour approfondir cette notion).
Code implémentant cette action | `sdx-parameters.xsl`
Contexte d'utilisation | `sdx:base` peut s'employer avec `sdx:includeDocument`, `sdx:deleteDocument` et `sdx:repo`.
Contenu éventuel | Aucun.
Tableau 4. Paramètre spécifique
Nom | Description |
--- | --- | ---
base | Identifiant de la base de document. | Obligatoire
Tableau 5. Paramètres communs
Nom | Description | Elément correspondant |
--- | --- | --- | ---
app | Identifiant de l'application. Par défaut, il s'agit de l'application courante. | `sdx:app` | Facultatif
appbypath | Indique la partie de l'URL qui suit "`sdx/`" dans une installation standard, par exemple "`sdxtest`". | `sdx:app` | Facultatif
## `sdx:bases`(CHECK) `sdx:bases` est un conteneur pour de multiples `sdx:base`.
Code implémentant cette action | `sdx-parameters.xsl`
Contexte d'utilisation | Aucune action n'appelle la règle exécutant `sdx:bases`. (FIXME)
Contenu éventuel | Un ou plusieurs `sdx:base` FIXME.
Tableau 6. Paramètre spécifique
Nom | Description |
--- | --- | ---
`base` | Identifiant de la base de documents. | Facultatif
Tableau 7. Paramètres communs
Nom | Description | Elément correspondant |
--- | --- | --- | ---
app | Identifiant de l'application. Par défaut, il s'agit de l'application courante. | `sdx:app` | Facultatif
appbypath | Indique la partie de l'URL qui suit "`sdx/`" dans une installation standard, par exemple "`sdxtest`". | `sdx:app` | Facultatif
## `sdx:repo`(CHECK) `sdx:repo` peut être considérée comme une action spécifique de `sdx:location`. Comme cette dernière, elle permet de modifier le contexte d'application d'une action ; son rayon d'action étant limitée à l'identification d'un entrepôt (voir le chapitre sur les entrepôts pour approfondir cette notion).
Code implémentant cette action | `sdx-parameters.xsl`
Contexte d'utilisation | `sdx:repo` peut être employée avec les actions d'indexation `sdx:uploadDocument` et `sdx:uploadDocuments`.
Contenu éventuel | `sdx:base`
Tableau 8. Paramètre spécifique
Nom | Description |
--- | --- | ---
`repo` | Identifiant de l'entrepôt. | Obligatoire
Tableau 9. Paramètres communs
Nom | Description | Elément correspondant |
--- | --- | --- | ---
`base` | Identifiant de la base de documents. Par défaut, il s'agit de la base de documents courante. | `sdx:base` | Facultatif
`app` | Identifiant de l'application. Par défaut, il s'agit de l'application courante. | `sdx:app` | Facultatif
`appbypath` | Indique la partie de l'URL qui suit "`sdx/`" dans une installation standard, par exemple "`sdxtest`". | `sdx:app` | Facultatif
| Auteur : Malo Pichot (AJLSM) - 2003-06-04

| Home |
Copyright © 2000, 2001, 2002, 2003, 2004 Ministère de la culture et de la communication, AJLSM.