Ativação de pesquisas sem distinção entre maiúsculas e minúsculas

Você pode ativar as operações de pesquisa sem distinção entre maiúsculas e minúsculas, ativando pesquisas sem distinção entre maiúsculas e minúsculas para a entidade ou coluna aplicável. Para isso, adicione o atributo CaseInsensitiveSearch no arquivo XML da entidade aplicável.

Procedimento

  1. Editar o XML de Entidade necessário para incluir o atributo CaseInsensitiveSearch=Y .

    Inclua o atributo ShadowColumnName shadow column no Entity XML e especifique um nome para a coluna shadow. Se esse campo for deixado em branco, o sistema gera um automaticamente. Se estiver indexando a coluna shadow, você deverá especificar um nome de coluna shadow. Em seguida, é gerada uma coluna sombra, que é vinculada à coluna original, marcada como insensível a maiúsculas e minúsculas.

  2. Se o Case Insensitive Data Loader agente for executado em um ambiente de produção, especifique o modo de configuração para a entidade ou coluna na CaseInsensitiveSearch.Mode propriedade do customer_overrides.properties arquivo. Defina o valor da propriedade CaseInsensitiveSearch.Mode como MIXED ou DISABLED.
    Observação: Por padrão, a pesquisa de insensibilidade a maiúsculas e minúsculas está ativada.
  3. Desative o cache da entidade para a qual você deseja executar o agente Case Insensitive Data Loader.
    Observação: Além de desativar o cache, você deve desativar as auditorias para essa entidade específica.
  4. Execute o agente Case Insensitive Data Loader para preencher os dados nas colunas shadow.
    Observação: Se você pulou a etapa 2, pule esta etapa.
  5. Defina o valor da propriedade CaseInsensitiveSearch.Mode como ENABLED no arquivo customer_overrides.properties.
    Observação: Se você desativou as auditorias na etapa 3, ative-as agora.
  6. Habilite o cache para a entidade ou coluna para a qual o agente Case-Insensitive Data Loader foi executado na Etapa 3.
    As APIs a seguir oferecem suporte a pesquisas sem distinção entre maiúsculas e minúsculas para colunas definidas pelo sistema:
    • getOrderList
    • getItemListForOrdering
    • getExceptionListForOrder
    • getCustomerList
    • getPersonInfoList

      Por padrão, a getPersonInfoList API usa uma abordagem obsoleta para implementar as pesquisas sem distinção entre maiúsculas e minúsculas. Para permitir que a getPersonInfoList API use colunas shadow para pesquisas sem distinção entre maiúsculas e minúsculas, no customer_overrides.properties arquivo, defina yfs.api.getPersonInfoList.UseShadowCol=Y.

    Para colunas personalizadas que são estendidas, as pesquisas sem distinção entre maiúsculas e minúsculas funcionam somente se a pesquisa normal funcionar para essas colunas.
    Nota:
    • Esse recurso é aplicável somente a pesquisas que usam as XAPIs geradas por aplicativos. As pesquisas que usam consultas personalizadas não diferenciam maiúsculas de minúsculas.
    • As pesquisas sem distinção entre maiúsculas e minúsculas só podem ser ativadas para o tipo de dados de texto, que são as colunas Char e Varchar.
    • Não há suporte para o uso de consultas complexas junto com pesquisas sem distinção entre maiúsculas e minúsculas para uma coluna.