b : truefalse; flag indicating whether the commit was successful.

r : posint; new revision number

The Commit(s,cs) calling sequence commits all changes in the change set cs to the SysML server in one atomic transaction. If cs is not specified, the internally cached change set is used. It returns a truefalse flag indicating success, and the new revision number on the server.

Currently the supported changes are for the numeric values of Value Properties or Slots (see PutValue), or the constraint relations for Constraint Blocks (see PutConstraint).

The commit is successful if all elements of the change set contain valid changes (e.g., none of the model elements to be changed has been deleted on the server) and the revision on the server has not changed since the initial Connect call, i.e., no other changes were committed since then. In this case, the internally stored revision number will be updated to the new revision, and cs will be reset to the empty change set.

An error is raised if the head revision on the server is different from the one that was obtained with the initial Connect call. This can happen for two reasons: either the Connect was deliberately made to an older revision, or another commit, typically by a different user, has happened since the initial Connect.

In order to preserve the change set in cases when another commit may have happened on the server since the initial Connect, it is recommended to record all changes not in the internal change set but in an explicitly specified change set that is maintained by the user, since the internal change set is cleared automatically by a Connect call to a newer revision. It is the responsiblity of the user in that case to verify that the change set is still valid for the newer revision, e.g., there were no changes in the newer revision that conflict with ones from the user's change set.

If the commit is successful and no other commits were detected, the changes from cs will be applied to all locally cached model elements as well. Otherwise, if another commit has happened shortly before or after this Commit call, then the internal cache will be cleared.

If the commit is not successful, then upon return cs contains all changes that were not committed, e.g., corresponding to model elements that do not exist on the server.

Use of this command requires an active server connection, using the Connect command.  If such a connection does not exist, an error will be raised.

$\mathrm{with}\left(\mathrm{SysMLConnector}\right)$

$\left[\mathrm{ClearChangeSet}\,\mathrm{Commit}\,\mathrm{Connect}\,\mathrm{GetBinding}\,\mathrm{GetChildren}\,\mathrm{GetConstraint}\,\mathrm{GetInstances}\,\mathrm{GetSlots}\,\mathrm{GetValue}\,\mathrm{Login}\,\mathrm{Logout}\,\mathrm{PrintChangeSet}\,\mathrm{PrintElement}\,\mathrm{PutConstraint}\,\mathrm{PutValue}\,\mathrm{QualifiedNameOf}\,\mathrm{QueryModel}\,\mathrm{Warnlevel}\right]$

$\mathrm{Login}\left(''https://twc.mycompany.com:8111/''\,'\mathrm{user}'=''alice''\,'\mathrm{password}'=''a\%5Wr^Xt0p@2''\right)$

$\mathrm{Connect}\left(''JMPTWCSysML''\right)\:$

$\mathrm{PR\_fan}≔\mathrm{QueryModel}\left(''Model-Turbofan::System\; Breakdown::System\; Structure::Analysis\; Block::PR\_fan''\right)$

$\mathrm{PR\_fan}≔\left[''d478980a-4ab8-4693-b4af-c1d136b33423''\,\left[''uml:Property''\,''ValueProperty''\right]\,\mathrm{PR\_fan}\right]$

$\mathrm{GetValue}\left(\mathrm{PR\_fan}\left[3\right]\right)$

$''PR\_fan''=\left[1.5\,1\right]$

$\mathrm{cs}≔\mathrm{table}\left(\right)\:$

$\mathrm{PutValue}\left(\mathrm{PR\_fan}\left[3\right]\,1.2\,\mathrm{cs}\right)$

$\mathrm{GetConstraint}\left(''Model-Turbofan::Constraints::Temperature\; at\; exit''\right)$

$''Temperature\; at\; exit''=\left[\mathrm{T0tt}=\mathrm{T0t}+\mathrm{deltaT}\right]$

$\mathrm{PutConstraint}\left(''Model-Turbofan::Constraints::Temperature\; at\; exit''\,\mathrm{T0tt}=\mathrm{T0t}\,\mathrm{cs}\right)$

$\mathrm{PrintChangeSet}\left(\mathrm{cs}\right)$

502a4da2-d9c3-4585-908e-484772a0051f (Temperature at exit): body = ["T0tt = T0t"] (["T0tt = T0t + deltaT"])

c5bf0b87-1c3f-42db-8862-ab4155b05e5d (PR_fan): value = "1.2" ("1.5")

$\mathrm{Commit}\left(''Updated\; PR\_fan\; and\; Temperature\; at\; exit''\,\mathrm{cs}\right)$

$\mathrm{true},31$

$\mathrm{PrintChangeSet}\left(\mathrm{cs}\right)$

$\mathrm{PrintElement}\left(''502a4da2-d9c3-4585-908e-484772a0051f''\right)$

"ID" = "_19_0_3_8970276_1591124299670_346644_24803"
"body" = [1 = "T0tt = T0t"]
"name" = ""
"owner" = [1 = {"@id" = "ad7c35e5-ed4a-43a3-bb6e-dd40720e8768"}]
"owningConstraint" = {"@id" = "ad7c35e5-ed4a-43a3-bb6e-dd40720e8768"}
"visibility__from_PackageableElement" = "public"

$\mathrm{Logout}\left(\right)$