IRPCPropertyDefsAdmin.GetObjectClasses
Administration API / specialized admin session idempotent
Gets the administrative definitions of all classes.
| Service | Property definition and class administration MFiles.IRPCPropertyDefsAdmin |
|---|---|
| gRPC method | /MFiles.IRPCPropertyDefsAdmin/GetObjectClasses |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-object-classes |
| Request | GetObjectClassesRequest |
| Response | GetObjectClassesResponse |
| Book and level | Administration API, specialized |
| Kind | admin |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
- Requires a vault session; no vault rights are needed. A normal user got all 41 classes of the Sample Vault, the same as an administrator.
- Names are in the session language. For class groups and the per-user permissions of classes, use GetObjectClassesAndGroups.
Request: GetObjectClassesRequest
No fields.
Response: GetObjectClassesResponse
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
values[] | repeated DocClass | One DocClass per class. The class ID is value_list_item.item_info.obj_id.item_id.internal_id. |
values[].value_list_item | ValueListItem | Value list item representing this document class. |
values[].value_list_item.item_info | ItemInfo | The item's identity and name: obj_id.type is the value list ID, obj_id.item_id.internal_id the item ID (unique within the list only), plus name, guid, external_id and flags. options.is_deleted marks a deleted item. |
values[].value_list_item.has_parent | bool | True if the item has a parent item in the same (hierarchical) list. |
values[].value_list_item.has_owner | bool | True if the item belongs to an item of the owner list (ValueList.owner_object_type). |
values[].value_list_item.parent_id | int32 | With has_parent, the item ID of the parent item; otherwise ignored. |
values[].value_list_item.owner_id | int32 | With has_owner, the item ID of the owner item in the owner list. |
values[].value_list_item.owner_name | string | The name of the owner item. |
values[].value_list_item.automatic_permissions | AutomaticPermissions | If set, specifies the automatic permissions for an object for which the user selects this item. |
values[].value_list_item.icon | Bytes | If set, contains the icon of this item in .ICO format. |
values[].workflow | int32 | The default workflow of the document class, or zero if there is no default workflow. |
values[].object_type | int32 | The object type with which this class is used. |
values[].is_predefined | bool | True if this is a predefined class (cannot be deleted, editing is restricted). |
values[].force_workflow | bool | True if the use of the workflow with this class is enforced. |
values[].name_property_def | int32 | The ID of the property definition that represents the name of the document or other object. Typically PROPERTYDEF_TITLE (0). |
values[].object_type_specific_properties | ObjectTypeSpecificClassContentUnion | Additional object type specific class content. |
values[].object_type_specific_properties.assignment | AssignmentClassInfo (oneof data) | Assignment-specific class settings. |
values[].signature_settings_for_new_objects | ElectronicSignatureSettings | The electronic signature settings for creating an electronic signature for new objects. Reserved for future improvements. |
values[].signature_settings_for_new_objects.is_required | bool | True if this transition requires an electronic signature. |
values[].signature_settings_for_new_objects.prompt_mode | ElectronicSignaturePromptMode | Option 1: static reason/meaning.Values: ELECTRONIC_SIGNATURE_PROMPT_MODE_FIXED (0), ELECTRONIC_SIGNATURE_PROMPT_MODE_SELECTABLE (1). |
values[].signature_settings_for_new_objects.fixed_prompt_details | ElectronicSignaturePromptInfo | Option 2: Pre-defined reason |
values[].signature_settings_for_new_objects.selectable_prompt_details[] | repeated ElectronicSignaturePromptInfo | Option 3: Metadata-based reason/meaning. |
values[].signature_settings_for_new_objects.user_selectable_reason_meaning_items_property_def | int32 | A property definition that represents items in value list. Used if the prompt mode is eesrmpmPromptModeMetadataBasedUserSelectable. |
values[].signature_settings_for_new_objects.user_selectable_reason_property_def | int32 | A property definition that indicates the reason property. PROPERTYDEF_UNINITIALIZED if no reason is specified. Used if the prompt mode is eesrmpmPromptModeMetadataBasedUserSelectable. |
values[].signature_settings_for_new_objects.user_selectable_meaning_property_def | int32 | A property definition that indicates the meaning property. PROPERTYDEF_UNINITIALIZED if no meaning is specified. Used if the prompt mode is eesrmpmPromptModeMetadataBasedUserSelectable. |
values[].signature_settings_for_new_objects.add_metadata_reference_to_reason_meaning_item | bool | Common prompt details. |
values[].signature_settings_for_new_objects.prompt_free_form_text | bool | True if a free-form text is prompted with the signature. |
values[].signature_settings_for_new_objects.free_form_text_property_def | int32 | Signature details. boolean bFillReasonPropertyText; //!< Optional? boolean bFillMeaningPropertyText; //!< Optional? |
values[].signature_settings_for_new_objects.manifestation_additional_info | string | Additional information for the manifestation text for the signature. This is not shown to the user when signing. |
values[].signature_settings_for_new_objects.create_separate_signature_object | bool | True if the electronic signature shall be stored as a separate signature object. False to store as an embedded signature in a multi-line text property. |
values[].signature_settings_for_new_objects.manifestation_property_def | int32 | Property definition to be used for storing the signature manifestation on the object. Ignored if bCreateSeparateSignatureObject is true. |
values[].signature_settings_for_new_objects.signature_identifier | string | Signature identifier. Required if bCreateSeparateSignatureObject is true. |
values[].aliases | string | Semicolon-separated list of semantic aliases. |
Related methods
- IRPCPropertyDefs.GetObjectClassesAndGroups -- Gets all classes and class groups that the user is allowed to see.