Redesign the feature "New Model" (Model Builder)

[tiagofml]

Redesign the feature "New Model" (Model Builder)

• [ ] Specify the behavior and the design of GUI using low-fidelity prototypes
• [ ] Review the specification
• [ ] Refactor the source code to develop the changes and improvements defined by the specification

Specification

User Storie

As a User, I WANT to create a new model SO THAT I can create simulations with the existing library files.

General behavior

Preconditions: - Postconditions: 1) the new model (XML file) is created inside the user's library folder;

Rules / restrictions:

• a name is valid if it contains only alphanumeric chars, hyphen (-) and/or underscore (_)
• The user must select a category and type a valid name to able able to create the new model.

Basic Flow

1. User access the "New" feature: Tools -> Model Builder -> New | Model Builder Icon -> New
2. "New Model" window is opened on the page to select the category and define its name. The "Create" button is disabled when the window is loaded.
3. The user selects the category and types a valid Name (ID).
4. The "Create" button is enabled allowing the user to click or "ENTER" on the keyboard.
5. "The XML file is copied to the users' library and the new model created is immediately opened in the Model Builder Interface.

Alternative Flow: user cancel the operation (project page or model page)

N.1. User clicks on "Cancel" or "X" N.2. The "New" window is closed and the system returns to the Model Builder interface

Alternative Flow: name is invalid (model page)

6.1. The user types an invalid name for the model. 6.2. A warning message is presented.

Alternative Flow: name already exists (model page)

3.1. The user types a name of a model that already exists in the users' library. 3.2. A warning message is presented.

GUI

Prototype

New Model - Model Builder

Guildelines

• The window is modal and opened with auto-focus
• The "Create" button has greater priority to receive focus than the "Cancel" button, which means that if everything is fine (e.g. category was selected and the name is valid and unique) and user types "Enter", the "Create" must be performed.

Messages and labels (english | portuguese)

• Window Title: Model Builder - New Model | Editor de Modelos - Novo Modelo
• Title: New Model | Novo Modelo
• Subtitle: Select the category in which the model will be created and define its name. | Selecione a categoria que o modelo será criado e defina seu nome.
• Labels:
  • Category | Categoria
  • Define a name (unique identifier) for your new model. | Defina um nome (identificador único) para o novo modelo.
  • Name (ID): | Nome(ID):
  • Cancel | Cancelar
  • Create | Criar
• Warning (invalid name): The model name can contain only alphanumeric chars, hyphen (-) and / or underscore (_) | O nome do modelo pode conter somente caracteres alfanuméricos, hífen (-) e / ou sublinhado (_).
• Warning (duplicated name): A model with this name already exists in the current library. | Um modelo com esse nome já existe na biblioteca de modelos.

[tiagofml]

@Guelmisp It would be interesting to offer to user the option to create a new model based on existing one of DengueMELib. The behavior will be like to clone an existing model - copy it from DengueMELib to the user's local library.