Paramétrage applicatif (v1.6)

Nouveaux paramètres

Vous trouverez ici tous les nouveaux paramètres pour la version 1.6.0 :

Licence Calcium

Informations concernant la licence de Calcium, voir Gestion de la licence Calcium pour en savoir plus.

calcium:
  licence:
    # Chemin du fichier .lic déposé sur le serveur Tomcat de l'établissement, à demander à l'équipe Calcium
    path: "chemin/vers/calcium.lic"

Envoi de SMS

Ces paramètres sont facultatifs. L’application se lancera si ceux-ci ne sont pas présents ou renseignés.

Général

Informations globales sur l’envoi de SMS

sms:
  # Adresse mail qui recevra le récapitulatif journalier des sms envoyés
  recap:
    mail:
  # numéro de téléphone de test, utilisé si 'param.test' à true
  test:
    numero:

OVH

Si votre établissement utilise le service d’envoi de SMS de OVH :

sms:
    # utilisation d'OVH
  ovh:
    # Adresse mail validé par OVH
    from:
    destinataire: email2sms@ovh.net
    # Compte SMS à utiliser (ex : sms-xx11111-1)
    compte:
    # Utilisateur SMS à utiliser sur le compte associé
    utilisateur:
    # Mot de passe de l'utilisateur
    motdepasse:
    # Un des expéditeurs déclarés sur votre compte SMS
    expediteur:
    # Paramètre optionnel, séparés par ":" : cf https://help.ovhcloud.com/csm/fr-sms-sending-from-email-address?id=kb_article_view&sysparm_article=KB0051386#etape-2-ajouter-des-champs-facultatifs
    options: "NoStop=1"

Mail

Si votre établissement utilise un service d’envoi de SMS via l’envoi d’un mail

sms:
    mail:
    # adresse mail du service d'envoi de sms (vide si non utilisé)
    to:
    # adresse mail de l'expéditeur, lié au service d'envoi de sms (vide si non utilisé)
    from:

ESUP

Si votre établissement utilise le service d’envoi de SMS via ESUP-SMS

sms:
    esup:
    # URL de l'API ESUP-SMS
    url: https://sms.univ.fr/esup-sms/rest/
    # authentification à l'API ESUP-SMS (vide si non utilisé)
    username:
    password:

Calcium PRdV

Secret partagé (RAPPEL)

Il faut que le secret soit identique à celui que vous allez rentrer dans le fichier application.yml de votre serveur Calcium ! (cf Paramétrage applicatif PRdV)

Exemple de génération de la clé :

 openssl rand -base64 32

prdv:
  secret: votreSecret

Dépôt de document des étudiants

Chemin vers le dossier contenant les documents que les étudiants pourront déposer depuis la plateforme PRdV

# Dépôt de documents PDF par les étudiants via Calcium PRdv (répertoire dédié, distinct de document.path)
depot:
   path: /path/vers/dossier/depots

Date bascule vers agenda v2

Défini la date à partir de laquelle il ne sera plus possible de prendre des rendez-vous sur l’ancien planning

prdv:
     # Gel anticipé (bascule agenda v2) : plus aucune prise de RDV dans l'ancien planning
     # à partir de cette date (format yyyy-MM-dd). Vide ou absent = pas de gel.
   # date-gel: 2026-09-01

Bascule de l’API PRdV vers agenda v2

Pour que Calcium PRdV puisse récupérer les informations du nouvel agenda

prdv:
     # Bascule agenda v2 : true = PRdv utilise agenda v2 pour la prise de rendez-vous
   # v2:
   #    actif: false

Sécurisation de la communication Calcium <-> PRdV

En lien avec la configuration de PRdV : Connexion sécurisée avec Calcium

Calcium Scan

Une nouvelle version de Calcium Scan est disponible.

Afin de renforcer la sécurité de communication entre Calcium et Calcium Scan, un secret est à définir. Ce secret sera à définir dans les variables d’environnement des postes utilisateurs ayant installés Calcium Scan, cf Installation de Calcium Scan – Pour une version >= 1.6.0

Exemple de génération de la clé :

 openssl rand -base64 32

# Calcium Scan (secret partagé avec l'application installée sur les postes)
scan:
   secret: votreSecretScan

Envoi de notification sur l’application mobile

Si votre établissement utilise l’application mobile esup-multi, vous pouvez ajouter ces paramètres afin que Calcium puisse envoyer des notifications mobiles, pour les convocations et les rendez-vous, depuis cette application.

