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, vedere 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 in basso è per Image Viewer e viene utilizzato qui 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, vedere 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. Vedere la sezione Comportamento di default del servlet getContent, in basso.
- 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. Vedere la sezione Interazione con altre impostazioni, in basso.
# 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.