openCourrier 4.1 documentation¶

Note

Cette création est mise à disposition selon le Contrat Paternité-Partage des Conditions Initiales à l’Identique 2.0 France disponible en ligne http://creativecommons.org/licenses/by-sa/2.0/fr/ ou par courrier postal à Creative Commons, 171 Second Street, Suite 300, San Francisco, California 94105, USA.

openCourrier est un logiciel de gestion de courrier entrant et sortant dans une organisation. Il est conçu pour traiter simplement l’arrivée et le départ de courrier sans se substituer aux traitements existants dans les logiciels « métier » (factures, demande d’emploi, autorisation d’urbanisme, …). Il répond à un besoin de gestion de courrier centralisée avec un suivi de la relation citoyen (gestion de tâches) dans une organisation ayant un organigramme de traitement de courrier assez plat avec de nombreux métiers comme les mairies (organigramme en rateau). De ce fait, il ne gère qu’une seule numérotation de registre de départ et d’arrivée. (Il existe sur la forge de l’adullact d’autre logiciel libre de courrier pouvant gérer une multiplicité de registre de départ et d’arrivée).

Ce document a pour but de guider les utilisateurs et les développeurs dans la prise en main du projet.

Bonne lecture et n’hésitez pas à nous faire part de vos remarques à l’adresse suivante : contact@openmairie.org !

Manuel de l’utilisateur¶

Préambule¶

openCourrier est un logiciel qui permet de :

gérer le courrier entrant/sortant dans une organisation.
lier des courriers entre eux.
affecter un courrier à UN service de traitement.
associer des documents (courriers numérisés, courriers départ, rapport d’intervention) pour constituer un dossier depuis un courrier.
numériser le courrier arrivé (à la volée dans un répertoire) et en l’associant à un numéro de registre inscrit automatiquement sur le courrier scanné.
associer le courrier numérisé à la volée dans un répertoire en lui inscrivant le numéro de registre et en l’associant au dossier du courrier.
affecter une ou plusieurs tâches à des services (notification de ces services par email) dépendant ou non du service de traitement : les tâches peuvent ainsi être suivies jusqu’à ce qu’elles soient soldées par les services.

Ergonomie ¶

Cette partie vise à présenter l’ergonomie du logiciel c’est-à-dire à décrire la connexion à l’application, la structure de l’application, la navigation et l’utilisation du menu, ainsi que la présentation et la description des principaux icônes. Cette rubrique peut s’appliquer à toute application métier développée avec OpenMairie.

Sommaire

Connexion, déconnexion et permissions ¶

Connexion ¶

Note

Pour réaliser cette étape, votre administrateur doit vous fournir une adresse Web pour accéder à l’application, un identifiant utilisateur ainsi qu’un mot de passe. Ces éléments auront été préalablement configuré dans le logiciel.

Navigateur Web ¶

L’application est accessible via un navigateur Web, pour y accéder il faut saisir l’adresse Web fournie par votre administrateur dans la barre d’adresse.

_images/opencourrier--ergonomie-navigateur.png

Note

Ce logiciel est développé principalement sous le navigateur Mozilla Firefox, il est donc conseillé d’utiliser ce navigateur pour une efficacité optimale.

Saisie des informations de connexion ¶

Cet écran de connexion est composé de deux zones de texte et d’un bouton.

_images/opencourrier--ergonomie-formulaire-connexion.png

Dans l’écran d’identification, il faut saisir son identifiant et son mot de passe puis cliquer sur le bouton « Se connecter ».

Note

L’identifiant et le mot de passe doivent être saisis en respectant la casse, c’est-à-dire les minuscules et majuscules.

Connexion échouée ¶

Si les identifiants saisis sont incorrects, un message d’erreur apparaît et il faut ressaisir les informations de connexion.

_images/opencourrier--ergonomie-connexion-message-erreur.png

Connexion réussie ¶

Si les identifiants sont corrects, vous êtes redirigé vers la page demandée sur laquelle le message suivant doit d’afficher.

_images/opencourrier--ergonomie-connexion-message-ok.png

Déconnexion ¶

Pour une question de sécurité évidente, il est important de se déconnecter de l’application pour qu’un autre utilisateur ne puisse pas accéder au logiciel via votre compte utilisateur.

L’action « Déconnexion » est disponible à tout moment dans les actions personnelles en haut à droite de l’écran.

_images/opencourrier--ergonomie-deconnexion-action.png

