ACT! SDK - Software Development Kit

Software Development Kit (SDK)
Technical Reference Guide

Click for Main Menu

Windows 2000    Windows 95                               Windows 98                     Windows N

 

Introducing the ACT!TM SDK

The ACT! Software Development Kit (SDK) includes documentation and sample code files for SDK components that are built into the ACT! application. You can use the ACT! SDK to extend the functionality of ACT!, enable external applications to control ACT! and read and write to ACT! database tables, and add auxiliary commands to the user interface to execute external programs. The ACT! SDK was developed for use by ACT! Certified Consultants, ACT! add-on product developers, independent software developers, and corporate developers.

What’s Included

The ACT! Software Development Kit (SDK) Technical Reference Guide is a set of eight documents: this introduction, sections for each of the five current components of the ACT! SDK, two appendixes of reference material, and a Readme file.

The following table describes the documents included in the ACT! Software Development Kit (SDK) Technical Reference Guide.

Section

Document

Description

Introduction

Introducing the ACT! SDK

Introduction to the manual. Includes an overview, license and warranty information, and technical support information.

I

ACT! OLE Database Object

Describes the ACT! OLE Database Object component of the ACT! SDK, which uses OLE automation to enable non-ACT! applications to read and write information in ACT! database tables.

II

ACT! OLE Application Object

Describes the ACT! OLE Application Object component of the ACT! SDK, which uses OLE automation to provide non-ACT! applications with both control and context interrogation of the ACT! application.

III

ACT! Scripting Support

Describes how to create scripts that can be notified of events in the ACT! application.

IV

Adding Extensible Views and Tabs to ACT!

Describes how to add views, accessible by a Contact or Group tab or View command, to display HTML content within the ACT! application.

V

Adding Custom Commands to ACT!

Describes the ACT! OLE Command Object component of the ACT! SDK, which uses OLE automation to add custom commands to ACT! that execute external programs.

Appendix A

ACT! Database File Format Reference

Describes the file formats of ACT! database tables and relationships among ACT! tables.

Appendix B

ACT! Command ID Reference

Lists ACT! command IDs referenced in the ACT! Application Object and Adding Custom Commands to ACT! sections of the ACT! SDK.

The following sample files are included with the ACT! Software Development Kit (SDK).

·         Sample Microsoft Visual Basic and Visual C++ code files for the ACT! OLE Application Object and the ACT! OLE Database Object.

·         Sample control files for adding extensible views and tabs to the ACT! application.


 Service and Support Solutions

The ACT! Software Development Kit (SDK) offers two support options: “How Do I” support and Consulting services. For the latest information about support for the ACT! SDK, visit http://www.actsoftware.com/, click the Add Ons link, then click the Software Development Kit link.

To learn more about general ACT! Customer Service and Technical Support solutions, visit the web sites listed in the ACT! User’s Guide or choose Service and Support Information from the Help menu within ACT! See the back cover of the ACT! User’s Guide for general Customer Service and Technical Support telephone numbers.

“How-Do-I” support

“How-Do-I” Technical Support for the ACT! SDK is charged at $50 US per incident. An incident is defined as a question regarding one specific operation.

Please call (480) 444-1399 or (800) 927-3989 to leave a message for an ACT! SDK specialist. Your call will be returned within two business days. “How-Do-I” support is available Monday through Friday, 6:00 a.m. to 5:00 p.m. Pacific Standard Time.

Consulting Services

Users of the ACT! SDK are also entitled to code debugging services. These services are charged at $100 US per hour. These services cover errors encountered during use of the ACT! SDK.

Please call(480) 444-1399 or (800) 927-3989 to leave a message for an ACT! SDK specialist. Your call will be returned within two business days. Consulting services are available Monday through Friday, 6:00 a.m. to 5:00 p.m. Pacific Standard Time.

Programming Services

Programming services are available from independent ACT! Certified Consultants. For a list of ACT! Certified Consultants, visit http://www.actsoftware.com/ then click the Certified Consultants link.

Every effort has been made to ensure the accuracy of this information. Interactive Commerce Corporation reserves the right to limit any single support call, change the terms and conditions of support, and change support pricing and service availability without notice.



 

ACT! Software Development Kit (SDK)
Technical Reference Guide

The software described in this book is furnished under a license agreement and may be used only in accordance with the terms of the agreement.

Copyright Notice

Portions of this publication copyright 2000 Interact Commerce Corporation. Portions of this publication copyright  1993 ‑ 2000 Symantec Corporation under exclusive license to Interact Commerce Corporation.

