Project

General

Profile

FrRedmineReceivingEmails » History » Version 1

yannick quenec'hdu, 2010-06-23 02:33

1 1 yannick quenec'hdu
[[FrGuide]]
2
3
h1. Recevoir des courriels
4
5
{{>toc}}
6
Depuis la version 0.8, Redmine peut être configuré pour créer des demandes ou des commentaires directement par courriels.
7
8
h2. Mise en oeuvre
9
10
Vous pouvez configurer Redmine pour recevoir des courriels avec une des méthodes suivantes :
11
12
* Adresser des messages à partir de votre serveur de messagerie
13
** Distant: Fonctionne avec un serveur de messagerie distant, les courriels sont traitées immédiatement, rapide (pas d'environnement à redémarrer)
14
** Local: Nécessite quelques configuration sur votre serveur de messagerie local (ex. Postfix sendmail, etc.)
15
16
* Récupérer les courriels depuis un serveur IMAP ou POP3 :
17
** Distant: Facile à mettre en oeuvre, ne nécessite pas de configurer le MTA, fonctionne avec un serveur de messagerie distant
18
** Local: Le traitement n'est pas réalisé instantanément (un cron doit être ajouter pour lire périodiquement les courriels)  
19
20
h3. Adresser des courriels à partir de votre serveur de messagerie
21
22
Un script autonome peut être utilisé pour transmettre des courriels entrants à partir de votre serveur de messagerie.
23
Ce script lit un flux de courriel depuis l'entrée standard et le transmet à Redmine via une requête HTTP.
24
Le fichier est accessible depuis le répertoire de redmine: @extra/mail_handler/rdm-mailhandler.rb@.
25
26
Pour pouvoir l'utiliser, vous devez activer l'API qui reçoit les courriels:
27
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
28
29
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
30
31
Usage:
32
33
34
<pre>
35
rdm-mailhandler [options] --url=<Redmine URL> --key=<API key>
36
37
Required:
38
  -u, --url                      URL of the Redmine server
39
  -k, --key                      Redmine API key
40
  
41
General options:
42
  -h, --help                     show this help
43
  -v, --verbose                  show extra information
44
  -V, --version                  show version information and exit
45
46
Issue attributes control options:
47
  -p, --project=PROJECT          identifier of the target project
48
  -t, --tracker=TRACKER          name of the target tracker
49
      --category=CATEGORY        name of the target category
50
      --priority=PRIORITY        name of the target priority
51
  -o, --allow-override=ATTRS     allow email content to override attributes
52
                                 specified by previous options
53
                                 ATTRS is a comma separated list of attributes
54
</pre>
55
56
Exemples:
57
58
<pre>
59
  # No project specified. Emails MUST contain the 'Project' keyword:
60
  rdm-mailhandler --url http://redmine.domain.foo --key secret
61
  
62
  # Fixed project and default tracker specified, but emails can override
63
  # both tracker and priority attributes:
64
  rdm-mailhandler --url https://domain.foo/redmine --key secret \\
65
                  --project foo \\
66
                  --tracker bug \\
67
                  --allow-override tracker,priority
68
</pre>
69
70
Ici un exemple pour les aliais Postfix:
71
72
<pre>
73
foo: "|/path/to/rdm-mailhandler.rb --url http://redmine.domain --key secret --project foo"
74
</pre> 
75
76
h3. Récupérer les courriels depuis un serveur IMAP