QVersitContactImporter Class Reference

Importing categories

The importer imports the vCard CATEGORIES property by converting each category to a QContactTag. Some managers may not have support for QContactTag, but instead support categorization using the HasMember QContactRelationship along with contacts of type TypeGroup. For these backends, if the categorization information needs to be retained through group relationships, extra work needs to be done to do the conversion. Below is some example code that does this translation.

 /*! Adds contacts in  \a newContacts into \a manager, converting categories specified
   with tags into group membership relationships.  Note that this implementation uses the
   synchronous API of QContactManager for clarity.  It is recommended that the asynchronous
   API is used in practice.

   Relationships are added so that if a contact, A, has a tag "b", then a HasMember relationship is
   created between a group contact in the manager, B with display label "b", and contact A.  If there
   does not exist a group contact with display label "b", one is created.
   */
 void insertWithGroups(const QList<QContact>& newContacts, QContactManager* manager)
 {
     // Cache map from group names to QContactIds
     QMap<QString, QContactId> groupMap;

     foreach (QContact contact, newContacts) {
         if (!manager->saveContact(&contact))
             continue; // In practice, better error handling may be required
         foreach (const QContactTag& tag, contact.details<QContactTag>()) {
             QString groupName = tag.tag();
             QContactId groupId;
             if (groupMap.contains(groupName)) {
                 // We've already seen a group with the right name
                 groupId = groupMap.value(groupName);
             } else {
                 QContactDetailFilter groupFilter;
                 groupFilter.setDetailDefinitionName(QContactType::DefinitionName);
                 groupFilter.setValue(QLatin1String(QContactType::TypeGroup));
                 groupFilter.setMatchFlags(QContactFilter::MatchExactly);
                 // In practice, some detail other than the display label could be used
                 QContactDetailFilter nameFilter = QContactDisplayLabel::match(groupName);
                 QList<QContactLocalId> matchingGroups = manager->contactIds(groupFilter & nameFilter);
                 if (!matchingGroups.isEmpty()) {
                     // Found an existing group in the manager
                     QContactId groupId;
                     groupId.setManagerUri(manager->managerUri());
                     groupId.setLocalId(matchingGroups.first());
                     groupMap.insert(groupName, groupId);
                 }
                 else {
                     // Make a new group
                     QContact groupContact;
                     QContactName name;
                     name.setCustomLabel(groupName);
                     // Beware that not all managers support custom label
                     groupContact.saveDetail(&name);
                     if (!manager->saveContact(&groupContact))
                         continue; // In practice, better error handling may be required
                     groupId = groupContact.id();
                     groupMap.insert(groupName, groupId);
                 }
             }
             // Add the relationship
             QContactRelationship rel;
             rel.setFirst(groupId);
             rel.setRelationshipType(QContactRelationship::HasMember);
             rel.setSecond(contact.id());
             manager->saveRelationship(&rel);
         }
     }
 }