create()

Legt eine Mappe an und gibt sie vollständig gelesen als ECMPortfolio zurück.

1. Signatur

  • Sync

  • Async

ecm.portfolio.create(*, creator: str | None = None, recipient: str | None = None,
                     subject: str | None = None,
                     objects: Iterable[ECMPortfolioObjectLike] | None = None,
                     object_type_id: int | None = None,
                     reuse_existing: bool = False) -> ECMPortfolio
await ecm.portfolio.create(...) -> ECMPortfolio

2. Parameter

Parameter Typ Standard Beschreibung

creator

str | None

None

Anmeldename des Erstellers.

recipient

str | None

None

Anmeldename des Empfängers, für eine an jemanden übergebene Mappe.

subject

str | None

None

Titel der Mappe. Die Datenbankspalte fasst 32 Zeichen; was mit längeren Werten geschieht, entscheidet der Server.

objects

Iterable | None

None

Startinhalt. Zulässig sind ECMPortfolioObject, (id, type_id)-Paare und Modellinstanzen.

object_type_id

int | None

None

Beschränkt die Mappe auf diesen Objekttyp. Objekte anderer Typen weist der Server danach ab.

reuse_existing

bool

False

True liefert die vorhandene Mappe zu recipient/subject, statt eine zweite gleichen Titels anzulegen (Mode=0).

3. Rückgabe

Die angelegte oder weiterverwendete ECMPortfolio.

Betreff, Empfänger und Objekttyp einer bestehenden Mappe lassen sich nachträglich nicht mehr ändern, die Server-API kennt dafür keinen Job. Umbenennen bedeutet löschen und neu anlegen.

4. Fehler

ECMException, wenn der Server keine brauchbare Mappen-ID liefert.

5. Beispiel

mappe = ecm.portfolio.create(
    creator="ROOT",
    recipient="ROOT",
    subject="Wiedervorlage KW 34",
    objects=[(83, 262144)],
)
print(mappe.id, mappe.created)

# Idempotent: legt nur beim ersten Aufruf an
mappe = ecm.portfolio.create(recipient="ROOT", subject="Wiedervorlage", reuse_existing=True)

6. Verwandte Seiten