Projects page

Introduction

Any user can select the to get to the Projects page. The view on the page will change depending on the user role.

Each project is summarized by a card.

Icons

The icons on the left of the indicate its state.

- everything is good with the project and there are no issues.

- This icon will rotate to indicate the the project is currently being analyzed

- The project is in the Task Queue. Projects are queued if the system is in Maintenance mode or if many projects are being analyzed. The will indicate that there are jobs in the queue.

- This icon indicates that the the project has failed. It is accompanied by the . This indicates that there is a problem with this project that should be explored.

Name

The project name in the card has several components.

• Group Name - (CET) This is the name of the group for the projects. When creating a project, the group name defaults to the name of the repository
• Project Name - (CitySmart) The name of the project. This defaults to the name of the project in the repository at creation. The group name and project name combination must be unique.
• Module - (Quality) This can be the branch of the repository or another identifier
• Tags - (newtag2, project4) Other identifiers for the project.

When the project name is selected from the Projects page, it opens the Project Overview.

Analysis Type

A project can by analyzed by Globalyzer and use Localyzer to manage locales and translations.

- The project is being analyzed by Globalyzer. Selecting this icon will open the Globalyzer Report page.

- The project is using Localyzer and how much of the project has been translated. Selecting this icon will open the Localyzer Report page.

Analysis Status

The analysis section shows the current state of the project analyses and the last time it occurred.

• Analysis Run
• Project Configuration changed
• Analysis Failed

Selecting the analysis status will open the console logs for the last analysis for the project.

Buttons

Only the Administrator and the Manager user will have access to the project card buttons.

• The Run button will start the analysis of the project.
  • The status icon will start twirling to indicate that it is processing
  • Or the status icon will become the clock icon to indicate that the project is queued in the Task List to be analyzed.
• The Edit button opens the Edit Project Configuration page for the project.

Create and Configure Projects

[Administrator, Manager]

Only the Administrator and Manager users can create, edit or delete projects.

Create a new project

1. Select the to get to the Projects page.
2. Select the . If the Manager does not have any Data Source Credentials assigned, the process will error. Contact the administrator to get credential access.
3. Select the Data Source Credential to use. As a Manager, if the data source credential is not in the list, make a request to the Administrator to grant access to the manager.
4. Fill out the specific data source credential information, like the Github URL and branch.
5. Set the name, module, tags and the project run type (Globalyzer, Localyzer or both)
6. Continue with Globalyzer or Localyzer specific questions.
7. Assign teams or users to be able to access the project
8. Select the Create Project and return to the projects list. The project should start running. If the system is in Maintenance mode, the project will be queued.

Search Projects

[Admin, Manager, Developer, Translator]

Search allows the user to look for projects that match a string. In the example, the word 'project' was matched with two projects with 'project' in the tags, project4 and project6. The search parameter is shown at the top of the screen.

When the Search is closed, the search result remains and the search parameter is still shown. Selecting the search parameter and clearing it will return the full list.

Filter Projects

[Admin, Manager, Developer, Translator]

Filter allows the user to filter the projects based on status, type or tag. In the example, the list is filtered by projects that have no errors, are Globalyzer projects, and have the tag 'project4' or 'QA'. The filter parameters are shown at the top of the screen.

When the Filter is closed, the result remains and the parameters are still shown. Selecting a parameter and clearing it will modify the filter. Filter and Search can be combined and both parameters show at the top of the window.

Sort Projects

[Admin, Manager, Developer, Translator]

Sort by allows the user to sort by the Group name or the Project name in ascending or descending order. The sort remains when the Sort is closed.