IBM FileNet P8, Versão 5.1.+            

Acessando Objetos através de URLs

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

em que:
  • server é o nome do servidor Application Engine ou Workplace XT no qual o aplicativo cliente FileNet P8 reside.
  • web_application é o nome do aplicativo cliente FileNet P8; por exemplo, Workplace XT.
  • objectStoreID é o ID do armazenamento de objeto, que pode ser o GUID ou o nome do armazenamento de objeto. O nome do armazenamento de objeto é exclusivo em um único domínio, mas não necessariamente no Active Directory. Quando o nome é usado para fazer referência ao armazenamento de objeto, o primeiro armazenamento de objeto correspondente no Active Directory é retornado. Se houver armazenamentos de objetos com o mesmo nome dentro do Active Directory, então você deverá qualificar o nome do armazenamento de objeto com o nome de domínio usando o caractere "@"; por exemplo, objectStoreName@domainName.
  • pathName é o nome do caminho de restrição.
  • o parâmetro mode=download (opcional) permite salvar o conteúdo localmente.
    Nota: URLs baseadas em caminhos para objetos de documento, de procura armazenada, de modelo de procura e de modelo de publicação sempre fazem referência à versão mais recente.

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.


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)