06. Version 3 Overview [4:00]

Description: This video outlines the functions and features available in Version 3 of the Address Book Manipulator.

Transcript:
Let’s talk about what is new and why you should upgrade to the new Version 3 of the Address Book Manipulator.

0:13 You can now access the picture image field in Apple’s address book. This long awaited feature is here. Using this SetImage and GetImage functions, you can set and get the picture image. This will allow you to push and pull images to and from FileMaker and Apple’s Address Book as shown here.

0:35 Additional Group Functionality has also been added. Using the new GetListOfValues functions, you can retrieve a value list of group members or a list of groups to which a contact belongs. The value list contains either names or UIDs depending on the parameter specified. The new ClearAll function allows you to delete persons or group records according to the group which they belong. The two new functions give you more flexibility to easily manage, locate, and clear group records.

1:12 The Search Function now has a new optExpandConstrain parameter to allow you to expand your search. Setting this parameter to expand or constrain will add an “or” or “and” functionality to the last search allowing you to perform a multi-valued search.

1:33 Apples Address Book has custom fields that are not visible to the user and you can now access these custom fields using the AddCustomField, GetCustomField and SetCustomField functions. These new functions are very straight forward and simply add, get, and set customs fields in Apple’s Address Book. Apple’s custom fields do come with limitations as outlined in our documentation, but still can be quite useful especially if you want to assign a unique FileMaker ID to a contact in Address Book.

2:08 The GetLastError function can now be used to obtain a full textual or numerical description of any errors returned by the plug-in functions. Let’s have a look at some samples of how to now trap for errors.

  • In Example 1; after some plug-in function, if the result does not equal zero, then we will call the GetLastError function to obtain a textual description of the last error.
  • In Example 2; after some plug-in function, if the result does equal the error string, then we will call the GetLastError function to obtain a numerical description of the last error.

2:49 This improved method of error trapping will allow you to easily identify and trap for errors. Please note that although all functions are backwards compatible, if you are upgrading from the previous Version 2 of the Address Book Manipulator, then you may need to adjust your scripts to account for this new method of error trapping and accommodate for the error string now returned.

3:11 Other additions include adding the optName to the new function. This parameter allows you to assign a name to a new group created. We have also added the optType parameter to these functions. This new parameter allows you to operate with a currently opened group of person record.

3:29 This is just a small sampling of what is possible with the new version of the plug-in. I encourage you to explore www.AddressBookManipulator.com, review the videos and documentation, and download a demo. Please contact us via email or phone or browse our forum if you have any additional questions. We hope you enjoy connecting FileMaker and Apple’s Address Book.

Contact Us:
Email: support@productivecomputing.com
Phone: (760) 510-1200
Forum: http://www.productivecomputing.com/forum