IBM FileNet P8, Versione 5.2            

Proprietà di reindirizzamento contenuti

Il file content_redir.properties configura i reindirizzamenti a JSP (Java Server Pages) o servlet di Workplace XT oppure ad applicazioni personalizzate o del fornitore, quando un utente tenta di aprire un file da Workplace XT. I reindirizzamenti sono basati sul tipo MIME di contenuto. Questo argomento illustra come personalizzare i reindirizzamenti. La sezione che segue illustra come l'applicazione utilizza il file content_redir.properties. Per personalizzare i reindirizzamenti, consultare la sezione Modifica del file delle proprietà di reindirizzamento.

Panoramica del reindirizzamento dei contenuti

Il file content_redir.properties è costituito da coppie chiave/valore in cui la chiave è un tipo MIME e il valore specifica il componente da utilizzare per aprire un file del tipo MIME associato. L'elenco riportato di seguito è relativo ad Image Viewer e viene utilizzato in questo punto come esempio. L'esempio può essere applicato ad altre applicazioni. Nell'esaminare l'elenco, si notino i seguenti punti:
  • Il primo gruppo di coppie chiave/valore crea una corrispondenza tra i tipi MIME e Image Viewer. Per trarre vantaggio dalla funzione di annotazione di Image Viewer, è possibile modificare questo file per specificare i tipi di immagine aperti in Image Viewer. Nell'elenco sono riportati i tipi MIME aperti da Image Viewer con un valore di /WcmJavaViewer.jsp?{QUERY_STRING}. Per ulteriori informazioni su Image Viewer, vedere Uso di Image Viewer.
  • Le chiavi in content_redir.properties sono basate sulla proprietà mimeType definita in alcune classi di Content Engine. Per ulteriori informazioni, consultare About MIME types.
  • Un valore può include macro, ad esempio {QUERY_STRING}. Le macro disponibili sono riportate in content_redir.properties.
  • Se un tipo MIME non è definito in content_redir.properties, viene richiamato il servlet getContent, che risponde in base al tipo di oggetto selezionato. Consultare Comportamento di default del servlet getContent.
  • Per i tipi di oggetti documento, il comportamento del reindirizzamento viene definito ulteriormente da determinate impostazioni, che è necessario considerare se si modifica il file content_redir.properties. Consultare Interazione con altre impostazioni, di seguito.
# Comment the lines with MIME types to not be opened by the Image Viewer applet
image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/bmp=/WcmJavaViewer.jsp?{QUERY_STRING}
image/tiff=/WcmJavaViewer.jsp?{QUERY_STRING}
image/gif=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-visio=/redirect/customAppRedirect.jsp?vsId={VERSION_SERIES_ID}&objectStoreName={OBJECT_STORE_NAME}&id={OBJECT_ID}&objectType=document

application/vnd.filenet.im-image=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-form=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-other=/WcmJavaViewer.jsp?{QUERY_STRING}

folder=/WcmObjectBookmark.jsp
customobject=/integrationWebBasedCommand?_commandId=3010
showPropertiesCommand=/integrationWebBasedCommand?_commandId=3010
application/x-filenet-search=/WcmObjectBookmark.jsp
application/x-filenet-searchtemplate=/WcmObjectBookmark.jsp
application/x-filenet-workflowdefinition=/eprocess/WcmDesigner.jsp
application/x-filenet-scenariodefinition=/eprocess/WcmSimDesigner.jsp
...

Comportamento di default del servlet getContent

Se un tipo MIME non è specificato in content_redir.properties, l'applicazione richiama il servlet getContent. Il comportamento del servlet è determinato dal tipo di oggetto selezionato, come riportato in basso.
Cartella
Reindirizza il client ad una pagina in cui viene visualizzata la cartella.
Documento
Se il documento presenta un contenuto, il contenuto viene restituito al browser.
Se il documento presenta un riferimento esterno, il servlet reindirizza il client in modo appropriato.
Se il documento non presenta alcun contenuto, viene riportato un errore.
Documento di definizione flusso di lavoro
Reindirizza il client a Workflow Designer.
Ricerca memorizzata
Reindirizza il client ad una pagina in cui viene visualizzata la ricerca memorizzata.
Modello di ricerca
Reindirizza il client ad una pagina in cui viene visualizzato il modello di ricerca.
Modello di pubblicazione
Il contenuto del modello di pubblicazione viene restituito come XML.

Interazione con altre impostazioni

Oltre alle impostazioni del file content_redir.properties, una proprietà nascosta negli oggetti di tipo documento, che include le immagini, influisce sul comportamento del reindirizzamento. Questa proprietà nascosta, denominata "IgnoreRedirect" non è impostata per default. Può essere impostata solo in modo programmatico o mediante Enterprise Manager.