Une fois déconnecté, c’est le formulaire de donnexion qui s’affiche avec un message expliquant la réussite de la déconnexion.

_images/opencourrier--ergonomie-deconnexion-message-ok.png

Les droits et profils des utilisateurs ¶

Les droits et profils des utilisateurs permettent de limiter l’accès aux informations et aux actions uniquement aux personnes autorisées. Chaque utilisateur est associé à un profil. Le profil correspond à un ensemble de permissions de l’utilisateur. Les profils sont hiérarchiques et listés de façon croissante, c’est à dire que les permissions d’un profil son valable pour les suivants, par défaut il existe cinq profils :

Consultation :

peut visualiser les courriers arrivées/départs, les courriers archivés et les tâches non soldées de son service, ainsi que les courriers recherchés de chaque service.
Utilisateur limité :

peut modifier les tâches non soldées de son service.
Utilisateur :

peut ajouter ou modifier les courriers arrivées/départs de son service et les objets liés à celui-ci. Il peut aussi paramétrer l’application : ajouter/modifier/supprimer les émetteurs/destinataires, la bible, les civilités, les types de correspondants et les courriers types.
Super utilisateur :

peut faire les traitements concernant le registre et l’archivage, les exports des éditions et des requêtes mémorisées, le paramétrage des services, des états, des sous-états et des lettres type.
Administrateur :

peut paramétrer les collectivités, les paramètres de l’application, les profils, les droits, les utilisateurs, les widgets, importer des tables et utiliser le générateur.

Chaque page de l’application est associée à un profil. Pour chaque accès à une page, l’application vérifie si l’utilisateur a un profil supérieur ou égal au profil de la page consultée, si c’est le cas l’utilisateur à donc le droit d’accéder aux informations.

Les profils ainsi que leurs permissions associées sont modifiables par l’administrateur.

Ergonomie générale ¶

L’application, sur la grande majorité des écrans, conserve ses composants disposés exactement au même endroit. Nous allons décrire ici le fonctionnement et l’objectif de chacun de ces composants. Cette structuration de l’application permet donc à l’utilisateur de toujours trouver les outils au même endroit et de se repérer rapidement.

_images/opencourrier--ergonomie-generale-detail.png

Note

Les actions et affichages de l’application diffèrent en fonction du profil de l’utilisateur. Il se peut donc que dans les paragraphes qui suivent des actions soient décrites et n’apparaissent pas sur votre interface ou inversement que des actions ne soient pas décrites mais apparaissent sur votre interface.

Le logo ¶

C’est le logo de l’application, il vous permet en un seul clic de revenir rapidement au tableau de bord.

Les actions personnelles ¶

Cet élément affiche plusieurs informations importantes.

La première information est l’identifiant de l’utilisateur actuellement connecté ce qui permet de savoir à tout moment si nous sommes bien connectés et avec quel utilisateur. Ensuite est noté le nom de la collectivité sur laquelle nous sommes en train de travailler. En mode multi, une action est disponible sur cette information pour permettre de changer de collectivité. Ensuite la liste sur laquelle nous sommes en train de travailler, une action est disponible sur cette information pour permettre de changer de liste. Enfin l’action pour permettre de changer de mot de passe et pour se déconnecter sont disponibles en permanence.

Les raccourcis ¶

Cet élément permet d’afficher des raccourcis vers des écrans auxquels nous avons besoin d’accéder très souvent. Par exemple, ici nous avons un raccourci direct vers le tableau de bord.

Les actions globales ¶

Cet élément permet d’afficher en permanence le numéro de version du logiciel. Ensuite les différentes actions sont des liens vers le site officiel du logiciel ou vers la documentation.

Ergonomie des formulaires ¶

De manière générale, il y a une règle simple dans les applicatifs openMairie : on accède d’abord à un listing d’éléments puis depuis ce listing on peut ajouter un nouvel élément ou modifier un élément existant en accédant au formulaire dédié à cet élément.

Les listings ¶

Un listing est un tableau qui liste des éléments récapitulant des informations permettant d’identifier un élément parmi les autres.

_images/opencourrier--ergonomie-listing.png

Les actions ¶

En haut à gauche ¶

Ajouter : cette action représentée par un plus permet d’accéder au formulaire de création d’un élément.
Autre : il peut y avoir d’autres actions positionnées ici qui représentent des actions que l’on peut faire sur un lot d’éléments par exemple.

A gauche devant chaque élément ¶

