IBM FileNet P8, Versão 5.1.+            

Customizar Opções de Procura do Workplace XT

É possível customizar as caixas de seleção da opção de procura do Workplace XT que aparecem nas páginas de procura simples ou avançadas. As opções de procura são exibidas nas listas de Opções e Tipos de Documentos. É possível customizar as listas das seguintes maneiras:
  • Opções de inclusão
  • Opções de remoção
  • Opções de renomeação
Antes de uma procura ser executada, o Workplace XT transforma as condições de procura em uma consulta SQL. Cada caixa de seleção de opção de procura representa uma condição incluída na cláusula WHERE na instrução SQL. As caixas de seleção são definidas no arquivo <caminho_de_implementação_do_WPXT>/FileNet/Config/WC/SimpleSearch.xml. Conforme mostrado no fragmento XML, cada caixa de seleção é descrita em um elemento de objeto searchOption.
<object key="searchOptionGroup">
 <setting key="id">options</setting>
 <list key="searchOptions">
 <object key="searchOption">
 <label key="label" localizationKey="server.SimpleSearch.createdByMe">
 <resource>Added by me</resource>
 </label>
 <setting key="symname">Creator</setting>
 <setting key="value">{CURRENT_USER}</setting>
 <setting key="type">typestring</setting>
 <setting key="operator">eq</setting>
 <setting key="join">and</setting>
 <array key="objectTypes">
 <value>document</value>
 <value>folder</value>
 </array>
 <array key="objectStores"></array>
 <array key="roles"></array>
 </object>
...
Notas:
  • Ao editar o arquivo XML, certifique-se de trabalhar com o arquivo implementado no servidor de aplicativos, que pode ser diferente do arquivo XML no local de instalação padrão.
  • Faça backup de SimpleSearch.xml antes de modificá-lo.
  • Se você modificar o arquivo para que inclua caracteres estendidos, salve o arquivo no formato UTF-8.
  • Depois de modificar o SimpleSearch.xml, é possívelrecarregá-lo a partir do Workplace XT para evitar o reinício do servidor de aplicativos.
A tabela a seguir descreve os elementos em SimpleSearch.xml usando a caixa de seleção Incluído por mim como exemplo. Um elemento é identificado por seu atributo-chave. A não ser que especificado o contrário, os elementos a seguir são necessários.
Tabela 1. Esta tabela descreve os elementos em SimpleSearch.xml usando a caixa de seleção Incluído por mim como exemplo.
Configuração Valor
<object key="searchOptionGroup">
 <setting key="id">options</setting>
O elemento searchOptionGroup organiza as opções de procura nas listas de Opções e de Tipos de Documentos nas páginas de procura simples e avançada. O elemento id especifica a lista: elementos com um valor de opções são exibidos na lista de Opções; elementos com um valor de docTypes são exibidos na lista de Tipos de Documentos.
<object key="searchOption">
 <label key="label"
 localizationKey=
 "server.SimpleSearch.createdByMe">
 <resource>
 Added by me
 </resource>
 <resource locale=fr_FR" >
 Créé par moi
 </resource>
 </label>
O elemento searchOption define uma opção de procura. O elemento label define vários atributos do texto usado para descrever a caixa de seleção.

O elemento label requer um atributo localizationKey. Para especificar o valor para o atributo localizationKey ao criar uma nova opção de procura, use a sequência server.SimpleSearch. e anexe um nome descritivo. A localizationKey deve ser exclusiva no SimpleSearch.xml. Use o elemento resource para especificar o texto usado para descrever a caixa de seleção.

O elemento label suporta sequências localizadas. É possível, opcionalmente, ter um ou mais elementos resource com um atributo locale. O valor desse atributo deve usar o idioma e códigos de país ISO padrão conforme suportado pelos navegadores.
<setting key="symname"> 
 Creator
</setting>
O elemento symname especifica o nome simbólico (identificador programático) da propriedade associada à caixa de seleção. É possível obter o nome simbólico de uma propriedade usando o Enterprise Manager.
<setting key="value">
 {CURRENT_USER}
</setting>
O elemento value especifica o valor da propriedade especificada na consulta SQL. Onde aplicável, as seguintes macros são suportadas:
  • {CURRENT_USER} é o nome curto da versão do usuário com login efetuado atualmente.
  • {DATE}[ + | - ][days] é a data atual +/- o número de dias especificado. Por exemplo, " {DATE}-7" significa o dia atual menos 7 dias. Espaços não são permitidos.
<setting key="type">
 typestring
</setting>
O elemento type especifica o tipo de dado da propriedade. Os tipos de dados válidos são: typestring, typeboolean e typedate. É possível determinar o tipo de dado da propriedade usando o Enterprise Manager.
<setting key="operator">
 eq
</setting>
O elemento operator especifica o operador relacional usado na consulta SQL. Os valores válidos são os seguintes: eq, lt, gt, lte, gte, neq, in, isnull, isnotnull, like.
<setting key="join">
  and
</setting>
O elemento join especifica como essa opção de procura é combinada com outras opções de procura. Essa opção usa como padrão "ou" para as caixas de seleção de Tipo de Documento e "e" para todas as outras. Por exemplo, se um usuário selecionar os tipos de documentos Word, Excel e PDF, a procura retornará qualquer documento que corresponder ao tipo Word ou Excel ou PDF. Alternativamente, se um usuário selecionar as caixas de seleção Criado por mim e Retirado, a procura retornará documentos criados pelo usuário e retirados.

Quando o Workplace XT transforma as opções de procura em uma consulta SQL, ele agrupa todas as condições "e" seguidas de todas as condições "ou". Por exemplo, usando as configurações padrão, se um usuário selecionar Word, PDF, Criado por mim e Retirado, a procura enviará uma consulta semelhante a "criado por mim and retirado and (Word or PDF)."

<array key="objectTypes">
 <value>document</value>
 <value>folder</value>
</array>
O elemento objectTypes especifica a lista de tipos de objetos para os quais essa opção de procura é válida. Os valores suportados são documento e pasta.
<array key="objectStores">
 <value>Claims</value>
</array>
O elemento objectStores especifica a lista de armazenamentos de objetos nos quais essa propriedade é válida. Se o usuário estiver procurando em um armazenamento de objeto no qual a propriedade não é válida, a opção de procura associada não será exibida. Para exibir a opção de procura para todos os armazenamentos de objetos, ignore o elemento de objeto value.
<array key="roles">
 <value>Adjustor</value>
</array>
O elemento roles especifica a lista de funções que possuem acesso a esta opção de procura. Se o usuário não for um membro de uma função especificada, a opção de procura associada não será exibida. Para exibir a opção de procura para todos os usuários, ignore o elemento de objeto value.


Feedback

Última atualização: Julho de 2011


© Copyright IBM Corporation 2011.
Este centro de informações foi desenvolvido com a tecnologia Eclipse. (http://www.eclipse.org)