Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

CNContact.AddURLAddress

Adds an URL address to a contact.

Component Version macOS Windows Linux Server iOS SDK
Contacts 8.4 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContact.AddURLAddress"; ContactIdentifier; URL { ; Label } )   More

Parameters

Parameter Description Example Flags
ContactIdentifier The contact identifier. "46B1E34D-58F9-4B6B-A80D-0F71ABB87A0E"
URL The URL address. "https://www.mbsplugins.de/"
Label The label to use.
For your convenience we translate Homepage, Work, Home and Other to the right values, so they get localized in display.
Default label is Other.		 "Work" Optional

Result

Returns OK or error.

Description

Adds an URL address to a contact.
This is a convenience function to add just one URL with a given label to the contact.
Please call CNContactStore.UpdateContact later to store the values.

Examples

Add homepage:

Set Variable [ $r; Value:MBS( "CNContact.AddURLAddress"; $contactID; "http://www.monkeybreadsoftware.com/"; "Homepage" ) ]

Add FMP URL to carry the record ID for our record in FileMaker for this person:

Set Variable [ $r; Value:MBS( "CNContact.AddURLAddress"; $contactID; "fmp://$/Contacts.fmp12?script=ShowContact&param=12345"; "FileMaker" ) ]

Update a contact by adding an URL:

Set Variable [ $ContactID; Value: "BD2307E5-92F6-4A8F-946D-C4804615C18B:ABPerson" ]
// add the URL:
Set Variable [ $r; Value: MBS( "CNContact.AddURLAddress"; $contactID; "http://www.monkeybreadsoftware.com/"; "Homepage" ) ]
// and save
Set Variable [ $r; Value: MBS( "CNContactStore.UpdateContact"; $ContactID ) ]

See also

Example Databases

Created 1st August 2018, last changed 7th May 2024


CNContact.AddSocialProfileJSON - CNContact.DeleteValue