SNOMED International Mapping Tool

Space shortcuts

Child pages
  • Editing, Tracking, Workflow

Versions Compared

Old Version 12

changes.mady.by.user Patrick Granvold

Saved on

compared with

New Version 13

changes.mady.by.user Patrick Granvold

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: QA_PATH added

...

Workflow Status CombinationActionResultTrigger

The combinations of map records that exist for a given
workflow state. Each combination is listed on a new line.
Where multiple records exist for a single combination, they
are linked with a plus sign (+),
e.g. EDITING_DONE + EDITING_IN_PROGRESS.
The current user's record (if any) is marked in bold.

The legal actions that can be
requested for each workflow
status combination.		Description of map records added, modified, or deleted as a result
of the requested action. 		User action in Mapping Tool resulting in requested action.
Specialist Level Work: User's record marked in bold

[NO RECORDS – INITIAL STATE ]
NEW
EDITING_IN_PROGRESS
EDITING_DONE

ASSIGN_FROM_SCRATCHRecord created with NEW status.User clicks Assign Concept on Available Work widget
NEWSAVE_FOR_LATERSpecialist's record saved without validation and
set to EDITING_IN_PROGRESS.		Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved and marked EDITING_DONE. 		Specialist clicks Finish from Map Record editing page.
UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget.
EDITING_IN_PROGRESSSAVE_FOR_LATERSpecialist's record saved without validation. No workflow modification.Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved and marked EDITING_DONE. 

Specialist clicks Finish from either:

  • Map Record editing page, or
  • Assigned Work widget.
UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget.
EDITING_DONESAVE_FOR_LATERSpecialist's record saved without validation. No workflow modification.Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved. No workflow modification. 		Specialist clicks Finish from Map Record editing page.
UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget.

NEW + NEW
NEW + EDITING_IN_PROGRESS
NEW + EDITING_DONE

SAVE_FOR_LATERSpecialist's record saved without validation and
set to EDITING_IN_PROGRESS.

Specialist clicks Save For Later on Map Record editing page.

FINISH_EDITING

Specialist's record validated. If record valid:

  • If EDITING_DONE record exists:
    • Compare this record to EDITING_DONE record.
    • If conflict detected, set both records to CONFLICT_DETECTED
    • If conflict not detected
      • Set user's record to READY_FOR_PUBLICATION
      • Delete second CONFLICT_DETECTED record
      • Delete tracking record
  • IF EDITING_DONE record does not exist:
    • set user's record to EDITING_DONE

Specialist clicks Finish from Map Record editing page.

 

UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget.

EDITING_IN_PROGRESS + NEW
EDITING_IN_PROGRESS + EDITING_IN_PROGRESS
EDITING_IN_PROGRESS + EDITING_DONE

SAVE_FOR_LATERSpecialist's record saved without validation. No workflow change.Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITING

Specialist's record validated. If record valid:

  • If EDITING_DONE record exists:
    • Compare this record to EDITING_DONE record.
    • If conflict detected, set both records to CONFLICT_DETECTED
    • If conflict not detected
      • Set user's record to READY_FOR_PUBLICATION
      • Delete second CONFLICT_DETECTED record
      • Delete tracking record
  • IF EDITING_DONE record does not exist:
    • set user's record to EDITING_DONE

Specialist clicks Finish from either:

  • Map Record editing page, or
  • Assigned Work widget
UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget

EDITING_DONE + NEW
EDITING_DONE + EDITING_IN_PROGRESS

SAVE_FOR_LATERSpecialist's record saved without validation. No workflow change.Specialist clicks Save For Later on Map Record editing page
FINISH_EDITINGSpecialist's record validated. If validation successful, record saved.

Specialist clicks Finish from Map Record editing page.

UNASSIGNSpecialist's record deleted.User clicks Unassign on Assigned Work widget
CONFLICT_DETECTED + CONFLICT_DETECTED

 



SAVE_FOR_LATER

Specialist's record saved without validation. No workflow change.User clicks Save for Later on Map Record editing page.
FINISH_EDITING

Specialist's record validated. If validation successful, compare this
record to second CONFLICT_DETECTED record:

  • If conflict detected, save record. No workflow modification
  • If conflict not detected
    • Set user's record to READY_FOR_PUBLICATION
    • Delete second CONFLICT_DETECTED record
    • Delete tracking record
User clicks Finish on Map Record editing page. 
UNASSIGN

Specialist's record deleted.
Remaining CONFLICT_DETECTED record set to EDITING_DONE. 

