Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 1.0.0 instead.
Reason given by maintainers: TLS certificate missmatch with Python <=3.10

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)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ecmind_blue_client-0.8.1.dev8.tar.gz (44.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ecmind_blue_client-0.8.1.dev8-py3-none-any.whl (44.8 kB view details)

Uploaded Python 3

File details

Details for the file ecmind_blue_client-0.8.1.dev8.tar.gz.

File metadata

  • Download URL: ecmind_blue_client-0.8.1.dev8.tar.gz
  • Upload date:
  • Size: 44.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for ecmind_blue_client-0.8.1.dev8.tar.gz
Algorithm Hash digest
SHA256 ae5e9e609cdcd57089265dd0ec1839441df1e477b7c6bf6e46ee121761085d89
MD5 391a5486311b5c0acc1c1676b4b2e169
BLAKE2b-256 162cec42f304c9d02f9b91c498970e0c63f39d826b0b9d367cb33eaae4f670de

See more details on using hashes here.

File details

Details for the file ecmind_blue_client-0.8.1.dev8-py3-none-any.whl.

File metadata

File hashes

Hashes for ecmind_blue_client-0.8.1.dev8-py3-none-any.whl
Algorithm Hash digest
SHA256 09bd8d5e6c83f30f30f56d2e66a14a41f31e6c50410615eaff65f19cda44cced
MD5 cc62231525624522dc3b52cd375f96a5
BLAKE2b-256 54f971c5dd21f04384b8c779f338b9041ccdd0e75e5bcd1076f0757ebab195da

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page