Parametri del worker del servizio

Funzionalità aggiuntive > Gestione dati assistenza > Guida alla configurazione > Impostazione della pubblicazione di servizio > Parametri del worker del servizio

I parametri del worker del servizio (o SIS) controllano il processo di pubblicazione. I parametri del worker vengono specificati nella regola di pubblicazione utilizzando il seguente formato:

<worker name="namespace/parameter">value</worker>

La specifica di un parametro worker fa parte di un param-set trasmesso a Windchill Visualization Services all'inizio del processo di pubblicazione. Per la pubblicazione di Windchill Service Information Manager, è possibile destinare un parametro a un sistema o sottosistema specifico utilizzato dal processo di pubblicazione.

La creazione di una regola di pubblicazione è descritta in Regole di pubblicazione servizio per Windchill Visualization Services.

Specifica di un sistema di parametri

L'attributo name specifica il sistema utilizzando uno dei prefissi elencati di seguito.

• com.ptc.arbortext.wvs controlla il comportamento di Windchill Visualization Services sul server Windchill.

• com.ptc.arbortext.pe controlla il comportamento della pubblicazione sul server Arbortext Publishing Engine utilizzando l'applicazione Service (che deve già essere installata sul server Arbortext Publishing Engine).

• com.ptc.arbortext.all si applica a Windchill Visualization Services su Windchill e alla pubblicazione sul server Arbortext Publishing Engine.

Specifica dei parametri del worker di Windchill Visualization Services

I parametri com.ptc.arbortext.wvs/ controllano il comportamento del sistema Windchill Visualization Services. Aggiungere un nome del parametro al sistema per specificare il parametro. Una barra / precede il nome del parametro. Esempio:

Nome del parametro

Tipo di output

Descrizione

ApplyTranslationFilter

PDF

Bundle XML

Tramite XSL

Specificare se è necessario applicare i criteri di filtro di base durante la pubblicazione degli oggetti tradotti. Se è impostato sul valore di default, true, durante la pubblicazione viene utilizzata la versione dell'oggetto inclusa nella baseline. Se è impostato su false, durante la pubblicazione viene utilizzata la versione più recente dei documenti tradotti.

attachmentFilter

Bundle XML

Tramite XSL

Specificare le categorie per gli allegati del documento dinamico e WTDocument (contenuto secondario) da includere nel payload. Gli allegati corrispondenti alla specifica vengono pubblicati nel payload.

Il valore di default è derivato dal parametro ContentFilter preceduto da *: (che specifica tutte le categorie).

Ogni allegato è assegnato a una categoria in Windchill. Di seguito viene riportata la sintassi per specificare una categoria e le estensioni di file correlate.