All Rights Reserved.

Released: 6/2000 for ACT! 2000

This document may not, in whole or in part, be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form without prior consent in writing from Interact Commerce Corporation, 8800 N. Gainey Center Dr. #200, Scottsdale, AZ 85258.

ALL EXAMPLES WITH NAMES, COMPANY NAMES, OR COMPANIES THAT APPEAR IN THIS MANUAL ARE IMAGINARY AND DO NOT REFER TO, OR PORTRAY, IN NAME OR SUBSTANCE, ANY ACTUAL NAMES, COMPANIES, ENTITIES, OR INSTITUTIONS. ANY RESEMBLANCE TO ANY REAL PERSON, COMPANY, ENTITY, OR INSTITUTION IS PURELY COINCIDENTAL.

Every effort has been made to ensure the accuracy of this manual. However, Interact Commerce makes no warranties with respect to this documentation and disclaims any implied warranties of merchantability and fitness for a particular purpose. Interact Commerce shall not be liable for any errors or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual or the examples herein. The information in this document is subject to change without notice.

Trademarks

ACT! is a registered trademark and SideACT! is a trademark under exclusive license to Interact Commerce Corporation by their owner, Symantec Corporation, in the United States and other countries. Interact Commerce Corporation and not Symantec Corporation has produced this publication and is responsible for the contents hereof. Symantec and WinFax are U.S. registered trademarks of Symantec Corporation. WinFax PRO is a trademark of Symantec Corporation. Microsoft, MS, Windows, Windows CE, Windows NT, Word, Schedule+, ActiveX, FoxPro, Visual Basic, and Visual C++ are either registered trademarks or trademarks of Microsoft Corporation in the U.S. and/or other countries. Dale Carnegie Training is a registered trademark of Dale Carnegie and Associates, Inc. ECCO is a trademark of NetManage Inc. ExpensAble is a registered trademark of Managemark, Inc. Palm is a trademark of Palm, Inc. GoldMine is a trademark of Goldmine Software Corp. Janna Contact is the exclusive property of Janna Systems Inc. Maximizer is a registered trademark of Modatech Systems Inc. Lotus Organizer is a trademark of Lotus Development Corporation. Quicken is a registered trademark of Intuit, Inc. Sidekick is a trademark of Starfish Software. Sharkware is a trademark of CogniTech Corporation. Tracker is a trademark of Softcode Pty Ltd. Yahoo! is a registered trademark of Yahoo! Inc. WordPerfect is a registered trademark of Novell, Inc. CompuServe is a registered trademark of CompuServe, Inc., and its affiliates. cc:Mail and cc:Mail Mobile are trademarks of cc:Mail, Inc., a wholly owned subsidiary of Lotus Development Corporation. Day Runner is a registered trademark of Day Runner, Inc. Day-Timer is a registered trademark of Day-Timers, Inc. Netscape is a trademark of Netscape Communications Corporation. Portions of ACT! are Copyright 1995 by Streetwise Software. All rights reserved.

Other product names mentioned in this manual may be trademarks or registered trademarks of their respective companies and are the sole property of their respective manufacturers.

Printed in the United States of America.

10  9  8  7  6  5   4  3  2  1


INTERACT COMMERCE CORPORATION LICENSE AND WARRANTY


NOTICE: INTERACT COMMERCE CORPORATION LICENSES THE ENCLOSED SOFTWARE TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THIS LICENSE AGREEMENT. PLEASE READ THE TERMS CAREFULLY BEFORE OPENING THIS PACKAGE, AS OPENING THE PACKAGE WILL INDICATE YOUR ASSENT TO THEM. IF YOU DO NOT AGREE TO THESE TERMS, THEN INTERACT COMMERCE CORPORATION IS UNWILLING TO LICENSE THE SOFTWARE TO YOU, IN WHICH EVENT YOU SHOULD RETURN THE FULL PRODUCT WITH PROOF OF PURCHASE TO THE DEALER FROM WHOM IT WAS ACQUIRED WITHIN THIRTY DAYS OF PURCHASE, AND YOUR MONEY WILL BE REFUNDED.

LICENSE AND WARRANTY
The software which accompanies this license (the
Software) is the property of Interact Commerce Corporation or its licensors and is protected by copyright law. While Interact Commerce Corporation continues to own the Software, you will have certain rights to use the Software after your acceptance of this license. Except as may be modified by a license addendum which accompanies this license, your rights and obligations with respect to the use of this Software are as follows:

You may:
(i) use only one copy of the Software on a single computer;
(ii) make one copy of the Software for archival purposes, or copy the software onto the hard disk of your computer and retain the original for archival purposes;
(iii) use the Software on a network, provided that you have a licensed copy of the Software for each computer that can access the Software over that network;
(iv) after written notice to Interact Commerce Corporation, transfer the Software on a permanent basis to another person or entity, provided that you retain no copies of the Software and the transferee agrees to the terms of this agreement; and
(v) if a single person uses the computer on which the Software is installed at least 80% of the time, then after registering the product, that person may also use the Software on a single home computer.

You may not:
(i) copy the documentation which accompanies the Software;
(ii) sublicense, rent or lease any portion of the Software;
(iii) reverse engineer, decompile, disassemble, modify, translate, make any attempt to discover the source code of the Software, or create derivative works from the Software; or
(iv) use a previous version or copy of the Software after you have received a disk replacement set or an upgraded version as a replacement of the prior version, unless you donate a previous version of an upgraded version to a charity of your choice, and such charity agrees in writing that it will be the sole end user of the product, and that it will abide by the terms of this agreement. Unless you so donate a previous version of an upgraded version, upon upgrading the Software, all copies of the prior version must be destroyed.

Thirty Day Money Back Guarantee:
If you are the original licensee of this copy of the Software and are dissatisfied with it for any reason, you may return the complete product, together with your receipt, to the place of purchase, postage prepaid, for a full refund at any time during the thirty day period following the delivery to you of the Software.

Limited Warranty:
Interact Commerce warrants that the media on which the Software is distributed will be free from defects for a period of thirty (30) days from the date of delivery of the Software to you. Your sole remedy in the event of a breach of this warranty will be that Interact Commerce will, at its option, replace any defective media returned to Interact Commerce within the warranty period or refund the money you paid for the Software. Interact Commerce does not warrant that the Software will meet your requirements or that operation of the Software will be uninterrupted or that the Software will be error-free.

THE ABOVE WARRANTY IS EXCLUSIVE AND IN LIEU OF ALL OTHER WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. YOU MAY HAVE OTHER RIGHTS, WHICH VARY FROM STATE TO STATE.

Disclaimer of Damages:
REGARDLESS OF WHETHER ANY REMEDY SET FORTH HEREIN FAILS OF ITS ESSENTIAL PURPOSE, IN NO EVENT WILL INTERACT COMMERCE BE LIABLE TO YOU FOR ANY SPECIAL, CONSEQUENTIAL, INDIRECT OR SIMILAR DAMAGES, INCLUDING ANY LOST PROFITS OR LOST DATA ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE EVEN IF INTERACT COMMERCE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. IN NO CASE SHALL INTERACT COMMERCE CORPORATION'S LIABILITY EXCEED THE PURCHASE PRICE FOR THE SOFTWARE. The disclaimers and limitations set forth above will apply regardless of whether you accept the Software.

U.S. Government Restricted Rights:
RESTRICTED RIGHTS LEGEND. All Interact Commerce products and documentation are commercial in nature. The software and software documentation are
Commercial Items, as that term is defined in 48 C.F.R. 2.101, consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are defined in 48 C.F.R. 252.227-7014(a)(5) and 48 C.F.R. 252.227-7014(a)(1), and used in 48 C.F.R. 12.212 and 48 C.F.R. 227.7202, as applicable. Consistent with 48 C.F.R. 12.212, 48 C.F.R. 252.227-7015, 48 C.F.R. 227.7202 through 227.7202-4, 48 C.F.R. 52.227-14, and other relevant sections of the Code of Federal Regulations, as applicable, Interact Commerce's computer software and computer software documentation are licensed to United States Government end users with only those rights as granted to all other end users, according to the terms and conditions contained in this license agreement. Manufacturer is Interact Commerce Corporation, 8800 N. Gainey Center Drive #200, Scottsdale, Arizona, 85258, USA.

General:
This Agreement will be governed by the laws of the State of Arizona. This Agreement may only be modified by a license addendum which accompanies this license or by a written document which has been signed by both you and Interact Commerce. Should you have any questions concerning this Agreement, or if you desire to contact Interact Commerce for any reason, please write: Interact Commerce Customer Sales and Service, 8800 N. Gainey Center Drive #200, Scottsdale, Arizona, 85258, USA.




License and Warranty Addendum

The software you are acquiring has been specially configured to run on a network, and consequently Interact Commerce Corporation grants to you the right to use the enclosed Software on a computer network provided that for each and every concurrent user on the network, you have acquired and dedicated one licensed copy of the software.