Modifier : cette action permet d’accéder au formulaire de modification d’un élément.
Supprimer : cette action permet d’accéder au formulaire de suppression d’un élément.
Autre : il peut y avoir d’autres actions positionnées ici qui permettent d’effectuer des actions rapides sur l’élément.

Sur l’élément ¶

Modifier : cette action permet d’accéder au formulaire de modification d’un élément.

Divers ¶

Afficher les éléments expirés : sur les élements qui possèdent une date de validité, par défaut les éléments qui sont dans le passé n’apparaissent pas, il est nécessaire de cliquer sur cette action pour les faire apparaître. L’action se situe au dessus du tableau.
Imprimer le listing en PDF : sur les éléments pour lesquels l’édition existe une action représentée par une imprimante permet de télécharger un pdf qui reflète le contenu du listing sans aucun filtre de recherche. L’action se situe au dessus du tableau.

Les formulaires ¶

Un formulaire dans cet applicatif peut soit être soit d’ajout, soit de modification, soit de suppression.

Voici l’exemple d’un formulaire en mode modification.

_images/opencourrier--ergonomie-formulaire-modifier.png

Les actions de formulaires :

Modifier : cette action permet d’accéder au formulaire de l’élément en mode modification. Une fois le formulaire de modification validé alors un bouton retour nous permet de revenir au listing des éléments.
Supprimer : cette action permet d’accéder au formulaire de l’élément en mode suppression. Une fois le formulaire de suppression validé alors un bouton retour nous permet de revenir au listing des éléments.

Les onglets ¶

Sur le formulaire d’un élément, il peut apparaître plusieurs onglets qui correspondent à des éléments liés à l’élément en cours. Un onglet présente un listing de ces éléments liés avec des actions qui permettent également d’accéder à des formulaires sur ces éléments liés.

Par exemple sur l’image suivante, on peut voir sur le « profil » un onglet « tableau de bord » qui liste les tableaux de bord liés au profil utilisateur.

_images/opencourrier--ergonomie-formulaire-onglet-listing.png

Gestion des courriers ¶

Ce chapitre vous propose d’utiliser la gestion de courrier.

Sommaire

Gestion des courriers

Les éléments permettant la gestion du courrier sont disponibles dans la rubrique (Courrier) du menu.

Saisir un courrier ¶

Les courriers sont saisis soit en « courrier arrivée » soit en « courrier départ ».

Courrier arrivée ¶

(Courrier ‣ Courrier arrivée)

Ce sont les courriers entrants dans l’organisation.

Dans ce listing les actions possibles depuis le tableau sont :

Accéder au tableau de bord du courrier
Télécharger l’édition PDF « Récapitulatif du courrier »
Télécharger l’édition PDF « Accusé de réception » (ce courrier est paramétrable via le menu (Administration ‣ Etat)

Il est possible de créer ou modifier un courrier arrivée dans le formulaire ci dessous.

Il est saisi dans courrier arrivée :

le premier courrier scanné du répertoire utilisateur (si un SCAN existe) à associer s’affiche
Si une réponse est souhaitée à ce courrier : permet de créer automatiquement une tâche associée. Ce champ est visible seulement si l’option autocreation_tache est activé paramétrable par l’administrateur technique.
la nature : lettre mail … (paramétrable par l’administrateur technique)
la date arrivée (date du jour par défaut) et date du courrier [obligatoire] (Vous pouver utilisez le calendrier)
l’émetteur : nom, prénom, adresse, CP, Ville, type de correspondant. Il est possible de chercher un émetteur actif dans la table émetteur en appuyant sur la flèche et de sauvegarder un émetteur en cochant la case (en ajout seulement). Si un emetteur est choisi, l ensemble des données de l’emetteur est rapatrié dans la table courrier
l’Objet : possibilité d’utiliser des textes paramétrés en appuyant sur le lien « bible »
la catégorie de courrier
le service : service chargé du traitement, obligatoire et eventuellement le référent
la diffusion : service(s) ou élu(s) ayant une copie (facultatif)

Tableau de bord d’un courrier arrivée

Courrier départ ¶

Cette fonctionnalité est optionnelle dans l’application, il est possible d’activer ou de désactiver la fonctionnalité dans le paramétrage (paramétrage de l’option courrier départ).

(Courrier ‣ Courrier départ)

Ce sont les courriers sortants de l’organisation.

Il est possible de créer ou modifier un courrier départ dans le formulaire ci dessous.

Il est saisi dans courrier départ :

la nature : lettre mail … (paramétrable par l’administrateur technique)
la date signature (date du jour par défaut) et la date de départ
le destinataire : nom, prénom, adresse, CP, Ville, type de correspondant. Il est possible de chercher un destinataire actif dans la table émetteur en appuyant sur la flèche et de sauvegarder un émetteur en cochant la case (en ajout seulement). Si un emetteur est choisi, l ensemble des données de l’emetteur est rapatrié dans la table courrier
l’Objet : possibilité d’utiliser des textes paramétrés en appuyant sur le lien « bible »
le service : service chargé du traitement : obligatoire et eventuellement le référent
la diffusion : service(s) ou élu(s) ayant une copie (facultatif)

Tableau de bord d’un courrier sortant

Règles :

Il est à noter que si un courrier scanné est associé lors de l’ajout du d’un courrier, il est rajouté un enregistrement dans la table dossier avec sur le scan en rouge, le numéro de registre et sa date d’arrivée.

Il est conseiller de rajouter un utilisateur spécifique pour le scan.

Lier un courrier ¶

Il est proposé de décrire dans ce paragraphe la liaison de courrier.

La liaison des courriers se fait en 3 étapes :

dans le formulaire courrier_depart ou courrier_arrivee, appuyer sur le plus (ajout de courrier lié)
le moteur de recherche de courrier apparait, saisir votre recherche et valider

une liste de courrier correspondant à la recherche apparait, valider le courrier

le courrier correspondant est lié

La liaison s’établit par un numéro commun aux courriers liés qui font chacun référence aux autres…

Saisir une tâche ¶

Cet onglet permet de saisir les tâches associées aux courriers.

Il est proposé de décrire dans ce paragraphe la saisie d’une tache associé à un courrier arrivée.

Il est possible de creer ou modifier une tâche dans le formulaire ci dessous

Il est saisi :

l’état de la tâche
la catégorie de la tâche
la date butoir
la date exécution
le Solde : Oui si soldée, Non sinon. (Voir traitement : courrier -> taches non soldées)
le Service de traitement de la tache (les services « fils » ou sous service)
observations : Texte libre
Chronoréponse Éventuellement Texte libre ou courrier lié

Télécharger un fichier / dossier ¶

Avertissement

Il est impératif de sauvegarder le répertoire trs/ où sont stockés les documents. Il faut donc conserver ce répertoire en cas de changement de version. Il faut donner à apache les droits d’écriture sur ce répertoire.

Le dossier sert à conserver l’ensemble des documents relatifs au courrier :

le courrier arrivé scanné (voir paragraphe saisir le courrier)
les courriers départs (au format PDF)
les divers rapports d’intervention
les pièces jointes …

Il est proposé de décrire dans ce paragraphe l’upload de document dans les dossiers dans l’onglet « dossier » d’un courrier départ ou arrivée.

Les documents du dossier sont listés dans l’onglet « dossier »

Il est possible de creer ou modifier un dossier dans le formulaire ci dessous

Les zones à saisir sont les suivantes :

le fichier à associer depuis son poste de travail

Le fichier est stocké dans le répertoire trs par centaine

exemple : pour le courrier 1051; le fichier est stocké sous le nom 10/a_1051.pdf si courrier arrive et d_1051.pdf si courrier départ et éventuellement d_1051_2.pdf si un deuxième courrier départ est implémenté…
la date
l’observation : champ texte
le type : départ ou arrivé

La recherche de courriers ¶

(Courrier ‣ Recherche Courrier)

La recherche des courriers est accessible pour chaque profil d’utilisateur et permet de visualiser tous les courriers entrants et sortants de l’application.

Les critères de recherches sont sauvegardés au changement de page.

La recherche de tâches ¶

(Courrier ‣ Recherche Tâche)

La recherche des courriers est accessible pour chaque profil d’utilisateur et permet de visualiser toutes les tâches de l’application.

Les critères de recherches sont sauvegardés au changement de page.

Les tâches non soldées ¶

(Courrier ‣ Tâche non soldée)

la liste des taches non soldées est accessible en : courrier -> tâche non soldée

Il est possible de modifier une tâche non soldée dans le formulaire ci dessous

(Saisir une tâche)

Les archives ¶

(Courrier ‣ Archive)

Avertissement

L’archivage des courriers à une date précise se fait sur la date du courrier sans vérification des dates ou de l’exécution des taches associées

la liste des courrier archivés est accessible en : courrier -> Archive

Les archives ne sont pas modifiables et ne sont pas accessibles par le moteur de recherche.

Traitement ¶

Nous vous proposons dans ce chapitre de mettre en oeuvre les traitements.

Sommaire

Traitement
- La remise à zéro des registres
- L’archivage des courriers

Les éléments permettant le traitements des courriers sont disponibles dans la rubrique (Traitement) du menu.

La remise à zéro des registres ¶

Ce traitement est à faire à chaque début d’année. Il remet à zéro la séquence utilisée pour les registres (les identifiants des séquences sont registre_seq pour les courriers arrivée et registre_depart_seq pour les courriers départ).

Ce traitement est accessible via le menu (Traitement ‣ Registre) :

L’archivage des courriers ¶

Ce traitement archive les courriers, dossiers et tâches à partir d’une date. Il permet d’accélérer les recherches.

Ce traitement est accessible via le menu (Traitement ‣ Archivage) :

Les archives ne sont pas modifiables et ne sont pas accessibles par le moteur de recherche. Elles sont uniquement consultables via le menu (Courrier ‣ Archive) :

(Les archives)

Paramétrage ¶

Le paramétrage permet d’adapter openCourrier à votre organisation.

Sommaire

Paramétrage

Tables de références ¶

Les tables de références sont disponibles dans la rubrique (Paramétrage) du menu.

Le service ¶

(Paramétrage ‣ Service)

Il est proposé de décrire dans ce paragraphe la saisie d’un service dans le menu paramétrage.

Les services sont listés dans l’option service du menu paramétrage

Il est possible de creer ou modifier une voie dans le formulaire ci dessous

Il est saisi :

code
libelle
diffusion oui/non (reçoit ou non du courrier en traitement)
service père (lien hiérarchique)

Règles :

seul un service « père » peut attribuer des tâches à un service « fils »

paramétrage des services en om_utilisateur :

Le paramétrage « service » de l’utilisateur est spécifique à openCourrier

cas particulier :

En affectant « tous service » dans la case service, les droits de l utilisateur s’étend à tous les services

Gestion des « scan »

Les scans d’un utilisateur sont stockés dans le repertoire trs/collectivite/utilisateur

exemple : scan/1/2 pour om_collectivite=1 et om_utilisateur=2

Le correspondant (émetteur / destinataire)¶

(Paramétrage ‣ Émetteur / Destinataire)

Il s’agit ici de ne saisir que les correspondants permanents ou fréquents (préfecture, trésorerie, …) pour éviter de resaisir les informations du correspondant à chaque nouvelle saisie de courrier.

L’écran suivant permet de lister les différents correspondants ainsi que les actions possibles sur ces derniers.

Il est possible de créer ou modifier un correspondant dans le formulaire suivant.

Il est saisi :

civilite
nom
prénom
adresse
complément
cp
ville
téléphone
type de correspondant

Note

Il est possible de créer un correspondant fréquent/permanent directement depuis le formulaire de création de courrier en cochant la case « création émetteur » ou « création destinataire ».

La bible ¶

(Paramétrage ‣ Bible)

La bible sert à compléter l’objet d’un courrier. Il est donc possible de stocker des phrases réutilisables à l’identique pour chaque courrier.

Les textes bibles sont listés dans le formulaire suivant

Il est possible de créer ou modifier bible dans le formulaire ci dessous

Il est saisi :

un libellé affiché en fenêtre lors de la saisie du courrier
un contenu récupéré dans objet_courrier lors de la saisie du courrier

La civilité ¶

(Paramétrage ‣ Civilité)

La civilité correspond au titre de civilité d’une personne. Elle est utilisée dans l’application lors de la saisie de correspondants.

L’écran suivant permet de lister les différentes civilités ainsi que les actions possibles sur ces dernières.

Il est possible de créer ou modifier une civilité dans le formulaire suivant.

Il est saisi :

le libellé

Le type de correspondant ¶

(Paramétrage ‣ Type de correspondant)

Le type de correspondant permet de catégoriser une personne. Il est utilisé dans l’application lors de la saisie de correspondants.

L’écran suivant permet de lister les différents types de correspondant ainsi que les actions possibles sur ces derniers.

Il est possible de créer ou modifier un type de correspondant dans le formulaire suivant.

Il est saisi :

le libellé du type de correspondant

L’élu ¶

(Paramétrage ‣ Élu)

Les élus peuvent être mise en copie sur les courriers.

L’écran suivant permet de lister les élus.

Il est possible de créer ou modifier un élu sur le formulaire suivant.

Il est saisi :

la civilité
le nom de l’élu
le prénom de l’élu
activer l’auto-insertion en copie sur chaque courrier, pour cela il faut activer l’option (voir paramétrable par l’administrateur)

La catégorie des courriers ¶

(Paramétrage ‣ Catégorie Des Courriers)

La catégorie des courriers permet de catégoriser un courrier. Elle est utilisée dans l’application lors de la saisie des courriers et n’est pas obligatoire.

L’écran suivant permet de lister les différentes catégories de courrier ainsi que les actions possibles sur ces dernières.

Il est possible de créer ou modifier une catégorie de courrier dans le formulaire suivant.

Il est saisi :

le libellé de la catégorie de courrier

La catégorie des tâches ¶

(Paramétrage ‣ Catégorie Des Tâches)

La catégorie des tâches permet de catégoriser une tache. Elle est utilisée dans l’application lors de la saisie des tâches. C’est un champ obligatoire.

L’écran suivant permet de lister les différentes catégories de tâche ainsi que les actions possibles sur ces dernières.

Il est possible de créer ou modifier une catégorie de tâche dans le formulaire suivant.

Il est saisi :

le libellé de la catégorie de tâche

L’état des tâches ¶

(Paramétrage ‣ État Des Tâches)

L’état des tâches permet d’indiquer l’avancement d’une tache. Il est utilisé dans l’application lors de la saisie des tâches. C’est un champ obligatoire.

L’écran suivant permet de lister les différents états de tâche ainsi que les actions possibles sur ces derniers.

Il est possible de créer ou modifier un état de tâche dans le formulaire suivant.

Il est saisi :

le libellé de l’état de tâche

Paramètres généraux ¶

Ce paramétrage permet de configurer certaines options spécifiques de l’application. Il est accessible via le menu (Administration ‣ Paramètre).

Voici le descriptif de ces paramètres :

Paramètre	Description
« maire »	Nom du maire.
« ville »	Nom de la ville.
« registre_arrivee »	Par défaut : « [annee]-[seq] ». Caractéristique du registre dans notre cas 2012-0001.
« registre_depart »	Par défaut : « [annee]-D-[seq] ». Caractéristique du registre dans notre cas 2012-D-0001.
« option_courrier_depart »	Par défaut : « true ». Utilisation du courrier départ.
« service_tache »	Par défaut : « 1 ». Indique si les tâches peuvent être affectées uniquement aux services enfants du service qui traite le courrier (1) ou à tous les services de la commune (0).
« option_elu »	Par défaut : « false ». Affiche la gestion des élus sur les courriers (identique aux services).
« autoinsertion_diffusion »	Par défaut : « false ». Ajoute une case à cocher sur les services et les élus pour qu’ils soient automatiquement en diffusion lors de l’ajout d’un courrier.
« autocreation_tache »	Par défaut : « true ». Création automatique d’une tâche de réponse lors de la création d’un courrier.
« delai_reponse »	Par défaut : « 15 ». Délai de réponse à un courrier. Permet de saisir la date butoir d’une tâche créée automatiquement.
« vue_sous_service »	Par défaut : « false ». Possibilité au service de voir les éléments de ses sous services.
« voption_localisation »	Par défaut : « false ». Active la géolocalisation des tâches.
« filtre_recherche_service »	Par défaut : « false ». Active le filtre par service. Les résultats des listings sont filtrés par le service de l’utilisateur.

Paramètres spécifiques dans le fichier dyn/var.inc ¶

Ce paramétrage est réservé à l’administrateur technique de l’application. Il permet de configurer des options critiques ou des listes de références non destinées à être modifiées régulièrement. Il est accessible via le système de fichiers directement sur le serveur. Il n’est pas possible de modifier ce paramétrage via l’interface de l’application.

paramètres de dyn/var.inc

<?php
...

// nature dans objet courrier
$select_nature = array('','CH','F','L','LAR','MAIL','TEL','TLE');
$select_naturelib = array(
    'Votre choix',
    'Chronopost',
    'Fax',
    'Lettre',
    'Lettre A/R',
    'Email',
    'T&eacute;l&eacute;copie',
    'T&eacute;l&eacute;gramme',
);

// type dans objet courrier
$select_type = array('', 's');
$select_typelib = array('Votre Choix', 'signale');

...
?>

Paramètres spécifiques dans le fichier dyn/config.inc.php ¶

Ce paramétrage est réservé à l’administrateur technique de l’application. Il permet de configurer des options critiques ou des listes de références non destinées à être modifiées régulièrement. Il est accessible via le système de fichiers directement sur le serveur. Il n’est pas possible de modifier ce paramétrage via l’interface de l’application.

paramètres de dyn/config.inc.php

<?php
...

/**
 * Configuration de la notification par mail des nouvelles taches attribuees aux utilisateurs du service concerne
 * Default : false
 */
$config['notification_email'] = false;

/**
 * Mail de notification
 */
$config['notification_email_title']=utf8_decode("OpenCourrier [ville] : une nouvelle tâche vous a été affectée");
$config['notification_email_corps']=utf8_decode("Bonjour,
<br/><br/>
Une nouvelle tâche vous a été affectée sur l'application openCourrier.<br/>
Vous pouvez la consulter en suivant le lien présenté ci-dessous :
<br/><br/>
<a href='http://demo.openmairie.org/opencourrier/scr/form.php?obj=tache&idx=[id_task]'>
Lien vers la tache.</a>
<br/><br/>
Cordialement,<br/>
L'administrateur de openCourrier, [ville].");

/**
 * Configuration du nombre de colonnes sur le tableau de bord.
 */
$config['dashboard_nb_column'] = 2;

/**
 * Option pour la gestion du scan automatique
 * Cette option permet d'activer lors de l'ajout d'un courrier la récupération
 * dans le répertoire ../scan/<ID_COLLECTIVTE>/<ID_UTILISATEUR>/ d'un fichier
 * PDF qui aurait été préalablement scanné et déposé dans ce répertoire.
 * Lors de l'enregistrement du courrier ce fichier est rattaché au courrier
 * via l'onglet dossier et le numéro de registre est inscrit en rouge directement
 * dans le PDF. Ce fichier est alors supprimé.
 * Valeurs disponibles :
 *  - true => Option activée
 *  - false => Option désactivée
 * Default : $config['option_scanpdf'] = true;
 */
$config['option_scanpdf'] = true;

...
?>

Paramètres spécifiques dans le fichier dyn/mail.inc.php ¶

Ce paramétrage est réservé à l’administrateur technique de l’application. Il permet de configurer des options critiques ou des listes de références non destinées à être modifiées régulièrement. Il est accessible via le système de fichiers directement sur le serveur. Il n’est pas possible de modifier ce paramétrage via l’interface de l’application.

paramètres de dyn/config.inc.php

<?php
...

/**
 *
 */
$mail = array();

/**
 * Informations sur $mail
 *
 *  La variable $mail est un tableau associatif. Ce tableau peut, de ce
 *  fait, contenir plusieurs configurations de serveur mail différentes.
 *
 *  Chaque serveur est représente par une cle de tableau. Ces cles se
 *  retrouvent dans le fichier database.inc.php et permettent d'associer
 *  une base de donnees precise a un serveur mail precis.
 *
 *  Les autres cles de configuration :
 *
 *       mail_host -> Adresse du serveur de mail
 *       mail_port -> Port d'ecoute du serveur de mail
 *
 *       mail_username -> Identifiant de l'utilisateur du serveur de mail
 *       mail_pass     -> Mot de passe de cet utilisateur
 *
 *       mail_from      -> Adresse email de l'expediteur
 *       mail_from_name -> Nom de l'expediteur
 */
$mail["mail-default"] = array(
    'mail_host' => '',
    'mail_port' => '',
    'mail_username' => '',
    'mail_pass' => '',
    'mail_from' => '',
    'mail_from_name' => '',
);

...
?>

Guide du développeur¶

Installation¶

Pré-requis¶

Vous devez avoir installer :

un serveur web (apache, …)
PHP
le moteur de base de donnees PostgreSQL

Sous windows, il est facile de trouver de la documentation pour l’installation de ces éléments en utilisant wamp (http://www.wampserver.com/) ou easyphp (http://easyphp.fr/) par exemple.

Sous Linux, il est facile de trouver de la documentation pour l’installation de ces éléments sur votre distribution.

Déploiement¶

Installation des fichiers de l’applicatif¶

Télécharger l’archive zip¶

https://adullact.net/frs/?group_id=297

Décompresser l’archive zip dans le répertoire de votre serveur web¶

Exemple sous windows dans wamp : wamp/www/opencourrier Exemple sous linux avec debian : /var/www/opencourrier

Création et initialisation de la base de données¶

Créer la base de données¶

Par défaut la base de données s’appelle opencourrier.

Initialiser la base de données¶

Il faut initialiser les tables, les séquences et données de paramétrage :

data/pgsql/init.sql
data/pgsql/init_metier.sql
data/pgsql/init_parametrage.sql

Initialiser un jeu de données de démonstration (optionnel)¶

Il est possible d’initialiser un jeu de données pour tester l’applicatif avec des données de démonstration :

data/pgsql/init_data.sql

Configuration de l’applicatif¶

Positionner les permissions nécessaires au serveur web¶

Exemple sous linux avec debian : chown -R www-data:www-data /var/www/opencourrier

Configuration de la connexion à la base de données¶

La configuration se fait dans le fichier dyn/database.inc.php :

// PostgreSQL
$conn[1] = array(
     "opencourrier",
     "pgsql",
     "pgsql",
     "root", // Remplacer ici le login de l'utilisateur PostgreSQL
     "", // Remplacer ici le mot de passe de l'utilisateur PostgreSQL
     "",
     "localhost",
     "",
     "",
     "opencourrier", // Remplacer ici le nom de la base de données
     "AAAA-MM-JJ",
     "",
     "",
     "",
     "", // Remplacer ici la configuration du serveur mail
);

Connexion à l’application¶

Ouverture dans le navigateur¶

http://localhost/opencourrier/

Login¶

Utilisateur « administrateur » :
- identifiant : admin
- mot de passe : admin
Utilisateur « démonstration » (si le fichier d’initalisation du jeu de données de démonstration a été appliqué) :
- identifiant : demo
- mot de passe : demo

Le message de bienvenue doit être affiché « Votre session est maintenant ouverte. »

En cas d’erreur¶

Activer le mode debug¶

Il est possible d’activer le mode debug pour visualiser les messages d’erreur détaillés. Dans le fichier dyn/debug.inc.php, il faut commenter le mode production et décommenter le mode debug.

Mode production :

//define('DEBUG', VERBOSE_MODE);
//define('DEBUG', DEBUG_MODE);
define('DEBUG', PRODUCTION_MODE);

Mode debug :

//define('DEBUG', VERBOSE_MODE);
define('DEBUG', DEBUG_MODE);
//define('DEBUG', PRODUCTION_MODE);

Intégration¶

Nous vous proposons dans ce chapitre de décrire l’intégration d’openCourrier dans le système d’information

principes d’une application composite (mashup)
les fonds de cartes internet et géolocalisation des taches
le tableau de bord parametrable (widget)

Les principes d’une application composite¶

openCourrier permet de construire une application composite en intégrant des contenus venant d’applications externes.

Suivant wikipedia : « Une application composite (ou mashup ou encore mash-up) est une application qui combine du contenu ou du service provenant de plusieurs applications plus ou moins hétérogènes. »

http://fr.wikipedia.org/wiki/Application_composite

Les applications composites permettent de construire une application rapidement a un faible coût grace à la fusion de multiples services internet. Les composants sont facilement ré utilisables

Il est décrit ici les principes d’integration d’openCourrier dans le domaine de l’information géographique pour la géolocalisation des tâches (option prévue dans une prochaine version).

Il est decrit ensuite l’intégration au travers de tableau de bord personnalisé.

La géolocalisation¶

La géolocalisation des tâches est une demande de la DGST d’Arles et est implémentée (fonctionnement prévu sous postgresql)

Uniquement si option_localisation sig_internne

Les widgets¶

openCourrier permet de construire une application composite en integrant des widgets dans le tableau de bord.

Le mode de fonctionnement des widget est décrit dans le guide du développeur openMairie.

Il est decrit ensuite l’integration au travers de tableau de bord personnalisés.

Il est donc possible de créer tout type de widget et de les intégrer dans un tableau de bord personnalisé :

Dans notre cas ci dessus, l’utilisateur « demo » a accès :

à des applications externes

la météo à Arles
l'horoscope du jour
les actualités via google

à des applications internes
```
courriers non soldés
```
à des applications composites
```
finances, ressources humaines
```

Bibliographie¶

http://www.openmairie.org/telechargement/openMairie-Guidedudveloppeur.pdf/view

Contributeurs¶

(par ordre alphabétique)

atReal
Florent Michon
Francois Raynaud (Arles)
Sofien Timezouaght
Victor Collette