Click or drag to resize

COM Library Manual

COM (Component Object Model) is a platform for software components.

This allows dynamic object creation, in any programming language that supports the technology.

This library is a reduced version of the .NET client library prepared for languages compatible with COM.

This version presents the following changes respecting to the original:

  • Only synchronous persistent functions that return LkData objects are available from client functions. Automatic classes (List<T>) are excluded.

  • In the MV Functions and Data Functions, their respective objects must be requested before using them

The client presenting functions objects must be used with the constructor empty and they must be later initialized using the InitializeProperties methods.

If you want to use the COM library it is necessary to register it in the computer.

The library register is made through the RegAsm.exe tool, which location will depend on the machine where it is going to be executed.

How to register 32 bits LinkarClientCOM from the commands console of windows (cmd):

C:\>C:\Windows\Microsoft.NET\Framework\v4.0.30319\regasm "C:\linkar\Clients\NET_Framework\x86\LinkarClientCOM.DLL" /codebase /tlb

How to register 64 bits LinkarClientCOM from the commands console of windows (cmd):

C:\>C:\Windows\Microsoft.NET\Framework64\v4.0.30319\regasm "C:\linkar\Clients\NET_Framework\x64\LinkarClientCOM.DLL" /codebase /tlb

Important

  • It is recommended that the console is opened in admin mode to avoid errors in the register.

  • You must have Framework 4.5 (v4.0.30319) and use the RegAsm from that Framework.

  • There are two RegAsm versions, 32 and 64 bits (Framework or Framework64). You must use the same as the one from the library to register; otherwise the command will return an error.

  • For Excel, it is necessary that the registered library is the same as the Excel version you have.

Linkar can use three types of Functions:

PERSISTENT FUNCTIONS

Exclusively from OOP (OBJECT-ORIENTED PROGRAMMING) and allow the creation of a LinkarClt object that manages all the operations.

After creating the object, it is necessary to Login that, through a Session code; this allows it to make all the desired operations until a call to the Close method is produced or until the session expires because of inactivity. This is defined on its EntryPoint.

They are useful for applications that require user identification, for instance, to log into an ERP session.

DIRECT FUNCTIONS

Used for direct and independent communication with the database.

Its arguments contain the necessary information to identify the user before returning the required information.

Unlike persistent functions, these do not have a Session Code, each call is completely independent of the others and does not have Login or Close functions.

They are used for database access from public websites, for instance online shops.

TEXT FUNCTIONS

This type of function does not need to access the database.

They are executed in the client and their goal is to ease the management of the MV buffers.

They are grouped in the MV Functions and Data Functions chapters