Vous pourrez alors paramétrer l’envoi pour les convocation et/ou les rendez-vous depuis la vue des Paramètres.

# notification appli mobile
notif:
  # URL de l'API de notification
  api:
  # Clé JWT pour l'authentification auprès de l'API
  jwt:
  # application qui demande l'envoi des notifications
  channel:
  # uid de l'expediteur des notifications
  sender:
    uid:
  # uid TEST, recevra la notification si 'param.test' à true
  test:

Divers

Ces paramètre doivent êtres présents, mais sans valeurs

ragul-chatbot:
  target-url:
  target-key:
  src-url:
  proxy-url: 
  slug: 
  customization:
    app-url:
    primary-color:
    enable-fullscreen:
    always-fullscreen:
    auto-open:
    enable-download:
    secure-urls:
    avatar:
    avatar-header:

Fichier application.yml

Tous les paramètres de lancement et de configuration de Calcium se situent dans le fichier application.example.yml

Vous devez renommer ce fichier en application.yml et remplir les différents paramètres.

URL de l’application

app:
   url: https://calcium.univ.fr

Proxy

Si vous utilisez un proxy pour votre application, sinon vous pouvez laisser vide.

proxy:
   host:
   port:

CAS

Si vous n’utilisez pas le CAS, vous pouvez laisser le champ vide. Cela n’affichera que la connexion locale lors de la connexion d’un utilisateur.

cas:
   # URL du CAS
   url: https://auth.univ.fr

URL

URLs liés à la documentation et au support, à ne pas modifier.

url:
    # URL de la documentation
    doc: https://calcium.univ-lorraine.fr
    # URL mail de l'assistance
    help: mailto:calcium-support@univ-lorraine.fr

Spring – Base de données et envoi de mail

Informations concernant votre connexion à votre base de données (url, username et password), ainsi que la configuration pour l’envoi de mail (from, host et port)

Si votre timezone n’est pas Europe/Paris, il faut alors le modifier l’option ‘serverTimezone‘ de l’url de votre base de données.

spring:
    # Base de donnees
    datasource:
        url: jdbc:mysql://localhost:3306/calcium?serverTimezone=Europe/Paris
        username: user
        password: xxxx
    # Mails
    mail:
        from: noreply.calcium@univ-lorraine.fr
        host: smtp-test.sig.univ.fr
        port: 25

Si vous utilisez un SMTP authentifié, il faudra rajouter ces paramètres :

spring:
    mail:
        from: noreply.calcium@univ-lorraine.fr
        host: smtp-test.sig.univ.fr
        port: 25
        username: login
        password: password
        properties:
            mail:
                smtp:
                    auth: true
                    starttls:
                        enable: true

Logs

Localisation des fichiers de logs, ainsi que le mail qui reçoit les logs d’erreurs. Veuillez vous assurer que le chemin renseigné ai les mêmes droits que le serveur !

logging:
    file:
        path: target/logs
    mail:
        to: dev-log@univ.fr

Propriétés CALCIUM

Clé de chiffrement

Propre à votre établissement, elle doit être basée sur 16 caractères alpha numériques sans caractères spéciaux (accent, …)

encryption:
   key: 1234567890123456

Université

Nom de votre université. Ce nom sera notamment utilisé lors d’envoi de mail de convocation.

L’année renseignée sera utilisé lors de la création manuel d’un dossier médical étudiant. C’est cette année qui sera utilisée comme année d’inscription de sa scolarité.

univ:
   nom: Université
   # Annee universitaire d'inscription (exemple : 2022 pour 2022-2023)
   annee-inscription: 20XX

Batch

Vérification des processus à lancer tous les X millisecondes (600000ms = 10min). Pas de nécessité à modifier ce paramètre sauf indication de notre part.

batch:
   fixedRate: 600000

Import scolarité

Contient le mail qui recevra le rapport des importations, le nom du fichier contenant les informations de scolarité, ainsi que le chemin du répertoire du fichier précédent

import:
   rapport: dev@univ.fr
   fichier: Calcium.csv
   repertoire: /repertoire/IMPORT

Relances

Mail qui recevra les mails de rapports de relance

relance:
    rapport: utilisateur@univ.fr

Modèle, Document et Archive

Chemin vers le dossier contenant les modèles d’impression. Ce dossier contiendra des documents de type Word, utilisés pour l’impression des documents (ordonnances, certificats…). Cf Gestion des modèles.

