How to model sentences with multiple work objects?

[hofstef]

Domain Storytelling's basic syntax (subject – predicate – object) is supported very well. However, I could not find a way to model more complex syntax (as described here). The activity macro seems to support arrays of work objects and "target" actors but I could not figure out how to use them:

activity(step, subject, predicate, object, [post], [target], [objectArr], [targetArr], [color], [scale], [note])

An example would be great.

[johthor]

Hi @hofstef, when I originally created the macros I misread or did not realize that other sentence structures should be possible. Only after merging #7 and rereading the relevant passages of your book did I realize the need for more flexibility.

Unfortunately the notation activity(step, subject, predicate, object, [post], [target], [objectArr], [targetArr], [color], [scale], [note]) does not denote any arrays but instead optional parameters, that may also be specified as keyword arguments.

All in all the macro is not very flexible as it only supports three actors and/or work objects at a time. I already have some Ideas for more flexible activity descriptions (#11).

But after #7 was merged the activity macro allows for more complex sentence structures as demonstrated below

@startuml
!include ../domainStory.puml

Person(A6, "A")
Document(w6, "w")
Document(v2, "v")
Document(u)
Document(t)
activity(6, A6, works on, w6, using, v2)
activity(., v2, and, u, with, t)


Person(A5, "A")
Person(B3, "B")
Document(w5, "w")
activity(=5, A5, collaborates on, w5)
activity(|, B3, collaborates on, w5, $objectArr = "<--")

Person(A4, "A")
Person(B2, "B")
Person(C)
Document(w4, "w")
activity(4, A4, hands over, w4, to, B2)
activity(., w4, and, C)

Person(A3, "A")
Person(B)
Document(w3, "w")
activity(3, A3, hands over, w3, to, B)

Person(A2, "A")
Document(w2, "w")
Document(v)
activity(2, A2, works on, w2, using, v)

Person(A)
Document(w)
activity(1, A, works on, w)
@enduml