ECMind blue client

A client wrapper for blue.

Deprecation warning

From Mai 2024, ecmind_blue_client.com_client is no longer supported nor tested.
From Mai 2024, ecmind_blue_client.soap_client is no longer supported nor tested.

Installation

pip install ecmind_blue_client

Usage

The workflow consists roughly of the following:

Create a new Client() connection using a client implementation. There are four implementations:
- SoapClient() in the module ecmind_blue_client.soap_client: Connect with a SOAP connection string
- ComClient() in the module ecmind_blue_client.com_client: Connect by using the COM class on Windows
- TcpClient() in the module ecmind_blue_client.tcp_client: Directly talk to a server via protlib.
  - Use TcpClient.Connection() in a with block/context.
- TcpPoolClient() in the module ecmind_blue_client.tcp_pool_client
Create a new Job() with a job name and provide/add job input parameters and optional job input file parameters
Execute the Job() with the Client() instance and consume the result
- result.result_code returns the blue result code
- result.values is a dict of output parameters
- result.files is a list of output file parameters
- result.error_messages is a string of the servers error response or None if result_code == 0

>>> from ecmind_blue_client.soap_client import SoapClient
>>> client = SoapClient(self.endpoint, 'TestApp', 'root', 'optimal')
>>> test_job = Job('krn.GetServerInfo', Flags=0, Info=6)
>>> result = client.execute(test_job)
>>> print(result.values['Value'])
oxtrodbc.dll

Example

from ecmind_blue_client import SystemFields
from ecmind_blue_client.tcp_pool_client import TcpPoolClient as Client

# Connect with DMS
client = Client(
    connection_string="localhost:4000:100", # Balancing setup for the used Client class `TcpPoolClient`
    appname="Test-Script",                  # Instance name, visible in the enterprise manager
    username="root",
    password="optimal"
)

# Query a folder
query = client.lol_query(
    object_name="Dossier",
    result_fields=[
        SystemFields.OBJECT_CRDATE, 
        "LastName", 
        "FirstName"
    ]
)

# Iterate over folder results
for dossier in query:
    print(                                                 # Output some infos
        dossier["OBJECT_ID"],                              # OBJECT_ID is added per defaults
        dossier['OBJECT_CRDATE'].strftime("%Y-%m-%d"),     # Manually added system field from line 16
        (f"{dossier['FirstName']} {dossier['LastName']}"), # Manually added objdef fields from line 17 & 18
    )

# Check that we have found a least one folder
assert dossier and "OBJECT_ID" in dossier

# Import a test document into the last found folder
import_result = client.xml_import(
    object_name="Dokument", 
    folder_id=dossier["OBJECT_ID"], 
    search_fields={
        "Type": "Invoice"
    },
    import_fields={
        "Type": "Invoice"
    },
    files = ["invoice.pdf"]
)

# Check if the import was successful and output OSID
assert import_result, import_result.error_message
print(import_result.import_action, import_result.object_id)

Development Status
- 4 - Beta
Intended Audience
- Developers
- System Administrators
Operating System
- OS Independent
Programming Language
- Python :: 3
Topic
- System :: Archiving

Metadata

Development Status
- 4 - Beta
Intended Audience
- Developers
- System Administrators
Operating System
- OS Independent
Programming Language
- Python :: 3
Topic
- System :: Archiving

Release files for ecmind-blue-client 0.9.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ecmind-blue-client 0.9.1
File	Size	Uploaded
ecmind_blue_client-0.9.1.tar.gz	53.0 kB	Jul 25, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for ecmind-blue-client 0.9.1
File	Interpreter	ABI	Platform	Reset
ecmind_blue_client-0.9.1-py3-none-any.whl 48.4 kB Jul 25, 2025	Python 3	none	any	Details

Total release size: 101.4 kB

Release files / ecmind_blue_client-0.9.1.tar.gz

Download URL	ecmind_blue_client-0.9.1.tar.gz
Size	53.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`f97848d421f003ac32af1341a75082df21a67332d61a90e6672ed678da7d7997`
BLAKE2b-256 checksum How to use checksums	`65e6d11d272ece95342ccd06a9bcad433e0c01f79d3e789b9c296d8e98b0e735`
Upload date	Jul 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.13`

Release files / ecmind_blue_client-0.9.1-py3-none-any.whl

Download URL	ecmind_blue_client-0.9.1-py3-none-any.whl
Size	48.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d58e1f1b43b4ffc40f11f89cefc79f78d96fe86f84a965ad3e8fc8c1da605468`
BLAKE2b-256 checksum How to use checksums	`2c7bdd77237d09f7d9e7cc4f1c312eaf79f00d16733aa01d5b0dcb800b17bf75`
Upload date	Jul 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.13`