A custom property is an element of an AODocs document.
It's a field providing information for a specific document. Properties can be used to structure documents, to improve the search experience or to customize a workflow.
Properties are also called metadata.
Important: Custom properties are defined at the document class level by library administrators. They can be edited by contributors and are visible by all library readers.
|Edit custom properties and save your changes|
|What if you can't save your document?|
Edit custom properties and save your changes
1. Open a document and press the Edit button.
Note: When you are editing the properties of a document, the document is locked and other users can't edit it. The document stays locked for 15 minutes by default.
2. In edit mode, fill in the property values for your document.
Adapt the value according to the type of field the administrator has configured:
- String: for a string of alphanumerical and special characters limited to 400 characters.
- Text: for a text field (where you can add line breaks).
- Date/Time/Date & Time: for date and time fields.
- Integer: for integer values (0, 1, 2, -1,..).
- Decimal: for decimal values (0.1, -5.1, 1.655,..) with maximum 3 decimal digits.
- Boolean: for a boolean field.
- Person: for the name of a person or a Google Group (AODocs autocompletes email addresses available in your G Suite domain global address list).
Note: A Person field accepts Google Groups only if the administrator has set the field as a multi-valued field in the document class configuration. Learn more: Configure custom properties.
- Geopoint: for the location in latitude and longitude.
- URL: for a link to a URL with a display name.
- Categories: custom values defined by categories like "Price" and "Country" in our example. End-users can select values from a drop-down list in the user interface.
3. To see the description of a property, hover over the tooltip icon to the right of the property's name. Library administrators can add a description for each custom property to guide users when filling in the properties.
Note: You can also access the property descriptions in view mode.
4. When editing a document as an administrator, properties set as hidden in the document class configuration are in a dedicated Hidden properties section. AODocs contributors don't see the hidden properties.
5. Press the Save button.
What if you can't save your document?
You can't save your document if one or more:
- mandatory properties haven't been filled in
- properties have incorrect values
- property values have been deleted
Property fields can become mandatory (and also hidden and/or read-only) depending on the workflow state. A warning message is displayed in view mode if you are a workflow validator and a workflow transition is prevented because:
- at least one mandatory property is empty
- at least one property has an invalid value
A warning icon appears at the top of the Properties section if at least one mandatory property is empty.
Mandatory properties haven't been filled in
Make sure all mandatory properties are filled in before saving. You can't save your document without filling in all the mandatory properties.
Note: It is also mandatory to give your document at title.
In edit mode, mandatory properties are marked with a red star. A progress bar indicates how many mandatory properties remain to be filled in.
Properties have incorrect values
Library administrators can add data validation rules on certain properties. This forces you to respect a rule when entering the values in the property. If you don't follow this rule, a red error message is displayed:
Properties have outdated category values
Library administrators can set category values as outdated. If a property has been assigned an outdated value, you must enter a new valid value before saving the document.