IRPCPropertyDefsAdmin.AddObjectClass
Administration API / specialized admin session
Creates a class with its property associations.
| Service | Property definition and class administration MFiles.IRPCPropertyDefsAdmin |
|---|---|
| gRPC method | /MFiles.IRPCPropertyDefsAdmin/AddObjectClass |
| HTTP (mf-http-grpc) | POST /grpc/v1/add-object-class |
| Request | AddObjectClassRequest |
| Response | AddObjectClassResponse |
| Book and level | Administration API, specialized |
| Kind | admin |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | no |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
- Requires
change_metadata_structureandlicense_allows_modifications. - If the class's
name_property_defis not Name or title (0), the server resets that property definition's permissions so that all users can see and edit it. - Increments the metadata structure version.
Request: AddObjectClassRequest
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 |
|---|---|---|
doc_class | DocClass | The new class. The item ID and GUID in value_list_item are ignored and assigned by the server; object_type sets the object type of the class. |
doc_class.value_list_item | ValueListItem | Value list item representing this document class. |
doc_class.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. |
doc_class.value_list_item.has_parent | bool | True if the item has a parent item in the same (hierarchical) list. |
doc_class.value_list_item.has_owner | bool | True if the item belongs to an item of the owner list (ValueList.owner_object_type). |
doc_class.value_list_item.parent_id | int32 | With has_parent, the item ID of the parent item; otherwise ignored. |
doc_class.value_list_item.owner_id | int32 | With has_owner, the item ID of the owner item in the owner list. |
doc_class.value_list_item.owner_name | string | The name of the owner item. |
doc_class.value_list_item.automatic_permissions | AutomaticPermissions | If set, specifies the automatic permissions for an object for which the user selects this item. |
doc_class.value_list_item.icon | Bytes | If set, contains the icon of this item in .ICO format. |
doc_class.workflow | int32 | The default workflow of the document class, or zero if there is no default workflow. |
doc_class.object_type | int32 | The object type with which this class is used. |
doc_class.is_predefined | bool | True if this is a predefined class (cannot be deleted, editing is restricted). |
doc_class.force_workflow | bool | True if the use of the workflow with this class is enforced. |
doc_class.name_property_def | int32 | The ID of the property definition that represents the name of the document or other object. Typically PROPERTYDEF_TITLE (0). |
doc_class.object_type_specific_properties | ObjectTypeSpecificClassContentUnion | Additional object type specific class content. |
doc_class.object_type_specific_properties.assignment | AssignmentClassInfo (oneof data) | Assignment-specific class settings. |
doc_class.signature_settings_for_new_objects | ElectronicSignatureSettings | The electronic signature settings for creating an electronic signature for new objects. Reserved for future improvements. |
doc_class.signature_settings_for_new_objects.is_required | bool | True if this transition requires an electronic signature. |
doc_class.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). |
doc_class.signature_settings_for_new_objects.fixed_prompt_details | ElectronicSignaturePromptInfo | Option 2: Pre-defined reason |
doc_class.signature_settings_for_new_objects.selectable_prompt_details[] | repeated ElectronicSignaturePromptInfo | Option 3: Metadata-based reason/meaning. |
doc_class.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. |
doc_class.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. |
doc_class.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. |
doc_class.signature_settings_for_new_objects.add_metadata_reference_to_reason_meaning_item | bool | Common prompt details. |
doc_class.signature_settings_for_new_objects.prompt_free_form_text | bool | True if a free-form text is prompted with the signature. |
doc_class.signature_settings_for_new_objects.free_form_text_property_def | int32 | Signature details. boolean bFillReasonPropertyText; //!< Optional? boolean bFillMeaningPropertyText; //!< Optional? |
doc_class.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. |
doc_class.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. |
doc_class.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. |
doc_class.signature_settings_for_new_objects.signature_identifier | string | Signature identifier. Required if bCreateSeparateSignatureObject is true. |
doc_class.aliases | string | Semicolon-separated list of semantic aliases. |
property_defs[] | repeated AssociatedPropertyDef | The properties of the class and whether each is required. |
property_defs[].property_def | int32 | The ID of the property definition. |
property_defs[].is_required | bool | True if objects of the class must have a value for this property. |
Response: AddObjectClassResponse
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 |
|---|---|---|
id | int32 | The ID of the new class. |