Referenzbefehle › pdm_text_cmd – Befehlszeilenschnittstelle für Text-API

pdm_text_cmd – Befehlszeilenschnittstelle für Text-API

pdm_text_cmd ist der Befehl für die Text-API, mit der Sie verschiedene Objekte wie zum Beispiel Requests, Changes, Issues, Assets und Kontakte erstellen und aktualisieren können.

Wichtig! Sie können kein einzelnes oder doppeltes Anführungszeichen als Parameter der Befehle pdm_text_nxd oder bop_cmd verwenden.

Syntax

Dieser Befehl hat das folgende Format:

pdm_text_cmd -t table {-u from_userid -p from_persid} [-o operation] [-f input file] [-T timeout] [-h]

-t table

(Erforderlich) Gibt die zu verarbeitende Tabelle an. Der Tabellenname kann einer der folgenden Werte sein (keine Unterscheidung zwischen Groß- und Kleinschreibung):

• Asset
• Kontakt
• Ändern
• Issue
• Request

Hinweis: Eine vollständige Liste der gültigen Tabellennamen finden Sie im Abschnitt [OPTIONS] der Datei "text_api.cfg".

-u from_userid | -p from_persid

(Eine Option erforderlich) Bestimmt den Kontakt für diese Operation:

-u from_userid

Bestimmt den Kontakt über die Anwenderkennung.

-p from_persid

Bestimmt den Kontakt über die eindeutige Objektkennung für den Kontaktdatensatz. "from_persid" muss folgendes Format haben: cnt:xxxx. xxxx ist die permanente ID des Objekts.

Hinweis: Der Wert, den Sie mit dieser Option angeben, wird am Ende der Eingabe für den Befehl "pdm_text_cmd" angehängt, wobei das entsprechende Schlüsselwort, %FROM_USERID oder %FROM_PERSID, verwendet wird.

-o operation

Gibt die durchzuführende Operation an. Die Operation muss einer der folgenden Werte sein (keine Unterscheidung zwischen Groß- und Kleinschreibung):

• NEU – Erstellt ein Objekt. Dies ist der Standardwert, wenn keine Operation angegeben wird.
• UPDATE | UPD – Erstellt ein Objekt wenn kein Objekt gefunden wurde oder aktualisiert ein bestehendes Objekt, wenn ein Objekt gefunden wurde.
• UPDATE_ONLY | UPDO – Aktualisierung erfolgt, wenn ein Objekt gefunden wurden, andernfalls erfolgt keine Aktion.

Sowohl für UPDATE als auch für UPDATE_ONLY ist das %SEARCH-Schlüsselwort bei der Eingabe des Befehls erforderlich. Bei jedem Aufruf von "pdm_text_cmd " können Sie nur eine Operation ausführen.

-f input_file

Gibt den vollständigen Pfad der zu verarbeitenden Datei an. Dies ist eine Textdatei, die gültige Text-API-Befehle enthält. Wenn Sie diesen Parameter weglassen, werden Befehle aus STDIN benutzt. Die Text-API verwendet das folgende grundlegende Eingabeformat:

%keyword=value

Sie können mehrere Befehle eingeben, indem Sie die Befehlsanfrage durch mindestens fünf Prozentzeichen trennen (%%%%%).

Hinweis: Weitere Informationen über gültige Schlüsselwörter und über das Formatieren einer Eingabe zur Text-API finden Sie in der Datei "text_api.cfg".

-T timeout

Gibt die Anzahl der Sekunden an, die auf eine Antwort vom Server gewartet wird, bevor eine Zeitüberschreitung eintritt. Der Standardwert ist 30 Sekunden.

Hinweis: "pdm_text_cmd" zeigt die textbasierten Antworten von Text-API an: Erfolgs- oder Fehlermeldungen sowie den ursprünglichen gesendeten und über die API verarbeiteten Text. "pdm_text_cmd" gibt "0" zurück, wenn der Befehl erfolgreich ohne Warnungen oder Fehler ausgeführt wurde oder "1", wenn der Befehl zwar erfolgreich abschließt, jedoch Warnungen aufweist. Jeder andere Rückgabewert zeigt an, dass ein Fehler aufgetreten ist.

Wichtig! Bei UNIX muss der LIBPATH vor der Ausführung mehrerer CA SDM-Dienstprogramme festgelegt werden. Verwenden Sie pdm_task, um den LIBPATH vor der Ausführung eines Dienstprogramms festzulegen. Geben Sie zum Beispiel "pdm_task pdm_clean_attachments ..." ein.

Hinweis: Wenn Sie Parameter über die Eingabeaufforderung weitergeben, verwenden Sie STRG+Z in Windows und STRG+D in POSIX.

(neue verwandte Gruppe 1)

Verwenden der Text-API