([-]*|categoria)[:
[-]est,
est,...
[|...]

category è il nome di una categoria in Windchill. Separare più filtri di categoria con una barra verticale |

La specifica est è un'estensione file facoltativa per la categoria specificata. Più tipi di estensioni file sono separati da virgole.

Esempio:

GRAPHICS:png,gif|
ILLUSTRATIONS:png,gif

Se si specifica automaticamente una categoria, sono consentiti tutti i file di dati secondario. Esempio:

GRAPHICS

Se la specifica est è vuota, nessun elemento per tale categoria viene trasmesso al payload. Esempio:

GRAPHICS:

È possibile specificare il carattere jolly * per includere tutte le categorie. Può essere utilizzato da solo o con uno o più valori est. Ad esempio, la sintassi riportata di seguito consente le estensioni specificate per tutte le categorie:

*:png,tif,jpg

La sintassi seguente consente tutto il contenuto secondario, tranne i file senza alcuna estensione.

Le categorie o le estensioni non specificate vengono considerate incluse.

Il carattere di esclusione - può essere anteposto all'intera specifica del filtro per categoria o est per escludere tutto ciò che lo segue. Ad esempio, la sintassi seguente esclude tutto il contenuto secondario per la categoria GRAPHICS:

-GRAPHICS

I file jpg e tif vengono esclusi in ognuno degli esempi riportati di seguito.

-GRAPHICS:jpg,tif

GRAPHICS:-jpg,tif

Il filtro riportato di seguito esclude le estensioni specificate per entrambe le categorie specificate.

-ILLUSTRATIONS:png,jpg,
tif|GRAPHICS:cgm,tif

- può essere combinato in una specifica con il carattere jolly *.

Ad esempio, la sintassi riportata di seguito esclude tutto il contenuto secondario:

I file png e jpg vengono esclusi in ognuno degli esempi riportati di seguito per tutte le categorie:

-*:png,jpg

*:-png,jpg

Le specifiche del carattere jolly * devono essere posizionate dopo valori più specifici (ad esempio, *|GRAPHICS:jpg consente tutti i file e ignora la specifica GRAPHICS che segue).

Questa tabella è seguita da un elenco di esempio delle categorie.

Audit.Enabled

HTML

PDF

Bundle XML

Tramite XSL

Specificare se il processo di pubblicazione registra informazioni di diagnostica sulla raccolta di oggetti di documenti dinamici collegati ai contenitori.

Specificare yes o no (impostazione di default).

I link del documento dinamico ad altri documenti dinamici non vengono verificati.

Audit.IncludeChild

HTML

PDF

Bundle XML

Tramite XSL

Specificare se raccogliere gli oggetti di contenuto figlio di documenti dinamici, denominati documenti dinamici figlio. La verifica dei documenti dinamici figlio non è attivata per default.

Specificare yes o no (impostazione di default).

Se si specifica yes, è necessario impostare anche Audit.Enabled su yes.

checkDuplicatePINodes

Bundle XML

Specificare se verificare la presenza di nodi di istanza di prodotto duplicati.

Specificare true, il valore di default, per verificare la presenza di nodi di istanza di prodotto duplicati.

Specificare false per migliorare le prestazioni quando non esistono nodi di istanza di prodotto duplicati.

collectChildDocMetadata

Bundle XML

Specificare se includere i metadati di un riferimento a un'immagine o a un documento dinamico.

Specificare yes per includere i metadati di riferimento oppure no (valore di default) per ignorarli.

completeTranslationCheck

HTML

PDF

Bundle XML

Tramite XSL

Specificare se procedere alla pubblicazione se una traduzione per un valore di attributo non è disponibile.

Specificare yes per annullare la pubblicazione se il valore dell'attributo tradotto non è disponibile oppure no (valore di default) per continuare con la pubblicazione utilizzando il testo di origine per il valore di attributo.

configurableLinkFilter

Bundle XML

Specificare il nome del filtro del documento configurabile per impostarlo come filtro per i documenti configurabili.

contentFilter

HTML

PDF

Bundle XML

Tramite XSL

Specificare le estensioni di file da utilizzare come specifica di fallback di default del filtro per AttachmentFilter e PrimaryFilter.

È possibile specificare un elenco di estensioni di file separate da virgole. Il valore di default è il carattere jolly *, che consente tutti i documenti dinamici di immagine e i relativi allegati.

Per sostituire il valore in modo specifico per i documenti dinamici di immagine, vedere i parametri AttachmentFilter e PrimaryFilter.

describeLinkFilter

Bundle XML

Specificare il nome del filtro del documento descrittivo per impostarlo come filtro per i documenti descrittivi.

disableMetadataReplacer

PDF

HTML

Quando il parametro del worker com.ptc.arbortext.wvs/disableMetadataReplacer viene aggiunto al file SamplePublishingRules.xml per l'applicazione di creazione Arbortext con il valore false, assicura che se i metadati bidirezionali sono configurati in Arbortext Editor, tutte le modifiche apportate ai metadati Windchill applicabili si riflettano nel documento dopo la pubblicazione.

Gli attributi dei metadati utilizzati per i metadati bidirezionali devono essere inclusi nel payload. A tale scopo, è necessario modificare il file manifest_attset.xml e includere gli attributi. Per ulteriori informazioni sul file manifest_attset.xml, vedere Definizione di insiemi di attributi.

Questa opzione è applicabile quando si utilizza Arbortext Publishing Engine 8.2.0.0 o versione successiva. In caso contrario, non aggiungere questo parametro.

emitAttachments

HTML

PDF

Bundle XML

Tramite XSL

Specificare se includere gli allegati per i documenti dinamici di immagine o gli oggetti WTDocument (contenuto secondario) nel payload.

Specificare yes per includere gli allegati oppure no (valore di default) per ignorarli.

Questo parametro viene ignorato per gli elementi informativi di testo.

Viene ignorato anche per gli elenchi parti. Gli allegati dell'illustrazione dell'elenco parti sono inclusi nel payload per default.

emitRepresentations

HTML

PDF

Bundle XML

Tramite XSL

Specificare se includere le rappresentazioni nel payload in base al valore specificato da RepresentationFilter.

Specificare yes per includere le rappresentazioni. L'impostazione di default è no.

Questo parametro supporta solo i documenti e i documenti dinamici delle illustrazioni di un elenco parti.

enableNoServiceEffectivity Delegate

HTML

PDF

Bundle XML

Tramite XSL

Specificare se escludere gli elenchi parti senza effettività del servizio dal payload.

Specificare yes per filtrare gli elenchi parti senza effettività del servizio. Specificare no (valore di default) per includere gli elenchi parti senza effettività del servizio.

includeContentHolderReps

Bundle XML

Specificare se pubblicare la rappresentazione di default di un contenitore di elementi informativi per un documento dinamico testuale, un documento dinamico grafico, un documento o un elenco parti. Questa rappresentazione di default verrà utilizzata come miniatura in Arbortext Content Delivery.

Specificare true per pubblicare la rappresentazione di default di un contenitore. L'impostazione di default è false.

includeContentMetadata

HTML

PDF

Bundle XML

Tramite XSL

Specificare se includere metadati dell'elenco parti e del documento dinamico in una struttura pubblicazione pubblicata in un payload.

Specificare yes per includere i metadati nella struttura pubblicazione. Specificare no (valore di default) per ignorare i metadati.

I metadati vengono comunque sempre inclusi nel manifest.

includeEmptyBranches

HTML

PDF

Bundle XML

Tramite XSL

Specificare se includere tutte le sezioni che non contengono dati (documenti dinamici o elenchi parti) nel payload della struttura ricambi.

Specificare yes per includere le sezioni che non contengono dati. Specificare no (valore di default) per ignorare le sezioni vuote.

includeMilestoneTimes InWorkerLog

HTML

PDF

Bundle XML

Tramite XSL

Specificare se includere le informazioni sulle prestazioni degli eventi per la pubblicazione di attività cardine nel file di log del worker SIS. Specificare true per includere le prestazioni di attività cardine. Specificare false (valore di default) per escluderle.

Ogni voce di attività cardine contiene il tempo di completamento dell'attività associata. La traccia include l'ora e la durata della compressione della richiesta di pubblicazione, dell'invio e della restituzione di una risposta.

language

HTML

PDF

Bundle XML

Tramite XSL

Specificare la lingua per l'operazione di pubblicazione. Definire la lingua della traduzione di destinazione, ad esempio fr_FR. Le impostazioni locali devono corrispondere ai link di traduzione del contenuto creato e dell'attributo della lingua di un oggetto localizzabile.

Questo parametro può essere sostituito dalla selezione Lingua nella finestra di dialogo Pubblica rappresentazione.

Il parametro language viene utilizzato per le azioni descritte di seguito.

• Seguire i link di traduzione nel contenuto tradotto.

• Tradurre gli attributi localizzabili mediante il dizionario di traduzione.

• Generare un file translation.xml nel payload.

• Eseguire azioni specifiche della lingua, ad esempio traduzioni di testo generato, durante il processo di pubblicazione.

• Definire la lingua del bundle XML.

Se non viene specificato, valore di default, e se la struttura ricambi contiene una combinazione di lingue di creazione, non viene seguito alcun link di traduzione e il payload può comunque contenere una combinazione di più lingue.

maxErrorCount

HTML

PDF

Bundle XML

Tramite XSL

Specificare il numero di errori per le traduzioni mancanti visualizzati in una notifica di errore. Specificare un valore intero per il numero massimo di errori di traduzione in una notifica di errore. L'impostazione di default è 100.

maxPartReferenceDepth

HTML

PDF

Bundle XML

Tramite XSL

Specificare la profondità per una parte correlata da includere in un elenco parti del payload. Specificare un valore intero per la profondità delle parti correlate da includere. Le parti correlate che presentano un valore di profondità uguale o inferiore al valore specificato vengono incluse nel payload.

Gli elenchi parti possono fare indirettamente riferimento alle parti tramite relazioni, ad esempio sostituzioni, alternative o parti supplementari. Queste parti indirettamente referenziate vengono denominate parti correlate. Ciascuna parte correlata dispone di un valore di profondità aggiuntivo rispetto alla parte a cui fa riferimento.

Le parti che sono direttamente referenziate da un elenco parti hanno un valore di profondità pari a 0. Se questo valore viene impostato su 0, nel payload non vengono incluse parti correlate.

Se il valore di questo parametro è -1 (valore di default), tutte le parti correlate vengono incluse nel payload.

onBundleWithoutContexts

Bundle XML

Specificare il comportamento di pubblicazione quando la struttura ricambi non è associata a una gerarchia di prodotti o a dei nodi della gerarchia. Il valore di default warning genera un messaggio di avvertenza nel log di Windchill Visualization Services e procede con l'operazione di pubblicazione.

Specificare ignore per pubblicare senza messaggi.

Specificare error per registrare un messaggio di errore nel log di Windchill Visualization Services e generare un errore nell'operazione di pubblicazione al termine del processo.

Specificare fatal per registrare un messaggio di errore irreversibile nel log di Windchill Visualization Services e interrompere immediatamente l'operazione di pubblicazione.

onContentHolderLinkFailed

HTML

PDF

Bundle XML

Tramite XSL

Specificare la modalità di gestione di un contenitore quando il relativo contenuto non è disponibile o dispone di più oggetti di contenuto associati. Il valore di default Latest consente di applicare la specifica di configurazione più recente per individuare il contenuto associato.

Specificare ignore per ignorare il contenuto mancante e continuare.

Specificare warning per registrare il contenuto mancante nel log di Windchill Visualization Services, ignorare il contenuto mancante e procedere con l'operazione di pubblicazione.

Specificare error per registrare il contenuto mancante nel log di Windchill Visualization Services, ignorare il contenuto mancante ma annullare l'operazione di pubblicazione al termine del processo.

Specificare fatal per registrare il primo oggetto dati mancante e interrompere immediatamente l'operazione di pubblicazione.

onContentWithNoPrimary

HTML

PDF

Bundle XML

Tramite XSL

Specificare se continuare con l'operazione di pubblicazione nel caso in cui un oggetto di contenuto non contenga contenuto principale.

Specificare ignore per ignorare l'oggetto di contenuto e procedere con l'operazione di pubblicazione.

Specificare fail (valore di default) per interrompere immediatamente l'operazione di pubblicazione.

onlyForeignContent

Bundle XML (creato da una struttura pubblicazione)

Specificare se includere tutti i documenti dinamici, le immagini e gli elenchi parti referenziati in un bundle XML.

Specificare no per includere tutti i documenti dinamici, le immagini e gli elenchi parti referenziati. Specificare yes (valore di default) per includere solo il contenuto che non è referenziato dalla struttura informazioni principale associata allo stesso prodotto.

Una struttura pubblicazione in fase di pubblicazione in un bundle accede al contenuto utilizzando un riferimento al relativo bundle della struttura informazioni, che viene pubblicato separatamente.

Questo parametro consente la pubblicazione di una struttura pubblicazione solo in un bundle XML.

onPvzMissingTranslation

HTML

PDF

Bundle XML

Tramite XSL

Durante la pubblicazione di una struttura informazioni o di pubblicazione che fa riferimento a un file PVZ collegato a un file .c3di che include contenuto tradotto, questo parametro specifica l'azione da intraprendere se nel file PVZ manca il contenuto richiesto per la rappresentazione di una lingua specifica.

Specificare warning per registrare il contenuto mancante nel monitor di Windchill Visualization Services, ma procedere con l'operazione di pubblicazione. (Il valore di default).

Specificare fail per registrare il contenuto mancante nel monitor di Windchill Visualization Services e interrompere l'operazione di pubblicazione.

Specificare error per continuare con la pubblicazione, ma generare errori nel log di Windchill Visualization Services.

Specificare fatal per annullare la richiesta di pubblicazione e interrompere la pubblicazione, generando un errore irreversibile nel log di Windchill Visualization Services.

onPartListItemMissing

HTML

PDF

Bundle XML

Tramite XSL

Specificare se includere un elenco parti con una o più parti mancanti. Ad esempio, è possibile che un elenco parti contenga dieci elementi ma che uno possa essere escluso.

Specificare fail per registrare la parte mancante nel monitor di Windchill Visualization Services e interrompere l'operazione di pubblicazione.

Specificare message per registrare la parte mancante nel monitor di Windchill Visualization Services, ma procedere con l'operazione di pubblicazione.

Specificare ignore per ignorare la parte mancante e non ricevere messaggi nel monitor di Windchill Visualization Services.

onPartListWithoutParts

HTML

PDF

Bundle XML

Tramite XSL

Specificare se pubblicare un elenco parti che non contiene parti, ad esempio quando viene applicato un filtro.

Specificare Ignore per continuare con la pubblicazione di elenchi parti vuoti e non generare messaggi.

Specificare Warning (valore di default) per continuare con la pubblicazione, ma generare un'avvertenza per ciascun elenco parti vuoto.

Specificare Error per continuare con la pubblicazione, ma generare errori nel log di Windchill Visualization Services.

Specificare Fatal per annullare la richiesta di pubblicazione e interrompere la pubblicazione, generando un errore irreversibile nel log di Windchill Visualization Services.

partListImageSource

Bundle XML

Specificare la modalità di gestione di un documento dinamico di immagine che contiene allegati in un elenco parti.

Specificare postPublishOnly per includere solo il contenuto successivo alla pubblicazione collegato all'immagine. Se non è disponibile alcun contenuto successivo alla pubblicazione, questo parametro non include immagini.

Specificare originalOnly per includere solo l'immagine originale.

Specificare preferPostPublish (valore di default) per utilizzare il contenuto successivo alla pubblicazione, se disponibile. In caso contrario, viene inclusa l'immagine originale.

I metadati provengono sempre dall'immagine originale, anche se viene incluso solo il contenuto successivo alla pubblicazione.

È comunque possibile filtrare il contenuto del documento dinamico di immagine utilizzando i parametri primaryFilter, attachmentFilter e representationFilter.

partListIncludeAllPostPublish

Bundle XML

Specificare se includere tutto il contenuto successivo alla pubblicazione nel bundle.

Impostare su true per includere il contenuto successivo alla pubblicazione dell'illustrazione dell'elenco parti nel bundle.

Impostare su false (valore di default) per escludere il contenuto successivo alla pubblicazione dal bundle.

Per utilizzare questo parametro, il valore di partListImageSource deve essere specificato come preferPostPublish o postPublishOnly.

partListVersion1.5

HTML

PDF

Bundle XML

Tramite XSL

Specificare se pubblicare un elenco parti nel formato della versione 1.5, 2.0 o in un formato successivo. Specificare yes per utilizzare la versione 1.5. Specificare false (valore di default) per utilizzare la versione 2.0 o versioni successive.

Nella versione 1.5, il payload non contiene informazioni sulle parti correlate e le informazioni relative alle parti referenziate sono incorporate in ciascun elemento dell'elenco parti.

Nelle versioni successive, le informazioni sulle parti correlate (sostituzioni, alternative o parti supplementari) vengono incluse nel payload.

PartResources

Bundle XML

Tramite XSL

Specificare i tipi di rappresentazioni di parte che saranno inclusi nel file partThumbnails.zip nel payload. È possibile specificare un ruolo per la miniatura grafica nonché il valore speciale PVZ. I valori di parametro sono separati tra loro da virgole.

Il valore di default è THUMBNAIL,THUMBNAIL_SMALL,PVZ.

Specificare THUMBNAIL per scegliere la miniatura.

Specificare THUMBNAIL_SMALL per scegliere la miniatura piccola.

Specificare THUMBNAIL3D per scegliere una miniatura 3D.

Specificare PVZ per scegliere un file PVZ contenente la rappresentazione di default.

Specificare NONE per escludere tutte le miniature e i file PVZ.

Esempio:

THUMBNAIL,THUMBNAIL3D,PVZ

Sebbene PVZ non sia un ruolo, è un valore speciale consentito nell'elenco. Se PVZ è specificato, il contenuto del file PVZ viene specificato dal parametro PvzFilter.

Anche i file da includere in partThumbnails.zip possono essere specificati dal parametro thumbnailRole.

Per ulteriori informazioni sul file partThumbnails.zip e sull'elaborazione dei parametri di miniatura, vedere Payload e manifest

Per ulteriori informazioni sul file partThumbnails.zip e sull'elaborazione dei parametri di miniatura, vedere Payload e manifest in Personalizzazione di Windchill Service Information Manager e Windchill Service Parts.

payloadCache

Bundle XML

Specifica se il payload è memorizzato nella cache della sottocartella SISPayloadCache della cartella temporanea di Windchill. Impostare il valore su yes o true per memorizzare il payload nella cartella temporanea. Il valore di default è false.

PTC consiglia di utilizzare questo parametro per la risoluzione dei problemi, non per la pubblicazione normale.

includePIReps

Bundle XML

Le PIRep non sono utilizzate da Arbortext Content Delivery. Specifica se le rappresentazioni di istanze di prodotto sono incluse nel bundle.

Specificare false, il valore di default, per escludere le rappresentazioni di un'istanza di prodotto dal bundle pubblicato.

Specificare true per includere le rappresentazioni di un'istanza di prodotto nel bundle pubblicato.

preferAdapter

Bundle XML

Specificare se recuperare il contenuto di una struttura mediante l'adattatore PTC Server connection sul server Arbortext Publishing Engine.

Specificare yes per utilizzare l'adattatore sul server Arbortext Publishing Engine. Specificare no (valore di default) per inviare il contenuto di una struttura in un payload da Windchill al server Arbortext Publishing Engine. L'impostazione di default è no.

Per i valori yes e no, è possibile che alcuni dati vengano inviati nel payload ed altri vengano recuperati utilizzando l'adattatore.

Specificare never per indicare che non sono stati recuperati dati utilizzando l'adattatore e che tutti i dati devono essere nel payload.

Il valore never è applicabile in caso di utilizzo di Arbortext Publishing Engine 8.2.1.0 o versioni successive. In caso contrario, non aggiungere questo parametro.

primaryFilter

Bundle XML

Specificare il filtro per il contenuto principale di un documento dinamico di immagine per determinare se includerlo nel payload. Le immagini che corrispondono alla specifica vengono pubblicate nel payload.

È possibile specificare un elenco di estensioni di file separate da virgole. Il valore di default viene derivato dal parametro ContentFilter.

Il carattere jolly * consente tutto il contenuto principale.

È possibile eliminare il contenuto principale di immagine e consentire tuttavia le rappresentazioni e gli allegati associati nel payload.

PvzFilter

Bundle XML

Tramite XSL

Specificare i tipi di file che saranno inclusi in un file PVZ per una parte. Il PVZ viene incluso nel payload nel file partThumbnails.zip. Questo parametro si applica quando il valore del parametro PartResources include PVZ. È possibile specificare i tipi di file grafici supportati per un PVZ o i ruoli specificati nel contenuto nel PVZ. I valori di parametro sono separati tra loro da virgole.

+|- estensione o ruolo,
estensione o ruolo,...

L'utilizzo di + è facoltativo poiché si presume che i valori siano per default delle inclusioni. Utilizzare - per specificare solo le esclusioni.

Esempio:

png,jpg include tutti i file PNG e JPG nel PVZ.

pvs,ol include tutti i file PVS e OL nel PVZ.

-png,THUMBNAIL3D esclude tutti i file PNG e tutte le miniature 3D.

Per ulteriori informazioni sul file partThumbnails.zip e sull'elaborazione dei parametri di miniatura, vedere Payload e manifest

referenceLinkFilter

Bundle XML

Specificare il nome del filtro della documentazione di riferimento per impostarlo come filtro per la documentazione di riferimento.

representationFilter

HTML

PDF

Bundle XML

Tramite XSL

Specificare i tipi di rappresentazioni da includere nel payload. Specificare il tipo principale e le relative estensioni file degli allegati. Le rappresentazioni corrispondenti alla specifica vengono incluse nel payload.

Specificare il formato riportato di seguito.

[-][*|principale,
principale,...]:
[-]estensione,
estensione,...[|...]

Più tipi principali sono separati da virgole. I due punti sono seguiti dall'elenco di estensioni delle rappresentazioni associate. Separare più specifiche con una barra verticale.

Ad esempio, la specifica c3di:jpg,gif corrisponde alle rappresentazioni principali c3di con i tipi di allegati jpg o gif. Un elenco di estensioni vuoto non corrisponde ad alcuna rappresentazione.

In un altro esempio, il filtro specifica i tipi di rappresentazione principali c3di e tiff. Per includere i tipi di allegati della rappresentazione è necessario che siano specificati dopo i due punti.

c3di:png,jpg,gif|
tiff:imap

È possibile utilizzare il carattere jolly *, che deve seguire altre specifiche più distinte. L'esempio riportato di seguito include i tipi di allegati specificati per tutti i tipi principali.

*:png,tiff,jpg

Il carattere - può escludere tutte le rappresentazioni di un tipo principale. Esempio:

-pvz

Il carattere di esclusione - può iniziare la specifica del filtro per escludere i tipi specificati. Nell'esempio riportato di seguito, vengono escluse solo le rappresentazioni pvz per i tipi di rappresentazione principali png o jpg. Tutti gli altri elementi sono consentiti.

-png,jpg:pvz

Il carattere - può inoltre escludere le estensioni di file specificate per i tipi principali. Ad esempio, il formato riportato di seguito consente di escludere solo gli allegati pvz oppure png o jpg.

png,jpg: -pvz

È possibile filtrare gli oggetti senza tipo principale specificando la stringa vuota per il tipo principale. Ad esempio, è possibile specificare le rappresentazioni png mediante :png.

savedFilter

HTML

PDF

Bundle XML

Tramite XSL

Specificare il nome delle opzioni e il filtro varianti da applicare durante la serializzazione della struttura nel payload. Specificare il nome di un filtro precedentemente salvato.

structuresUseAuthored Language

HTML

PDF

Bundle XML

Tramite XSL

Specificare se utilizzare la lingua di creazione o la lingua di destinazione negli elementi della struttura.

Specificare false per utilizzare le traduzioni della lingua di destinazione per gli attributi dell'oggetto, se disponibili.

Specificare true per utilizzare i valori della lingua di creazione per gli attributi dell'oggetto.

Di seguito vengono riportati i valori default.

• true per l'output del bundle e che utilizza file XSL.

• false per l'output PDF.

thumbnailRole

HTML

PDF

Bundle XML

Tramite XSL

Specificare i tipi di rappresentazioni di parte che saranno inclusi nel file partThumbnails.zip nel payload. Specificare il ruolo per il quale selezionare la miniatura da includere durante la pubblicazione. Il valore di default è una stringa vuota.

Specificare THUMBNAIL per scegliere il ruolo della miniatura.

Specificare THUMBNAIL_SMALL per scegliere il ruolo della miniatura piccola.

Specificare PVZ per scegliere un file PVZ contenente la rappresentazione di default.

Anche i file da includere in partThumbnails.zip possono essere specificati dal parametro PartResources.

Per ulteriori informazioni sul file partThumbnails.zip e sull'elaborazione dei parametri di miniatura, vedere Payload e manifest

useApexExpression

HTML

PDF

Bundle XML

Tramite XSL

Specifica se le espressioni nel payload saranno in formato APEX.

L'impostazione yes specifica che le espressioni usano il formato APEX, l'impostazione no (il valore di default) specifica che le espressioni usano il formato ATO.

usePseudoTranslation

HTML

PDF

Bundle XML

Tramite XSL

Specificare se pubblicare il contenuto di origine di un attributo localizzabile in un formato speciale per una traduzione.

Specificare yes per utilizzare il contenuto di origine. Specificare no (valore di default) per utilizzare le traduzioni.

Quando è impostato su yes, si verificano le condizioni descritte di seguito.

• Se l'attributo è localizzabile ma non è disponibile alcun valore tradotto, il risultato tradotto di un valore dell'attributo viene rappresentato da [valore-origine].

• Se l'attributo è localizzabile ed è disponibile un valore tradotto, il valore dell'attributo tradotto viene rappresentato da [[valore-origine]].

Esempi di categorie Windchill

Di seguito vengono elencate alcune categorie Windchill che è possibile utilizzare per filtrare gli allegati del contenuto secondario tramite com.ptc.arbortext.wvs.AttachmentFilter:

• ANALYSIS_INPUT

• ANALYSIS_RESULTS

• DRAWING

• EXPORT

• FAMILY_TABLE

• GENERAL

• GRAPHICS

• ILLUSTRATION

• IMAGE_MAP

• IMPORT

• INFORMATION

• IMAGE

• MANUFACTURING

• PACKAGE

• PRINT

• REPRESENTATION

• TESTO

• VIEWABLE

• XCF (XML Companion File)

Specifica di un sottosistema di parametri del server Arbortext Publishing Engine

Per la pubblicazione su Arbortext Publishing Engine, l'attributo name può anche specificare diversi sottosistemi Arbortext Publishing Engine destinati a determinati aspetti della pubblicazione.

• com.ptc.arbortext.pe.service trasforma una struttura pubblicazione, una struttura informazioni o un elenco parti dal formato generico serializzato e trasmesso da Windchill Visualization Services al server Arbortext Publishing Engine.

Il risultato può essere una mappa DITA o un altro tipo di documento che può essere elaborato per la pubblicazione nell'output desiderato.

In caso di pubblicazione di un bundle per Arbortext Content Delivery, il sottosistema produce output che fornisce l'input al sottosistema bundle.

Il sottosistema specificato gestisce anche la conversione del formato grafico.

Per informazioni sui formati grafici, fare riferimento a Formati di file grafici.

• com.ptc.arbortext.pe.publish trasforma una mappa DITA o un altro documento elaborato dal sottosistema service nel formato di output richiesto, ad esempio PDF.

• com.ptc.arbortext.pe.bundle trasforma il documento XML elaborato dai sottosistemi service o publish in un bundle, che viene posizionato sul server Arbortext Publishing Engine. Arbortext Content Delivery lo preleva da questa posizione.

I parametri bundle controllano la gestione e la creazione dei file del bundle sul server Arbortext Publishing Engine. È possibile specificare la posizione della sottodirectory del file di base del bundle. I bundle possono essere anche mantenuti per la risoluzione dei problemi.

• I parametri com.ptc.arbortext.inservice.all controllano la pubblicazione del server Arbortext Publishing Engine in Arbortext Content Delivery.

• com.ptc.arbortext.pe.all influisce sui sottosistemi service e publish. I parametri per all vengono impostati prima dell'avvio del sottosistema service e rimangono effettivi anche una volta terminata l'esecuzione del sottosistema del bundle.

Se non è specificato un sottosistema (service o publish), il valore di default è all.

Specifica di un tipo di parametro Arbortext Publishing Engine

Oltre alla definizione di un sottosistema, è possibile specificare il tipo di parametro utilizzando facoltativamente una forma /type:name. Il valore type può essere uno di quelli descritti di seguito.

• composer specifica un parametro utilizzato dall'applicazione Service, la struttura di pubblicazione e la pipeline del contenuto sul server Arbortext Publishing Engine.

Se type viene omesso, il valore di default è composer.

• environment specifica un parametro che imposta una variabile di ambiente per il sottoprocesso Arbortext Publishing Engine che esegue l'applicazione Service.

• option specifica un parametro che imposta un'opzione Arbortext Command Language (lista controllo di accesso) set per il sottoprocesso Arbortext Publishing Engine che esegue l'applicazione Service, ad esempio option:appsnapshot. Fare riferimento a Arbortext Command Language Reference, un manuale fornito con Arbortext Editor and Publishing Engine, per informazioni sull'opzione di comando set.

• variable specifica un parametro che imposta una variabile globale della lista controllo di accesso per il sottoprocesso Arbortext Publishing Engine che esegue l'applicazione Service.

Fare riferimento a Arbortext Command Language Reference.

Specifica dei parametri Arbortext Publishing Engine

Di seguito sono riportati i parametri com.ptc.arbortext.pe che controllano il comportamento del sistema del server Arbortext Publishing Engine. È possibile aggiungere un sottosistema facoltativo, quindi specificare un tipo facoltativo e un nome di parametro nel sistema per specificare il parametro dopo la barra /. Esempio:

<worker name="com.ptc.arbortext.pe.service/stylesheet">techinfomap.xsl
</worker>

La tabella fornisce inoltre informazioni su quali parametri o regola di pubblicazione vengono ignorati o tengono conto della modifica del proprio valore durante la pubblicazione incrementale.

Nome del parametro

Output

Descrizione

Ignorabile(supporta la modifica di valore durante la pubblicazione incrementale)

applicabilitySyntax

PDF

Bundle XML

Tramite XSL

Specificare il nome della sintassi di applicabilità utilizzata per le espressioni di applicabilità nel payload. Specificare il nome registrato sul server Arbortext Publishing Engine. Non sono disponibili valori di default.

Per ulteriori informazioni sull'applicabilità, vedere Applicabilità in linea nella pubblicazione.

artifactDirectory

HTML

PDF

Bundle XML

Tramite XSL

Specificare la directory in cui vengono salvate le copie compresse degli elementi del payload creati durante la pubblicazione per la risoluzione dei problemi.

Deve essere una directory valida e accessibile in scrittura sul server Arbortext Publishing Engine.

Sì

disableInlineApplic Filtering

PDF

Tramite XSL

Specificare se attivare il filtraggio in base alle espressioni di applicabilità in linea per gli output PDF e che utilizzano file XSL. Specificare true (valore di default) per disattivare l'applicabilità in linea oppure false per attivarla.

disableStructure ApplicabilityConverter

HTML

PDF

Bundle XML

Tramite XSL

Specificare se le espressioni di applicabilità trovate nelle strutture e nei file di raccolta ausiliari vengono convertite.

Il valore di default è false per l'output del bundle. In tal caso, la conversione è controllata da structureSourceApplicSyntaxstructureTargetApplicSyntax

Per la pubblicazione di PDF, il valore di default di questo parametro è true.

enableChecksumOnMetadata

Bundle XML

Specificare un valore di checksum per monitorare qualsiasi modifica nell'effettività di un attributo o un servizio di una parte di riferimento. Il valore di default, true, aggiunge un valore di checksum quando per una parte viene modificata l'effettività di un attributo o un servizio.

htmlLogVerbosityLevel

HTML

PDF

Bundle XML

Tramite XSL

Specificare il livello di messaggi incluso nella versione HTML del file di log eventi restituito a Windchill Visualization Services. Messaggi. I messaggi al livello specificato e al livello superiore vengono inclusi nel log. I valori sono info, warning, erroro fatal. Se tale parametro non è specificato o dispone di un valore non valido, il valore di default è warning.

Tutti i messaggi vengono inclusi nella versione XML del file di log restituito a Windchill Visualization Services.

Sì

includeMilestoneTimes InHtmlLog

HTML

PDF

Bundle XML

Tramite XSL

Specificare se includere le informazioni sui tempi per la pubblicazione di attività cardine nella versione HTML del log eventi restituito a Windchill Visualization Services. Ogni voce di attività cardine contiene il tempo di completamento dell'attività.

Questo log è disponibile anche nell'archivio transazioni sul server Arbortext Publishing Engine. Questa tabella è seguita da un elenco delle attività cardine.

Sì

reportMore Applicability ParseErrors

PDF

Tramite XSL

Specificare se segnalare ulteriori problemi di espressione di applicabilità per l'applicabilità in linea prima dell'esito negativo. Il valore di default, false, determina il fallimento immediato della pubblicazione dopo aver trovato la prima espressione problematica. Impostare su true per raccogliere quanti problemi di espressione di applicabilità possibili prima di avere l'esito negativo dell'operazione di pubblicazione.

resultBaseName

HTML

PDF

Bundle XML

Tramite XSL

Specificare la stringa che definisce il nome file di base di una rappresentazione. La stringa può contenere uno o più schemi di sostituzione in formato stringa denominati key che vengono valutati durante la pubblicazione e sostituiti con il valore di sostituzione. Le chiavi possono rappresentare chiavi di sostituzione di Windchill Visualization Services, parametri del worker del servizio e attributi per la radice della struttura ricambi da pubblicare.

Il valore di default prevede l'utilizzo dell'ID dell'oggetto radice come nome di base per gli output XSL e PDF o l'ID dell'oggetto radice e il nome del foglio di stile pubstructXsl per i bundle.

Specificare una chiave utilizzando il modulo {chiave}, dove chiave è una chiave di sostituzione di WVS, un parametro del worker del servizio (che inizia con com.ptc.arbortext) o il nome di un attributi nella radice di un attributo della struttura ricambi (ad esempio, nome, numero o stato). Un esempio di valore del parametro:

{name}_myrep_
{EPM_NUMBER}_{state}

Le chiavi di sostituzione di WVS che è possibile fornire per {chiave} sono le seguenti.

• EPM_NAME - Il nome del documento pubblicato.

• EPM_NUMBER - Il numero del documento pubblicato.

• EPM_TYPE - Il sottotipo del documento.

• AUTHORING_APP - L'applicazione di creazione del documento.

• OUTPUT_TYPE - Il tipo di output prodotto.

• PARAM_SET_NAME - Il nome del param-set nella regola di pubblicazione pubblicata.

Se la {chiave} è il nome di un parametro del worker non definito nelle regole di pubblicazione o nel file pubspec.xml, viene utilizzato il valore di default per il parametro.

Questo parametro non definisce l'estensione file (per pubspec.xml), viene utilizzato il valore di default per il parametro.

Questo parametro non definisce l'estensione file del file di output. Inoltre, un eventuale file PDF contenuto nella rappresentazione rimane invariato.

Se la {chiave} è un attributo di una parte radice che viene pubblicata, è necessario configurare l'attributo nel file manifest_attset.xml affinché venga visualizzato nel file manifest.xml del payload.

Per ulteriori informazioni, vedere Definizione dell'insieme di attributi.

Sì

rootApplicability Expression

PDF

Tramite XSL

Specificare un'espressione di applicabilità da applicare al contenuto e alla struttura ricambi durante la pubblicazione. La sintassi dell'espressione deve corrispondere alla sintassi trovata nella struttura e nel contenuto testuale XML.

La pubblicazione applica filtri alla struttura pubblicazione e ai relativi documenti dinamici. È possibile creare un filtro utilizzando il gruppo di azioni Filtro della barra degli strumenti della struttura ricambi e salvarlo in modo che sia disponibile per le successive operazioni di pubblicazione. Tuttavia, il parametro della regola di pubblicazione rootApplicabilityExpression sovrascrive il filtro.

Quando questo valore non viene specificato, il valore viene derivato dal filtro che l'utente imposta utilizzando il gruppo di azioni Filtro.

Il foglio di stile della trasformazione XSL deve includere l'espressione di applicabilità affinché venga copiato nella mappa DITA.

Per ulteriori informazioni sull'applicabilità, vedere Applicabilità nella pubblicazione.

Le informazioni sull'applicazione Service sono disponibili in Personalizzazione di Windchill Service Information Manager e Windchill Service Parts.

structureSource ApplicSyntax

HTML

PDF

Bundle XML

Tramite XSL

Specificare il nome della sintassi di applicabilità di origine utilizzata per le espressioni di applicabilità nella struttura ricambi, negli elenchi parti e negli altri file raccolti. Specificare il nome registrato sul server Arbortext Publishing Engine. Se non specificato, viene utilizzato il valore di applicabilitySyntax. Se applicabilitySyntax non è specificato, il valore di default è ATO.

Per ulteriori informazioni sull'applicabilità, vedere Applicabilità nella pubblicazione.

structureTarget ApplicSyntax

HTML

PDF

Bundle XML

Tramite XSL

Specificare il nome della sintassi di applicabilità di destinazione da applicare durante la pubblicazione per le espressioni di applicabilità nella struttura ricambi, negli elenchi parti e negli altri file raccolti. Specificare il nome registrato sul server Arbortext Publishing Engine. Se non specificato, viene utilizzato il valore di applicabilitySyntax. Se applicabilitySyntax non è specificato, il valore di default è APEX per l'output del bundle e ATO per gli altri tipi di output.

Per ulteriori informazioni sull'applicabilità, vedere Applicabilità in linea nella pubblicazione.

stylesheet

HTML

PDF

Bundle XML

Tramite XSL

Specificare il foglio di stile per il bundle o la pubblicazione utilizzato per applicare lo stile all'output. È possibile specificare un foglio di stile utilizzando un percorso assoluto o un nome.

Il foglio di stile XSL deve essere memorizzato nella cartella di installazione di Arbortext Editor, nella cartella APTCUSTOM o nella cartella APTAPPLICATION.

Un nome viene risolto utilizzando il percorso catalog del tipo di documento sul server Arbortext Publishing Engine che corrisponde al tipo di documento degli argomenti pubblicati.

Per informazioni sui tipi di documento e sui fogli di stile, vedere la documentazione di Arbortext Editor and Publishing Engine.

Se l'argomento presenta un'istruzione di elaborazione dell'associazione del foglio stile, viene ignorato.

useRestricted TransactionArchive

PDF

Bundle XML

Tramite XSL

Specificare se utilizzare la posizione alternativa dell'archivio di transazione. Specificare 1 per utilizzare l'archivio di transazione alternativo.

L'archivio alternativo di transazione consente di memorizzare le transazioni che contengono informazioni riservate in una posizione accessibile solo in base a permessi. Gli archivi di transazione vengono configurati nel server Arbortext Publishing Engine. Fare riferimento alla documentazione per Arbortext Publishing Engine in Configuring Arbortext Publishing Engine.

Sì

usingxsl.destination

Tramite XSL

Specificare la posizione in cui viene collocato l'output di pubblicazione XSL. Specificare un percorso assoluto di una cartella accessibile in scrittura da Arbortext Publishing Engine. Se la cartella è in conflitto con una directory esistente, viene sovrascritta.

Sì

usingxsl.stylesheet

Tramite XSL

Specificare il foglio di stile .xsl da utilizzare durante la pubblicazione dell'output XSL. Il foglio di stile prevede un documento di origine con un tipo di documento che corrisponde all'output della trasformazione pubstructXsl o un documento risolto per l'elaborazione con Styler (RDS).

Il foglio di stile XSL deve essere memorizzato nella cartella di installazione di Arbortext Editor, nella cartella APTCUSTOM o nella cartella APTAPPLICATION.

L'output viene aggiunto nella posizione specificata da usingxsl.destination. Solo il log del compositore e un manifest con le informazioni sull'operazione di pubblicazione vengono restituiti a Windchill.

Per personalizzare l'output XSL, utilizzare una regola di pubblicazione del sottosistema di pubblicazione. Ad esempio, per impedire la modifica degli attributi href in percorsi locali (da percorsi URI di WC), aggiungere la regola di pubblicazione riportata di seguito.

com.ptc.arbortext.
pe.publish
/dontModifyHref=yes

L'output XSL è una funzionalità supportata da Arbortext Editor and Publishing Engine.

variable:compose:: debug

HTML

PDF

Bundle XML

Tramite XSL

Specificare 1, true o on per aumentare la quantità di informazioni registrate nel file di log del compositore durante una richiesta di pubblicazione.

Per default, i messaggi di errore e di avvertenza vengono posizionati nel file di log del compositore.

Inoltre, è possibile avviare atitrace.exe su Arbortext Publishing Engine e sull'output di debug inviato a tale finestra, acquisendo informazioni di analisi di basso livello. Tale azione sarebbe eseguita da un amministratore Arbortext Publishing Engine.

Sì

variable:_sis:: archiveTransaction

HTML

PDF

Bundle XML

Tramite XSL

Specificare se utilizzare l'archivio di transazione per memorizzare gli elementi della pubblicazione sul server Arbortext Publishing Engine. Specificare 1 per archiviare la transazione. Il valore di default 0 non consente l'archiviazione della transazione, ma la configurazione sul server Arbortext Publishing Engine può comunque permetterla.

Sì

vcs-capture-logs

Bundle XML PDF

Specificare il parametro vcs-capture-logs=yes nella regola di pubblicazione nel seguente formato se si desiderano le informazioni di log su una pubblicazione completata:<worker name="com.ptc.arbortext.pe/vcs-capture-logs">yes</worker>

Se un'operazione di pubblicazione ha esito positivo, il codice SUCCESS viene restituito a Visualization Content Service (VCS).

Se un'operazione di pubblicazione ha esito negativo, il codice guasto appropriato viene restituito a Visualization Content Service.

Yes

Per ulteriori informazioni sulle espressioni di applicabilità, vedere Applicabilità nella pubblicazione.

Tra le attività cardine segnalate dal includeMilestoneTimesInHtmlLog figurano quelle riportate di seguito.

Fase cardine	Attività
Estrazione del payload completa	Tempo di decompressione del payload in una directory temporanea sul server Arbortext Publishing Engine.
Pre-servizio dell'elaborazione del sottosistema completato	Elaborazione dei valori presenti nel file di configurazione pubspec.xml, determinazione della configurazione dell'adattatore e altre attività di pre-elaborazione.
Servizio del sottosistema completato	Il file della configurazione pipeline Service.ccf è stato eseguito e la struttura pubblicazione e il relativo contenuto vengono trasformati.
Pubblicazione del sottosistema completata	La pubblicazione del sottosistema è stata eseguita. Le attività sono determinate dal tipo di pubblicazione eseguito.
Sottosistema di bundle completato	Incluso se è in corso la pubblicazione di un bundle. Copre la durata necessaria per generare il contenuto restante del bundle, per comprimerlo e per inserirlo nella relativa posizione di destinazione.

I parametri del sottosistema com.ptc.arbortext.pe.bundle riportati di seguito controllano il comportamento dell'elaborazione dell'output del bundle del server Arbortext Publishing Engine. È possibile specificare un tipo facoltativo e un nome di parametro per specificare il parametro dopo la barra /.

Nome del parametro

Output

Descrizione

Ignorabile(supporta la modifica di valore durante la pubblicazione incrementale)

altDestination

Bundle XML

Specificare la directory alternativa in cui Arbortext Publishing Engine posiziona il bundle. Questa posizione è compatibile con il sistema operativo del server Windchill ed è specificata come punto di montaggio, percorso UNC o lettera di unità montata. Esempio:

/local/mnt/bundles

Sì

boilerplate

Bundle XML

Specificare il nome di un file ZIP boilerplate per un bundle che viene estratto nella directory di destinazione.

Il percorso del file boilerplate dipende dalla ricerca della specifica set libpath sul server Arbortext Publishing Engine. È necessario che il file disponga del permesso di lettura e abbia lo stesso nome del valore del parametro specificato. L'impostazione di default è boilerplate.zip.

bundleName

Bundle XML

Specificare un nome per la sottodirectory del bundle in cui vengono posizionati i bundle generati. Al nome viene aggiunto _data e ora. Il valore di default è bundle.

Le sottodirectory del bundle vengono posizionate nella directory specificata dal parametro destination.

I caratteri del nome bundle possono essere numeri, lettere e alcuni caratteri speciali, ad esempio . (punto), - (tratto) e _ (tratto di sottolineatura). I caratteri che non sono supportati, ad esempio \ / : * ? " < > |, vengono sostituiti con il valore esadecimale appropriato %xx.

Le virgolette singole e doppie a sinistra e a destra non sono supportate e vengono sostituite con un valore esadecimale %xx.

Sì

destination

Bundle XML

Specificare la directory in cui Arbortext Publishing Engine posiziona l'output del bundle. Questa posizione si trova sul server Arbortext Publishing Engine, specificato come unità fisica o mappata. È necessario creare la directory in anticipo. Non sono disponibili valori di default.

Specificare bundleName per creare le sottodirectory della directory per i bundle.

Sì

DMPmapSchema

Bundle XML

Specificare il percorso (relativo o assoluto) dello schema che si desidera utilizzare per la convalida. Il valore di default prevede un percorso relativo a DMPmap\DMPmap.xsd.

La specifica di un percorso relativo utilizza la prima posizione nel percorso di ricerca Arbortext Publishing Engine doctypes che include il file di schema specificato.

Se lo schema non viene trovato, il log eventi del compositore Arbortext Publishing Engine acquisisce il messaggio di errore. Il valore del parametro DMPmapSchema specificato viene visualizzato nel messaggio.

saveCopy

Bundle XML

Specificare se salvare i file del bundle in un file ZIP per la risoluzione dei problemi. Specificare true per attivare la funzionalità. L'impostazione di default è false.

Specificare una directory utilizzando il parametro artifactDirectory. Il nome file del bundle è ottenuto dal valore di saveCopyName.

Sì

saveCopyName

Bundle XML

Specificare un nome del file di base per i file del bundle. Al nome di base viene aggiunto _data e ora.zip.

Il valore di default è bundle_saveCopy.

I file vengono posizionati nella directory specificata dal parametro artifactDirectory.

I caratteri del nome di base possono essere numeri, lettere e alcuni caratteri speciali, ad esempio . (punto), - (tratto) e _ (tratto di sottolineatura). Altri caratteri, ad esempio i caratteri non supportati nei nomi file Windows (\ / : * ? " < > |), vengono sostituiti con il valore esadecimale % appropriato.

Le virgolette singole o doppie a sinistra e a destra non sono supportate.

Sì

validate

Bundle XML

Specificare se convalidare il file DMPmap.xml rispetto a uno schema specificato dal parametro DMPmapSchema. DMPmap.xml è il file generato da una richiesta di pubblicazione di bundle.

Specificare yes per eseguire la convalida. L'impostazione di default è no.

Se impostato su yes, la pubblicazione ha esito negativo se non è possibile convalidare l'output.

Il foglio di stile DMPmap.xsl di default genera un file DMPmap.xml che non esegue la convalida rispetto al file DMPmap\DMPmap.xsd di default.

Il log eventi del compositore Arbortext Publishing Engine acquisisce il messaggio di errore e contiene il percorso assoluto dello schema utilizzato per la convalida

Se la convalida ha esito positivo, nel log eventi viene visualizzato un messaggio informativo che conferma il superamento della convalida e contiene il percorso assoluto allo schema.

I parametri del sottosistema com.ptc.arbortext.pe.service riportati di seguito controllano il comportamento dell'elaborazione dell'applicazione Service del server Arbortext Publishing Engine. È possibile specificare un tipo facoltativo e un nome di parametro per specificare il parametro dopo la barra /.

Nome del parametro

Output

Descrizione

Ignorabile(supporta la modifica di valore durante la pubblicazione incrementale)

contentMetadaTokens

HTML

PDF

Bundle XML

Tramite XSL

Specificare i valori del token dei metadati che vengono copiati dal manifest nel markup della struttura pubblicazione. Specificare un elenco di valori del token dei metadati separati da virgole. Il carattere jolly * (valore di default) include tutti i valori. Un valore vuoto o - indica di non includere alcun valore. Questo parametro supporta solo le strutture pubblicazione con versione 2.0 o successiva.

disableStructureTitleAndDescriptionCreator

PDF

Specificare se l'applicazione del servizio ripristina Title e gli elementi Description nella struttura di pubblicazione. Se impostata su false, l'applicazione del servizio inserisce gli elementi Title e Description nella struttura di pubblicazione, se non sono già presenti. Quando è impostata su true (valore di default), non vengono apportate modifiche.

graphicTransform

Bundle XML

Specificare le conversioni grafiche che vengono applicate alle immagini referenziate dai documenti dinamici e dagli elenchi parti. Ogni regola di conversione assume la forma:

tipo-immagine,
tipo-immagine,...
:tipo-destinazione,
tipo-destinazione,...
[|...]

dove tipo-immagine e tipo-destinazione sono estensioni dei file di immagine.

Separare più specifiche con una barra verticale |.

Il valore di default è:

tif,drw,eps,svg:png,-

Ogni tipo-immagine viene convertito in ogni tipo-destinazione.

Per tipo-immagine, il carattere jolly * corrisponde a tutti i formati di file e il simbolo + corrisponde ai formati per il Web.

Per tipo-destinazione, specificare il carattere di esclusione - se non si desidera convertire il file di immagine.

Nell'esempio riportato di seguito, tutti i formati per il Web vengono copiati semplicemente nel payload e tutti i formati grafici rimanenti vengono convertiti nel formato JPG.

+:-|*:jpg

In assenza di regole di conversione per un tipo grafico, quest'ultimo non viene convertito. Le conversioni vengono elaborate in ordine, pertanto i caratteri jolly devono essere utilizzati dopo altre specifiche. Ad esempio, in *:-|tif:jpg, il carattere jolly sostituisce il tipo grafico nella seconda regola di conversione e rende l'intera specifica equivalente a *:-. In questo caso, tutte le immagini vengono copiate e non viene eseguita alcuna conversione.

Il valore di default viene applicato nel file pubspec.xml dell'applicazione Service.

Per informazioni sui formati grafici, fare riferimento a Formati di file di immagine e oggetti multimediali e Supporto per la conversione grafica.

È possibile specificare la modalità di gestione delle conversioni grafiche di elenchi parti in bundle mediante l'insieme di parametri transformImage.

Sì

Outputclass

HTML

PDF

Bundle XML

Tramite XSL

Specificare il valore dell'attributo outputclass nel nodo radice della mappa DITA di output. Tale valore viene utilizzato dal foglio di stile della trasformazione XSL.

partlistBundleCcfParam. convertAttachments

Bundle XML

Specificare se gli allegati grafici dell'elenco parti devono essere convertiti. Impostare su true (valore di default), per convertire gli allegati grafici dell'elenco parti. Impostare su false, per mantenere allegati grafici dell'elenco parti nel formato nativo.

Le conversioni grafiche utilizzano il parametro graphicTransform per i valori di default.

Sì

partlistBundleCcfParam. partMetadataTokens

Bundle XML

Specificare i valori del token dei metadati che vengono copiati dal file delle parti referenziate nel markup dell'elenco parti. Specificare un elenco di valori del token dei metadati separati da virgole. Il valore di default è number,orgName,servicekit,name.

Il carattere jolly * include tutti i valori. Un valore vuoto o - indica di non includere alcun valore. Questo parametro supporta solo gli elenchi parti con versione 2.0 o successiva.

L'elenco di tutti i valori del token dei metadati delle parti disponibili: name,number,orgName,ServiceEffectivity,LogicalExpression,beginSerialNumberRange,endSerialNumberRange,beginDateRange,endDateRange,effTarget,effContextReference,serviceable.

Sì

partlistBundleCcfParam. sbomMetadataTokens

Bundle XML

Specificare i valori del token dei metadati della distinta base di manutenzione che vengono copiati dal file delle parti referenziate nel markup dell'elenco parti. Specificare un elenco di valori del token dei metadati separati da virgole. Il valore di default è number,orgName,servicekit,name.

Il carattere jolly * include tutti i valori. Un valore vuoto o - non include alcun valore. Questo parametro supporta solo gli elenchi parti con versione 2.0 o successiva.

L'elenco di tutti i valori del token dei metadati della distinta base ricambi disponibili: name,number,orgName,servicekit,ServiceEffectivity,LogicalExpression,beginSerialNumberRange,endSerialNumberRange,beginDateRange,endDateRange,effTarget,effContextReference,serviceable.

Sì

partlistBundleCcfParam. transformImage

Bundle XML

Specificare se le immagini dell'elenco parti devono essere trasformate. Se impostato su true, le immagini dell'elenco parti possono essere trasformate in base al valore di transformImageTypes. È necessario invece impostare il valore su false (valore di default) per utilizzare i valori specificati da graphicTransform.

Questo parametro non influisce sui riferimenti grafici dei documenti dinamici, che utilizzano il parametro graphicTransform.

Sì

partlistBundleCcfParam. transformImageTypes

Bundle XML

Specificare i tipi di immagini principali in un elenco parti da trasformare dalla lingua di origine, insieme ai tipi di allegati associati per ciascun tipo principale. Il valore di default è *, ovvero ciascun elemento IMAGE viene elaborato e può essere trasformato in uno o più elementi IMAGE aggiuntivi.

Specificare le estensioni dei file principali o *, seguito da due punti facoltativi : e da un elenco separato da virgole di estensioni di file allegati. È possibile separare più specifiche con la barra verticale |.

Di seguito viene riportata la sintassi.

estensione_principale:
estensione_allegato
[|estensione_principale:
estensione_allegato]

estensione_principale può essere * o una o più estensioni di file separate da virgole.

estensione_allegato è una o più estensioni di file separate da virgole.

Esempio:

png,tif:imap|cgm|ldf

Se i tipi principali specificati corrispondono a più tipi di origine, il primo tipo trovato viene utilizzato come tipo principale e i rimanenti vengono ignorati. Ad esempio, se si desidera un solo formato raster, si preferisce il formato png al formato tif e si desidera includere, se possibile, anche un allegato imap, è necessario specificare png,tif:imap.

Di seguito vengono riportati altri esempi.

png:imap|*

jpg:tif|png|gif|eps|
svg|tif|bmp

Questo parametro non influisce sulle immagini referenziate dai documenti dinamici, che utilizzano il parametro graphicTransform.

È necessario specificare i formati di conversione grafica supportati. Per informazioni sui formati grafici, fare riferimento a Formati di file di immagine e oggetti multimediali e Supporto per la conversione grafica.

Sì

partlistBundleCcfParam. transformImage AllowedConversions

Bundle XML

Specificare un elenco di formati grafici di output consentiti e i formati di origine associati per le immagini dell'elenco parti. Utilizzare il formato descritto di seguito.

output1:
origine1,origine2

È possibile separare più specifiche con una barra verticale |.

Esempio:

png:tif,cgm|
jpg:tif,pvz

Le conversioni grafiche vengono eseguite nell'ordine in cui vengono specificati i formati di origine. I formati di output specificati vengono convertiti dall'origine nell'ordine in cui i vengono elencati i formati di output.

Ad esempio, se si specifica png:tif,cgm, le immagini PNG vengono generate prima da immagini TIFF di origine, quindi da immagini CGM. Se non sono disponibili immagini di origine TIFF o CGM, non viene generata alcuna immagine PNG.

Se il parametro non è impostato, il comportamento di default converte l'immagine in tutti gli output supportati.

Per informazioni sui formati grafici, fare riferimento a Formati di file di immagine e oggetti multimediali e Supporto per la conversione grafica.

Sì

partlistBundleCcfParam. transformImage DisableConversions

Bundle XML

Specificare se disattivare le conversioni di immagini dell'elenco parti. Se impostato su true, le conversioni di immagini dell'elenco parti vengono disattivate. Le immagini vengono incluse solo se corrispondono al contenuto principale o secondario.

Se impostato su false (valore di default), le conversioni grafiche sono consentite. Le conversioni utilizzano la specifica del parametro transformImageAllowedConversions.

Sì

partlistStylesheet

HTML

PDF

Bundle XML

Tramite XSL

Specificare il foglio di stile XSL che Arbortext Publishing Engine utilizza per trasformare il modulo XML generico di un elenco parti in un tipo di documento compatibile con il tipo di documento per com.ptc.arbortext.pe/stylesheet.

Il foglio di stile XSL deve essere memorizzato nella cartella di installazione di Arbortext Editor, nella cartella APTCUSTOM o nella cartella APTAPPLICATION.

È possibile specificare un foglio di stile utilizzando un percorso assoluto o un nome sul server Arbortext Publishing Engine. Un nome viene risolto utilizzando il percorso catalog per le directory del tipo di documento sul server Arbortext Publishing Engine. Per default, cerca il tipo di documento partlist dell'applicazione Service.

pubstructXsl

HTML

PDF

Bundle XML

Tramite XSL

Specificare il foglio di stile XSL che Arbortext Publishing Engine utilizza per trasformare il modulo XML generico di una struttura ricambi in un tipo di documento compatibile con il tipo di documento per com.ptc.arbortext.pe/stylesheet.

Il foglio di stile XSL deve essere memorizzato nella cartella di installazione di Arbortext Editor, nella cartella APTCUSTOM o nella cartella APTAPPLICATION.

Per l'output PDF o che utilizza XSL, questo foglio di stile deve trasformare una struttura pubblicazione in un tipo di documento che è possibile pubblicare. Per l'output del bundle, il foglio di stile deve trasformare la struttura ricambi nel formato previsto daArbortext Content Delivery (DMPmap).

suppressPipeline InfoMessages

HTML

PDF

Bundle XML

Tramite XSL

Specificare se registrare i messaggi della pipeline ricambi di livello INFO e inferiore (ad esempio TRACE o DEBUG). I messaggi di errore irreversibile, errore e avvertenza sono comunque inclusi.

Specificare true (valore di default) per eliminare i log dei messaggi dettagliati della pipeline. Specificare false per registrare messaggi dettagliati della pipeline.

L'impostazione su false può avere un impatto significativo sulle prestazioni. Utilizzare questa impostazione solo per la risoluzione dei problemi e per creare test case di dimensioni ridotte.

Quando la variabile compose::verbose è impostata su un valore, questo parametro viene ignorato.

Sì

topicCCfParam. disableApplicability Converter

Bundle XML

Specificare se individuare e convertire le espressioni di applicabilità in un argomento. Specificare il valore di default false per attivare la conversione di applicabilità. Specificare true per disattivare la conversione di applicabilità.

Utilizzare topicCcfParam.SourceApplicabilitySyntax e topicCcfParam.TargetApplicabilitySyntax per definire le espressioni.

topicCCfParam. sourceApplicability Syntax

Bundle XML

Specificare il nome della sintassi di applicabilità utilizzata per le espressioni di applicabilità in argomenti del bundle. Specificare il nome registrato sul server Arbortext Publishing Engine. Se non specificato, viene utilizzato il valore di applicabilitySyntax. Se applicabilitySyntax non è specificato, il valore di default è ATO.

topicCCfParam. targetApplicability Syntax

Bundle XML

Specificare il nome della sintassi di applicabilità utilizzata per le espressioni di applicabilità negli argomenti al termine del processo di elaborazione del servizio del sottosistema. Specificare il nome registrato sul server Arbortext Publishing Engine. Se non specificato, viene utilizzato il valore di applicabilitySyntax. Se applicabilitySyntax non è specificato, il valore di default è APEX.

topicCCfParam. disableMetadata Replacer

Bundle XML

Specificare se la sostituzione di metadati degli elementi informativi è disattivata per gli argomenti XML. Il parametro controlla se il contenuto degli elementi informativi viene sostituito con i valori dei metadati trovati nell'argomento XML durante la pubblicazione del bundle. Specificare false per attivare la sostituzione dei metadati. Specificare il valore di default true per disattivare la sostituzione dei metadati.

topicCCfParam. disableProfiling Converter

Bundle XML

Specificare se la conversione dei profili è disattivata per gli argomenti XML. Il parametro controlla se il markup dei profili negli argomenti XML viene convertito durante la pubblicazione del bundle. Specificare false per attivare la conversione dei profili. Specificare il valore di default true per disattivare la conversione dei profili.

L'attributo di creazione profili è specificato da topicCCfParam.profilingAttribute.

topicCCfParam. profilingAttribute

Bundle XML

Specificare l'attributo da utilizzare per applicare filtri alla creazione di profili. Specificare il Nomelocale per l'attributo o l'URI specificando il namespace e il nome locale ({Namespaceuri}Nomelocale).

L'impostazione di default crea l'attributo applic derivandolo nel modo indicato di seguito.

{http://arbortext.ptc.com/namespace
/applicability/profiling}applic

topicCCfParam. removeProfilingMarkup

Bundle XML

Specificare se il markup dei profili viene rimosso dagli argomenti XML. Il parametro controlla se il markup dei profili negli argomenti XML viene rimosso durante la pubblicazione. Specificare true per rimuovere il markup dei profili negli argomenti XML. Specificare il valore di default false per mantenere il markup dei profili.

L'attributo di creazione profili è specificato da topicCCfParam.profilingAttribute.

I parametri del sottosistema com.ptc.arbortext.pe.publish riportati di seguito controllano il comportamento dell'elaborazione del sottosistema di pubblicazione del server Arbortext Publishing Engine. È possibile specificare un tipo facoltativo e un nome di parametro per specificare il parametro dopo la barra /.

Nome del parametro	Output	Descrizione
APPConfigFile	PDF	Specificare un file di configurazione di APP (.3sppdf) se si desidera generare file PDF tramite APP. Specificare il percorso assoluto del file sul server Arbortext Publishing Engine.

I seguenti parametri del sottosistema com.ptc.arbortext.inservice.all controllano il comportamento di Arbortext Content Delivery durante la gestione dei bundle.

Nome del parametro	Output	Descrizione
Language	Bundle XML	Specificare il codice lingua o le impostazioni locali del contenuto da pubblicare. Per default, il valore è derivato dal parametro com.ptc.arbortext.wvs/language.
Bundle-Source	Bundle XML	Specificare il valore della proprietà per mappare un sottotipo della struttura ricambi per Arbortext Content Delivery. Il valore di default è il valore della proprietà radice orgName della struttura ricambi. Un solo valore è valido; non sono supportati più valori.

Esempi

In una regola di pubblicazione, è possibile specificare quanto riportato di seguito per un bundle.

<param-set name="ServiceBundleRule">
<worker name="com.ptc.arbortext.pe/stylesheet">techinfo.style</worker>
<worker name="com.ptc.arbortext.pe.service/pubstructXsl">DMPmap.xsl</worker>
<worker name="com.ptc.arbortext.wvs/PreferAdapter">no</worker>
<worker name="com.ptc.arbortext.wvs/IncludeContentMetadata">yes</worker>
<worker name="com.ptc.arbortext.pe.bundle/destination">
D:\ptc\bundlepath</worker>
</param-set>

In una regola di pubblicazione, è possibile specificare quanto riportato di seguito per un PDF.

<param-set name="PDFPublishingRule">
<worker name="com.ptc.arbortext.pe/stylesheet">techinfo.style</worker>
<worker name="com.ptc.arbortext.pe.service/stylesheet">techinfomap.xsl
</worker>
<worker name="com.ptc.arbortext.wvs/PreferAdapter">yes</worker>
<worker name="com.ptc.arbortext.wvs/IncludeContentMetadata">yes</worker>
<post-publish name="delegate">com.ptc.wvs.server.publish.
DDPostPublishDelegate</post-publish>
<post-publish name="name">{EPM_NAME}.{OUTPUT_TYPE}</post-publish>
<post-publish name="folder">Published</post-publish>
<post-publish name="published-content-link">create</post-publish>
</param-set>

In una regola di pubblicazione, è possibile specificare quanto riportato di seguito per un HTML.

<param-set name="html">
<worker name="com.ptc.arbortext.pe/stylesheet">techinfo.style</worker>
<worker name="com.ptc.arbortext.pe.service/pubstructXsl">techinfomap.xsl
</worker>
<worker name="com.ptc.arbortext.pe/includeMilestoneTimesInHtmlLog">yes
</worker>
<worker name="com.ptc.arbortext.wvs/PreferAdapter">no</worker>
<worker name="com.ptc.arbortext.wvs/IncludeContentMetadata">yes</worker>
</param-set>

Ai fini della risoluzione dei problemi, è possibile aggiungere quanto riportato di seguito a una regola di pubblicazione param-set.

<worker name="com.ptc.arbortext.pe/artifactDirectory">
D:\ptc\bundle_debug</worker>
<worker name="com.ptc.arbortext.pe.bundle/saveCopy">
true</worker>
<worker name="com.ptc.arbortext.pe.bundle/saveCopyName">
bundle_debug</worker>

L'esempio di file della regola di pubblicazione contiene esempi per Windchill Service Information Manager e Windchill Service Parts.

Il file SamplePublishingRules.xml si trova nella posizione riportata di seguito.

percorso-Windchill\codebase\com\ptc\arbortext\windchill\worker

Cercare la sezione delle regole di pubblicazione SIS con l'intestazione:

Alcune regole specificano il tipo di output EPUB non ancora supportato e indicato come tale nei commenti. Queste regole sono incluse come anteprima della tecnologia per l'utilizzo non di produzione.

È stato utile?