= get_object_type_by_id()
:description: Löst die numerische Objekttyp-ID für eine ECM-Objekt-ID auf (dms.GetObjectTypeById). Nützlich, wenn nur die object_id bekannt ist und der Typ ermittelt werden muss.
:keywords: get_object_type_by_id, GetObjectTypeById, object_id, Objekttyp-ID, Typ ermitteln
:page-tags: api, dms

Ermittelt die numerische Objekttyp-ID für eine gegebene ECM-Objekt-ID über
`dms.GetObjectTypeById`. Nützlich, wenn nur die Objekt-ID bekannt ist, aber
der Typ benötigt wird — zum Beispiel vor dem Aufruf von `delete()` oder `move()`
mit einer numerischen ID.

== Signatur

[tabs]
====
Sync::
+
[source,python]
----
ecm.dms.get_object_type_by_id(object_id: int) -> int
----

Async::
+
[source,python]
----
await ecm.dms.get_object_type_by_id(object_id: int) -> int
----
====

== Parameter

[cols="1,1,3"]
|===
|Parameter |Typ |Beschreibung

|`object_id`
|`int`
|Numerische ID des ECM-Objekts.
|===

== Rückgabewert

Die numerische Objekttyp-ID des Objekts mit der angegebenen `object_id`.

== Ausnahmen

[cols="1,3"]
|===
|Ausnahme |Bedingung

|`ECMNotFoundException`
|Kein Objekt mit der angegebenen `object_id` existiert auf dem Server.
|===

== Beispiele

=== Typ eines Objekts anhand seiner ID ermitteln

[tabs]
====
Sync::
+
[source,python]
----
type_id = ecm.dms.get_object_type_by_id(12345)
print(type_id)
----

Async::
+
[source,python]
----
type_id = await ecm.dms.get_object_type_by_id(12345)
print(type_id)
----
====

=== Zusammen mit delete() verwenden, wenn nur die ID bekannt ist

[tabs]
====
Sync::
+
[source,python]
----
object_id = 12345
object_type_id = ecm.dms.get_object_type_by_id(object_id)
ecm.dms.delete(object_id, object_type_id)
----

Async::
+
[source,python]
----
object_id = 12345
object_type_id = await ecm.dms.get_object_type_by_id(object_id)
await ecm.dms.delete(object_id, object_type_id)
----
====

=== Typ auflösen und in der Objektdefinition nachschlagen

[tabs]
====
Sync::
+
[source,python]
----
object_id = 12345
type_id = ecm.dms.get_object_type_by_id(object_id)
definition = ecm.system.definition()
obj_def = definition[type_id]
print(obj_def.internal_name, obj_def.maintype)
----

Async::
+
[source,python]
----
object_id = 12345
type_id = await ecm.dms.get_object_type_by_id(object_id)
definition = await ecm.system.definition()
obj_def = definition[type_id]
print(obj_def.internal_name, obj_def.maintype)
----
====

== Siehe auch

* xref:api/dms/get.adoc[get()] — Einzelnes Objekt anhand der ID laden
* xref:api/dms/delete.adoc[delete()] — Objekt anhand ID und Typ löschen
* xref:api/system/definition.adoc[definition()] — Objekttypdefinitionen auflösen
