A chamada update

A chamada update é usada para modificar um registro (entidade) existente identificado pelo identificador de registro com valores especificados.

A solicitação update

Além dos argumentos normais de ID de logon e senha, a chamada update também requer os seguintes argumentos:

Integrante: classe do bean

Descrição: classe de bean de java (tipo de dados complexos) específica da entidade que contém valores para os campos que devem ser atualizados, durante a atualização de uma entidade existente identificada pelo identificador de registro.

Durante uma atualização, não é necessário especificar todos os campos desse tipo de entidade. Transmita os valores para os campos que deseja atualizar durante a chamada.

Os campos não especificados serão mantidos intactos. Os campos muito longos são truncados. Se você enviar valores de campo não reconhecidos na solicitação update, a API WS da Central de atendimento rejeitará a chamada e enviará o código de status 300 com uma mensagem de status associada que indica o seguinte:

Rejecting the value supplied for input data element "{ 0} "; due to a correlation failure because the data transformation process could not resolve the supplied input data element into native format.

A API aplica uma definição estrita dos valores de campo não reconhecidos, de modo que todos os campos da chamada precisem ser válidos para o usuário da operação. Por exemplo: a API rejeita chamadas que especificam um valor para um campo personalizado que tenha sido excluído ou removido do acesso de um usuário.
A API rejeita chamadas que especificam campos somente leitura.

A resposta de update: a resposta padrão do serviço para todas as chamadas de API conterá o identificador de registro (ID de linha) de um registro que está sendo atualizado no formato de saída solicitado para uma chamada update.

É possível limpar os campos de texto que não são obrigatórios inserindo ##NULL##. No entanto, se você digitar ##NULL## em um campo obrigatório, você irá receber a mensagem padrão informando que o campo é obrigatório.

Quando um usuário tenta atualizar o ticket, é exibida uma mensagem de erro indicando que os seguintes campos são campos somente leitura:

Organização do solicitante
Local do solicitante
Site do solicitante
Solicitado para – Organização
Solicitado para o local
Solicitado para o site
Caso de pai