Managing App Screens

Navigating Apps Screens

To access the App Screens management interface, navigate through the left-hand menu:

1. Click on the Apps  menu item.
2. Select Screens from the expanded submenu.

This action will direct you to the Project Screens main page, displaying a comprehensive overview of all configured project screens in a data table format. You are currently viewing a Project Screen with ID 6056.

App Screens Overview Table 📊

The Project Screens table provides a central location for administrators to review and manage all project screens. Each row represents a unique project screen, with columns detailing key attributes:

• Name: Displays the name of the project screen.
• Screen Type: Indicates the type of screen (e.g., List, Form, Detail).
• Screen Layout: Shows the layout template used for the screen.
• Project: The associated project to which this screen belongs.
• Active: A boolean indicator (Yes/No) showing if the screen is currently active and available.
• Parent Screen: If applicable, identifies the parent screen of this child screen.
• Screen Order: Defines the numerical order in which the screen appears relative to others.
• Actions: This column contains inline actions for managing individual project screen records:
  • ✏️ Edit: Click the pencil icon to modify the details of an existing project screen.
  • 🗑️ Delete: Click the trash icon to remove a project screen from the system.

Adding a New Project Screen ➕

To create a new project screen:

1. Click the Add New button located at the top right of the Project Screens page. This will open a modal dialog.
2. In the modal, provide the necessary information for the new project screen in the respective fields.
3. Click Save to create the new project screen, or Cancel to discard the operation.

Editing an Existing App Screen 📝

To modify the details of an existing project screen:

1. Locate the desired project screen within the data table.
2. Click the ✏️ Edit icon in the Actions column for that record. This will open a modal dialog pre-populated with the current project screen's information.
3. Update the necessary fields in the modal. All fields are editable, allowing for comprehensive modification of the screen's properties.
4. Click Save to apply your changes, or Cancel to close the modal without saving.

Deleting a App Screen 🗑️

To remove a project screen from the system:

1. Locate the project screen you wish to delete in the data table.
2. Click the 🗑️ Delete icon in the Actions column for that record.
3. A confirmation dialog will appear, prompting you to confirm the deletion. This is a critical step as deletion is permanent.
4. Click Confirm to proceed with the deletion, or Cancel to abort the operation.

Workflow and Post-Action Notes:

• Validation: All input fields within the Add/Edit modals are subject to validation rules. Ensure all required fields are completed and conform to expected formats before saving.
• Dependencies: Be aware that deleting a project screen may impact other system components or functionalities that depend on it. For example, if a screen is referenced in a workflow or another screen, its deletion might cause errors. The system is designed to notify administrators of critical dependencies where possible.
• Auditing: All additions, edits, and deletions of project screens are logged, allowing administrators to track changes and maintain an audit trail. This information is typically accessible via system logs or dedicated auditing features within GimCore.