1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
/*
* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/
#ifndef __CNTVCARD_H__
#define __CNTVCARD_H__
// System includes
#include <cntdb.h>
#include <vcard.h>
// Classes referenced
class CVCardAddress;
class CVCardItemAndLabel;
class CVCardToContactsAppConverter;
// Enumerations
/**
@internalComponent
@released
*/
enum TCntVCardImportType
{
ECntVCardImportTypeFirstSync,
ECntVCardImportTypeMerge
};
class CContactVCardConverter : public CContactEcomConverter
/**
Plug-in vCard to CContactItem converter.
@publishedAll
@released
*/
{
public:
// Ideally each converter should be able to define its own flags relevant
// to its own mode of operation. Due to the legacy design (defining flags
// in CContactDatabase) they have to be redeclared here. Long term we hope
// to deprecate the CContactDatabase flags and rely on those declared in
// the converter implementation.
/** Import and export format flags. Contacts can be imported into
or exported from the contact database as vCards.
The following options are available during import and export.
@publishedAll
@released
*/
enum TOptions
{
EDefault = CContactDatabase::EDefault,
/** Handle Symbian's extended vCard format options. */
EIncludeX = CContactDatabase::EIncludeX,
/** Support non-standard extensions requried by Symbian PC connectivity software
and Microsoft, amongst others. */
ETTFormat = CContactDatabase::ETTFormat ,
/** Don't export the contact ID (for exporting only). */
EExcludeUid = CContactDatabase::EExcludeUid,
/** Decrease the contact's access count when importing and exporting. */
EDecreaseAccessCount = CContactDatabase::EDecreaseAccessCount,
/** Only import the first contact in the read stream (for importing only). */
EImportSingleContact = CContactDatabase::EImportSingleContact,
/** Increase the contact's access count when importing and exporting. */
EIncreaseAccessCount = CContactDatabase::EIncreaseAccessCount,
/** Sets a contact item to the local time when importing. */
ELocalTime = CContactDatabase::ELocalTime,
/** Allows to set a template to a contact item that does not exist. */
ENullTemplateId = CContactDatabase::ENullTemplateId,
/** Allows to set white spaces as value for an empty field. */
EConnectWhitespace=0x0100, // Used to correctly manage the TimeIS protocol for syncing.
/**
During import ignore the UID property value of the vCard. By ignoring
the UID the client is indicating that it knows that the contact does not
already exist in the database (i.e. the contact is being added rather
than being updated). Within the CContactVCardConverter::ImportL()
method no attempt to search for the UID in the database will be made.
For a series of addition of vCards with UIDs use of this option will
give a performance improvement since the search for the UID in the
Contacts database can become very costly as the number of contacts
grows.
*/
EIgnoreUid = CContactDatabase::EConverterReserved1,
/**
During import, if it is determined that the contact item being imported
already exists in the database then the contact item in the database will
be deleted before being replaced by the vCard being imported. This option
should be used when the client does not want a merge type behaviour for
existing contact items. This option will typically be used in a sync use case
where the vCard data that the client is provided with has already been through a process
of conflict resolution and so the existing contact item should be replaced not merged.
*/
EReplaceIfExists = CContactDatabase::EConverterReserved2,
};
/**
@internalComponent
@released
*/
enum TVersitPropertyType
{
EPropertyValueSingle,
EPropertyValueComposite,
EPropertyValueHandlingNotImplemented
};
public: // from CContactConverter
static CContactVCardConverter* NewL();
CArrayPtr<CContactItem>* ImportL(CContactDatabase& aDb,RReadStream& aReadStream,TBool& aImportSuccessful,TInt aOptions,TBool aImportSingle);
void ExportL(CContactDatabase& aDb,const CContactIdArray& aSelectedContactIds,RWriteStream& aWriteStream,TInt aOptions,const Versit::TVersitCharSet aCharSet, TBool aExportPrivateFields, TInt aCommitNumber);
public: // Utility
static TBool ContainsExportableData(const TDesC& aText);
static TBool ContainsImportableData(const TDesC& aText, TVersitPropertyType aType, TCntVCardImportType aImportType);
private:
static TBool ContainsData(const TDesC& aText);
void doImportL(CVCardToContactsAppConverter& aConverter, CParserVCard& aVCard, CContactDatabase& aDb, TInt aOption, TBool aIncAccessCount, TBool aDecAccessCount, TBool& aImportSuccessful, CArrayPtr<CContactItem>* aContactItems, TBool aIsInTransaction, TContactItemId aIdForUpdate);
TContactItemId IsVCardMergeNeededL(CVCardToContactsAppConverter& aConverter, CParserVCard& aVCard, CContactDatabase& aDb, TInt aOption);
void ModifyAccessCountL(CContactItem& aContact, TBool aIncAccessCount, TBool aDecAccessCount);
void HandleAgentsInVCardL(CVCardToContactsAppConverter& aConverter, CArrayPtr<CParserProperty>* aAgentProperties, CContactItem& aContact, CContactDatabase& aDb, TInt aOption, TBool aIncAccessCount, TBool aDecAccessCount, CArrayPtr<CContactItem>* aContactItemArray, TBool aMerge);
};
#endif
|
