1. Identification
| Parameter | Value |
|---|---|
| Object Type | Catalog |
| Name | CounterpartyContractsAttachedFiles |
| Full Name | Catalog.CounterpartyContractsAttachedFiles |
| Synonym | “Attached Files (Counterparty Contracts)” |
| Configuration | Accounting for Kazakhstan, edition 3.0 (3.0.74.2) |
| File Owner | Catalog.CounterpartyContracts |
Purpose. A service (technical) catalog of the “File Management” subsystem of the standard subsystem library (BSP). Stores files attached to the elements of the “Counterparty Contracts” catalog: scanned copies of contracts, additional agreements, acts, specifications, and other accompanying documentation in electronic form. Each catalog element is one attached file along with its metadata (author, dates, size, extension, signature and encryption indicators). The user interacts with the catalog indirectly — through the “Attached Files” command in the counterparty contract card; it is not displayed directly in the sections of the command interface.
Attached files of this type are created automatically for each owner catalog that has file management enabled. Similar objects exist for counterparties, nomenclature, and other configuration objects.
Where to find (navigation link): e1cib/list/Catalog.CounterpartyContractsAttachedFiles — opens a service list of all files; in standard operation, the “Attached Files” command is used from the contract form.
2. Attributes and Table Parts
2.1 Header Attributes (from evidence)
| Name | Type | Mandatory | Purpose |
|---|---|---|---|
| Author | CatalogReference.Users | ShowError (mandatory) | The user who initially uploaded the file. Authorship control and audit. |
| FileOwner | CatalogReference.CounterpartyContracts | DontCheck | The counterparty contract to which the file is attached. Ensures connection with the main accounting object. |
| UniversalModificationDate | Date (DateTime) | DontCheck | Date/time of the last modification of the file in UTC. Synchronization and tracking of version relevance. |
| CreationDate | Date (DateTime) | ShowError (mandatory) | Date/time of the initial upload. Chronological accounting and sorting. |
| Encrypted | Boolean | DontCheck | Indicator of file encryption with certificates. Determines the need for decryption before opening. |
| ModifiedBy | CatalogReference.Users | DontCheck | The user who last modified the file or its metadata. Audit and version control. |
| ImageIndex | Number | DontCheck | Index of the file icon in the interface image collection (by extension). |
| Description | String | DontCheck | Arbitrary text description of the content/purpose of the file. |
| SignedByEP | Boolean | DontCheck | Indicator of the presence of at least one valid electronic signature. |
| FilePath | String | DontCheck | Path to the file on the volume (for storage “On volumes on disk”); not filled when stored in the database. |
| Size | Number | DontCheck | Size of the file in bytes. Volume control and upload limits. |
| Extension | String | DontCheck | File extension (pdf, docx, jpg …). Determines type, opening program, and icon. |
| EditingUser | CatalogReference.Users | DontCheck | The user who has taken the file for editing (prevents simultaneous editing). |
2.2 Typical Attributes for Attached Files in BSP
In addition to those listed in evidence, the attached files catalogs in BSP typically contain several other attributes that ensure versioning and content storage:
| Name | Type | Purpose |
|---|---|---|
| Name | String (main field) | The name of the file without the extension — displayed in lists. |
| FileStorageType | EnumerationReference.FileStorageTypes | Method of storage: in the information base or on volumes on disk. |
| Volume | CatalogReference.FileStorageVolumes | Storage volume (when type is “On volumes on disk”). |
| CurrentVersion | CatalogReference.…VersionsOfAttachedFiles | Reference to the active version of the file (when versioning is enabled). |
| UploadedToDatabase | Boolean | Indicator that the content of the file has been placed in the value storage attribute. |
| FileStorage | ValueStorage | Binary data of the file (when stored in the IB). |
The exact set of service attributes for versioning depends on the version of BSP built into 3.0.74.2 — requires verification in the specific delivery.
2.3 Table Parts
The catalog has no table parts. A file is an atomic entity: one catalog element corresponds to one attached file. Data on versions and electronic signatures are placed in separate objects (version register, register of digital signature information), not in table parts.
3. Forms
The service catalog of attached files generally does not have its own forms — work is conducted through the common forms of the “File Management” subsystem of BSP:
| Form | Type | Purpose |
|---|---|---|
| CommonForm.AttachedFiles | List form | List of files attached to a specific contract. Opens with the “Attached Files” command. Commands: add, open, edit (take/release), save changes, versions, EP, encryption. |
| CommonForm.FileView / FileCard | Element form | View and edit file metadata: description, author, dates, size, version, signatures. |
| CommonForm.FileSelectionForm / AddFiles | Service | Dialog for uploading a file from disk and creating a catalog element. |
| List form (auto) | List form | Auto-generated list by navigation link e1cib/list/… for service/administrative access. |
If in a specific delivery the forms are still redefined at the catalog level — their purpose coincides with the above; requires verification of the metadata composition 3.0.74.2.
4. Key Module Procedures
No separate BSL code is attached in evidence. For the service catalog of attached files, the main logic is implemented not in the object module, but in the common modules of the BSP file subsystem (FileManagement, ServiceFileManagement, ServiceFileManagementClient, ServiceFileManagementServerCall). Typical handlers and logic points for this type of object:
- ManagerModule.BeforeOpeningForm — substitution of its own forms with common BSP forms.
- ObjectModule.BeforeWriting — filling in service fields:
UniversalModificationDate,ModifiedBy, indicatorsSignedByEP/Encrypted, recalculation ofSize. - ObjectModule.BeforeDeleting — clearing content in the disk volume (deleting the physical file) when deleting an element stored outside the IB.
- Common module
ServiceFileManagement— methodsAddFile,UpdateFileVersion,TakeFile/ReleaseFile, working with versions, EP, and encryption; these create and modify elements of this catalog. - Editing Lock Handlers — setting/removing the
EditingUserattribute to prevent simultaneous modification of the file by multiple users.
Specific paths
path:stringare not provided — evidence with the source code of the modules was not supplied; standard handlers characteristic of BSP attached files are listed.
5. Posting and Movements
The catalog is not a document and is not posted — it does not generate registers and accounting entries. This is fundamental for this type of object: attached files store electronic documents, not facts of economic life.
The generated data is of an accounting-technical nature and is created by the file subsystem, not by the posting mechanism:
- recording content in value storage (when stored in IB) or physical file in volume on disk;
- recording versions in the service register/catalog of attached file versions;
- recording information about electronic signatures in the register of digital signature information of BSP.
The accounting meaning (entries according to the typical chart of accounts of the RK) arises not in the file, but in the related owner document. For reference — these entries form sales/purchase documents according to the contract to which the file is attached, for example:
| Operation of the owner document | Dr | Cr |
|---|---|---|
| Sale to the customer (revenue) | 1210 | 6010 |
| VAT accrued to be paid (rate 16 %) | 1210 | 3130 |
| Cost of goods written off | 7010 | 1330 |
| Payment from the customer to the current account | 1030 | 1210 |
| Receipt of goods from the supplier | 1330 | 3310 |
Electronic documents for such a contract (ESF in the ESF IS, SNT) are issued by the relevant configuration objects; the attached file itself only stores their electronic copies/scanned images. All tax amounts in the owner documents are calculated according to the RK norms of 2026 (VAT 16 %, PIT 10 %/15 %, OPP 10 %, OPPR 3.5 %, VOSMS 2 %, OSMS 3 %, CO 5 %, social tax 6 %; MRP 4,325 ₸, MZP 85,000 ₸), but they have no relation to the catalog of files itself.
6. Related Objects and Input on the Basis
Owner (mandatory link):
Catalog.CounterpartyContracts— defined through the attributeFileOwner; determines which contract the file relates to.
Adjacent objects of the BSP file subsystem:
Catalog.UsersFileSets/ register of versions of attached files — storage of version history;RegisterInformation.FileElectronicSignatures(information about EP) — signature data for the attributeSignedByEP;Catalog.FileStorageVolumes— volumes for storage “on disk”;Enumeration.FileStorageTypes— method of storage;Catalog.Users— attributesAuthor,ModifiedBy,EditingUser.
Input on the basis. The “Input on the basis” mechanism for this catalog is not applied — elements are created exclusively through the “Attached Files” command (adding/uploading/scanning) in the counterparty contract form and programmatically by means of BSP.
7. Extension Points
- File upload/save — redefined through common modules
FileManagement*(configuration extension), but with caution: this is BSP code, updated together with the platform library. - Additional attributes and information — service file catalogs are generally excluded from the composition of objects with additional attributes; if necessary, arbitrary notes are stored in the
Descriptionattribute. - BSP event handlers — subscriptions to events of recording attached files for logging/integration with external EDO, ESF IS, SNT.
- Configuration extension — adding custom attributes/commands to the list form of attached files without removing the configuration from support.
- Access restriction (RLS) — access to files inherits rights to the owner object (counterparty contract); settings... ```
