empty_job()

Führt den generischen No-Op-Job krn.EmptyJob auf dem Server aus.

Dieser Job besitzt keine eigene Logik — alle Eingabeparameter und Dateien werden unverändert zurückgegeben (Echo). Sein Zweck ist es, als universeller Kommunikationskanal zu dienen, dessen Verhalten vollständig durch serverseitige Before/After-Events definiert wird.

Ohne konfigurierte Events verhält sich der Job als Echo: Alle Eingabeparameter und Dateien werden 1:1 in der Antwort zurückgegeben.

1. Signatur

  • Sync

  • Async

ecm.system.empty_job(*, files=None, **params) -> JobResult
await ecm.system.empty_job(*, files=None, **params) -> JobResult

2. Parameter

Parameter Typ Standard Beschreibung

files

list[JobRequestFile] | None

None

Optionale Liste von Eingabedateien, die an den Job gesendet werden.

**params

JobValueTypes

 — 

Beliebige Schlüsselwortargumente werden als Eingabeparameter an den Server gesendet und an die serverseitigen Events weitergereicht.

3. Rückgabewert

Ein JobResult-Objekt. Ausgabeparameter können über result.get(name, …​) abgerufen werden, zurückgegebene Dateien über result.files.

4. Beispiele

4.1. Echo-Test

  • Sync

  • Async

result = ecm.system.empty_job(MyParam="Hello World")
print(result.get("MyParam", str))  # "Hello World"
result = await ecm.system.empty_job(MyParam="Hello World")
print(result.get("MyParam", str))  # "Hello World"

4.2. Dateien senden und empfangen

  • Sync

  • Async

from ecmind_blue_client.rpc import JobRequestFile

file = JobRequestFile(name="test.txt", data=b"Hello")
result = ecm.system.empty_job(files=[file])
print(len(result.files))  # 1
from ecmind_blue_client.rpc import JobRequestFile

file = JobRequestFile(name="test.txt", data=b"Hello")
result = await ecm.system.empty_job(files=[file])
print(len(result.files))  # 1

5. Siehe auch