Modo de conjunto de importação de serviço web

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Quando uma mensagem SOAP insere um registro em uma tabela de conjunto de importação e não há nenhum conjunto de importação para essa tabela no Carregando um novo conjunto de importação será criado com Modo definido como Síncrono .

    Um conjunto de importação com um Modo de Síncrono transformará os dados assim que forem inseridos (desde que o mapa de transformação já exista). Este conjunto de importação também terá um padrão Estado de Carregando . Por padrão, Todos Síncrono os conjuntos de importação serão modificados automaticamente para Processado à meia-noite. Como resultado, quando uma nova inserção acontece com a mesma tabela, uma nova Síncrono o conjunto de importação será criado.

    Figura 1. Conjunto de importação síncrona
    Alterando este conjunto de importação para um modo de Assíncrono e um estado de Carregando não transforma os dados de entrada conforme são inseridos, mas "carrega" o conjunto de importação e adia a transformação de dados posteriormente, manualmente ou com um trabalho de script agendado.
    Tabela 1. Modo de conjunto de importação
    Modo Estado Função
    Assíncrono Carregando A transformação de dados não está ocorrendo automática e imediatamente. Os dados adicionados à linha do conjunto de importação têm um estado "Pendente". A transformação pode ser programada ou executada manualmente quando o estado é alterado para Carregado
    Assíncrono Carregado em Marca a conclusão do carregamento de dados. A transformação de dados agora pode ocorrer de forma programada ou manualmente.
    Síncrono Carregando A transformação de dados ocorre automática e imediatamente sempre que os dados são inseridos na linha do conjunto de importação associado.
    Síncrono Carregado em Quando novos dados são inseridos neste conjunto de importação associado, um novo conjunto de importação do modo Síncrono e estado Carregando será criado. Alterando o estado para Carregado é uma maneira de indicar que um novo Síncrono o conjunto de importação deve ser criado para a próxima inserção de linha do conjunto de importação (e transformado imediatamente)

    Controle do comportamento de inserção

    Em conjuntos de importações que especificam um ou mais campos de aglutinação, os registros com um valor de aglutinação correspondente são transformados da tabela de origem para a tabela de destino em série (um de cada vez) para evitar duplicatas.

    Em conjuntos de importação que não especificam nenhum campo aglutinar, os registros são transformados simultaneamente. Você pode controlar esse comportamento usando glide.import_set_insert_serialized_when_no_coalescepropriedade.

    . glide.import_set_insert_serialized.<table name>a propriedade do sistema controla como a instância insere registros de chamadas de serviço web em uma tabela de conjunto de importação específica. Quando verdadeiro, esta propriedade impede que inserções simultâneas idênticas criem registros duplicados serializando as operações de inserção do banco de dados. Se uma tabela de destino não tiver campos de aglutinação definidos em um mapa de transformação, defina esta propriedade como falso para melhorar o desempenho do conjunto de importação de serviço web.

    Nota:
    Definindo esta propriedade como falso pode resultar na criação de registros duplicados.
    Nota:
    . glide.soap.import_set_insert_serialized.<table name>a propriedade do sistema fornece funcionalidade equivalente a. glide.import_set_insert_serialized.<table name>, mas se ambas as propriedades estiverem definidas, glide.import_set_insert_serialized.<table name>substitui glide.soap.import_set_insert_serialized.<table name>.

    Resposta SOAP padrão

    A resposta SOAP de um conjunto de importação de serviço web inserir a chamada retorna os seguintes valores padrão.
    <SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Body><insertResponse><sys_id>fa648f5f0a0a0b2b0048e7012448b8f1</sys_id><table>incident</table><display_name>number</display_name><display_value>INC10014</display_value><status>inserted</status></insertResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>
    Tabela 2. Resposta SOAP padrão
    Campo Descrição
    sys_id O sys_id do registro resultante que foi criado ou modificado
    tabela O nome da tabela afetada. No caso de um Assíncrono chamada, o nome da tabela seria a tabela do conjunto de importação, por exemplo, imp_notification para Notificações tabela de conjunto de importação de serviço da web
    display_name O nome do campo definido como o campo de exibição do registro que foi criado ou modificado
    display_value O valor do campo designado como o campo de exibição. Por exemplo, o campo de exibição do Incidente a tabela é Número E um valor de exemplo seria INC10001
    status Um valor de cadeia de caracteres que indica a ação que ocorreu como resultado da invocação do serviço web, relacionada ao registro definido pelo sys_id e. tabela valores de campo
    • inserido - o registro foi inserido
    • atualizado - o registro foi atualizado
    • ignorado - a entrada foi ignorada, o registro não foi atualizado e nenhum novo registro foi criado
    • ignorado - os dados de entrada foram ignorados (semelhante a ignorado) devido à ausência de valores de aglutinação
    • erro - ocorreu um erro ao processar a entrada
    status_message Este valor se traduz no valor encontrado em Comentário campo da linha do conjunto de importação e geralmente contém informações relacionadas ao status , por exemplo, "Nenhum valor de campo alterado" quando o status é "Ignorado". Definir este valor como um valor de cadeia de caracteres personalizado fará com que a resposta SOAP contenha um campo opcional status_message a ser retornado.
    error_message A mensagem relacionada a um status de erro . Quando ocorre um erro, definir este valor como um valor de cadeia de caracteres personalizado fará com que a resposta SOAP contenha um campo error_message opcional a ser retornado

    Personalizando a resposta SOAP

    É possível incluir informações diferentes das especificadas no WSDL substituindo o conteúdo de status_message usando o script de transformação.