Specialist clicks Unassign on Assigned Work widget 
ASSIGN_FROM_SCRATCHRecord created with CONFLICT_NEW statusLead clicks Assign Conflict from Available Work widget.
Lead Level Work: User's record is marked in bold

CONFLICT_DETECTED
+ CONFLICT_DETECTED
+ CONFLICT_NEW

SAVE_FOR_LATERLead's record saved without validation
and marked CONFLICT_IN_PROGRESS.		Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITING

Lead's record validated. If validation successful, lead's record
saved and marked CONFLICT_RESOLVED

Lead clicks Finish from Compare Records editing page.

UNASSIGNLead's record deleted.Lead clicks Unassign on Assigned Work widget.

CONFLICT_DETECTED
+ CONFLICT_DETECTED
+ CONFLICT_IN_PROGRESS

SAVE_FOR_LATERLead's record saved without validation. No workflow change.Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITINGLead's record validated. If validation successful, lead's record
saved and marked CONFLICT_RESOLVED

Lead clicks Finish from either:

  • Compare Records editing page
  • Assigned Work widget
UNASSIGNLead's record deletedLead clicks Unassign on Assigned Work widget.

CONFLICT_DETECTED
+ CONFLICT_DETECTED
+ CONFLICT_RESOLVED




SAVE_FOR_LATERLead's record saved without validation. No workflow change.Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITINGLead's record validated. If validation successful, lead's record
saved and marked CONFLICT_RESOLVED

Lead clicks Finish from either: Compare Records editing page

Assigned Work widget

.

PUBLISH

Lead's record set to READY_FOR_PUBLICATION.
Records marked CONFLICT_DETECTED deleted.
Tracking record deleted.

LEADS TO FINAL STATE.

Lead clicks Publish from Assigned Work widget.
UNASSIGNLead's record deleted.Lead clicks Unassign on Assigned Work widget.

...

Workflow Status CombinationActionResultTrigger

The combinations of map records that exist for a given
workflow state. Each combination is listed on a new line.
Where multiple records exist for a single combination, they
are linked with a plus sign (+),
e.g. EDITING_DONE + EDITING_IN_PROGRESS.
The current user's record (if any) is marked in bold.

The legal actions that can be
requested for each workflow
status combination.		Description of map records added, modified, or deleted as a result
of the requested action. 		User action in Mapping Tool resulting in requested action.
Specialist Level Work: User's record marked in bold

READY_FOR_PUBLICATION
PUBLICATION 

INITIAL STATE: No tracking record

ASSIGN_FROM_INITIAL_RECORD

Map record marked PUBLISHED or READY_FOR_PUBLICATION is
marked REVISION.
Record created with NEW status.

User clicks Edit Record on either:

  • Project Records page
  • Concept Records page
REVISION + NEWSAVE_FOR_LATERSpecialist's record saved without validation and
set to EDITING_IN_PROGRESS.		Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved and marked REVIEW_NEEDED.		Specialist clicks Finish from Map Record editing page.
UNASSIGNSpecialist's record deleted.
Record marked REVISION marked as previous workflow state
(either PUBLISHED or READY_FOR_PUBLICATION) 		Specialist clicks Unassign on Assigned Work widget.
REVISION + EDITING_IN_PROGRESSSAVE_FOR_LATERSpecialist's record saved without validation. No workflow modification.Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved and marked REVIEW_NEEDED.

Specialist clicks Finish from either:

  • Map Record editing page, or
  • Assigned Work widget.
UNASSIGNSpecialist's record deleted.
Record marked REVISION marked as previous workflow state
(either PUBLISHED or READY_FOR_PUBLICATION)		Specialist clicks Unassign on Assigned Work widget.
REVISION + REVIEW_NEEDEDSAVE_FOR_LATERSpecialist's record saved without validation. No workflow modification.Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved. No workflow modification. 		Specialist clicks Finish from Map Record editing page.
UNASSIGNSpecialist's record deleted.
Record marked REVISION marked as previous workflow state
(either PUBLISHED or READY_FOR_PUBLICATION)		Specialist clicks Unassign on Assigned Work widget.
ASSIGN_FROM_SCRATCHRecord created with REVIEW_NEW statusLead clicks Assign on Available Work widget
Lead Level Work: User's record is marked in bold

REVISION
+ REVIEW_NEEDED
+ REVIEW_NEW

SAVE_FOR_LATERLead's record saved without validation
and marked REVIEW_IN_PROGRESS.		Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITING

Lead's record validated. If validation successful, lead's record
saved and marked REVIEW_RESOLVED

Lead clicks Finish from Compare Records editing page.

UNASSIGNLead's record deleted.Lead clicks Unassign on Assigned Work widget.

