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


SDX

Localisation des applications, bases de documents et entrepôts

Liste des actions décrites dans cette page :

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 actionsdx-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 éventuelAucun.

Tableau 1. Paramètres spécifiques

NomDescription 
hostL'hôte du serveur SDX. (CHECK)Facultatif
portLe port du serveur SDX. (CHECK)Facultatif

Tableau 2. Paramètres communs

NomDescription 
appL'identifiant de l'application.Facultatif
appbypathIndique la partie de l'URL qui suit "sdx/" dans une installation standard, par exemple "sdxtest".Facultatif
baseL'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 actionsdx-parameters.xsl
Contexte d'utilisation Idem sdx:location.
Contenu éventuelUn 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 actionsdx-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 éventuelAucun.

Tableau 3. Paramètres spécifiques

NomDescription 
appIdentifiant de l'applicationObligatoire
appbypathIndique 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 actionsdx-parameters.xsl
Contexte d'utilisationsdx:base peut s'employer avec sdx:includeDocument, sdx:deleteDocument et sdx:repo.
Contenu éventuelAucun.

Tableau 4. Paramètre spécifique

NomDescription 
base

Identifiant de la base de document.

Obligatoire

Tableau 5. Paramètres communs

NomDescriptionElément correspondant 
app Identifiant de l'application. Par défaut, il s'agit de l'application courante.sdx:appFacultatif
appbypathIndique la partie de l'URL qui suit "sdx/" dans une installation standard, par exemple "sdxtest".sdx:appFacultatif

sdx:bases(CHECK)

sdx:bases est un conteneur pour de multiples sdx:base.

Code implémentant cette actionsdx-parameters.xsl
Contexte d'utilisationAucune action n'appelle la règle exécutant sdx:bases. (FIXME)
Contenu éventuelUn ou plusieurs sdx:base FIXME.

Tableau 6. Paramètre spécifique

NomDescription 
baseIdentifiant de la base de documents.Facultatif

Tableau 7. Paramètres communs

NomDescriptionElément correspondant 
app Identifiant de l'application. Par défaut, il s'agit de l'application courante.sdx:appFacultatif
appbypathIndique la partie de l'URL qui suit "sdx/" dans une installation standard, par exemple "sdxtest".sdx:appFacultatif

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 actionsdx-parameters.xsl
Contexte d'utilisation sdx:repo peut être employée avec les actions d'indexation sdx:uploadDocument et sdx:uploadDocuments.
Contenu éventuelsdx:base

Tableau 8. Paramètre spécifique

NomDescription 
repo Identifiant de l'entrepôt.Obligatoire

Tableau 9. Paramètres communs

NomDescriptionElément correspondant 
baseIdentifiant de la base de documents. Par défaut, il s'agit de la base de documents courante.sdx:baseFacultatif
app Identifiant de l'application. Par défaut, il s'agit de l'application courante.sdx:appFacultatif
appbypathIndique la partie de l'URL qui suit "sdx/" dans une installation standard, par exemple "sdxtest".sdx:appFacultatif


Auteur : Malo Pichot (AJLSM) - 2003-06-04