Redirections

Client-server instructions

SLDR multi-tier infrastructure is a basic framework for responding to distributed content search launched from portals and search engines. We hope to expand it to the specifications of CLARIN's European demo case.

On this page,

• sldrxxxxxx is the unique identifier of an item. 'xxxxxx' is a six-digit number.
• lg is a 2-character code for the navigation language, with values in set {en, es, fr, zh}. It may be an empty string, in which case the site will try to select the language set up as default by the web browser.

Queries specific to a single item

sldr.org/sldrxxxxxx/download/lg
sldr.org/sldrxxxxxx_vyyy/download/lg

• Effect: this link will download object sldrxxxxxx version yyy after performing users' authentification their identification as belonging to the group granted free access to the object.

• Examples:

  • http://sldr.org/sldr000041/download/fr
  • http://sldr.org/sldr000005_v2/download/en

sldr.org/sldrxxxxxx/download/source/lg

• Effect: only for item owners or privileged users as per group 2, this link will download object sldrxxxxxx in its latest version currently available on SLDR.

• Example:

  • http://sldr.org/sldr000041/download/source/fr

sldr.org/sldrxxxxxx/preview/lg
sldr.org/sldrxxxxxx/preview/lg

• Effect: this link will show the preview (window) describing object sldrxxxxxx. This will be reduced to the list of files in case no index file is available. The language tag might also not work.

• Examples:

  • http://sldr.org/sldr000006/preview
  • http://sldr.org/sldr000011/preview/fr
  • http://sldr.org/sldr000720/preview

Example of index.php code selecting several languages:

<?php
$l = '';
if(isset($_GET['lang']) AND $_GET['lang'] != '')
        $l = $_GET['lang'];
else {
        $lngnav = $_SERVER['HTTP_ACCEPT_LANGUAGE'];
        if(is_integer(strpos($lngnav,'fr'))) $l="fr";
        else if(is_integer(strpos($lngnav,'en'))) $l="en";
        else $l="fr";
        }
$name = "index-".$l.".html";
include($name);
?>

sldr.org/sldrxxxxxx/pub*/lg

• Explanation: pub* is any word in lower-case characters with 'pub' as its prefix, eg. publications or publicaciones
• Effect: this link will display the list of publications associated with object sldrxxxxxx.

sldr.org/sldrxxxxxx/com*/lg

• Explanation: com* is any word in lower-case characters with 'com' as its prefix, eg. community
• Effect: this link will display the 'community' of persons who downloaded object sldrxxxxxx.
• Note: the list will only be visible to identified users who already downloaded or uploaded an object on the site.

sldr.org/sldrxxxxxx/toc/lg
sldr.org/sldrxxxxxx_vyyy/toc/lg

• Effect: this link displays the detailed table of contents of item sldrxxxxxx version yyy

• Examples:

  • http://sldr.org/sldr000731/toc/es
  • http://sldr.org/sldr000005_v1/toc/en

sldr.org/sldrxxxxxx_vyyy/map/lg

• Effect: this link displays the file mapping of item sldrxxxxxx version yyy

• Examples:

  • http://sldr.org/sldr000731/map/fr (current version, French)
  • http://sldr.org/sldr000026_v18/map/es (version 18, Spanish)

sldr.org/ark:XXXX

• Explanation: ark:XXXX is the archival resource key of an object presumably documented on sldr.org
• Effect: this link will find the sldrxxxxxx identifier and display the object's metadata.
• Example 1: http://sldr.org/ark:/87895/2.7-18672 (TEST environment)
• Example 2: http://sldr.org/ark:/87895/2.7-20588 (TEST environment, chunked item)
• Example 3: http://sldr.org/ark:/87895/1.4-6536 (PROD environment)
• Note: the link might redirect the user to the site from which the object originates, if other than sldr.org

sldr.org/sldrxxxxxx/source

• Effect: if the item is produced by an institution, this link tries to display the item at its source.

• For institutions whose link is active and supply a 'path', the link is redirected to: URLinstitution/path/source/sldrxxxxxx

  • Example: http://sldr.org/sldr000740/source points at http://lpl-aix.fr/sldr/source/sldr000740

• For other institutions the link is redirected to URLinstitution

  • Example: http://sldr.org/sldr000013/source points at http://www.mica.edu.vn

sldr.org/sldrxxxxxx/source/action

• Effect: if the item is produced by an institution, this link tries to launch action on the item at its source.

  • Example: http://sldr.org/sldr000740/source/voir points at http://lpl-aix.fr/sldr/source/sldr000740/voir

sldr.org/sldrxxxxxx/licenyyy/zzz

• Effect: tries to display specific licence of sldrxxxxxx whose file name is zzz

• 'yyy' is an arbitrary string allowing diverse spellings such as 'licence', 'license' etc.

  • Examples: http://sldr.org/sldr000753/licence/License.txt, http://sldr.org/sldr000764/license/LicenceValjouffrey.pdf