Chemin vers le dossier contenant les documents médicaux. Ce dossier contiendra des documents médicaux chiffrés.

Chemin vers le dossier des archives et rapport d’archivage. Ce dossier contiendra les dossiers médicaux archivés des étudiants si l’action a été faite depuis l’application.

modeles:
   path: /path/vers/dossier/modeles
document:
   path: /path/vers/dossier/documents
archives:
   path: /path/vers/dossier/archives

PRdV

Paramètres liés à l’application satellite de prise de rendez-vous en ligne.

Si vous n’utilisez pas cette application, le témoin en-service doit être mis à false.

Si vous utilisez cette application, le témoin sera à true. Le paramètre role ne doit pas changer, mais le secret doit être exactement le même que celui renseigné dans l’application PRdV.

prdv:
   en-service: true
   role: calcium-prdv
   secret: votreSecret

BCB – Banque Claude Bernard

Paramétrages liés à la Banque de données Claude Bernard. Si votre service de santé à un abonnement, il faut renseigner le paramètre code_editeur ainsi que le paramètre id_ps que la BCB vous a fourni.

Si vous avez un abonnement, il faudra préciser UNIV-LORRAINE dans le champ code_editeur

bcb:
  code_editeur:
  id_ps:

VIDAL

Paramétrages liés au dictionnaire médicale VIDAL. Si votre service de santé à un abonnement, il faut renseigner le paramètre app_id ainsi que le paramètre app_key que VIDAL vous a fourni.

vidal:
  app_id:
  app_key:

Divers

Sur votre instance de test, le témoin test est à mettre à true. Ainsi, les mails qui sont normalement envoyés à l’étudiant (convocation, …) seront envoyés à l’adresse mail renseigné dans le paramètre mail.test.

Sur le paramétrage dashboard, le paramètre id est fourni par l’équipe Calcium afin que nous puissions avoir un retour de vos installations. Nous ne récupérons que le nom de l’université, si c’est en test ou non et le numéro de version actuel.

param:
   test: true
   mail:
      test: dev@univ.fr
   dashboard:
      # - ID Calcium (a demander a calcium-contact si vous ne l'avez pas)
      id:
      # - cle API (ne pas modifier pour l'instant)
      api: 8469e00f-cfbf-4059-9f3f-bf708873772d
      # - cle secrete (ne pas modifier pour l'instant)
      secret: xxx

Ces paramètre doivent êtres présents, mais sans valeurs

ragul-chatbot:
  target-url:
  target-key:
  src-url:
  proxy-url: 
  slug: 
  customization:
    app-url:
    primary-color:
    enable-fullscreen:
    always-fullscreen:
    auto-open:
    enable-download:
    secure-urls:
    avatar:
    avatar-header:

Fichier exemple

# =====================
# APPLICATION & LICENCE
# =====================
app:
  # URL de l'application
  url: http://localhost.univ.fr:8080

# Université
univ:
  nom: Université
  annee-inscription: 20XX

calcium:
  licence:
    # Chemin du fichier .lic déposé sur le serveur Tomcat de l'établissement — à demander à l'équipe Calcium
    path: "${catalina.home}/conf/calcium.lic"

logging:
  file:
    path: target/logs
  mail:
    to: dev-log@univ.fr

# =====================
# DONNÉES & SÉCURITÉ
# =====================
spring:
  datasource:
    url: jdbc:mariadb://localhost:3306/calcium?serverTimezone=Europe/Paris
    username: root
    password:
  mail:
    from: noreply.blank@univ.fr
    host: smtp-test.sig.univ.fr
    port: 1025

encryption:
  # Clé de chiffrement propre à votre établissement
  key: 1234567890123456
  
# =====================
# AUTHENTIFICATION & ACCÈS
# =====================
cas:
  # URL du CAS
  # Si vous n'utilisez pas le CAS, laisser tel quel
  url: https://auth.univ.fr

proxy:
  host:
  port:

# Secret partagé avec l'application installée sur les postes
# Cette clé doit être reprise lors de l'installation de Calcium Scan sur les postes
# exemple pour générer la clé : 'openssl rand -base64 32'
scan:
  secret:

# =====================
# COMMUNICATION
# =====================
# Notification appli mobile
notif:
  # URL de l'API de notification
  api:
  # Clé JWT pour l'authentification auprès de l'API
  jwt:
  # application qui demande l'envoi des notifications
  channel:
  # uid de l'expediteur des notifications
  sender:
    uid:
  # uid TEST, recevra la notification si 'param.test' à true
  test:

