Given: Schema, Structure, Role
Result: Structure is changed, new player is added to the set of role players.

When you use the annotation wizard to annotate object data (e.g. source code) with a new real entity, you can on the fly add a new player to a given structure. the following figure shows the according page of the wizard.

In repair/elementary_actions.pl:

add_new_player(+SchemaID, +StructureID, +RoleID, -PlayerID)

This call updates the runtime fact base but does not persist the new structure.

In org.cs3.patchwork.facade.FacadeToProlog:

public String addRoleInstance(String schema, String structure, String role)

This call updates the runtime fact base but does not persist the new structure.