Skip to content

OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub

[#65393] Select custom fields format change https://community.openpr… (#19485)

Maya Berdygylyjova4797d65d69d8
diff --git a/docs/system-admin-guide/custom-fields/README.md b/docs/system-admin-guide/custom-fields/README.md
index 8619ac52767..a395e0e3fb8 100644
--- a/docs/system-admin-guide/custom-fields/README.md
+++ b/docs/system-admin-guide/custom-fields/README.md
@@ -19,28 +19,26 @@ To **create a new custom field** navigate to *Administration* -> *Custom fields*
You will see the list of all the custom fields that have been created so far, divided by the section on the different tabs for which they were created.
-If none have been created so far, click on the link **Create a new custom field** in the respective section, e.g. on the tab for work packages.
+If none have been created so far, click on the link **Create a new custom field** in the respective section, e.g. on the tab for work packages and select the custom field format.
![Custom fields in OpenProject administration settings](administration-custom-fields.png)
-Depending on the module, for which the new custom field is being created, slightly different options may be offered. This is an example of a new custom field for a work package.
+Depending on the module for which the new custom field is being created, slightly different options may be available. The example below shows a new custom field (with the **Text** format selected) for a **Work Package**.
-![Sys-admin-create-custom-field](openproject_system_guide_new_custom_field_new.png)
-
-1. Custom field **Name**, which will appear as the attribute name on the work package form.
-2. Choose a **Format** of the custom field, e.g. text, list, date, boolean. In this example the format *Text* is selected.
-
> [!TIP]
> Depending on the format of the custom field, the fields to specify vary.
-3. Specify the **minimal and maximal length**. If a 0 is chosen, no restriction will be imposed on the length of the custom field.
-4. **Regular expression** specifying which values are allowed for the custom field.
-5. **Default value** will be used as a default value for the custom field.
-6. Set if the new custom field should be a **required** field.
-7. Specify if the new custom field should be **used for all projects**. This means the custom field will be active for all projects and does not need to be activated separately per project.
-8. Specify if the new custom field should be **used as a filter for work packages**. See [here](../../user-guide/work-packages/work-package-table-configuration/#filter-work-packages) how to filter work packages.
-9. Specify if the new custom field should be **searchable** via the global search.
-10. **Save** the new custom field.
+![Sys-admin-create-custom-field](openproject_system_guide_new_custom_field_new.png)
+
+1. Custom field **Name**, which will appear as the attribute name on the work package form.
+2. Specify the **minimal and maximal length**. If a 0 is chosen, no restriction will be imposed on the length of the custom field.
+3. **Regular expression** specifying which values are allowed for the custom field.
+4. **Default value** will be used as a default value for the custom field.
+5. Set if the new custom field should be a **required** field.
+6. Specify if the new custom field should be **used for all projects**. This means the custom field will be active for all projects and does not need to be activated separately per project.
+7. Specify if the new custom field should be **used as a filter for work packages**. See [here](../../user-guide/work-packages/work-package-table-configuration/#filter-work-packages) how to filter work packages.
+8. Specify if the new custom field should be **searchable** via the global search.
+9. **Save** the new custom field.
## Custom field formats
diff --git a/docs/system-admin-guide/custom-fields/administration-custom-fields.png b/docs/system-admin-guide/custom-fields/administration-custom-fields.png
index 369627e619b..de005bfc43d 100644
Binary files a/docs/system-admin-guide/custom-fields/administration-custom-fields.png and b/docs/system-admin-guide/custom-fields/administration-custom-fields.png differ
diff --git a/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new.png b/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new.png
index 81768c02c5b..07a10fb1d39 100644
Binary files a/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new.png and b/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new.png differ
diff --git a/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new_hierarchy.png b/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new_hierarchy.png
index 420397acaaa..972b58e3cb6 100644
Binary files a/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new_hierarchy.png and b/docs/system-admin-guide/custom-fields/openproject_system_guide_new_custom_field_new_hierarchy.png differ
diff --git a/docs/system-admin-guide/custom-fields/system-admin-allow-multi-select.png b/docs/system-admin-guide/custom-fields/system-admin-allow-multi-select.png
index 090d1c0522c..06f1d50cdba 100644
Binary files a/docs/system-admin-guide/custom-fields/system-admin-allow-multi-select.png and b/docs/system-admin-guide/custom-fields/system-admin-allow-multi-select.png differ
diff --git a/docs/system-admin-guide/projects/project-attributes/README.md b/docs/system-admin-guide/projects/project-attributes/README.md
index 304ca4fdfa9..8a47bf18c5a 100644
--- a/docs/system-admin-guide/projects/project-attributes/README.md
+++ b/docs/system-admin-guide/projects/project-attributes/README.md
@@ -35,30 +35,23 @@ Attributes may also be contained in [sections](#sections).
## Create a project attribute
-To create a new project attribute, click on the **+ Project attribute** button in the top right corner.
+To create a new project attribute, click on the **+ Add** button in the top right corner, select **Project attribute** and select the project attribute format from the list of available options.
-This will display the "New attribute" form with these options:
+> [!TIP]
+> You cannot change the project attribute format once the project attribute is created.
-![Create a new attribute form in OpenProject administration](open_project_system_guide_project_attributes_new_attribute.png)
+You can pick from nine different types of formats: text, long text, integer, float, list, date, boolean, user and version. Depending on the chosen format, you might have additional options, such as minimum and maximum width, default value or regular expressions for validation.
-- **Name**: This is the name that will be visible in the [Project Overview](../../../user-guide/project-overview) page.
+![Create a new project attribute type in OpenProject administration](open_project_system_admin_guide_project_attributes_add_button.png)
-- **Section:** If there are sections, you can pick where this new project attribute should appear. [Learn about sections](#sections) for more information.
+This is an example of new project attribute with a format *Text*.
-- **Format**: You can pick from nine different types of fields: text, long text, integer, float, list, date, boolean, user and version.
-
-> [!TIP]
-> You cannot change this once the project attribute is created.
-
-- **Format options:** Depending on the type you choose, you might have additional options, such as minimum and maximum width, default value or regular expressions for validation.
+![Create a new attribute form in OpenProject administration](open_project_system_guide_project_attributes_new_attribute.png)
+- **Name**: This is the name that will be visible in the [Project Overview](../../../user-guide/project-overview) page, if the custom field is activated on that project.
+- **Section:** If there are sections, you can pick where this new project attribute should appear. [Learn about sections](#sections) for more information.
- **Required for all projects**: Checking this makes this project attribute required for all projects. It cannot be deactivated at a project level.
-
- **Admin-only**: If you enable this, the project attribute will only be visible to administrators. All other users will not see it, even if it is activated in a project.
-
-> [!TIP]
-> This is enabled by default. Only disable this if you want this field to be invisible to non-admin users.
-
- **Searchable**: Checking this makes this project attribute (and its value) available as a filter in project lists.
## Modify project attributes
@@ -91,9 +84,9 @@ The *Projects* tab will show a list of all the projects this project attributes
![Project attributes enabled in projects list in OpenProject administration](open_project_system_admin_guide_project_attributes_enabled_in_projects.png)
-You can remove a project attribute from a specific project by selecting the **More** menu at the end of the line and clicking the *Deactivate for this project* option.
+You can remove a project attribute from a specific project by selecting the **More** menu at the end of the line and clicking the *Remove from project* option.
-![Deactivate a project attribute for a project in OpenProject administration](open_project_system_admin_guide_project_attributes_deactivate_for_project.png)
+![Remove a project attribute from a project in OpenProject administration](open_project_system_admin_guide_project_attributes_deactivate_for_project.png)
To add this project attribute to a specific project click the **+Add projects** button. A modal will appear allowing you to search for projects to add this project attribute into. Please note, that the projects, in which the project attribute is already activated will be shown disabled in that selection. You can include subprojects.
@@ -105,7 +98,17 @@ To add this project attribute to a specific project click the **+Add projects**
## Sections
-You can group project attributes into sections to better organize them.
+You can create a new section click the **+ Add** button in the top right corner and select **Section**.
+
+![Add a new section ](open_project_system_guide_project_attributes_new_section.png)
+
+Name the section and save it.
+
+![Name a new project attribute section in OpenProject administration](open_project_system_admin_guide_project_attributes_new_section_name.png)
+
+You can group project attributes into sections to better organize them. Either drag and drop project attributes into a section or create new ones directly within a section by clicking **+Project attribute** button (only visible if a section is empty).
+
+![Add a new project attribute directly into an empty section in OpenProject adminstration](open_project_system_admin_guide_project_attributes_empty_section.png)
You can click on more icon to the right of each section to rename it, delete it or change its order.
diff --git a/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_add_button.png b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_add_button.png
new file mode 100644
index 00000000000..2a1aa22549a
Binary files /dev/null and b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_add_button.png differ
diff --git a/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_deactivate_for_project.png b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_deactivate_for_project.png
index 73ae6b55232..7ca445e20f2 100644
Binary files a/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_deactivate_for_project.png and b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_deactivate_for_project.png differ
diff --git a/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_empty_section.png b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_empty_section.png
new file mode 100644
index 00000000000..aa08d593154
Binary files /dev/null and b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_empty_section.png differ
diff --git a/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_list.png b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_list.png
index ff9bda5f005..3f70748046a 100644
Binary files a/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_list.png and b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_list.png differ
diff --git a/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_new_section_name.png b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_new_section_name.png
new file mode 100644
index 00000000000..057201edb64
Binary files /dev/null and b/docs/system-admin-guide/projects/project-attributes/open_project_system_admin_guide_project_attributes_new_section_name.png differ
diff --git a/docs/system-admin-guide/projects/project-attributes/open_project_system_guide_project_attributes_new_attribute.png b/docs/system-admin-guide/projects/project-attributes/open_project_system_guide_project_attributes_new_attribute.png
index 44bf2639326..73777d7afc5 100644
Binary files a/docs/system-admin-guide/projects/project-attributes/open_project_system_guide_project_attributes_new_attribute.png and b/docs/system-admin-guide/projects/project-attributes/open_project_system_guide_project_attributes_new_attribute.png differ
diff --git a/docs/system-admin-guide/projects/project-attributes/open_project_system_guide_project_attributes_new_section.png b/docs/system-admin-guide/projects/project-attributes/open_project_system_guide_project_attributes_new_section.png
new file mode 100644
index 00000000000..660a51514c7
Binary files /dev/null and b/docs/system-admin-guide/projects/project-attributes/open_project_system_guide_project_attributes_new_section.png differ