Topics
All
MacOS
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Deprecated
Guides
Examples
Videos
New in version:
12.1
12.2
12.3
12.4
12.5
13.0
13.1
13.2
13.3
13.4
Statistic
FMM
Blog
CNContact.DeleteValue
Deletes a value of a contact.
Component |
Version |
macOS |
Windows |
Linux |
Server |
iOS SDK |
Contacts
|
10.1 |
✅ Yes |
❌ No |
❌ No |
❌ No |
✅ Yes |
MBS( "CNContact.DeleteValue"; ContactIdentifier; Selector { ; Identifier } )
More
MBS(
"CNContact.DeleteValue"; /* Deletes a value of a contact. */
$ContactIdentifier; /* The contact identifier.e.g. "46B1E34D-58F9-4B6B-A80D-0F71ABB87A0E" */
$Selector; /* Which value to set.e.g. "givenName" */
$Identifier) /* Optional; Identifier or label to delete only one entry in a list.
Pass empty text to delete all. */
Less
Parameters
Parameter |
Description |
Example |
Flags |
ContactIdentifier |
The contact identifier. |
"46B1E34D-58F9-4B6B-A80D-0F71ABB87A0E" |
|
Selector |
Which value to set. |
"givenName" |
|
Identifier |
Identifier or label to delete only one entry in a list.
Pass empty text to delete all. |
|
Optional |
Result
Returns OK or error.
Description
Deletes a value of a contact.
Selector can be birthday, contactRelations, dates, departmentName, emailAddresses, familyName, givenName, imageData, imageDataAvailable, instantMessageAddresses, jobTitle, middleName, namePrefix, nameSuffix, nickname, nonGregorianBirthday, organizationName, phoneNumbers, phoneticFamilyName, phoneticGivenName, phoneticMiddleName, phoneticOrganizationName, postalAddresses, previousFamilyName, socialProfiles, thumbnailImageData, note, type, ImageData and thumbnailImageData or urlAddresses.
PhoneNumbers, emailAddresses, postalAddresses, urlAddresses, contactRelations, socialProfiles, instantMessageAddresses and dates can specify a label/identifier to delete only one entry.
Examples
Delete home address:
MBS( "CNContact.DeleteValue"; $contactID; "postalAddresses"; "home")
Delete all emails:
MBS( "CNContact.DeleteValue"; $contactID; "emailAddresses"; "")
Delete job title:
MBS( "CNContact.DeleteValue"; $contactID; "jobTitle")
See also
Release notes
Blog Entries
This function checks for a license.
Created 2nd March 2020, last changed 2nd March 2020
CNContact.AddURLAddress
-
CNContact.EditInAddressbook