IRPCPropertyDefsAdmin.GetPropertyDefsAdmin
Administration API / specialized admin session idempotent
Gets the administrative definitions of all property definitions.
| Service | Property definition and class administration MFiles.IRPCPropertyDefsAdmin |
|---|---|
| gRPC method | /MFiles.IRPCPropertyDefsAdmin/GetPropertyDefsAdmin |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-property-defs-admin |
| Request | GetPropertyDefsAdminRequest |
| Response | GetPropertyDefsAdminResponse |
| 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
read_all_metadata_structure; a normal user gets "Access denied.". Users without the right call GetPropertyDefs. - Returned 150 property definitions in the Sample Vault, built-in ones included.
Request: GetPropertyDefsAdminRequest
No fields.
Response: GetPropertyDefsAdminResponse
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 PropertyDefAdmin | One PropertyDefAdmin per property definition. |
values[].property_def | PropertyDef | Basic data. |
values[].property_def.id | int32 | The property definition ID. Built-in property definitions (0 Name or title, 20 Created, 100 Class, ...) have the same ID in every vault. IDs 1-19 are never used by real property definitions. |
values[].property_def.name | string | The name of the property. |
values[].property_def.tooltip | string | The tip text of this property. |
values[].property_def.data_type | Datatype | The data type of the values. Lookup properties use DATATYPE_LOOKUP (one item) or DATATYPE_MULTI_SELECT_LOOKUP (several items). |
values[].property_def.content_type | ContentType | Content type (sub-datatype).Values: CONTENT_TYPE_GENERIC (0), CONTENT_TYPE_EMAIL_ADDRESS (1), CONTENT_TYPE_URL (2), CONTENT_TYPE_RTF (3), CONTENT_TYPE_HTML (4). |
values[].property_def.is_based_on_value_list | bool | True for lookup properties; value_list then names the list. Test this flag, not value_list != 0: 0 is a valid list ID (the Document object type). |
values[].property_def.enable_automatic_permissions | bool | True to allow automatic permissions via this property def. |
values[].property_def.is_conflict_reference | bool | True if this is the conflict property of the object type in value_list. |
values[].property_def.disallow_as_grouping_level | bool | True to disallow using this property def as a grouping level in views. |
values[].property_def.value_list | int32 | With is_based_on_value_list, the ID of the value list or object type whose items are the property's values. |
values[].property_def.value_list_item_filter[] | repeated SearchCondition | A static filter on the items of value_list. The server applies it when this property is passed as filtering_property_def or LookupItemRequest.property_def; such conditions cannot be sent in search_conditions directly. |
values[].property_def.update_type | UpdateType | The update behaviour of the property.Values: UPDATE_TYPE_NORMAL (0), UPDATE_TYPE_SET_BY_SERVER (1), UPDATE_TYPE_SET_BY_CLIENT_CODE (2). |
values[].property_def.automatic_value_type | AutomaticValueType | Defines the type of the automatic value of this field, if any.Values: AUTOMATIC_VALUE_TYPE_NONE (0), AUTOMATIC_VALUE_TYPE_CALCULATE_WITH_TEMPLATE (1), AUTOMATIC_VALUE_TYPE_CALCULATED_WITH_CODE (2), AUTOMATIC_VALUE_TYPE_FIXED_VALUE_WITH_INCREMENT (3), AUTOMATIC_VALUE_TYPE_FIXED_VALUE_WITH_CODE (4). |
values[].property_def.default_value | TypedValue | If set, specifies a fixed default value for this property. |
values[].property_def.icon | Bytes | If set, contains an icon in .ICO format (contains multiple sizes and color depths). |
values[].property_def.is_predefined | bool | True if this is a predefined PropertyDef. Predefined PropertyDefs cannot be deleted and modifying them is restricted. |
values[].property_def.allow_for_all_object_types | bool | True if this property definition can be used with all object types. |
values[].property_def.is_owner | bool | True if this is the owner property of the object type in value_list. |
values[].property_def.is_default | bool | True if this is the default property of the object type in value_list (ValueList.default_property_def). |
values[].property_def.owner_property_def_info | OwnerPropertyDef | For a lookup property, the property whose value limits this property's values. For example, Workflow State (39) is limited by Workflow (38). A property_def of -106 means that the owner property is determined automatically. |
values[].property_def.object_type | int32 | If allow_for_all_object_types is false, the object type whose objects use this property; otherwise ignored. |
values[].property_def.acl | AccessControlList | If set, specifies the ACL that defines the visibility and editability of this property in objects. |
values[].property_def.property_def_permissions | PropertyDefPermissionsForClient | What the caller may do with values of this property: see them and edit them. Set when the property definition has permissions. |
values[].property_def.value_list_sorting_type | VLSortingType | The sorting type of value list items.Values: VLSORTING_TYPE_BY_DISPLAY_NAME (0), VLSORTING_TYPE_BY_EXTERNAL_ID (1). |
values[].property_def.value_list_sort_ascending | bool | True to sort in ascending order, false to sort in descending order. |
values[].property_def.validation_type | ValidationType | How values are validated; validation_string holds the rule.Values: VALIDATION_TYPE_NONE (0), VALIDATION_TYPE_REGEX (1), VALIDATION_TYPE_CODE (2). |
values[].property_def.validation_string | string | The validation rule; its meaning depends on validation_type. |
values[].property_def.formatting_type | FormattingType | How values are formatted; formatting_string holds the format.Values: FORMATTING_TYPE_NONE (0). |
values[].property_def.formatting_string | string | The format; its meaning depends on formatting_type. |
values[].property_def.guid | string | The GUID of the property definition, with braces. |
values[].property_def.options | PROPERTYDEFFLAGS | Flags such as can_use_in_search. See PROPERTYDEFFLAGS. |
values[].automatic_value | AutomaticValue | The definitions for automatic value generation. |
values[].automatic_value.automatic_numbering_increment | int32 | Simple automatic numbering: Increment. |
values[].automatic_value.automatic_numbering_code | string | Automatic numbering with VBScript: VBScript code. |
values[].automatic_value.calculated_value_template | string | Simple calculated value: Expression. |
values[].automatic_value.calculated_value_code | string | Calculated value with VBScript: VBScript code. |
values[].automatic_value.calculation_order | int32 | A number that specified calculation order. Properties are calculated from smallest to largest calculation order number. |
values[].validation | Validation | The definitions for property value validation. |
values[].validation.regular_expression | string | A regular expression for the validation. |
values[].validation.code | string | VBScript used in the validation. |
values[].aliases | string | Semicolon-separated list of semantic aliases for metadata mapping. |
values[].tags | NamedValueNamespaces | Names value namespaces related to the property definition. |
values[].tags.value[] | repeated NamedValueNamespace | An array of the NamedValueNAmespace structures. |
Related methods
- IRPCPropertyDefs.GetPropertyDefs -- Gets all property definitions that the user is allowed to see.