Redmine Integration

Connect with a project management tool – Redmine and associate Redmine tickets to Astah diagrams.

Details

Compatible with
Astah Professional 6.6 or later and UML, SysML 1.2 or later, GSN 1.1 or later
Latest Version
1.0.0 (Jan. 17, 2018)
Developer
Astah
Support
No technical support is provided.

How to Install on Astah Professional

  1. Download the Plug-in file.
  2. Launch Astah and drag the downloaded .jar file to an open instance of Astah. A pop-up will appear asking you to confirm installation, choose [Yes]. If the pop-up opens, restart Astah and open any project.
    Astah Plugin Install
  3. Now you will have [Redmine Tickets] tab below the Diagram Editor.If there is no window below the diagram editor, go to [View] – [Show/Hide Extra View] to open.
    Redmine pane in Astah
  4. Go to “How to Use – setup”

 

How to Install on Astah SysML

  1. Download the Plug-in file
  2. Launch Astah and go to [Help] – [Plugin List].
    Choosing [Plugin List] on Astah SysML
  3. Click [Install] button and select the .jar file you downloaded.
    Astah SysML Plugin window
  4. Restart Astah and open any project.
    Astah SysML Plugin Relaunch
  5. Now you will have [Redmine Tickets] tab below the Diagram Editor. (This is a screenshot of Astah Professional.)
    Redmine pane in AstahIf there is no window below the diagram editor, go to [View] – [Show/Hide Extra View] to open.
    Show/Hide Extra Menu
  6. Go to “How to Use – setup”

 

How to Install on Astah GSN

  1. Save the downloaded .jar file under Userhome/.astah/gsn/plugins
  2. Restart Astah and open any project
  3. Now you will have [Redmine Tickets] tab below the Diagram Editor. (This is a screenshot of Astah Professional.)
    Redmine pane in AstahIf there is no window below the diagram editor, go to [View] – [Show/Hide Extra View] to open.
    Show/Hide Extra Menu
  4. Go to “How to Use – setup”

 

How to Use

 

Setting up

  1. The [Redmine Tickets] view will look like the figure below when the Astah project is not associated with Redmine yet.
    Redmine pane in Astah
  2. Input Redmine URI, API access key and your redmine project name.
    NOTE1: Use the [Paste] button for each other than keyboard shortcuts.
    Note2: ”Redmine project name” means the project id, not the project names:Redmine configuration in Astah
  3. After filling out all the items, you can push [Setup Redmine].
    Set up redmine for Astah
  4. If connecting to Redmine is succeeded, you will see menu buttons on the [Redmine Tickets] view, e.g. [Add Ticket].
    Redmine pane in Astah

 

Creating a ticket

  1. If you push [Add Ticket] button, a browser will launch and open the Redmine page where you can create new tickets.
    Redmine in Astah
  2. In the ticket page of Redmine, you can update, fill out or set properties of the ticket, e.g. the ticket subject, the priority, etc. After creating tickets, pushing [Sync: astah*<-Redmine] button in the [Redmine Tickets] tab will import those tickets information.
    Redmine Astah Plugin

 

 

Showing ticket lists

    • One ticket is associated with one diagram. When you move from a diagram to another, the ticket list will be also updated to show the ones associated with the selected diagram.
    • [All Tickets] button will show all the tickets associated with all the diagrams in the currently-open Astah project.
      Redmine Astah Integration
    • Clicking any [Item] column will sort listed items accordingly.
    • Width of each column is manually adjustable.
    • Clicking Ticket number or ticket subject will open your browser to take you to the ticket page in Redmine. After you update the ticket information, you can sync it by pushing [Sync: Astah <- Redmine] button.
    • Clicking Diagram name in the table will give a focus on the diagram. At the same time, the table will be updated to show the ticket list associated with that diagram.

 

Ticket data in an Astah project

    • Redmine information i.e. URI, API access key and redmine project id and all the ticket information associated with diagrams will be saved in the Astah file when closing Astah project. When you open the Astah project, those data in the table will be restored.
      • If the connection to the Redmine is not established when you open an Astah project, those data will not be restored.
      • Existing bug: When you open an Astah project right after launching Astah, restoring Redmine information may fail sometimes. In this case, open any other project you have, and then open the project you wanted again, then the data will be restored.

 

Others

    • Width of columns of the table will be restored in Astah project when you push [Sync: Astah<-Redmine] and when you save an Astah project, that width information will be saved in Astah file.

 

Existing bug

    • When you open an Astah project right after launching Astah, restoring Redmine information may fail sometimes. In this case, open any other project you have, and then open the project you wanted again, then the data will be restored.

 

Special Thanks!

    • Special thanks to : A member of Friends of Astahakipii for inspiring me to create this Plug-in with his ideas.

 

What are you looking for?