CMA_JOURNALENTRY

Contains basic information about an entry from the specified accounting system data file. A filter DLL receives this structure when the Import Wizard calls the DLL's CMA_LoadCompany, CMA_LoadEntry, and CMA_LoadDetail functions. The CMA_LoadCompany function fills only the lCount member. The CMA_LoadEntry and CMA_LoadDetail functions must fill in the structure with the appropriate information.

Syntax

typedef struct tagCMA_JOURNALENTRY {
    LONG    lCount;
    LONG    lEntryNumberStamp;
    SYSTEMTIME    stEntryDateStamp;
    CHAR    szEntryStringStamp[21];
    CHAR    szSourceCode[21];
    CHAR    szUpdateControl[2];
    INT    nFiscalYear;
    INT    nPeriodNumber;
    SYSTEMTIME    stTransactionDate;
    CHAR    szPrimaryReference[11];
    CHAR    szExplanation[256];
} CMA_JOURNALENTRY;

lCount This represents the number of journal entries to be presented to the filter. SBCM uses this value to generate the progress display for the user during the import process.

lEntryNumberStamp The number of the entry to be tracked so that during an update, the only entries imported are those whose EntryNumberStamp value is greater than the highest EntryNumberStamp value of the last import or update as saved in the AA_ControlInformation table. This member is used only if the CMA_LoadPackage function set the nEntryStampType member of the CMA_PACKAGE structure to 1, specifying the number method is to be used to track entries for subsequent imports or updates. For more information about updates, see the Frequently Asked Questions section of Import Filters for the Microsoft Small Business Customer Manager.

stEntryDateStamp The date stamp for the specified entry.

szEntryStringStamp A null-terminated string that contains a two-part string the Import Wizard uses to track the last imported entry. The first part identifies an accounting subsystem, and the second part specifies the number of the last entry that was imported for that subsystem (for example, "GL143", "PR45", or "IN43245"). This member is used only if the CMA_LoadPackage function set the nEntryStampType member of the CMA_PACKAGE structure to 3, specifying the string method is to be used to track entries for subsequent imports or updates. For information about updates, see the Frequently Asked Questions section of Import Filters for the Microsoft Small Business Customer Manager.

szSourceCode The source code used; this is for reference purposes. Examples include "GJ" (General Journal) for most transactions, "BB" for beginning balance transactions, and "NBG" (NewBudget) for budget transactions.

szUpdateControl The update-control code. This can be any of the values from the CMA_UPDATECONTROL enumeration.

nFiscalYear The fiscal year for the transaction currently displayed. This member is required (must not be NULL).

nPeriodNumber The period number for the transaction currently displayed. This member is required (must not be NULL).

stTransactionDate The transaction date. This member is used for reference purposes only. This member is required (must not be NULL).

szPrimaryReference A null-terminated string for referencing the specified entry.

szExplanation A null-terminated string for providing an explanation of the entry.