Comandi di riferimento › Interfaccia riga di comando di Text API - pdm_text_cmd

Interfaccia riga di comando di Text API - pdm_text_cmd

Utilizzare il comando pdm_text_cmd per l'API di testo per creare e aggiornare diversi oggetti, quali Richieste, Ordini di cambiamento, Questioni, asset e contatti.

Importante. Non è possibile utilizzare le virgolette singole o doppie come parametro dei comandi pdm_text_nxd o bop_cmd.

Sintassi

Il comando presenta il seguente formato:

pdm_text_cmd -t tabella {-u da_idutente -p da_idpersistente} [-o operazione [-f file_ input] [-T timeout] [-h]

-t table

(Obbligatorio) Specifica la tabella da elaborare. Il valore di tabella può essere uno dei seguenti (nessuna distinzione tra maiuscole e minuscole):

• Asset
• Contatto
• Cambiamento
• Questione
• Filtro

Nota: vedere la sezione [OPTIONS] del file text_api.cfg per un elenco completo dei nomi di tabella validi.

-u da_idutente | -p da_idpersistente

(1 opzione obbligatoria) Identifica il contatto per l'operazione:

-u da_idutente

Identifica il contatto utilizzando il valore ID utente.

-p da_idpersistente

Identifica il contatto utilizzando l'ID oggetto univoco del record del contatto. da_idpersistente deve avere formato cnt:xxxx. xxxx è l'ID persistente dell'oggetto.

Nota: il valore specificato con questa opzione viene aggiunto in coda all'input del comando pdm_text_cmd, utilizzando la parola chiave appropriata, %FROM_USERID o %FROM_PERSID.

-o operazione

Specifica l'operazione da eseguire. Il valore di operazione può essere uno dei seguenti (nessuna distinzione tra maiuscole e minuscole):

• NEW—Crea un nuovo oggetto. Si tratta del valore predefinito se non è specificata alcuna operazione.
• UPDATE | UPD—Crea un oggetto se l'oggetto non viene trovato o aggiorna un oggetto esistente.
• UPDATE_ONLY | UPDO—Aggiorna l'oggetto se trovato, altrimenti non viene eseguita alcuna operazione.

Sia UPDATE che UPDATE_ONLY richiedono la parola chiave %SEARCH nell'input del comando. Ad ogni esecuzione del comando pdm_text_cmd è possibile specificare una sola operazione.

-f file_input

Specifica il percorso completo del file da elaborare. Si tratta di un file di testo contenente comandi validi dell'interfaccia API testo. Se si omette questo parametro, vengono utilizzati i comandi da STDIN. L'interfaccia API testo utilizza il seguente formato di base per l'input:

%parola_chiave=valore

È possibile utilizzare più comandi nell'input, separando la richiesta di comando con almeno cinque segni di percentuale (%%%%%).

Nota: per ulteriori informazioni sulle parole chiave valide e sulla formattazione dell'input per l'interfaccia API testo, vedere il file text_api.cfg.

-T timeout

Specifica il numero di secondi di attesa della risposta dal server trascorsi i quali si verifica il timeout. Il valore predefinito è 30 secondi.

Nota: pdm_text_cmd mostra le risposte in formato testo ricevute dall'interfaccia API testo, che includono messaggi di operazione riuscita o di errore, e il testo originale inviato utilizzando l'interfaccia API per l'elaborazione. pdm_text_cmd restituisce 0 (zero) se il comando viene eseguito correttamente senza avvisi o errori e 1 (uno) se viene eseguito correttamente ma con avvisi. Qualsiasi altro valore restituito indica che si è verificato un errore.

Importante: in UNIX, LIBPATH deve essere impostato prima di eseguire diverse utilità di CA SDM. Utilizzare pdm_task per impostare LIBPATH prima di eseguire un'utilità. Immettere ad esempio "pdm_task pdm_clean_attachments...".

Nota: per l'immissione dei parametri dal prompt dei comandi, utilizzare Ctrl+Z in Windows e Ctrl+D in POSIX.

(nuovo gruppo correlato 1)

Utilizzo dell'API testo