3 files changed, 55 insertions, 0 deletions
diff --git a/docs/clamp/acm/plantuml/system-dialogues/MigrateAcElements.puml b/docs/clamp/acm/plantuml/system-dialogues/MigrateAcElements.puml
new file mode 100755
index 00000000..2f9523fc
--- /dev/null
+++ b/docs/clamp/acm/plantuml/system-dialogues/MigrateAcElements.puml
@@ -0,0 +1,15 @@
+@startuml
+participant "ACM Runtime"
+participant Participant
+participant "Participant Api"
+
+alt "instance Id and Composition Ids exist"
+  "ACM Runtime" -> Participant : [ASYNC] Migration message from source to target composition
+  Participant -> "Participant Api" : Migrate AC Element
+  "Participant Api" -> Participant : AC Element Migrated
+  Participant -> "ACM Runtime" : [ASYNC] Migration completed
+  note right
+  Returns AUTOMATION_COMPOSITION_STATE_CHANGE message.
+  end note
+end
+@enduml
diff --git a/docs/clamp/acm/plantuml/system-dialogues/MigrateAcElementsResponse.puml b/docs/clamp/acm/plantuml/system-dialogues/MigrateAcElementsResponse.puml
new file mode 100755
index 00000000..3ba0410f
--- /dev/null
+++ b/docs/clamp/acm/plantuml/system-dialogues/MigrateAcElementsResponse.puml
@@ -0,0 +1,10 @@
+@startuml
+participant "ACM Runtime"
+participant "ACM Database"
+participant Participant
+
+alt "instance Id and Composition Ids exist"
+  Participant -> "ACM Runtime" : [ASYNC] Migration completed
+  "ACM Runtime" -> "ACM Database" : instance and AC Element will be set in a final state (DEPLOYED)\n and Comp Def IDs change for instance and AC Element
+end
+@enduml
diff --git a/docs/clamp/acm/plantuml/system-dialogues/MigrateAcInstance.puml b/docs/clamp/acm/plantuml/system-dialogues/MigrateAcInstance.puml
new file mode 100755
index 00000000..184e872a
--- /dev/null
+++ b/docs/clamp/acm/plantuml/system-dialogues/MigrateAcInstance.puml
@@ -0,0 +1,30 @@
+@startuml
+participant Rest
+participant "ACM Runtime"
+participant "ACM Database"
+participant Participants
+
+group Create New Composition type for Migration
+Rest -> "ACM Runtime" : Composition Definitions
+"ACM Runtime" -> "ACM Database" : Saved Definition
+Rest -> "ACM Runtime" : Prime Definition
+"ACM Runtime" -> Participants:  [ASYNC] Prime Definition
+end group
+
+group Migration per Instance
+/'Instance migration from source to target composition type. '/
+Rest -> "ACM Runtime" : Migrate Instance\n(InstanceId, sourceCompId, targetCompId, instance properties)
+note top
+Instance migration from source to target
+composition type.
+end note
+alt "instance Id and Composition Ids exist"
+  "ACM Runtime" -> "ACM Database" : Definition Validation
+  "ACM Runtime" -> "ACM Database" : instance and AC Element will be set\nin a transitional state (MIGRATING),\n new instance properties will be saved
+  "ACM Runtime" -> Participants : [ASYNC] Migration message from source to target composition
+  "ACM Runtime" -> Rest : Instance migration has been requested
+ else
+  "ACM Runtime" -> Rest : 400 Bad Reqest
+end
+end group
+@enduml