Expose all email addresses in autocompletion

This change is immediately applicable to LDAP-based system address
books. However, personal SQL-based address books must have their quick
tables recreated. To do so, one must use sogo-tool to backup and restore
the user's data.

Resolves #3443, #3526

NEWS

@@ -1,6 +1,9 @@
 3.1.1 (2016-MM-DD)
 ------------------
 
+Enhancements
+ - [web] expose all email addresses in autocompletion of message editor (#3443)
+
 Bug fixes
  - [web] fixed creation of chip on blur (sgTransformOnBlur directive)
  - [web] fixed composition of new messages from Contacts module

SoObjects/Contacts/NGVCard+SOGo.m

@@ -294,7 +294,7 @@ convention:
 
   ou = [ldifRecord objectForKey: @"ou"];
   if ([ou isKindOfClass: [NSArray class]])
-    units = [NSArray arrayWithArray: ou];
+    units = [NSArray arrayWithArray: (NSArray *)ou];
   else if (ou)
     units = [NSArray arrayWithObject: ou];
   else
@@ -723,6 +723,29 @@ convention:
   return fn;
 }
 
+- (NSArray *) emails
+{
+  NSArray *elements;
+  NSMutableArray *emails;
+  NSString *email;
+  int i;
+
+  emails = [NSMutableArray array];
+  elements = [self childrenWithTag: @"email"];
+
+  for (i = [elements count]-1; i >= 0; i--)
+    {
+      email = [[elements objectAtIndex: i] flattenedValuesForKey: @""];
+      if ([email caseInsensitiveCompare: [self preferredEMail]] == NSOrderedSame)
+        // First element of array is the preferred email address
+        [emails insertObject: email atIndex: 0];
+      else
+        [emails addObject: email];
+    }
+
+  return emails;
+}
+
 - (NSArray *) secondaryEmails
 {
   NSMutableArray *emails;
@@ -849,10 +872,12 @@ convention:
   value = [self preferredTel];
   if (value)
     [fields setObject: value forKey: @"c_telephonenumber"];
-  value = [self preferredEMail];
-  if (![value isNotNull])
-    value = @"";
-  [fields setObject: value forKey: @"c_mail"];
+  v = [self emails];
+  if ([v count] > 0)
+    [fields setObject: [v componentsJoinedByString: @","]
+               forKey: @"c_mail"];
+  else
+    [fields setObject: [NSNull null] forKey: @"c_mail"];
   element = [self org];
   [fields setObject: [element flattenedValueAtIndex: 0 forKey: @""]
              forKey: @"c_o"];

SoObjects/Contacts/SOGoContactGCSFolder.m

@@ -264,9 +264,23 @@ static NSArray *folderListingFields = nil;
   data = [contactRecord objectForKey: @"c_mail"];
   if ([data length])
     {
+      NSArray *values;
       NSDictionary *email;
-      email = [NSDictionary dictionaryWithObjectsAndKeys: @"pref", @"type", data, @"value", nil];
-      [contactRecord setObject: [NSArray arrayWithObject: email] forKey: @"emails"];
+      NSMutableArray *emails;
+      NSString *type, *value;
+      int i, max;
+
+      values = [data componentsSeparatedByString: @","];
+      max = [values count];
+      emails = [NSMutableArray arrayWithCapacity: max];
+      for (i = 0; i < max; i++)
+        {
+          type = (i == 0)? @"pref" : @"home";
+          value = [values objectAtIndex: i];
+          email = [NSDictionary dictionaryWithObjectsAndKeys: type, @"type", value, @"value", nil];
+          [emails addObject: email];
+        }
+      [contactRecord setObject: emails forKey: @"emails"];
     }
   else
     {

UI/Templates/MailerUI/UIxMailEditor.wox

@@ -64,7 +64,7 @@
                   md-selected-item="editor.autocomplete.to.selected"
                   md-items="user in editor.contactFilter(editor.autocomplete.to.searchText)"
                   md-min-length="3"
-                  md-delay="300"
+                  md-delay="150"
                   md-no-cache="true"
                   label:placeholder="Add a recipient">
                 <md-item-template>

UI/WebServerResources/js/Contacts/Card.service.js

@@ -424,6 +424,27 @@
     return this.refs.length - 1;
   };
 
+  /**
+   * @function explode
+   * @memberof Card.prototype
+   * @desc Create a new Card associated to each email address of this card.
+   * @return an array of Card instances
+   */
+  Card.prototype.explode = function() {
+    var _this = this, cards = [], data;
+
+    if (this.emails.length > 1) {
+      data = this.$omit();
+      _.forEach(this.emails, function(email) {
+        var card = new Card(angular.extend({}, data, {emails: [email]}));
+        cards.push(card);
+      });
+      return cards;
+    }
+    else
+      return [this];
+  };
+
   /**
    * @function $reset
    * @memberof Card.prototype

UI/WebServerResources/js/Mailer/MessageEditorController.js

@@ -197,8 +197,20 @@
     }
 
     function contactFilter($query) {
-      AddressBook.$filterAll($query);
-      return AddressBook.$cards;
+      return AddressBook.$filterAll($query).then(function(cards) {
+        // Divide the matching cards by email addresses so the user can select
+        // the recipient address of her choice
+        var explodedCards = [];
+        _.forEach(_.invokeMap(cards, 'explode'), function(manyCards) {
+          _.forEach(manyCards, function(card) {
+            explodedCards.push(card);
+          });
+        });
+        // Remove duplicates
+        return _.uniqBy(explodedCards, function(card) {
+          return card.$$fullname + ' ' + card.$$email;
+        });
+      });
     }
 
     function addRecipient(contact, field) {