User Tools

Site Tools


extensions:ticket-from-email

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
extensions:ticket-from-email [2019/10/08 10:37]
vdumas
extensions:ticket-from-email [2020/01/22 17:52] (current)
Line 7: Line 7:
 release_dt ​      : 2019-05-21 release_dt ​      : 2019-05-21
 itop-version-min : 2.3.0 itop-version-min : 2.3.0
-download_url ​    : http://​www.combodo.com/​itop-extensions/​+download_hidden  ​: http://​www.combodo.com/​itop-extensions/​combodo-mail-to-ticket-automation-3.1.0-463.zip
 code             : combodo-mail-to-ticket-automation code             : combodo-mail-to-ticket-automation
 state            : stable state            : stable
Line 109: Line 109:
   * A connection to a POP3 or IMAP server with a valid mailbox.   * A connection to a POP3 or IMAP server with a valid mailbox.
   * [[latest:​admin:​cron|cron.php]] must be running to enable the processing of incoming eMails.   * [[latest:​admin:​cron|cron.php]] must be running to enable the processing of incoming eMails.
-  * For resizing big images, [[http://​php.net/​manual/​en/​book.image.php|PHP GD]] must be installed. +  ​* For the debug trace, [[https://​www.php.net/​manual/​en/​book.mbstring.php|PHP MBString]] must be installed. 
-  ​* ​+  ​* For resizing big images, [[https://​php.net/​manual/​en/​book.image.php|PHP GD]] must be installed. 
 <note important>​On Ubuntu 16.04 the prerequisites can be installed using the ''​php-pear'',​ ''​php-net-socket''​ and ''​php-imap''​ packages: <note important>​On Ubuntu 16.04 the prerequisites can be installed using the ''​php-pear'',​ ''​php-net-socket''​ and ''​php-imap''​ packages:
 <​code>​ <​code>​
Line 183: Line 184:
 | Login | The name of the mail account used for connecting to the mailbox | test@mycompany.com | | Login | The name of the mail account used for connecting to the mailbox | test@mycompany.com |
 | Password | The password for the above mentioned account | | | Password | The password for the above mentioned account | |
-| Protocol | The protocol to connect to the mail server: either POP3 or IMAP. | POP3 |+| Protocol | The protocol to connect to the mail server: either POP3 or IMAP. \\ If you need to use IMAP with SSL or TLS, refer to the imap_options configuration parameter below. | POP3 |
 | Port | The TCP port to connect to the server. The standard values are 110 (secured: 995) for POP3 and 143 (secured: 993) for IMAP | 110 | | Port | The TCP port to connect to the server. The standard values are 110 (secured: 995) for POP3 and 143 (secured: 993) for IMAP | 110 |
 | Mailbox (for IMAP) | The IMAP mailbox (folder) to scan for incoming messages. If omitted the default (root) mailbox will be scanned. This option is ignored when using the POP3 protocol. | INBOX.Folder.Subfolder | | Mailbox (for IMAP) | The IMAP mailbox (folder) to scan for incoming messages. If omitted the default (root) mailbox will be scanned. This option is ignored when using the POP3 protocol. | INBOX.Folder.Subfolder |
Line 287: Line 288:
 | body_parts_order | Comma separated, ordered, list of MIME types, determining the preferred part of the message to retrieve for populating the ''​description''​ or ''​public_log''​ of the Ticket. **Note: new since 2.6.6** In order to import as inline images the images embedded in HTML, the HTML part of the email must be processed in priority over the text part. Therefore the recommended configuration is ''​text/​html,​text/​plain''​. | text/​html,​text/​plain | | body_parts_order | Comma separated, ordered, list of MIME types, determining the preferred part of the message to retrieve for populating the ''​description''​ or ''​public_log''​ of the Ticket. **Note: new since 2.6.6** In order to import as inline images the images embedded in HTML, the HTML part of the email must be processed in priority over the text part. Therefore the recommended configuration is ''​text/​html,​text/​plain''​. | text/​html,​text/​plain |
 | pop3_auth_options | POP3 authentication options. Possible values are: '​CRAM-MD5',​ '​APOP'​ , '​PLAIN'​ , '​LOGIN',​ '​USER'​ | USER | | pop3_auth_options | POP3 authentication options. Possible values are: '​CRAM-MD5',​ '​APOP'​ , '​PLAIN'​ , '​LOGIN',​ '​USER'​ | USER |
-| imap_options | Additional IMAP options. Possible values are listed here: [[http://​www.php.net/​manual/​en/​function.imap-open.php|IMAP flags]]. **Warning**:​ Do NOT use the ''​pop3''​ flag to connect to a POP3 mailbox using the PHP IMAP extension. Due to a limitation of the IMAP extension this will not work! If you want to connect to a POP3 server, use the POP3 protocol instead. | array('​imap', '​novalidate-cert') |+| imap_options | Additional IMAP options. Possible values are listed here: [[http://​www.php.net/​manual/​en/​function.imap-open.php|IMAP flags]]. ​\\ For example to use SSL you could specify : ''​array(0 => '​imap',​ 2 => '​ssl'​)''​ \\ **Warning**:​ Do NOT use the ''​pop3''​ flag to connect to a POP3 mailbox using the PHP IMAP extension. Due to a limitation of the IMAP extension this will not work! If you want to connect to a POP3 server, use the POP3 protocol instead. | array('​imap'​) |
 | exclude_attachment_types | Array of MIME types to exclude when retrieving attachments | array('​application/​attachment'​) | | exclude_attachment_types | Array of MIME types to exclude when retrieving attachments | array('​application/​attachment'​) |
 | html-tags-to-remove | ** new in 3.0.0 ** Used for computing the "new part" of HTML messages by removing the specified tags. The syntax is an array of ''​tag_name''​ <​nowiki>​=></​nowiki>​ array of CSS class names. | //see above// |  | html-tags-to-remove | ** new in 3.0.0 ** Used for computing the "new part" of HTML messages by removing the specified tags. The syntax is an array of ''​tag_name''​ <​nowiki>​=></​nowiki>​ array of CSS class names. | //see above// | 
Line 363: Line 364:
 Answer: There can be multiple reasons, which leads to flagging a mail in error. When browsing the ''​Mailbox Content''​ tab on the ''​Incoming eMail Inboxes''​ the error message should explain you the reason. Attachment too big, mail in an unkown format (encrypted for eg.),... Answer: There can be multiple reasons, which leads to flagging a mail in error. When browsing the ''​Mailbox Content''​ tab on the ''​Incoming eMail Inboxes''​ the error message should explain you the reason. Attachment too big, mail in an unkown format (encrypted for eg.),...
  
 +FIXME
 +Q1: Stockage des EML attention à la volumétrie si Tickets en erreurs non géré ou si Ticket non clos
 +
 +Q3: Message d'​erreur avec des chiffres à éclaircir
extensions/ticket-from-email.1570523853.txt.gz · Last modified: 2019/10/08 10:37 by vdumas

";