Commit 8ef4bb57 authored by Bertrand Gauthier's avatar Bertrand Gauthier
Browse files

Correction doc.

parent 5b771e42
Loading
Loading
Loading
Loading
+5 −5
Original line number Diff line number Diff line
@@ -225,7 +225,7 @@ depuis l'interface graphique.



## En lignes de commande 
## En ligne de commande 

### Import de données

@@ -235,7 +235,7 @@ Ce qui suit n'est possible que si le web service d'import de données est instal
reportez-vous au projet `sygal-import-ws` [sur github.com/EsupPortail](https://github.com/EsupPortail/sygal-import-ws)
ou [sur git.unicaen.fr](https://git.unicaen.fr/open-source/sygal-import-ws).

#### Lancement de l'import des données
#### Lancement de l'import

Il s'agit de l'interrogation du web service pour remplir les tables temporaires TMP_*.

@@ -244,7 +244,7 @@ Il s'agit de l'interrogation du web service pour remplir les tables temporaires
*NB: `UCN` doit être remplacé par le code établissement choisi lors
de la création de votre établissement dans la base de données (dans le script `05-init.sql`).*

#### Lancement de la synchro à partir des données importées 
#### Lancement de la synchro 

Il s'agit de la synchronisation des tables définitives de travail de l'application avec les tables TMP_* 
contenant les données déjà importées.
@@ -256,9 +256,9 @@ Pour plus de détails, vous pouvez vous reporter à la documentation sur les [li
Une fois la synchro effectuée, vous devriez voir des thèses apparaître en cliquant sur le menu "Thèses" de 
l'application.

#### Lancement de l'import et de la synchro
#### Lancement des 2

Pour lancer l'interrogation du web service puis la synchronisation des tables définitives de travail, faites :
Pour lancer l'interrogation du web service *puis* la synchronisation des tables définitives de travail, faites :

    php public/index.php import-all --etablissement=UCN --synchronize=1 --breakOnServiceNotFound=0
    
+1 −1
Original line number Diff line number Diff line
@@ -7,7 +7,7 @@
-- Remplacez "Unicaen"                      par l'intitulé court de votre établissement (ex: "UTLN").
-- Remplacez "Université de Caen Normandie" par l'intitulé long de votre établissement (ex: "Université de Toulon").
--
-- Faites-le avec sed !
-- Faites-le avec sed, ex :
--    cat 05-init.sql | sed "s/'UCN/\'UTLN\'/g" | sed "s/Unicaen/UTLN/g" | sed "s/Caen Normandie/Toulon/g" > 04-init-utln.sql
--

+19 −23
Original line number Diff line number Diff line
# Création de la base de données

Création de la base de données
==============================

Au préalable, charge à vous de créer une base de données Oracle vide quelque part. 
Ou pourquoi pas 2 bases de données : une base de PROD (ex: `SYGAL_PROD`) et une base de TEST (ex: `SYGAL_TEST`).
Voire même une 3e si vous envisagez de collaborer au développement (ex: `SYGAL_DEV`) !


## Script SQL [`00-oracle-generate-schema-SYGAL.sql`](00-oracle-generate-schema-SYGAL.sql)
## Création des objets de la base de données

Script [`00-oracle-generate-schema-SYGAL.sql`](00-oracle-generate-schema-SYGAL.sql)
 
Vous pouvez lancer ce script sans modifier quoi que ce soit.

@@ -14,11 +16,13 @@ Si l'erreur Oracle `ORA-00922: option erronée ou absente` est rencontrée,
c'est que `SET SQLBLANKLINES ON;` n'est pas compris par le client SQL que vous utilisez. 
Supprimez cette première ligne et relancez le script.

## Script SQL [`01-bootstrap.sql`](01-bootstrap.sql)
## Insertion des données de base

- Script [`01-bootstrap.sql`](01-bootstrap.sql)

Vous pouvez lancer ce script sans modifier quoi que ce soit.

## Scripts SQL dans le répertoire [`02-inserts`](02-inserts)
- Scripts du répertoire [`02-inserts`](02-inserts)

Vous pouvez lancer ces scripts sans les modifier et dans l'ordre que vous voulez puisque les contraintes de références
entre tables ne sont pas encore créées.
@@ -27,29 +31,21 @@ Si l'erreur Oracle `ORA-00922: option erronée ou absente` est rencontrée à la
c'est que `set define off ;` n'est pas supporté par le client SQL que vous utilisez. 
Si cette erreur a bloqué les INSERT situés après, supprimez cette ligne et relancez le script.

## Script SQL [`03-oracle-generate-ref-constraints-SYGAL.sql`](03-oracle-generate-ref-constraints-SYGAL.sql)

Vous pouvez lancer ce script sans modifier quoi que ce soit.
## Création des contraintes de référence 

## Script SQL [`04-crea-comue.sql`](04-crea-comue.sql)
Script [`03-oracle-generate-ref-constraints-SYGAL.sql`](03-oracle-generate-ref-constraints-SYGAL.sql)

Lisez ce script pour décider si vous devez l'utiliser.

## Script SQL [`05-init.sql`](05-init.sql)
Vous pouvez lancer ce script sans modifier quoi que ce soit.

Vous devez adapter ce script avant de le lancer :
## Création éventuelle d'une COMUE

- Remplacez `'Unicaen'` par le sigle ou raccourci de votre établissement, 
  ex 'URN', 'Unilim'.
Script [`04-crea-comue.sql`](04-crea-comue.sql)

- Remplacez `'Université de Caen Normandie'` par le nom complet de votre étblissement, 
  ex: 'Université de Rouen Normandie', 'Université de Limoges'
Lisez ce script pour décider si vous devez l'utiliser.

- Décidez d'un code identifiant votre établissement dans l'application, ex: 'UCN', 'UNILIM'.
## Insertion des données de base (suite et fin)

  Si vous préférez ou si votre client SQL ne supporte pas l'utilisation de paramètre du genre :codeEtablissement, 
  remplacez dans ce script toutes les occurences de ":codeEtablissement" par le code choisi *entre apostrophe*, 
  ex: `'UCN'`. Si votre client SQL supporte les motifs du genre :codeEtablissement, il vous demandera de saisir 
  une valeur pour ce paramètre lorsque vous lancerez le script : entrez le code choisi *entre apostrophe*.
Script [`05-init.sql`](05-init.sql)

Une fois ces adaptations faites, vous pouvez lancer le script.
Vous devez adapter ce script avant de le lancer, lisez bien les commentaires en début de script. 
Une fois ces adaptations faites, vous pourrez lancer le script.