Enterprise Communication Interface (ECI)

DFM and Quickload

Quickload is an extension to Fileserver and ECI.

With the standard ECI, only one level of a document structure can be read at once with the funciton eci_rea_rel, and needs to be repeated for every structure level. Afterwards, you have to call the function eci_cko_typ_fil for each found record to check out the assigned files.

With Quickload this process got improved. By calling the ECI function eci_loa_cax, the whole document structure with its file records are stored (flat) in two temporary tables:

To check out all corresponding files, you call the ECI function eci_cko_fil_lst.

The structure explosion for the document structure and files is done by a stored procedure:

 

Typical Sequence of ECI Functions

CAX adapter calls eci_loa_cax to load documents with quick load mechanism.
 
  1. In interactive mode the document type widget is opened and the user can select a document record.
  2. From the context menu, choose Load to CAD > Selection to CAD.
    This calls the userexit edb_usx with parameter eci_sel_dfm_ret.
    The LGV procedure "EP_DFM/DFM_SELECTION_CAD" is called for each selected record.
    In a DFM environment this LGV procedure asks if non-local files should be replicated immediately, in batch mode, or to abort the function.
    Afterwards, for all records with local files, the function eci_sel_retis is called.
    If no records can be found with local files, the function eci_sel_abo is called.
    eci_sel_ret itself calls xfile_loa_cax_str for each selected record which calls the stored procedure which fills the temporary tables T_CAX_STR_TMP and T_CAX_FIL_TMP.
    The ECI function returns the structure ID and other values which are used to identify the entries in the temporary tables.
    In batch mode, xfile_loa_cax_stris called immediately for selected document record.
If some files should not be checked out or should be checked out with different name, CAX adapter calls eci_upd_cax_fil to modfiy the records in T_CAX_FIL_TMP.
CAX adapter calls eci_cko_fil_lst to checkout all files in file list.
If the entries are not needed any longer, they should be deleted in the temporary tables by calling eci_del_cax_tmp.
As entries are stored in global temporary tables, they will be deleted automatically when terminating the program.

 

 

Temporary Tables

  T_CAX_FIL_TMP
 
STRUCTURE_ID
DOC_C_ID
FILE_C_ID
LOCAL
SITE
STORAGE_AREA
STORE_TYPE
STORE_KIND
STORE_NODE
NET_PROTOCOL
STORE_DISCPATH
CRYPT_NAME
FILE_STATUS
ERROR_CODE
FILE_NAME
STEP_ID
FILE_FORMAT
STEP_CRE_SYSTEM
CKO_FLAG
NEW_NAME
 

T_CAX_STR_TMP

Has more than 100 columns.

 
  • Columns starting with "F_"
    Refer to a parent record from T_DOC_DAT
  • Columns starting with "S_"
    Refer to a child record from T_DOC_DAT
  • Without a prefix
    Refer to a relation record from T_DOC_STR
 
STRUCTURE_ID
DOC_STR_C_ID
F_C_ID
S_C_ID
STR_LEVEL
POS_NO
VAL_FROM
VAL_UNTIL
CUR_FLAG
TRA_REF
NTM_REF
STEP_REL_TYPE
STEP_DESCR
UG2_IDENT
CAX_REF
CAX_COM
ECC_XMAT
CAX_01
CAX_02
CAX_03
CAX_04
F_DOC_ID
F_DOC_VERSION
F_DOC_REVISION
F_SHEET_NO
...
...