Soft Launch

After discussions with Ed, we have decided to migrate work on ZICORE to JIRA, owing to the fact that it is our newest project, and work on it will be continuing on into the new year. To that end, I have moved all tasks, comments, and attachments to the new system, which can be accessed here.

The URL for the system will be changed to something easy to remember once we go live, but as we are still technically in development, we need to leave it alone for the time being. I would suggest creating a bookmark for the current URL to save yourselves time.

Over the next few minutes, I will be sending you each invitation emails, which will contain all of the login information necessary for you to get started.

Outlook Signature

INCREDIBLY IMPORTANT NOTE: YOU MUST UPDATE YOUR OUTLOOK SIGNATURE TO INCLUDE 5 MINUS SIGNS/DASHES BEFORE THE SIGNATURE PRIOR TO USING JIRA.

If you do not do this, replying to a JIRA email to leave a comment or create an attachment to a task will copy the entire email chain into the comment and make a huge, huge mess.

There is no other available workaround.

If you do make this change, you can reply to any JIRA email to leave a comment on a task, and any attachments to that email will be automatically uploaded to the task, which is really neat.

Outlook Labeling

I would also HIGHLY recommend creating an Outlook filter to move all emails with [JIRA] in the subject line to a separate folder. You will be receiving a lot of emails, as JIRA sends updates whenever something changes. We will be tuning this moving forward, but at the beginning it will be a lot to keep up with if you have it coming directly into your inbox.

Structural Notes

The general “JIRA Metaphor” for the SharePoint structure we have presently is as follows:

  • Epics roughly equate to SharePoint “Components”
  • Stories roughly equate to SharePoint “Activities”
  • Subtasks roughly equate to SharePoint “Tasks”

I have already taken the liberty of creating the following Epics for ZICORE:

  • ZICORE-1: Field Office Administration
  • ZICORE-14: Home Office Administration
  • FIN-1: ZICORE Field Finance
  • FIN-4: ZICORE Home Finance
  • HR-7: ZICORE Field HR
  • HR-12: ZICORE Home HR

General Usage Notes

To create a Story (think of it like a category of tasks with a common goal) within an Epic, click the + sign next to “Issues in Epic,” select “Story” under Issue Type, and fill in the requested information.

To create a Subtask within a Story, click on the Story, then click “More > Create Sub-Task,” and fill in the requested information.

Documents can be attached to all issue types by simply dragging and dropping from your desktop. Document categories can be assigned by dragging and dropping the document between categories on the issue screen.

Issue Security levels can be adjusted for Epics and Stories within the HR and Finance projects (ZICORE would be the equivalent of “Zicore HR” and ZICORE Restricted would be the equivalent of “Zicore HR-Restricted). Subtasks inherit security levels from their parent.

To tag a user in a comment or description, simply type the “@” sign followed by the user’s name, i.e. @Pablo, and select the user from the box that appears.

If you have finished the work that you need to do on a subtask, but further work is required from another user, change the “Assignee” field to reflect the person that needs to take the next steps. Only one user can be assigned to an issue at any given time.

Once you have accepted the invitation to set up your JIRA account, please allow 10 minutes for your permissions to be set up.

Closing Remarks

Please do not hesitate to contact me with any questions, comments, or concerns. This is a big transition, and there will undoubtedly be hiccups- it is my hope, however, that we can use this pilot project to polish the system before rolling out across the organization, and make sure that everyone has a great experience with it once it’s live.

Please note that the information contained within these release notes may be duplicated elsewhere within the documentation, as it is currently a work in progress.