Comandos de referência › pdm_text_cmd--Interface da linha de comando API do texto

pdm_text_cmd--Interface da linha de comando API do texto

Use o comando pdm_text_cmd para a API do texto que você pode usar para criar e atualizar vários objetos tal como solicitações, requisições de mudança, ocorrências, ativos e contatos.

Importante: Não é possível usar aspas simples ou duplas como o parâmetro dos comandos pdm_text_nxd or bop_cmd.

Sintaxe

Esse comando apresenta o seguinte formato:

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

tabela -t

(Obrigatório) Especifica a tabela a ser processada. O nome da tabela pode ser um dos seguintes valores (não diferencia maiúsculas de minúsculas):

• Ativo
• Contato
• Mudança
• Ocorrência
• Solicitação

Observação: consulte a seção [OPTIONS] do arquivo text_api.cfg para obter uma lista completa de nomes de tabela válidos.

-u from_userid | -p from_persid

(Obrigatória uma opção) Identifica o contato para essa operação:

-u from_userid

Identifica o contato usando o valor da ID de Usuário.

-p from_persid

Identifica o contato usando o identificador de objeto exclusivo para o registro de contato. from_persid deve estar na forma cnt:xxxx. xxxx é a ID persistente do objeto.

Observação: o valor que você especifica com essa opção é anexado ao final da entrada para o comando pdm_text_cmd usando a palavra-chave apropriada, %FROM_USERID ou %FROM_PERSID

-o operation

Especifica a operação a ser executada. A operação deve ser um dos seguintes valores (não faz distinção entre letras maiúsculas e minúsculas):

• NEW — cria um objeto. Este valor é o padrão caso nenhuma operação seja especificada.
• UPDATE | UPD — cria um objeto se não for encontrado ou atualiza um objeto existente caso seja encontrado.
• UPDATE_ONLY | UPDO — atualiza o objeto caso seja encontrado. Caso contrário não realiza nenhuma ação.

Tanto UPDATE quanto UPDATE_ONLY precisam da palavra-chave %SEARCH na entrada do comando. Você pode executar apenas uma transação de operação com cada invocação de pdm_text_cmd.

-f input_file

Especifica o completo caminho do arquivo a ser processado, que é um arquivo de texto contendo comandos válidos de API de texto. Caso esse parâmetro seja omitido, os comandos são usados a partir do STDIN. A API de texto usa o seguinte formato básico para entrada:

%palavra-chave=valor

É possível emitir diversos comandos na entrada ao separar a solicitação de comando por pelo menos cinco sinais de porcentagem (%%%%%).

Observação: para obter mais informações sobre as palavras-chave válidas e sobre a entrada de formatação na API de texto, consulte o arquivo text_api.cfg.

-T timeout

Especifica o número de segundos que se deve esperar para uma resposta do servidor antes da expiração. O padrão é 30 segundos.

Observação: pdm_text_cmd mostra as respostas com base em texto recebidas novamente da API de texto, que incluem mensagens de erros ou êxito e o texto original enviado usando a API para processamento. O pdm_text_cmd retorna zero se o comando for concluído com sucesso sem aviso ou erros ou se um comando for concluído com sucesso, mas com avisos. Qualquer outro valor de retorno indica que ocorreu um erro.

Importante! Em UNIX, o LIBPATH deve ser definido antes de executar vários utilitários do CA SDM. Use pdm_task para definir LIBPATH antes de executar um utilitário. Por exemplo, insira “pdm_task pdm_clean_attachments...".

Observação: ao transmitir os parâmetros no prompt de comando, use Ctrl+Z no Windows e Ctrl+D no POSIX.

(novo grupo relacionado 1)

Usando a API de texto