diff --git a/SOAP/README.md b/SOAP/README.md index 2f0be49..cf51a4b 100644 --- a/SOAP/README.md +++ b/SOAP/README.md @@ -33,16 +33,16 @@ ### Usage ```bash - WosConnect.sh -u utilisateur [ -c cookies.txt ] + WosConnect.sh -u utilisateur [ -j cookie_jar ] WosConnect.sh -h ``` ### Options ```txt - -c indique le nom du fichier qui recevra les cookies (“cookies.txt” - par défaut) -h affiche cette aide + -j indique le nom du fichier qui recevra les cookies (“cookies.txt” + par défaut) -u indique le nom de l’utilisateur (login). ``` @@ -58,7 +58,7 @@ ```bash WosQuery.sh -s sid -q requête [ -p (début:fin|[124]week) ] [ -b [WOS:]base ]* [ -f champs ]* [ -t CH:[AD] ] - [ -n notices ] [ -c cookies.txt ] [ -i ] + [ -n notices ] [ -j cookie_jar ] [ -i ] WosQuery.sh -h ``` @@ -81,12 +81,12 @@ -b limite la recherche à une ou plusieurs bases (e.g. “WOS:SCI”). Cette option est répétitive et “WOS:” est facultatif (par défaut, la recherche se fait sur l’ensemble du WoS) - -c indique le nom du fichier qui recevra les cookies (“cookies.txt” - par défaut) -f limite les champs présents dans les notices téléchargées. Cette option est répétitive (par défaut, tous les champs sont présents) -i ajoute dans la réponse de l’API la liste des identifiants WoS des notices retournées (5 par défaut ou valeur de l’option “-n”) + -j indique le nom du fichier qui recevra les cookies (“cookies.txt” + par défaut) -n indique le nombre de notices, entre 1 et 100, à retourner (5 par défaut) -t trie les résultats sur un champ (nom abrégé à 2 majuscules) de @@ -109,20 +109,25 @@ ```bash WosRetrieve.sh -s sid -q queryId -n nb_notices -r résultat - [ -o offset ] [ -t taille ] [ -c cookies.txt ] + [ -f champs ]* [ -t CH:(A|D) ] [ -i ] + [ -o offset ] [ -T taille ] [ -j cookie_jar ] WosRetrieve.sh -h ``` ### Options ```txt - -c indique le nom du fichier qui recevra les cookies (“cookies.txt” - par défaut) + -f limite les champs présents dans les notices téléchargées. Cette + option est répétitive (par défaut, tous les champs sont présents) -h affiche cette aide - -n indique le nombre total de notices WoS à télécharger (la valeur - maximale est donnée par le programme envoyant la requête à l’API - WoS) - -o indique à partir de quel numéro (offset) on veut télécharger les + -i ajoute dans la réponse de l’API la liste des identifiants WoS des + notices retournées (5 par défaut ou valeur de l’option “-n”) + -j indique le nom du fichier qui recevra les cookies (“cookies.txt” + par défaut) + -n indique le nombre total de notices WoS à télécharger (la valeur + maximale est donnée par le programme envoyant la requête à l’API + WoS) + -o indique à partir de quel numéro (offset), on veut télécharger les notices, en particulier pour reprendre un téléchargement après un problème de connexion (1 par défaut) -q indique le numéro de la requête “queryId” dont on veut télécharger @@ -131,8 +136,10 @@ le tiret “-” comme argument de l’option) -s indique le jeton d’authentification “SID” obtenu avec le programme d’authentification à l'API WoS - -t indique le nombre de notices (entre 1 et 100) à télécharger à chaque - itération (100 par défaut) + -t trie les résultats sur un champ (nom abrégé à 2 majuscules) de + façon croissante (A) ou décroissante (D) ou par pertinence (RS) + -T indique le nombre de notices à télécharger à chaque itération + (100 par défaut) ``` @@ -144,9 +151,8 @@ ### Usage ```bash - WosSearchByDoi.sh -s sid -d (fichier|-) -r (résultats|-) - [ -p (début:fin|[124]week) ] [ -b [WOS:]base ]* - [ -f champs ]* [ -c cookies ] [ -i ] + WosSearchByDoi.sh -s sid -d (fichier|-) -r (résultats|-) [ -f champs ]* + [ -T taille ] [ -j cookie_jar ] [ -i ] WosSearchByDoi.sh -h ``` @@ -157,31 +163,27 @@ a un tiret “-” en argument, la liste de DOIs est lue sur l’entrée standard -h affiche cette aide - -p limite la recherche dans la base de données à la période indiquée - sous forme aaaa-mm-jj:aaaa-mm-jj (e.g., “2000-01-01:2020-07-31”) - ou sous forme “1week”, “2week” ou “4week” -r indique le nom du fichier résultat (pour la sortie standard, utiliser le tiret “-” comme argument de l’option) -s indique le jeton d’authentification “SID” obtenu avec le programme d‘authentification à l‘API WoS + -T indique le nombre de notices à télécharger à chaque itération + (100 par défaut) ``` #### Autres options ```txt - -b limite la recherche à une ou plusieurs bases (e.g. “WOS:SCI”). - Cette option est répétitive et “WOS:” est facultatif (par défaut, - la recherche se fait sur l’ensemble du WoS) - -c indique le nom du fichier qui recevra les cookies (“cookies.txt” - par défaut) -f limite les champs présents dans les notices téléchargées. Cette option est répétitive (par défaut, tous les champs sont présents) -i ajoute dans la réponse de l’API la liste des identifiants WoS des notices retournées à chaque itération + -j indique le nom du fichier qui recevra les cookies (“cookies.txt” + par défaut) ``` -## WosClose +## WosClose.sh Ce script permet de terminer une session d’interrogation de l’API WoS, après une ou plusieurs itérations de reqêtes et de téléchargements. À noter que l’identifiant de session (*SID*) a une durée de vie limitée, donc, la session s’arrêtera de toute façon. @@ -189,16 +191,16 @@ ### Usage ```bash - WosClose.sh -s sid [ -c cookies.txt ] + WosClose.sh -s sid [ -j cookie_jar ] WosClose.sh -h ``` ### Options ```txt - -c indique le nom du fichier qui recevra les cookies (“cookies.txt” - par défaut) -h affiche cette aide + -j indique le nom du fichier qui recevra les cookies (“cookies.txt” + par défaut) -s indique le jeton d’authentification “SID” obtenu avec le programme d’authentification à l'API WoS ```