37
PerformingTransformations
MergingPDFdocuments
ItispossibletomergeuptofivePDFfileswiththefilechosenfortransformation
(essentiallymergingsixfilestogether).Thistransformationappendseachfileintothe
PDFasadditionalpages.Thefilesaremergedintheorderinwhichtheyarespecified
inbelow.
Note:IfyoudonotwanttheadditionalfilestobeappendedtothePDF,theyshouldbe
addedasattachments.SeeAddingattachments,page88.
Tomergedocumentsduringthetransformation:
1. Navigatetothefilethatyouwanttotransformtocreateanewrendition.
2. Selectthefile,thenselectTools>Transform>MoreFormats
TheSelectTransformationtabappearsdisplayingtheselectedfileandtheavailable
transformationsfortheselectedfile.
3. SelectMergeDocumentsToPDFoption.ClickNext
TheTransformationDetailstabappears.
4. ClickeachSelectlinktobrowseforeachfile(uptofive)tobemergedduringthe
transformation.
5. TochangethedefaultPDFsettings,setChangeDefaultPDFSettingstoYes.
Additionalparametersrelatingtobookmarks,hyperlinks,minimumcompatibility
(PDFversions),andoptimizingforwebviewingaredisplayed.Selectthenew
valuesasrequired.
6. ToenablethePDFsecurityfeature,setEnablePDFSecurity,toYes.Additional
parametersrelatingtoencryption,passwords,accessibility,contentcopyingor
extraction,changingthedocument,printing,documentassembly,andfillingofform
fieldsaredisplayed.Settheparametersasrequired.ClickNext.
TheSaveAsscreenappears.
7. Selectoneofthefollowing:
• CreateaNewRendition
• CreateaNewObject
SelectingCreateaNewObjectwillallowyoutousethisobjectinitsown
workflow,createatranslationofit,applyitsownpermission,etc.
8. IfyouselectedCreateaNewRendition,theRenditionDefinitionscreenappears.
EnteradescriptionoftherenditionintheRenditionDescriptionfield.
• ClickSaveTransformationifyouwishtoperformthistransformationeverytime
theparentobjectisversioned.
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
103
35
PerformingTransformations
• ClickSetAsDefaultPreview,ifyouwishtosetthisrenditionasthedefault
previewrendition.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish.
9. IfyouselectedCreateaNewObject,theNewObjectDefinitionscreenappears.Enter
atitleofthenewobjectintheTitlefield.Performanyofthefollowingasrequired:
• SelecttheobjecttypefromtheObjectTypelistbox.
• ClickEditnexttoPermissionSetifyouwishtochangepermissionparameters.
ClickOK.
• ClickEditnexttoLifecycleifyouwishtochangedocumentlifecycleinformation.
ClickOK.
• ClickNewLocationoptiontochangeandlogthenewfilelocation.ClickOK.
• ClickSaveTransformationifyouwishtoapplythistransformationeverytime
theparentobjectisversioned.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish
10. Thetransformationrequestisimmediatelysenttotheappropriatequeuefor
processing.
Mergingvirtualdocuments
Thistransformationisavailableforvirtualdocumentsonly.Itmergestheentirefile
structure,includingchildren.TableofcontentscreationandPDFsecurityareavailable
withthistransformation.
Tomergevirtualdocuments:
1. Navigatetothefile/folderthatyouwanttotransformtocreateanewrendition.
2. Selectthefile/folder,thenselectTools>Transform>MoreFormats
TheSelectTransformationtabappearsdisplayingtheselectedfileandtheavailable
transformationsfortheselectedfile.
3. SelectMergevirtualdocumentoption.ClickNext
TheTransformationDetailstabappears.
4. Chooseadditionalfeaturesasrequired
104
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
39
PerformingTransformations
5. TochangethedefaultPDFsettings,setChangeDefaultPDFSettingstoYes.
Additionalparametersrelatingtobookmarks,hyperlinks,minimumcompatibility
(PDFversions),andoptimizingforwebviewingaredisplayed.Selectthenew
valuesasrequired.
6. ToenablethePDFsecurityfeature,setEnablePDFSecurity,toYes.Additional
parametersrelatingtoencryption,passwords,accessibility,contentcopyingor
extraction,changingthedocument,printing,documentassembly,andfillingofform
fieldsaredisplayed.Settheparametersasrequired.ClickNext.
TheSaveAsscreenappears.
7. Selectoneofthefollowing:
• CreateaNewRendition
• CreateaNewObject
SelectingCreateaNewObjectwillallowyoutousethisobjectinitsown
workflow,createatranslationofit,applyitsownpermission,etc.
8. IfyouselectedCreateaNewRendition,theRenditionDefinitionscreenappears.
EnteradescriptionoftherenditionintheRenditionDescriptionfield.
• ClickSaveTransformationifyouwishtoperformthistransformationeverytime
theparentobjectisversioned.
• ClickSetAsDefaultPreview,ifyouwishtosetthisrenditionasthedefault
previewrendition.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish.
9. IfyouselectedCreateaNewObject,theNewObjectDefinitionscreenappears.Enter
atitleofthenewobjectintheTitlefield.Performanyofthefollowingasrequired:
• SelecttheobjecttypefromtheObjectTypelistbox.
• ClickEditnexttoPermissionSetifyouwishtochangepermissionparameters.
ClickOK.
• ClickEditnexttoLifecycleifyouwishtochangedocumentlifecycleinformation.
ClickOK.
• ClickNewLocationoptiontochangeandlogthenewfilelocation.ClickOK.
• ClickSaveTransformationifyouwishtoapplythistransformationeverytime
theparentobjectisversioned.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
105
35
PerformingTransformations
10. Thetransformationrequestisimmediatelysenttotheappropriatequeuefor
processing.
TransformingEMCMFtoHTML
ThisprocedureconvertsEMCMFtoHTMLwiththefollowingparameters:
• Attachmentsareembedded
• MinimumcompatibilityissetforPDFversion1.2
• Fastwebviewisenabled
TotransformEMCMFtoHTML:
1. Navigatetothefilethatyouwanttotransformtocreateanewrendition.
2. Selectthefile,thenselectTools>Transform>MoreFormats
TheSelectTransformationtabappearsdisplayingtheselectedfileandtheavailable
transformationsfortheselectedfile.
3. SelecttheTransformEMCMailtoHTMLoption.ClickNext.
Therearenoparameterstospecifyforthistransformation.TheSaveAsscreen
appears.
4. Selectoneofthefollowing:
• CreateaNewRendition
• CreateaNewObject
SelectingCreateaNewObjectwillallowyoutousethisobjectinitsown
workflow,createatranslationofit,applyitsownpermission,etc.
5. IfyouselectedCreateaNewRendition,theRenditionDefinitionscreenappears.
EnteradescriptionoftherenditionintheRenditionDescriptionfield.
• ClickSaveTransformationifyouwishtoperformthistransformationeverytime
theparentobjectisversioned.
• ClickSetAsDefaultPreview,ifyouwishtosetthisrenditionasthedefault
previewrendition.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish.
6. IfyouselectedCreateaNewObject,theNewObjectDefinitionscreenappears.Enter
atitleofthenewobjectintheTitlefield.Performanyofthefollowingasrequired:
• SelecttheobjecttypefromtheObjectTypelistbox.
106
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
35
PerformingTransformations
• ClickEditnexttoPermissionSetifyouwishtochangepermissionparameters.
ClickOK.
• ClickEditnexttoLifecycleifyouwishtochangedocumentlifecycleinformation.
ClickOK.
• ClickNewLocationoptiontochangeandlogthenewfilelocation.ClickOK.
• ClickSaveTransformationifyouwishtoapplythistransformationeverytime
theparentobjectisversioned.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish
7. Thetransformationrequestisimmediatelysenttotheappropriatequeuefor
processing.
TransformingEMCMFtoPDF
ThisprocedureconvertsEMCMFtoPDFwiththefollowingparameters:
• Attachmentsareembedded.
• MinimumcompatibilityissetforPDFversion1.2
• Fastwebviewisenabled.
TotransformEMCMFtoPDF:
1. Navigatetothefilethatyouwanttotransformtocreateanewrendition.
2. Selectthefile,thenselectTools>Transform>MoreFormats
TheSelectTransformationtabappearsdisplayingtheselectedfileandtheavailable
transformationsfortheselectedfile.
3. SelecttheTransformEMCMailtoPDFoption.ClickNext.
Therearenoparameterstospecifyforthistransformation.TheSaveAsscreen
appears.
4. Selectoneofthefollowing:
• CreateaNewRendition
• CreateaNewObject
SelectingCreateaNewObjectwillallowyoutousethisobjectinitsown
workflow,createatranslationofit,applyitsownpermission,etc.
5. IfyouselectedCreateaNewRendition,theRenditionDefinitionscreenappears.
EnteradescriptionoftherenditionintheRenditionDescriptionfield.
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
107
25
PerformingTransformations
• ClickSaveTransformationifyouwishtoperformthistransformationeverytime
theparentobjectisversioned.
• ClickSetAsDefaultPreview,ifyouwishtosetthisrenditionasthedefault
previewrendition.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish.
6. IfyouselectedCreateaNewObject,theNewObjectDefinitionscreenappears.Enter
atitleofthenewobjectintheTitlefield.Performanyofthefollowingasrequired:
• SelecttheobjecttypefromtheObjectTypelistbox.
• ClickEditnexttoPermissionSetifyouwishtochangepermissionparameters.
ClickOK.
• ClickEditnexttoLifecycleifyouwishtochangedocumentlifecycleinformation.
ClickOK.
• ClickNewLocationoptiontochangeandlogthenewfilelocation.ClickOK.
• ClickSaveTransformationifyouwishtoapplythistransformationeverytime
theparentobjectisversioned.
Note:Aformatmustberichmedia_enabledtoallowfortransformationwheneverit
isversioned.
ClickFinish
7. Thetransformationrequestisimmediatelysenttotheappropriatequeuefor
processing.
108
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
29
Chapter7
Troubleshooting
Thischapterprovidestroubleshootinginformationforerrorsencounteredfromvariouselementsof
AdvancedDocumentTransformationServices.AlsoseeAdvancedDocumentTransformationServices
ReleaseNotes,whichcontainadditionalinformationregardinglimitations,technicalnotes,usability,
andknownbugs.
Thissectioncontainstroubleshootingguidancerelatingto:
• Erroreventsandlogfiles,page109
• Atransformationrequestfails,page110
• Aprofileerroroccurs,page110
• AdvancedDocumentTransformationServercannotaddarenditiontoaparticularformat,
page111
• AdvancedDocumentTransformationServercannotlogintotherepository,page112
• CTSAdministrationAgentgivesAGENT_INACCESSIBLEmessage,page113
• ContentTransformationServicesfailstofunction,page113
• Locatingapplicationserverworkingfolder,page114
Erroreventsandlogles
AnytimeAdvancedDocumentTransformationServerfailstoprocessaparticular
item,itqueuesanevent(dm_autorender_errorordm_mediaserver_error)totheInbox
oftherepositoryuserdefinedasthesystemoperatorintheAdvancedDocument
TransformationServerconfigurationfile.ThefirststepintroubleshootingAdvanced
DocumentTransformationServeristocheckthesystemoperator’sInboxforany
messagesthatmightexplaintheerror.
Additionally,reviewtheCTS_log.txtlogfile.Thislogfilecontainserrorsandexceptions
thatarespecifictotheAdvancedDocumentTransformationServer.Itislocatedonthe
AdvancedDocumentTransformationServerhost,inthisdirectory:
C:\Program Files\Documentum\CTS\config\logs
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
109
34
Troubleshooting
Atransformation request fails
Occasionally,atransformationrequestmayfailtoprocess,ormayprocessincorrectly.In
mostcases,theerrormessageswillindicatetheproblem.
Notificationofatransformationfailurewillbesenttothesystemoperator’sInbox.The
followingactionscanbeperformedtodeterminethecauseofatransformationrequest
failure.
Totroubleshootthefailureofatransformationrequest:
1. Checkthattheobjectofthetransformationrequestisnotlocked(checkedoutofthe
repository).Iftheobjectislockedduringthetransformation,theoperationfails.
2. Checkforerrormessagesinthesystemoperator’sInbox,indicatingthattheformat
ofthefilebeingtransformeddoesnotadheretosystemspecifications.Forexample,
thefilemaybecorrupted,orcompressionorothersimilarfeatures(suchascodec)of
thefilemaynotbesupportedbyAdvancedDocumentTransformationServices.
3. CheckthatdiskspaceandmemoryontheAdvancedDocumentTransformation
Serverhost,andtheContentServerhost,issufficienttohandletherequestedfile
transformation.
4. RestarttheAdvancedDocumentTransformationServerhostandattemptthe
transformationagain.
RestartingtheserverwillnotaffecttheAdvancedDocumentTransformation
Servicesqueue.
Aprole error occurs
Errorsrelatedtoprofilesmayoccur. Forexample,ifaprofilewaseditedandupdated
manually,theremaybeissueswiththeXMLcommand-linefile.
Thereareanumberofwaystodeterminethecauseofaprofileerror.
Toidentifythecauseofaprole-relatederror:
1. ChecktheInboxoftheAdvancedDocumentTransformationServersystemoperator
forerrormessages.Errormessagesheremayindicatethecauseoftheerror.
2. ChecktheCTS_log.txtorthemainDocumentumlogfile,log4j.log(locatedin
C:\ProgramFiles\Documentum\logs),forexceptions.
3. Ifyoususpecttheprofileitselfisthecauseoftheerror,logintoaDocumentumClient
(suchasDigitalAssetManager)asanadministratoruserorlogintoDocumentum
110
EMCDocumentumAdvancedDocumentTransformationServicesVersion6.5AdministrationGuide
Documents you may be interested
Documents you may be interested