REVISION
+ REVIEW_NEEDED
+ REVIEW_IN_PROGRESS

SAVE_FOR_LATERLead's record saved without validation. No workflow change.Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITINGLead's record validated. If validation successful, lead's record
saved and marked REVIEW_RESOLVED

Lead clicks Finish from either:

  • Compare Records editing page
  • Assigned Work widget
UNASSIGNLead's record deletedLead clicks Unassign on Assigned Work widget.

REVISION
+ REVIEW_NEEDED
+ REVIEW_RESOLVED



SAVE_FOR_LATERLead's record saved without validation. No workflow change.Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITINGLead's record validated. If validation successful, lead's record
saved and marked REVIEW_RESOLVED

Lead clicks Finish from either: Compare Records editing page

Assigned Work widget

.

PUBLISH

Lead's record set to READY_FOR_PUBLICATION.
Record marked REVIEW_NEEDED deleted.
Record marked REVISION deleted.
Tracking record deleted.

LEADS TO FINAL STATE.

Lead clicks Publish from Assigned Work widget.
UNASSIGNLead's record deleted.Lead clicks Unassign on Assigned Work widget.

...

Workflow Status CombinationActionResultTrigger

The combinations of map records that exist for a given
workflow state. Each combination is listed on a new line.
Where multiple records exist for a single combination, they
are linked with a plus sign (+),
e.g. EDITING_DONE + EDITING_IN_PROGRESS.
The current user's record (if any) is marked in bold.

The legal actions that can be
requested for each workflow
status combination.		Description of map records added, modified, or deleted as a result
of the requested action. 		User action in Mapping Tool resulting in requested action.
Specialist Level Work: User's record marked in bold

[NO RECORDS – INITIAL STATE ]

ASSIGN_FROM_SCRATCHRecord created with NEW status.User clicks Assign Concept on Available Work widget
NEWSAVE_FOR_LATERSpecialist's record saved without validation and
set to EDITING_IN_PROGRESS.		Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved and marked REVIEW_NEEDED. 		Specialist clicks Finish from Map Record editing page.
UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget.
EDITING_IN_PROGRESSSAVE_FOR_LATERSpecialist's record saved without validation. No workflow modification.Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved and marked REVIEW_NEEDED. 

Specialist clicks Finish from either:

  • Map Record editing page, or
  • Assigned Work widget.
UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget.
REVIEW_NEEDEDSAVE_FOR_LATERSpecialist's record saved without validation. No workflow modification.Specialist clicks Save For Later on Map Record editing page.
FINISH_EDITINGSpecialist's record validated. If validation successful, specialist's record
saved. No workflow modification. 		Specialist clicks Finish from Map Record editing page.
UNASSIGNSpecialist's record deleted.Specialist clicks Unassign on Assigned Work widget.
ASSIGN_FROM_SCRATCHRecord created with REVIEW_NEW statusLead clicks Assign on Available Work widget
Lead Level Work: User's record is marked in bold

REVIEW_NEEDED + REVIEW_NEW

SAVE_FOR_LATERLead's record saved without validation
and marked REVIEW_IN_PROGRESS.		Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITING

Lead's record validated. If validation successful, lead's record
saved and marked REVIEW_RESOLVED

Lead clicks Finish from Compare Records editing page.

UNASSIGNLead's record deleted.Lead clicks Unassign on Assigned Work widget.

REVIEW_NEEDED + REVIEW_IN_PROGRESS

SAVE_FOR_LATERLead's record saved without validation. No workflow change.Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITINGLead's record validated. If validation successful, lead's record
saved and marked REVIEW_RESOLVED

Lead clicks Finish from either:

  • Compare Records editing page
  • Assigned Work widget
UNASSIGNLead's record deletedLead clicks Unassign on Assigned Work widget.

REVIEW_NEEDED + REVIEW_RESOLVED



SAVE_FOR_LATERLead's record saved without validation. No workflow change.Lead clicks Save for Later on Compare Records editing page.
FINISH_EDITINGLead's record validated. If validation successful, lead's record
saved and marked REVIEW_RESOLVED

