<content-where> <content-addLinkTo>

Definition:

<!ENTITY % cm.content-addLinkTo "
  (attribute |
  destinationUrl |
  target |
  title |
  position)*
">
<!ELEMENT content-addLinkTo %cm.content-addLinkTo;>

Aufgabe: content-addLinkTo erzeugt einen freien Link und fügt ihn zum angegebenen Linklistfeld einer Arbeitsversion hinzu.

Spezielle Parameter dieses Funktionselements:

  • attribute: spezifiziert den Namen des Linklistfeldes, zu dem der freie Link hinzugefügt werden soll. Das betreffende Feld muss vom Typ linklist sein.
  • destinationUrl: enthält das Linkziel.
  • title: enthält den Titel des Links.
  • target: enthält den Zielrahmen.
  • position: (ab Version 6.6.1) enthält den Sortierwert des Links.

Verwendung: Zunächst wird mit content-where die Version ermittelt. Anschließend wird content-addLinkTo verwendet, um einem Linklistfeld der Version einen freien Link hinzuzufügen.

Rückgabewert bei Erfolg: die ID des erzeugten Links.

Erforderliche Rechte: Der authentifizierte Benutzer muss das Recht permissionWrite für die Datei haben, zu dem die Version gehört und Bearbeiter der Version sein.

Beispiel:

<cm-request...>
  <content-where>
    <objectId>116624</objectId>
    <state>edited</state>
  </content-where>
  <content-addLinkTo>
    <attribute>relatedLinks</attribute>
    <destinationUrl>https://www.flower.com</destinationUrl>
  </content-addLinkTo>
</cm-request>

<cm-response...>
  <cm-code numeric="0" phrase="ok">
    <link>
      <id>116624.54.6</id>
    </link>
  </cm-code>
</cm-response>