Verfügbar für: Content Management Server
Aufgabe: Die Prozedur ermittelt aus einer Liste von CMS-Dateien diejenigen, die eine angegebene Zeichenkette in einem angegebenen Feld enthalten. Zusätzlich kann der Status der zu findenden Dateien eingeschränkt werden.
Syntax:
grep expression objects [attribute] [args]
Funktionsparameter:
expression
: der anzuwendende reguläre Ausdruck
objects
: die Liste der CMS-Dateien, die
durchsucht werden sollen
attribute
: das zu durchsuchende Feld. Diese
Angabe ist optional, Voreinstellung: blob
args
: optionale Angabe zusätzlicher
Einschränkungen. args
kann sein:
-states state
: Dies schränkt die
Treffermenge auf CMS-Dateien ein, die einen bestimmten
Bearbeitungsstatus oder einen aus einer Menge von Status haben.
state
kann sein:
edited
, committed
,
released
, archived
.all
(Voreinstellung) steht für einen
beliebigen Status.active
steht für einen beliebigen Status
außer archived
.Rückgabewert bei Erfolg: je gefundene Datei deren
Pfad, Angaben zur Fundstelle sowie ein Auszug aus dem Text, in dem der
Suchausdruck vorkommt (string). Die Fundstelle wird mit den Kürzeln
o
(Datei-ID), c
(Versions-ID) und
l
(Zeilennummer) näher spezifiziert (siehe das
Beispiel).
Erforderliche Rechte: Der Benutzer muss das Leserecht für die gefundenen Dateien haben.
Beispiel:
CM>grep "modifyvar" [obj where condition {objType is template}] /mastertemplate (o:2011,c:2015,l:4) <npsobj modifyvar="set" varname="contentTypeAndCharset">text/html; charset=<npsobj insertvalue="var" name="exportCharset" /></npsobj>