Lead clicks Finish from either: Compare Records editing page.

  • Assigned Work widget
    • PUBLISH

    Lead's record set to READY_FOR_PUBLICATION.
    Record marked REVIEW_NEEDED deleted.
    Tracking record deleted.

    LEADS TO FINAL STATE.

    		Lead clicks Publish from Assigned Work widget.
    UNASSIGNLead's record deleted.Lead clicks Unassign on Assigned Work widget.

    ...

    Status 1Status 2Explanation
    NEW 

    One specialist has claimed the concept, but has not begun editing

    EDITING_IN_PROGRESS One specialist has begun editing, and has saved work.
    REVIEW_NEEDED One specialist has completed editing.
    REVIEW_NEEDEDREVIEW_NEWA lead has claimed specialist's work for review, but has not begun editing.
    REVIEW_NEEDEDREVIEW_IN_PROGRESSA lead has begun reviewing the specialist's work, and has saved work.
    REVIEW_NEEDEDREVIEW_RESOLVEDA lead has finished reviewing the specialist's work.

     

    QA Workflow Path

    The QA Workflow Path

    describes the process by which a concept with publication-ready mappings is inserted into the workflow by an admin or through the QA report process.  The concept is available to either specialists or leads, and requires only one-step review before being marked publication-ready.

    INITIAL STATE:

    • No tracking record exists for this concept and project.
    • A single publication-ready (PUBLISHED, READY_FOR_PUBLICATION) map record exists for this concept and project.

    FINAL STATE:

    • No tracking record exists for this concept and project.
    • A single map record marked READY_FOR_PUBLICATION exists.

     

    Workflow Status CombinationActionResultTrigger

    The combinations of map records that exist for a given
    workflow state.     Each combination is listed on a new line.
    Where multiple     records exist for a single combination, they
    are linked with a plus sign (+),
    e.g.     EDITING_DONE + EDITING_IN_PROGRESS.
    The current user's record (if any) is marked in bold.

    		The legal actions that can be
    requested for each workflow
    status combination.    		Description of map records added, modified, or deleted as a result
    of the requested action.     		User action in Mapping Tool resulting in requested action.
    Specialist or Lead Work: User's record is marked in bold

    READY_FOR_PUBLICATION
    PUBLICATION 

    INITIAL STATE: No tracking record

    		CREATE_QA_RECORD

    Map record marked PUBLISHED or READY_FOR_PUBLICATION is
    marked REVISION.
    Record created with QA_NEEDED status, owner set to "qa"

    User clicks Edit Record on either:

    • Project Records page
    • Concept Records page
    REVISION + QA_NEEDEDUNASSIGN

    NOT YET IMPLEMENTED

    Will remove the QA record and return the REVISION record to its earlier
    PUBLISHED or READY_FOR_PUBLICATION status 

    		N/A

    REVISION
    + QA_NEEDED
    + REVIEW_NEW

    		SAVE_FOR_LATERUser's record saved without validation
    and marked REVIEW_IN_PROGRESS.    		User clicks Save for Later on Compare Records editing page.
    FINISH_EDITING

    Users record validated. If validation successful, lead's record
    saved and marked REVIEW_RESOLVED

    User clicks Finish from Compare Records editing page.

    UNASSIGNUser's record deleted.User clicks Unassign on Assigned Work widget.

    REVISION
    + QA_NEEDED
    + REVIEW_IN_PROGRESS

    		SAVE_FOR_LATERUser's record saved without validation. No workflow change.User clicks Save for Later on Compare Records editing page.
    FINISH_EDITINGUser's record validated. If validation successful, lead's record
    saved and marked REVIEW_RESOLVED

    User clicks Finish from either:

    • Compare Records editing page
    • Assigned Work widget
    UNASSIGNUser's record deletedUser clicks Unassign on Assigned Work widget.

    REVISION
    + QA_NEEDED
    + REVIEW_RESOLVED



    		SAVE_FOR_LATERUser's record saved without validation. No workflow change.User clicks Save for Later on Compare Records editing page.
    FINISH_EDITINGUser's record validated. If validation successful, lead's record
    saved and marked REVIEW_RESOLVED

    User clicks Finish from Compare Records editing page

    PUBLISH

    User's record set to READY_FOR_PUBLICATION.
    Record marked REVIEW_NEEDED deleted.
    Record marked REVISION deleted.
    Tracking record deleted.

    LEADS TO FINAL STATE.

    		User clicks Publish from Assigned Work widget.
    UNASSIGNUser's record deleted.User clicks Unassign on Assigned Work widget.

    Description of workflow combinations

    This section describes each possible combination of workflow statuses attached to a tracking record for a concept and project.

    Status 1Status 2Status 3Explanation
    REVISIONQA_NEEDED 

    Concept with publication-ready mapping has been marked for QA

    REVISIONQA_NEEDEDREVIEW_NEWUser has claimed the concept marked for QA, but has not begun editing.
    REVISIONQA_NEEDEDREVIEW_IN_PROGRESSUser has begun QA editing, and has saved work.
    REVISIONQA_NEEDEDREVIEW_RESOLVEDUser has completed QA editing.

     TODO

     

    ...