h1. Introduction

TODO, What is the audience of this document?

h1. Synchronization

h2. Synchronization Direction

TODO, speak about synchronization direction options and consequences.

h2. Synchronization Options

TODO, speak about synchronization options available for each element.

h2. Sychronization Example

This section show typical synchronization environment treated by Mizura.

Assume that a _LEFT_TO_RIGHT_ synchronization operation is used, where _left_ elements are Enterprise Architect usecases and _right_ elements are Jira issues.

The elements involved in this example are displayed below:

|| Left element (EA usecases) || Last update || Right element (JIRA issues) || Last update || Comment ||
| usecase UC001 | 2010.02.01 10:00:00 | issue MZ-1 | 2010.02.01 09:00:00 | Usecase and issue are connected, and usecase information is more recent |
| usecase UC002 | 2010.02.01 12:00:00 | issue MZ-2 | 2010.02.01 11:00:00 | Usecase and issue are connected, and usecase information is more recent |
| usecase UC003 | 2010.02.01 14:00:00 | issue MZ-3 | 2010.02.01 15:00:00 | Usecase and issue are connected, and jira issue information is more recent |
| usecase UC004 | 2010.02.01 16:00:00 | -  | -  | A usecase exist, but not an equivalent issue |
| -  | -  | issue MZ-5 | 2010.02.01 17:00:00 | A jira issue exist, but not an equivalent usecase |
| {center}(x){center} | -  | issue MZ-6 | 2010.02.01 19:00:00 | Aa existent usecase was deleted in EA since the last synchronization, and a jira issue exist with the given usecase identificator information |

Once synchronization occurs, the following operations are performed in the environment, regard each [SyncOption|http://3layer.com.br/fisheye/browse/treelayer-mizura/trunk/mizura/src/br/org/treelayer/mizura/mapper/enums/SyncOption.java?r=HEAD] configuration:

TODO, finish this table...


|| Left element (EA usecases) || Right element (JIRA issues) || ADD || ADD_UPDATE || ADD_UPDATE_DELETE || ADD_UPDATEIFNEW || ADD_UPDATE_DELETEWITHPURGE ||
| usecase UC001 | issue MZ-1 | None  | issue updated | issue updated | issue updated if usecase was updated more recently\\ | issue updated |
| usecase UC002 | issue MZ-2 | None  | issue updated | issued updated | issue updated if usecase was updated more recently | issue updated |
| usecase UC003 | issue MZ-3 | None  | issue updated | issued updated | issue updated if usecase was updated more recently | issue updated |
| usecase UC004 | -  | issue MZ-n created | issue MZ-n created | issue MZ-n created | issue MZ-n created\\ | issue MZ-n created |
| -  | issue MZ-5 | None | None | None | None | issue MZ-5 deleted |
| {center}(x){center} | issue MZ-6 | None | None | issue MZ-6 deleted | None | issue MZ-6 deleted |