Definition:
<!ENTITY % cm.obj-release " (comment) "> <!ELEMENT obj-release %cm.obj-release;>
Aufgabe: Gibt die mit obj-where ermittelten Dateien frei.
Zusatzinformationen: Sollte die Datei noch nicht eingereicht sein, so wird sie vorher eingereicht (d. h. einer commit-Operation unterzogen). Ferner werden noch fehlende Unterschriften erzeugt.
Spezielle Parameter dieses Funktionselements:
comment: ist der Kommentar, der für die nächste Gruppe, die die Datei übernimmt, eingetragen wird.
Verwendung: Zunächst werden mit obj-where Dateien ermittelt. Anschließend wird obj-release verwendet, um diese Dateien freizugeben.
Rückgabewert bei Erfolg: keiner.
Erforderliche Rechte: Wenn es eine Arbeitsversion für eine Datei gibt, muss der authentifizierte Benutzer der Bearbeiter sein und das Schreibrecht haben (permissionWrite). Ferner muss die Freigabe der letzte Schritt im Workflow der Versionen sein, es sei denn, der Benutzer hat das Dateiadministrationsrecht (permissionRoot). In diesem Fall kann er die Version unabhängig vom Workflow freigeben, wenn er der Bearbeiter ist.
Wenn es eine eingereichte Version gibt und nur eine Unterschrift fehlt, muss der Benutzer Mitglied in einer Gruppe sein, die zu dieser Unterschrift berechtigt ist, und das Leserecht haben.
Beispiel:
<cm-request...>
<obj-where>
<id>9785</id>
</obj-where>
<obj-release>
<comment/>
</obj-release>
</cm-request>
<cm-response...>
<cm-code numeric="0" phrase="ok"/>
</cm-response>