[IMAGE: intFAR Logo]

DDE Manager

Written by Chris Means (cmeans.at.intfar.dot.com)
(Updated Saturday, June 21, 2003)

Copyright © 1994 - 2003, intFAR Productions. All rights reserved.

An Add-On for Commence® Corporation's namesake
Personal Information Manager Commence®, that extends its functionality via DDE.

How it works
An Agent in Commence sends a DDE message to DDE Manager, telling it which set of commands to run, and what values to use. DDE Manager then performs the actions in the background, and waits for more commands to arrive.
  • Version 1
  • Sample Script
  • Revision History
  • Version 2[IMAGE: Glasses]
  • Sample Script
  • Revision History
  • Pricing
  • Upgrades
  • Value Added Resellers
  • Ordering
  • Download Area[IMAGE: Glasses

  • Version 1

    First Released 1994
    Written in Borland C v3.1
    Current Version v1.4b
    for Commence v2.0 - v3.1
    Functions Supported SUM, AVERAGE and COUNT

    Version 1 allowed for Fields in Items of one Catetory to be SUMmed, AVERAGEd or COUNTed and to have that computed value placed in either the same or another Category. This gave users of Commence with DDE Manager the ability to have summary level data available in any Category, and to have it constantly updated as they either modified the detail data, selected various menu options, or other triggers occurred.

    As Commence matured, DDE Manager kept pace by incorporating the ability to handle decimals, and currency characters.

    Sample Script

    SUM:Phone Log,Duration,Project,(%Name%),Phone Time,CTCTI,,Refers to,Contact,Relates to,Project,(%Name%)

    The above script would be placed inside the Message Text area of a Send DDE Agent.

    When fired, the result would be that a Filter would be applied to the Phone Log category, limiting the entries to those connected to the (%Name%) item in the Project category. The sum of the Duration field from the resulting Phone Log view would be placed into the Phone Time field of the related Project item.

    Statement syntax is: Function:Source,Target,Filter

    BNF Grammar
    Function (SUM | AVERAGE | COUNT)
    Source Category,Field
    Target Category,Name,Field
    Category Commence category name
    Field Commence field name in the associated category
    Name An instance identifier name...e.g. (%Name%)
    Filter FilterType,Bool,Parameters
    FilterType (F | CTI | CTCTI | CTCF)
    Bool [Not]
    Parameters Parm,...

    Though powerful, using the above syntax to perform a relatively simple SUM operation, could be quite difficult. You will also notice that given the above statement syntax, the only thing you could do with DDE Manager was a SUM, AVERAGE or COUNT operation. This however, is not true for Version 2 of DDE Manager.

    Version 1 Revision History

    Version Reason
    1.1 Fix for negative numbers
    1.2 Fix for blank ViewFilter parameters
    1.3 Fix for numbers with decimal values
    1.4 Added COUNT function
    1.4a Fix for circumstances where SUM returned COUNT
    1.4b Fix for event where SUM, AVERAGE and COUNT did not return 0


    Back to Top


    Version 2

    First Released 1996
    Written in Borland Delphi v1.01 & v2.0
    Current Version v2.0f
    for Commence v3.0 - v3.1b+
    Functions Supported SUM, AVERAGE, MEAN, COUNT, HIGH, and LOW

    With the release of DDE Manager v2 came:


    A VAR (Value Added Reseller) of Commence, might use Developer to build DDE Scripts, but instead of distributing the Developer package with the customized database, they would provide the User release. This would keep the purchasing user from modifying and customizing the DDE Scripts (with the help of Developer), and would let the Scripts execute faster, as there would be none of the debugging facilities of Developer to use up system resources.

    Sample Script

    [ViewCategory(Phone Log)]
    [ViewFilter(1,CTI,,Refered to,Person,(%Name%))]

    ;Sum up all the Duration entries.
    [EditItem(Person,(%Name%),Total Phone Time,@_SUM(Duration))]
    [EditItem(Person,(%Name%),Average Call Length,@_AVERAGE(Duration))]
    [EditItem(Person,(%Name%),Number of Calls,@_COUNT())]

    ;Display a message on the screen.
    [FireTrigger(ShowMessage,(%Name%),made @_COUNT() calls totalling @_SUM(Duration) minutes,,,,,,,)]

    ;Apply an additional filter
    [ViewFilter(2,F,,Billable,Checked)]
    [EditItem(Person,(%Name%),Total Billable,@_SUM(Billable Total))]

    This DDE Script basically does four things:

    1. Filter the Phone Log category to only entries where (%Name%) is the connected person.
    2. Update the (%Name%) Person item with summarized data from the connected Phone Log items.
    3. Use a ShowMessage agent to display some of the summarized information in a dialog box.
    4. Apply an additional filter for just Billable entries in the Phone Log, and update the same Person item with a sum of the Billable Total field in the Phone Log.

    The script would be triggered by a Commence Send DDE Agent action that would simply specify the category and name where the Script was located, and the value for the (%Name%) variable.

    Version 2 Revision History

    Version Reason
    2.0a Fixed TOutline.ClearEntries method
    2.0b Fixed bug when user terminates DDE Manager while it is Receiving a new Script and Running a Script at the same time
    2.0c New Feature: Alert with MultiMedia file
    2.0d Fixed bug with blank or nil line in Script commands
    2.0e Fixed bug with use of '@' without a '_' in Script commands ;
    Improved the speed of parsing Script commands
    2.0f New Feature: TAB() function ;
    Fixed bug with HIGH, LOW, and MEAN functions where elements were not sorted correctly


    Back to Top


    Pricing

    All monies are in United States of America currency.

    Version Cost per Seat
    1.4b $25
    2.0f Developer $50
    2.0f User $25

    Upgrades

    From To Cost per Copy
    v1.x v2.0 Developer $25
    16 bit v2.0 User 32 bit v2.0 User $5

    VARs


    Back to Top


    Ordering

    Visa/MasterCard

    Method Use
    Voice 001 (312) 415-0418
    Fax 001 (773) 549-5794
    CompuServe 71544,2474
    Internet cmeans.at.intfar.dot.com

    Please Include:

    Check or (International) Money Order

    Chris Means
    intFAR Productions
    1206 West Nelson Street
    Chicago, Illinois 60657-4214
    United States of America

    Please Include:


    Back to Top


    Download Area

    These files are part of the distribution set for DDE Manager v2.0 Developer. To help assist in your decision about whether or not DDE Manager is for you, and to help familiarize yourself with its capabilities, these files can be downloaded and installed on your PC for your review.

    Description Name Size Last Updated
    Sample Database DDEMGR.xfr 295K October 19th 1996
    Windows Help File DDEMGR.hlp 117K October 19th 1996
    Installation Instructions README.rtf 5K October 19th 1996
    All of the above in a single file DDEMGR2.zip 354K October 20th 1996


    Back to Top


    back to intFAR Productions Home Page

    [IMAGE: Mouth in a box]Ideas, Comments and/or Suggestions
    Copyright © 1994 - 2003 intFAR Productions. All rights reserved.