O recurso de endereçabilidade da URL fornece aos usuários acesso direto a objetos sem ter que navegar pela interface com o usuário do cliente do IBM® FileNet P8. Após o registro em um cliente FileNet P8, como o Workplace XT, um usuário simplesmente insere a URL do objeto na barra de endereço de um navegador.
(Um administrador pode criar
marcadores ou favoritos para recuperar uma pasta ou um objeto provido de versões.)
Com a endereçabilidade da URL, é possível:
- Recuperar documentos, pastas, procuras armazenadas, modelos de procura, definições de
fluxo de trabalho e modelos de publicação.
- Fazer download dos tipos de objetos a seguir e salvá-los no PC local:
documento, procura armazenada, modelos de procura, modelo de publicação e definição de
fluxo de trabalho.
- Insira uma URL baseada em caminhos ou baseada em ID, conforme mostrado abaixo.
Uma URL baseada em caminhos usa o caminho de restrição para especificar o local de um objeto
em um armazenamento de objeto. Por exemplo, para recuperar um documento chamado Trabalhos Atuais, que reside na pasta Projetos no armazenamento de objeto Transporte, o usuário inserirá uma URL semelhante ao seguinte exemplo:
http://P8_client_server_name/application_name:port/getContent/Transportation/Projects/Current+Works
Para recuperar objetos usando URLs baseadas em caminhos, você deve definir a preferência do site Utilizar URLs com base no caminho.
Uma URL baseada em ID usa
GUIDs para especificar o local de um objeto em um armazenamento de objeto. O local do documento é especificado pelo GUID do armazenamento de objeto em que
o documento reside, assim como pelo GUID do documento. Por exemplo, para
recuperar um documento, um usuário insere uma URL semelhante ao seguinte exemplo:
http://P8_client_server_name/application_name:port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}
Um endereço baseado em ID é geralmente mais rápido do que o endereço baseado em caminho, no entanto,
apenas uma URL baseada em caminhos resolverá referências relativas em um documento.
Por exemplo, se você solicitar o arquivo "example.html"
com uma URL baseada em caminho, o arquivo será recuperado e o navegador resolverá
quaisquer URLs adicionais necessárias dentro do example.html (como as tags <script>, <img>
e <link>). Todos os links (<a href=...>) serão resolvidos pelo navegador quando o usuário clicar neles.
A tabela a seguir lista as respostas padrão para os diferentes
tipos de objetos que podem ser especificados em uma URL.
Tipo de objeto |
Resposta |
Pasta |
Retorna uma página exibindo o nome da pasta. |
Documento |
Se o documento tiver conteúdo, o conteúdo será retornado. Se o documento tiver uma referência externa, o cliente FileNet P8 redirecionará o cliente conforme necessário. Se o documento não tiver conteúdo, o cliente FileNet P8 relatará um erro. |
Definição de fluxo de trabalho |
Abre o applet Process Designer. |
Procura armazenada |
Retorna uma página exibindo o nome da procura armazenada. |
Modelo de procura |
Retorna uma página exibindo o modelo de procura. |
Modelo de Publicação |
Retorna o conteúdo do modelo de publicação como XML. |
Regras de Sintaxe de URL Baseada em Caminhos
Uma URL baseada em caminhos requer um ID de armazenamento de objeto e um nome do caminho de
restrição. O parâmetro
mode=download é opcional. Um exemplo:
http://server/web_application/getContent/objectStoreID/pathName?mode=download
Exemplo de URLs baseadas em caminhos
Com essa URL, a página do Workplace XT com o modelo de procura especificado é
exibida.
O armazenamento de objeto é identificado pelo nome (Formulários):
http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download
Com essa URL, o armazenamento de objeto Formulários é qualificado por seu nome de domínio,
Midwest:
http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download
Regras de Sintaxe de URL Baseada em ID
Uma URL baseada em ID usa três parâmetros de sequência de consulta necessários para o
objeto de pasta: objectStoreName, objectType e id. Por exemplo:
http://server/web application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}
Para os objetos de documento, de procura armazenada, de modelo de procura, de modelo de publicação e
de definição de fluxo de trabalho, a URL usa os parâmetros objectStoreName, objectType, id
e fsld. O parâmetro
mode=download é opcional. A seguir está um exemplo:
http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download
ou
http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}
ou
http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download
em que:
- server é o nome do servidor Application Engine
ou Workplace XT no qual o aplicativo cliente FileNet P8 está sendo executado.
- web_application é o nome do aplicativo cliente FileNet P8.
- objectStoreName=objectStoreGUID é o GUID do armazenamento de objeto em que
o objeto reside. Inclua as chaves.
- objectType=type é o tipo de objeto a ser recuperado. Insira
o valor objectType aplicável:
Para um: |
objectType= |
Documento |
documento |
Pasta |
pasta |
Procura Armazenada |
storedsearch |
Modelo de pesquisa |
searchtemplate |
Definição de fluxo de trabalho |
documento |
Modelo de publicação |
publishtemplate |
- id=objectGUID é o GUID que identifica o objeto no armazenamento
de objeto. Esse é um parâmetro necessário para o objeto de pasta.
Para objetos de
documento, de procura armazenada, de modelo de procura, de definição de fluxo de trabalho e de modelo de
publicação, o id é opcional e é usado para recuperar uma versão específica. Inclua as chaves.
- vsId=versionSeriesGUID é o GUID para recuperar a versão mais
recente da série de versão dos seguintes objetos:
documento, procura armazenada, modelo de procura, definição de fluxo de trabalho e
modelo de publicação.
Nota: Quando o ID e o vsld estiverem presentes na URL, o aplicativo cliente FileNet P8 usará o ID para recuperar a versão especificada.
Se a versão especificada não puder ser localizada, o aplicativo cliente FileNet P8 relatará um erro e fornecerá ao usuário a opção de recuperar a versão mais recente, conforme especificado pelo parâmetro vsld.
- O parâmetro mode=download é opcional, e permite
salvar o conteúdo localmente.
Nota: É possível configurar o aplicativo cliente FileNet P8 para usar as URLs baseadas em caminhos para solicitações de documentos. Portanto, se você inserir uma URL baseada em ID, o aplicativo cliente FileNet P8 converterá a URL baseada em ID em uma URL baseada em caminhos, se possível, para manter a integridade de qualquer referência de URL relativa integrada no conteúdo do documento.