Preencher o campo Tipo em tabelas de relacionamento usando o script de correção

  • Versão de lançamento: Yokohama
  • Atualizado 9 de jan. de 2026
  • 2 min. de leitura

    • Aproveite o script de correção para adicionar e gerenciar o campo Tipo em tabelas de relacionamento. Este script simplifica o mapeamento de dados e aprimora a consistência do registro em todo o sistema de base.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    A partir da versão Yokohama, um novo campo opcional de Tipo foi adicionado à tabela de membros da equipe de contas [sn_customerservice_team_member], que anteriormente incluía os campos Conta, Usuárioe Responsabilidade. Este script de correção se aplica a todas as tabelas de relacionamento no sistema de base.

    O campo Tipo faz referência à tabela de configuração de parte relacionada [sn_customerservice_related_party_configuration]​, uma tabela de metadados que permite aos administradores definir uma configuração de tipo para cada responsabilidade. Este campo permite que os administradores atribuam nomes comerciais significativos às responsabilidades, reduzindo a duplicação. Ao fazer referência interna à mesma responsabilidade, o campo Tipo simplifica o gerenciamento de dados e melhora a consistência do registro.

    Você pode usar o procedimento a seguir para preencher o campo Tipo usando o script de correção.

    Procedimento

    1. Identifique valores de responsabilidade distintos na tabela de relacionamento que você deseja atualizar.
    2. Crie registros de configuração de tipo correspondentes na tabela de configuração de parte relacionada [sn_customerservice_related_party_configuration]​.
    3. Execute o seguinte script de correção para preencher o campo Tipo. 
      fixRelatedPartyTypeField(String tableName, String appliesTo, String entityType, String typeField, String responsibilityField)
/**
	 * Fixes the related party type field in the specified table.
	 *
	 * @param tableName  The name of the table to update.
	 * @param appliesTo  The value for the applies_to field.
	 * @param entityType The value for the entity_type field.
	 * @param typeField  The name of the type field to update. If null, defaults to FIELD_TYPE.
	 * @param responsibilityField The name of the responsibility field to update. If null, defaults to FIELD_RESPONSIBILITY.
	 */

    Resultado

    O script de correção:
    • Preenche automaticamente o campo Tipo para registros correspondentes na tabela de relacionamento selecionada.
    • Mapeia as responsabilidades existentes para os registros de configuração de tipo correspondentes.
    • Processa atualizações em lotes para desempenho otimizado.
    • Atualizações de logs para referência.
    Nota:
    Para grandes volumes de registro, execute o script de correção durante o tempo de inatividade do sistema para evitar impactos no desempenho.

    Você pode preencher manualmente o campo Tipo navegando até a tabela de configuração de parte relacionada [sn_customerservice_related_party_configuration]​ e criando registros de configuração de tipo para cada responsabilidade distinta.

    Exemplo

    Suponha que você queira preencher o campo Tipo na tabela membro da equipe de conta [sn_customerservice_team_member], em que a tabela usa as seguintes responsabilidades:
    • Gerente de contas 1
    • Gerente de contas 2
    • Gerente de contas 3
    1. Navegue até a tabela de configuração de parte relacionada [sn_customerservice_related_party_configuration]​.
    2. Crie três registros de configuração de tipo, um para cada responsabilidade.
    3. Executar o script de correção que automaticamente:
      • Mapeia cada responsabilidade para o Tipocorrespondente.
      • Preenche o campo Tipo para todos os registros na tabela membro da equipe de contas [sn_customerservice_team_member].