# Envoi de sms
sms:
  # Adresse mail qui recevra le recapitulatif journalier des sms envoyés
  recap:
    mail:
  # numéro de téléphone de test, utilisé si 'param.test' à true
  test:
    numero:
  # Utilisation du service d'envoi de sms via OVH
  ovh:
    # Adresse mail validé par OVH
    from:
    destinataire: email2sms@ovh.net
    # Compte SMS à utiliser (ex : sms-xx11111-1)
    compte:
    # Utilisateur SMS à utiliser sur le compte associé
    utilisateur:
    # Mot de passe de l'utilisateur
    motdepasse:
    # Un des expéditeurs déclarés sur votre compte SMS
    expediteur:
    # Paramètre optionnel, séparés par ":" : cf https://help.ovhcloud.com/csm/fr-sms-sending-from-email-address?id=kb_article_view&sysparm_article=KB0051386#etape-2-ajouter-des-champs-facultatifs
    options: "NoStop=1"
  mail:
    # adresse mail du service d'envoi de sms (vide si non utilisé)
    to:
    # adresse mail de l'expéditeur, lié au service d'envoi de sms (vide si non utilisé)
    from:
  # Utilisation du service d'envoi de sms via l'API ESUP-SMS
  esup:
    # URL de l'API ESUP-SMS
    url: https://sms.univ.fr/esup-sms/rest/
    # authentification à l'API ESUP-SMS (vide si non utilisé)
    username:
    password:

# =====================
# LOGIQUE MÉTIER
# =====================
batch:
  # Vérification des batchs à lancer tous les x millisecondes (600000ms = 10min)
  fixedRate: 600000

param:
  # - Bandeau "TEST" en rouge
  test: true
  # - redirection mail de étudiant vers 'mail.test' si 'test' à true
  mail:
    test: dev@univ.fr
  dashboard:
    # - ID Calcium (a demander a calcium-contact)
    id:
    # - cle API (ne pas modifier pour l'instant)
    api: 8469e00f-cfbf-4059-9f3f-bf708873772d
    # - cle secrete (ne pas modifier pour l'instant)
    secret: xxx

# Calcium PRdV
prdv:
  en-service: true
  role: calcium-prdv
  # Sécurisation des tokens JWT
  secret: votreSecret
  # Gel anticipé (bascule agenda v2) : plus aucune prise de RDV dans l'ancien planning
  # à partir de cette date (format yyyy-MM-dd). Vide ou absent = pas de gel.
  # date-gel: 2026-09-01
  # Bascule agenda v2 : true = PRdv utilise l'API v2
  # v2:
  #    actif: false

# Import scolarité
import:
  # mail qui recevra le rapport des importations
  rapport: dev@univ.fr
  # nom du fichier contenant les informations de scolarité
  fichier: Calcium.csv
  # chemin du répertoire du fichier précédent
  repertoire: /repertoire/IMPORT

# Relances
relance:
  # mail qui recevra les mails de rapports
  rapport: utilisateur@univ.fr

# =====================
# FICHIERS & STOCKAGE
# =====================
modeles:
  path: /path/vers/dossier/modeles
document:
  path: /path/vers/dossier/documents
archives:
  path: /path/vers/dossier/archives
# Dépôt de documents PDF par les étudiants via Calcium PRdv (répertoire dédié, distinct de document.path)
depot:
  path: /path/vers/dossier/depots
  # taille max d'un PDF déposé en Mo (défaut 10 ; doit rester <= spring.servlet.multipart.max-file-size, 20MB)
  # max-size-mb: 10
  # nombre max de dépôts en attente de validation par étudiant (défaut 5)
  # max-en-attente: 5

# =====================
# APIs EXTERNES
# =====================
vidal:
  path: http://api.vidal.fr/rest/api/
  app_id:
  app_key:

bcb:
  code_editeur:
  id_ps:

# =====================
# INFORMATIONS & OPTIONNEL
# =====================
url:
  # URL de la documentation
  doc: https://calcium.univ-lorraine.fr/
  # URL de l'assistance (facultative, commenter pour désactiver)
  help: mailto:calcium-support@univ-lorraine.fr
 
ragul-chatbot:
  target-url:
  target-key:
  src-url:
  proxy-url: 
  slug: 
  customization:
    app-url:
    primary-color:
    enable-fullscreen:
    always-fullscreen:
    auto-open:
    enable-download:
    secure-urls:
    avatar:
    avatar-header: