FrRedmineReceivingEmails » History » Revision 2
Revision 1 (yannick quenec'hdu, 2010-06-23 02:33) → Revision 2/10 (yannick quenec'hdu, 2010-06-23 02:33)
[[FrGuide]]
h1. Recevoir des courriels
{{>toc}}
Depuis la version 0.8, Redmine peut être configuré pour créer des demandes ou des commentaires directement par courriels.
h2. Mise en oeuvre
Vous pouvez configurer Redmine pour recevoir des courriels avec une des méthodes suivantes :
* Adresser des messages à partir de votre serveur de messagerie
** Distant: Fonctionne avec un serveur de messagerie distant, les courriels sont traitées immédiatement, rapide (pas d'environnement à redémarrer)
** Local: Nécessite quelques configuration sur votre serveur de messagerie local (ex. Postfix sendmail, etc.)
* Récupérer les courriels depuis un serveur IMAP ou POP3 :
** Distant: Facile à mettre en oeuvre, ne nécessite pas de configurer le MTA, fonctionne avec un serveur de messagerie distant
** Local: Le traitement n'est pas réalisé instantanément (un cron doit être ajouter pour lire périodiquement les courriels)
h3. Adresser des courriels à partir de votre serveur de messagerie
Un script autonome peut être utilisé pour transmettre des courriels entrants à partir de votre serveur de messagerie.
Ce script lit un flux de courriel depuis l'entrée standard et le transmet à Redmine via une requête HTTP.
Le fichier est accessible depuis le répertoire de redmine: @extra/mail_handler/rdm-mailhandler.rb@.
Pour pouvoir l'utiliser, vous devez activer l'API qui reçoit les courriels:
Aller dans > Administration > Configuration > Emails entrants, vérifier que la fonction *Activer le WS pour la réception d'emails* est bien cocher et saisir ou générer une clé secrète
copier le fichier @rdm-mailhandler.rb@ sur votre serveur de messagerie, vérifier qu'il possède les permissions pour s'exécuter et configurer le serveur de messagerie
Usage:
<pre>
rdm-mailhandler [options] --url=<Redmine URL> --key=<API key>
Required:
-u, --url URL of the Redmine server
-k, --key Redmine API key
General options:
-h, --help show this help
-v, --verbose show extra information
-V, --version show version information and exit
Issue attributes control options:
-p, --project=PROJECT identifier of the target project
-t, --tracker=TRACKER name of the target tracker
--category=CATEGORY name of the target category
--priority=PRIORITY name of the target priority
-o, --allow-override=ATTRS allow email content to override attributes
specified by previous options
ATTRS is a comma separated list of attributes
</pre>
Exemples:
<pre>
# No project specified. Emails MUST contain the 'Project' keyword:
rdm-mailhandler --url http://redmine.domain.foo --key secret
# Fixed project and default tracker specified, but emails can override
# both tracker and priority attributes:
rdm-mailhandler --url https://domain.foo/redmine --key secret \\
--project foo \\
--tracker bug \\
--allow-override tracker,priority
</pre>
Ici un exemple pour les aliais Postfix:
<pre>
foo: "|/path/to/rdm-mailhandler.rb --url http://redmine.domain --key secret --project foo"
</pre>
h3. Récupérer les courriels depuis un serveur IMAP