Downloading/displaying specific files contained in an item

sldr.org/sldrxxxxxx/get/yyyy (generic command)

• Explanation: yyyy is the datastream of a file stored on the distribution site (CC-IN2P3).
• Effect: this link will reach the file and handle it if it is in public access.
• Example : http://sldr.org/sldr000731/get/2194.pdf
• Note: the link will fail if the item has not yet been submitted to the OAIS system.

sldr.org/sldrxxxxxx/get/preview/yyyyy

• Explanation: yyyy is the path to a file stored in the preview folder of sldr.org, or as a datastream with prefix 'DIFFUSION_' on the distribution site (CC-IN2P3).
• Example: http://sldr.org/sldr000731/get/preview/2199.mp3
• Note: all files contained in the 'preview' folder are declared in public access. However, beware of the fact that files are renamed when submitted to OAIS unless they are contained in folders named 'PERMANENT' or 'stream'.

sldr.org/sldrxxxxxx/get/stream/yyyyy

• Explanation: yyyy is the path to a file stored in a stream folder of sldr.org. Beacuse of this location, the file must be in public access and it is not renamed.
• Example: http://sldr.org/sldr000525/get/stream_CG5_22k.srt
• Note: since all files contained in a 'stream' folder retain their names during the archival process, this URL remains unchanged after that the item has been submitted to the OAIS system. Further (because of the stable name) it remains unchanged throughout further versions of the item.

sldr.org/sldrxxxxxx/get/preview/*/stream/yyyyy

• Explanation: yyyy is the path to a file stored in the preview/stream folder of sldr.org, or as a datastream with prefix 'DIFFUSION_stream_' on the dissemination site (CC-IN2P3).
• Example: http://sldr.org/sldr000715/get/preview/stream/Derrida-StateOfTheLie.mp3
• Note: since all files contained in the 'preview' folder are declared for public-access, and all files contained in a 'stream' folder retain their names during the archival process, this URL remains unchanged after that the item has been submitted to the OAIS system. Further (because of the stable name) it remains unchanged throughout further versions of the item.

sldr.org/sldrxxxxxx/get/olac

• Effect: this link displays the content of an OLAC description of this item.
• Example: http://sldr.org/sldr000731/get/olac
• Note: if the item is available on the distribution site (CC-IN2P3), the link displays the olac.xml file exported to the site. If it is not available, the link constructs olac.xml dynamically from metadata contained in the sldr.org database.

Queries generic to the site

sldr.org/hist*/lg

• Explanation: hist* is any word in lower-case characters with 'hist' as its prefix, eg. history or historique
• Effect: this link will open the page: "A history of SLDR long-term preservation scheme".

sldr.org/lic*/lg

• Explanation: lic* is any word in lower-case characters with 'lic' as its prefix, eg. licences or license
• Effect: this link will display SLDR user and producer licence (last version).
• Example: http://sldr.org/licenses

sldr.org/licence_vX/lg

• Effect: this link will display SLDR user licence version X in language 'lg'.
• Example: http://sldr.org/licence_v1/es

sldr.org/com*/lg

• Explanation: com* is any word in lower-case characters with 'com' as its prefix, eg. community
• Effect: this link will display 'communities' of persons who downloaded objects.
• Note: the list will only be visible to identified users who already downloaded or uploaded an object on the site.

sldr.org/rel*/lg

• Explanation: rel* is any word in lower-case characters with 'rel' as its prefix, eg. relations or relaciones
• Effect: this link will display the list of relations between objects of the site.

sldr.org/lang*/lg

• Explanation: lang* is any word in lower-case characters with 'lang' as its prefix, eg. langues or languages
• Effect: this link will display the list of spoken languages currently referenced on the site.

sldr.org/list=XXX
sldr.org/list=XXX/lg

• Explanation: XXX is a list of items that need to be displayed on the home page. Example: http://sldr.org/list=715,sldr000526,525,000757,sldr000013/en
• Effect: this link will display the list of items on the home page.

Menu items

sldr.org/contact/lg

• Effect: this link will open the contact page.

sldr.org/service/lg

• Effect: this link will open the on-line service page.

sldr.org/corp*/lg

• Explanation: corp* is any word in lower-case characters with 'corp' as its prefix, eg. corpus or corpora
• Effect: this link will display the list of corpora.

sldr.org/res*/lg

• Explanation: res* is any word in lower-case characters with 'res' as its prefix, eg. ressources or resource
• Effect: this link will display the list of resources.

sldr.org/outil*/lg
sldr.org/tool*/lg

• Explanation: outil* is any word in lower-case characters with 'outil' as its prefix, eg. outils. tool* is any word in lower-case characters with 'tool' as its prefix, eg. tools.
• Effect: this link will display the list of tools.

sldr.org/col*/lg

• Explanation: col* is any word in lower-case characters with 'col' as its prefix, eg. collections or colecciones
• Effect: this link will display the list of collections.