1. Identification
| Parameter | Value |
|---|---|
| Object Type | Catalog |
| Name | PowerOfAttorneyAttachedFiles |
| Full Name | Catalog.PowerOfAttorneyAttachedFiles (Catalogs.PowerOfAttorneyAttachedFiles) |
| Synonym | — (service, synonym not assigned) |
| Configuration | Accounting for Kazakhstan, edition 3.0.74.2 |
| Hierarchy | No (flat list of versions/file cards) |
| Navigation Link | e1cib/list/Catalog.PowerOfAttorneyAttachedFiles |
| Purpose | Storage and management of electronic files (scans, PDFs, images, contracts) attached to "Power of Attorney" documents |
Role in the configuration. This is a service catalog of the file management subsystem of the BSP (standard subsystem "File Management"). For each owner object that is allowed to attach files, the platform/configuration creates a separate catalog of the type <Owner>AttachedFiles. This catalog serves the document Power of Attorney: the user interacts with it indirectly through the power of attorney form (commands "Attached Files", "Attach File", drag-and-drop). The catalog supports versioning, electronic signature, encryption, and storage of the file both in the information base and on external volumes.
Note: the catalog is not accounting — it does not generate accounting entries and does not participate in tax calculations of the RK (VAT 16%, PIT, social contributions, etc.). The calculation logic (rates, accounts of the RK plan) is implemented in the owner document "Power of Attorney" and related documents of sale/receipt, not in the file catalog.
2. Attributes of the header and table parts
2.1 Header Attributes
| Name | Type | Mandatory | Purpose |
|---|---|---|---|
| Author | Catalog.Users | Mandatory (ShowError) | User who uploaded the file; filled automatically upon creation |
| FileOwner | Document.PowerOfAttorney | Optional | Reference to the power of attorney document to which the file is attached; main link of the file to the document |
| UniversalModificationDate | Date and time (UTC) | Optional | Date/time of the last modification of the file in UTC; for synchronization and tracking changes |
| CreationDate | Date and time (UTC) | Mandatory (ShowError) | Date/time of the initial upload; filled automatically |
| Encrypted | Boolean | Optional | Indicates whether the file is encrypted with user certificates |
| ModifiedBy | Catalog.Users | Optional | User who last modified the file or its properties |
| ImageIndex | Number | Optional | Index of the file type icon in the image collection for visual display |
| Description | String | Optional | Text description/comment for the file |
| SignedEP | Boolean | Optional | Indicates the presence of an electronic signature |
| FilePath | String | Optional | Full path to the file on the storage volume (for files outside the database) |
| Size | Number | Optional | Size of the file in bytes |
| Extension | String | Optional | File extension without a dot ("pdf", "jpg", "docx") |
| EditingUser | Catalog.Users | Optional | User currently editing the file (locking mechanism) |
| TextExtractionStatus | Enumeration.TextExtractionStatusFiles | Optional | Status of text extraction for full-text search |
| TextStorage | Value storage | Optional | Extracted text content of the file for full-text search |
| FileStorageType | Enumeration.FileStorageTypes | Mandatory (ShowError) | Method of storage: in the database or on an external volume |
The name (Name, standard attribute) stores the file name without the extension; the full name is formed as Name + "." + Extension.
2.2 Table Parts
The catalog does not have its own table parts. Binary data of files stored "in the database" is placed:
- in the value storage through the information register of the file subsystem (for BSP —
BinaryFileData/ storage of volumes), or - on an external volume (
Catalog.FileStorageVolumes), whenFileStorageType = OnVolume; in this case, the attributeFilePathis significant.
File versions and attached electronic signatures are stored in separate service objects of the subsystem (registers/catalogs of versions and EP), not in the table parts of this catalog.
3. Forms
As an element of the file subsystem, the catalog primarily uses common BSP forms, not its own:
| Form | Purpose |
|---|---|
| ElementForm (card) | View and edit file properties: name, description, author, dates, size, EP/encryption indicators. Commands: open, save as, edit, finish/cancel editing |
| ListForm | Service list of all attached files of the catalog; opened via the link e1cib/list/Catalog.PowerOfAttorneyAttachedFiles (used by the administrator/for debugging) |
| SelectForm | Select a file from the list attached to the owner |
| Common form "AttachedFiles" (BSP) | Main user interface: list of files for a specific power of attorney with commands "Add" (from file/from scanner), "View", "Edit", "Sign EP", "Encrypt", working with versions. Opened from the document form "Power of Attorney" |
| Common forms EP/encryption (BSP) | Applying and verifying electronic signatures, encryption/decryption |
4. Key Procedures of Modules
No application BSL code is attached to the evidence — the catalog does not carry calculation logic. Processing is performed by standard mechanisms of the "File Management" subsystem of the BSP. Standard handlers of this type of object:
Object Module:
BeforeWriting— recording indicators of changes, control of file occupancy by editing (attributeEditingUser), updatingUniversalModificationDateandModifiedBy.OnCopying/FillCheckFilling— control of mandatory attributesAuthor,CreationDate,FileStorageType(ShowError flag).
Manager Module:
- Functions for creating a file element and recording binary data (through the common module
FileManagementService/AttachedFilesServiceBSP): receiving the file stream, determining the extension, size, image index, settingAuthor,CreationDate.
Forms (handlers):
AttachFile/AddFile— uploading a file from disk or scanner, creating an element, linking toFileOwner.Open/FinishEditing— unloading to temporary storage, locking viaEditingUser, receiving the modified version back.SignEP/Encrypt— working with cryptography, settingSignedEP/Encrypted.
Requires verification (version-dependent): the specific composition of common BSP modules and exact procedure names depend on the version of BSP embedded in 3.0.74.2.
5. Posting and Movements
The catalog is not posted and does not generate movements in either accounting registers or accumulation/information registers of the accounting circuit. Accordingly:
- it does not create entries in the RK chart of accounts (1210, 1030, 1330, 3310, 3130, 6010, 7010, etc.);
- it does not participate in VAT calculations (16%), PIT, social contributions (10%), social contributions for the self-employed (3.5%), VOSMS (2%), OSMS (3%), social tax (6%);
- it does not participate in the exchange of electronic invoices (ESF) (IS ESF) and SNF — these documents are related to sales/movement, not to the storage of the power of attorney scan.
The only records accompanying the element are service records: information about binary data/versions, electronic signatures, and extracted text (TextStorage, TextExtractionStatus) for full-text search. This data is stored in the registers of the BSP file subsystem.
6. Related Objects and Input on the Basis
| Object | Relation |
|---|---|
| Document.PowerOfAttorney | Owner of files (attribute FileOwner); the catalog exists solely to service this document |
| Catalog.Users | Author, ModifiedBy, EditingUser |
| Catalog.FileStorageVolumes | Physical storage location when FileStorageType = OnVolume |
| Enumeration.FileStorageTypes | Method of storage (in database / on volume) |
| Enumeration.TextExtractionStatusFiles | Status of text indexing |
| Service objects of BSP (file versions, EP, binary data) | Storage of content, versions, and signatures |
Input on the basis for the service file catalog is not provided. Elements are created only through the file attachment mechanism from the power of attorney form. The power of attorney can be opened from the file card via the attribute FileOwner.
7. Extension Points
- Format and size restrictions. Allowed extensions and maximum size are set in the settings of the "File Management" subsystem (constants/register of settings of BSP), not in the catalog itself.
- Storage. Switching "in database / on volume" through
FileStorageTypeand the catalog of volumes; expandable by adding new volumes without changing metadata. - Additional attributes/information. Through the BSP properties mechanism (
CharacteristicTypes.AdditionalAttributesAndInformation), attributes can be added to files without changing the configuration on support. - Subscriptions to events / configuration extensions. The processing of
BeforeWriting/OnWritingof the element can be supplemented in the extension for auditing, auto-numbering, or integration with external storage. - Full-text search. Text extraction (
TextStorage,TextExtractionStatus) is configured by a regulatory task; expandable for new file types. - Cryptography. EP and encryption profiles are configured in the BSP electronic signature subsystem; the catalog only stores indicators (
SignedEP,Encrypted).
