edit_text

mutationSeit v1.0

Ersetzt eine einzelne Passage in einem langen Text an Ort und Stelle. Sie senden genau den Wortlaut, der weichen soll, und das, was an seine Stelle tritt; jedes andere Zeichen bleibt unverändert — eine lange Beschreibung oder ein veröffentlichtes Dokument kann so nicht stillschweigend einen Absatz an eine Neufassung verlieren. Für alles, was länger als ein paar Sätze ist, ist dieses Tool update_nodes vorzuziehen.

Lesen Sie den aktuellen Text zuerst (get_node_details oder list_renderings / list_publications mit eingeschlossenem Dokument), damit die zitierte Passage Zeichen für Zeichen übereinstimmt. Die Passage muss genau einmal vorkommen und exakt übereinstimmen; andernfalls wird die Änderung mit einer Begründung abgelehnt, statt zu raten — meist ein Zeichen dafür, dass sich der Text seit Ihrem Lesen geändert hat: also erneut lesen und neu ansetzen. Mit replace_all ändern Sie jedes Vorkommen; ein leerer Ersatztext löscht die Passage.

Erreichbar sind die Beschreibung eines Knotens, einer Beziehung, einer Ressource oder des Modells selbst, das Dokument eines Renderings und die Startseite einer Publikation. Die an eine Ressource angehängte Datei ist kein Text und lässt sich auf diesem Weg nicht bearbeiten.

Mit einer locale bearbeiten Sie den Text genau dieser Sprache — nie den Text, auf den ersatzweise zurückgegriffen wird — und die Änderung wird abgelehnt, wenn für diese Sprache dort noch nichts hinterlegt ist, statt Text der Standardsprache in ihren Platz zu schreiben.

Die Antwort nennt, was geschehen ist: wie viele Ersetzungen, ab welcher Zeile und wie sich die Länge geändert hat.

Parameter

Name	Typ	Pflichtfeld	Standard	Beschreibung
`target_type`	`String`	—	node	Was den Text enthält: node, relationship, model, rendering, publication oder asset.
`old_string`	`String`	✓		Die zu ersetzende Passage, exakt so kopiert, wie sie gespeichert ist.
`target_id`	`String`	—		Welches Element — eine UUID oder eine Auto-ID wie REQ-42. Renderings, Publikationen und Ressourcen lassen sich auch über ihren Namen ansprechen. Nur bei target_type „model” weglassen.
`field`	`String`	—		Welcher Text bearbeitet werden soll. Standard ist die Beschreibung bei Knoten, Beziehung, Modell und Ressource; das Dokument bei einem Rendering; die Startseite bei einer Publikation.
`new_string`	`String`	✓		Was an ihre Stelle tritt. Eine leere Zeichenkette löscht die Passage.
`replace_all`	`Boolean`	—	false	Ändert jedes Vorkommen, statt zu verlangen, dass die Passage nur einmal vorkommt.
`locale`	`String`	—		Bearbeitet den Text genau einer Sprache, zum Beispiel „de”. Wird abgelehnt, wenn für diese Sprache in diesem Feld noch kein Text hinterlegt ist.

Beispielanfrage

{"target_type": "node", "target_id": "REQ-42", "old_string": "reviewed quarterly by the data owner", "new_string": "reviewed monthly by the data owner"}

Beispielantwort

{"success": true, "operation_count": 1, "versions": [102], "summary": "Patched description of 'Quarterly Review': 1 replacement(s) from line 4, 812 → 795 chars"}