Quando si aprono oggetti di tipo documento, l'applicazione ricerca la proprietà IgnoreRedirect ed effettua le seguenti azioni:
  • Se la proprietà IgnoreRedirect è impostata su True, invia il documento al browser.
  • Se la proprietà IgnoreRedirect è impostata su False, invia il documento al componente specificato in content_redir.properties.
  • Se la proprietà IgnoreRedirect non è impostata (NULL), invia il documento al componente specificato in content_redir.properties.

Per i documenti memorizzati in una libreria esterna, ad esempio Image Services, esiste una preferenza sito di servizi esterni denominata "Includi reindirizzamento". Per default, questa preferenza è impostata su "Yes". Se è impostata su "Yes", l'URL viene aggiunto con l'impostazione della proprietà IgnoreRedirect nell'immagine. Per ulteriori informazioni su questa preferenza, vedere Preferenze servizi esterni.

Quando si aprono le immagini memorizzate in Image Services, l'applicazione effettua le seguenti azioni:
  • Se "Includi reindirizzamento" = Yes e la proprietà IgnoreRedirect del documento = true, l'applicazione invia l'immagine al browser.
  • Se "Includi reindirizzamento" = Yes e la proprietà IgnoreRedirect del documento = false, l'applicazione invia l'immagine alla destinazione specificata in content_redir.properties.
  • Se "Includi reindirizzamento" = No, l'impostazione della proprietà IgnoreRedirect non è inclusa nell'URL e l'applicazione invia l'immagine alla destinazione specificata in content_redir.properties.

Modifica del file delle proprietà di reindirizzamento

È possibile personalizzare i reindirizzamenti modificando il file content_redir.properties. Ad esempio, è possibile aggiungere reindirizzamenti alle applicazioni del fornitore o contrassegnare come commenti i reindirizzamenti esistenti e consentire al servlet getContent di gestire oggetti di tipo MIME commentati.

Nota:  Prima di modificare il file content_redir.properties, controllare la proprietà IgnoreRedirect e la preferenza sito "Includi reindirizzamento" per i tipi MIME per cui si desidera definire i reindirizzamenti.

Per modificare il file delle proprietà di reindirizzamento

  1. Aprire il file content_redir.properties con un editor di testo. Per default, il file è installato nel seguente percorso:
    Workplace XT: <percorso_installazione>/FileNet/Config/WebClient
  2. Modificare le impostazioni come desiderato.
    • Per rimuovere la mappatura di un tipo MIME esistente, contrassegnare come commento la coppia chiave/valore applicabile con un simbolo # iniziale, ad esempio #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Per aggiungere la mappatura di un tipo MIME, immettere una coppia chiave/valore con una chiave che corrisponda al valore di una proprietà mimeType definita in una classe Content Engine. Il valore deve specificare un percorso ad una pagina JSP o ad un servlet presente nell'applicazione, relativo alla directory dell'applicazione.

      Utilizzando le macro, è possibile trasmettere la stringa di query dell'URL dell'oggetto selezionato al componente specificato nella coppia chiave/valore. Ad esempio, è possibile includere la macro {QUERY_STRING} per trasmettere l'intera stringa di query. In alternativa, è possibile trasmettere singoli parametri dalla stringa di query con {OBJECT_TYPE}, {OBJECT_ID} e altre macro. Per un elenco complete delle macro, vedere il file content_redir.properties.

    • Per mappare un tipo MIME ad un'applicazione personalizzata o di un fornitore, è necessario specificare un componente all'interno dell'applicazione che reindirizzi all'applicazione esterna. Ad esempio, nella coppia chiave/valore Workplace di seguito riportata Workplace esegue il reindirizzamento a Workplace/redirect/customAppRedirect.jsp se un utente ha selezionato un file con un tipo MIME di "text/x-speech".
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      Per eseguire il reindirizzamento ad un'applicazione esterna, il codice di reindirizzamento JSP può essere semplice come la seguente riga:
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      In genere, tuttavia, la logica di reindirizzamento ad un'applicazione esterna è rivolta soprattutto a restituire l'URL, i parametri, il token di sicurezza e gli altri valori richiesti dall'applicazione esterna, utilizzando le stesse API di base di Workplace XT.

  3. Salvare il file content_redir.properties.
  4. Riavviare il server Web per applicare le nuove impostazioni.


Feedback

Ultimo aggiornamento: Marzo 2013
aeadm_config_file_content_redir.htm

© Copyright IBM Corp. 2013.
Questo centro informazioni è una tecnologia Eclipse. (http://www.eclipse.org)