CMA_PACKAGE

Contains information about an accounting package that provided data to be imported. A filter DLL fills in this structure when the Import Wizard calls the DLL's CMA_LoadPackage function.

Syntax

typedef struct tagCMA_PACKAGE {
    CHAR    szName[51];
    CHAR    szSearchFilename[13];
    INT    nEntryStampType;
    INT    nEntryStringStampLength1;
    INT    nEntryStringStampLength2;
    INT    nInvoiceType;
    DWORD    dwCMAVersion;
    INT    nOrgUpdateMethod;
    INT    nContactUpdateMethod;
    INT    nInvoiceUpdateMethod;
    INT    nPaymentUpdateMethod;
    INT    nProductUpdateMethod;
} CMA_PACKAGE;

szName A null-terminated string that contains the name of the accounting package (for example, "Peachtree/Windows"). This member is required (must not be NULL).

szSearchFilename A null-terminated string that contains the filenames or wildcard character to look for when searching the user's computer for the package's data (for example, "*.dat"). The CMA_FindFirstCompany and CMA_FindNextCompany functions determine whether each file is a valid data source for the filter. This member is required (must not be NULL).

This member supports multiple filename extensions for the package's data. Use a semi-colon (;) to separate the individual extensions, and make sure there are no leading or trailing spaces.

nEntryStampType A flag specifying the method to be used to track entries so that only new entries are processed during the next update. This applies only to rows passed in through the CMA_JOURNALENTRY structure. This can be any of the values from the CMA_ENTRYSTAMPTYPE enumeration. This member is required (must not be NULL).

For more information about how filters perform updates, see the Frequently Asked Questions section of Import Filters for the Microsoft Small Business Customer Manager

nEntryStringStampLength1 The length (in characters) of the string that identifies a subsystem for which the Import Wizard will store the highest entry number so that updates can continue with the next entry for the subsystem. For example, if the subsystem ID is "GL," the length would be 2. For more information, see the topic, CMA_LoadEntry. This member is used only if nEntryStampType is set to 3; otherwise, it is ignored.

nEntryStringStampLength2 The maximum number of digits to consider after the subsystem ID specified by nEntryStringStampLength1. For example, specifying five digits results in strings such as "GL145 AP73" being stored in the szEntryStringStamp of the CMA_CTRLINFO structure, which indicates the last imported GL entry is 145 and the last imported AP entry is 73. The next update continues with GL entry number 146 and AP entry number 74. For more information, see the topic, CMA_LoadEntry. This member is ignored if nEntryStampType is not equal to 3.

nInvoiceType A flag specifying the method to be used to match invoice line items to transaction detail lines. This method is included only for backward compatibility. This member should be set to 0 (zero).

dwCMAVersion The version of the CMA structures used to build the filter DLL. This member is required (must not be NULL). This should be the CMA_Version defined in Aacommon.h.

nOrgUpdateMethod A flag specifying the method to be used to keep track of organizations during the next update. This applies only to data passed in through the CMA_LoadOrganization function and related information imported by using the CMA_LoadOrganizationStreetAddress, CMA_LoadOrganizationWebAddress, and CMA_LoadOrganizationPhoneNumber functions. This can be any of the values from the CMA_UPDATEMETHOD enumeration. This member is required (must not be NULL).

nContactUpdateMethod A flag specifying the method to be used to keep track of contacts during the next update. This applies only to data passed in through the CMA_LoadContact function and related information imported by using the CMA_LoadContactStreetAddress, CMA_LoadContactWebAddress, and CMA_LoadContactPhoneNumber functions. This can be any of the values from the CMA_UPDATEMETHOD enumeration. This member is required (must not be NULL).

nInvoiceUpdateMethod A flag specifying the update method to be applied to invoices during the next update. This applies only to data passed in through the CMA_LoadInvoiceHeader function and related information imported by using the CMA_LoadInvoiceDetail, CMA_LoadDueDateDetail, CMA_LoadInvoiceStreetAddress, CMA_LoadInvoicePhoneNumber, and CMA_LoadInvoiceWebAddress functions. This can be any of the values from the CMA_UPDATEMETHOD enumeration. This member is required (must not be NULL).

nPaymentUpdateMethod A flag specifying the update method to be applied to payments during the next update. This applies only to data passed in through the CMA_LoadPaymentDetail function. This can be any of the values from the CMA_UPDATEMETHOD enumeration. This member is required (must not be NULL).

nProductUpdateMethod A flag specifying the update method to be applied to products during the next update. This applies only to data passed in through the CMA_LoadProductInfo function. This can be any of the values from the CMA_UPDATEMETHOD enumeration. This member is required (must not be NULL).

For more information about how filters perform updates, see the Frequently Asked Questions section of Import Filters for the Microsoft Small Business Customer Manager.