Escolar Documentos
Profissional Documentos
Cultura Documentos
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
XENAXERTableofContents
1) INTRODUCTION.....................................................................................................................................3 a) HighLevelDescriptionofXENAXER.................................................................................................3 b) AQuickExampleUsingXENAXER.....................................................................................................4 2) XENAXERVersionandPrimaveraVersionChanges.............................................................................6 c) XENAXERVersion.............................................................................................................................6 d) PrimaveraVersionChanges..............................................................................................................6 3) InstallingtheXENAXERImportUtility..................................................................................................6 e) Prerequisites.....................................................................................................................................6 f) Installation........................................................................................................................................7 g) UpdatinganExistingXENAXERinstallation......................................................................................7 h) Registering........................................................................................................................................8 4) UsingtheXENAXERUtility ...................................................................................................................9 . a) ConfiguringUsers..............................................................................................................................9 a) Configuration(LimitValuestoAuthorizedList)..............................................................................10 i) ForeignLanguages..........................................................................................................................11 j) ModifyingLabelsandMessages.....................................................................................................11 k) MaintainingAuthorizedValues ......................................................................................................12 . l) AddingaNewTemplate..................................................................................................................15 m) CopyingaTemplate....................................................................................................................15 n) ConvertingtheXERfile...................................................................................................................16 i) GeneralTab.................................................................................................................................16 ii) ActivityCodesTab.......................................................................................................................19 SeetheMaintainingAuthorizedValuessectionearlierinthisdocument.Thisfunctionalityisalso availableforProjectCodes,Resources,ResourceCodes,Calendars,UDFTypesandNotebook Topics..................................................................................................................................................20 iii) ActivityCodeValuesTab.............................................................................................................21 iv) ProjectCodesTab.......................................................................................................................22 v) ResourceCodesTab....................................................................................................................23 vi) CalendarsTab..............................................................................................................................24 vii) UDFTypesTab(UserDefinedFields)......................................................................................25 viii) UnitofMeasureTab...............................................................................................................26 ix) ResourcesTab.............................................................................................................................27 x) NotebooksTab............................................................................................................................28 5) RemoveFunction................................................................................................................................30 RemovePrimaveraFieldChart...............................................................................................................31 NoteaboutRemovalFunction:...............................................................................................................33 DataRemovalDisclaimer:.......................................................................................................................33 6) RecommendedImportSettingsinPrimavera.....................................................................................34 AppendixA,XENASupport.........................................................................................................................35 AppendixB,PrimaveraTechnicalTermsandTheirTitles...........................................................................36
ProvidedbyXENAUtilities.com
Page2
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
1) INTRODUCTION
a) HighLevelDescriptionofXENAXER
XENAXERImportUtilityisautilityusedwithOraclePrimaveraProjectManagementwhichprovides userstheabilitytoreviewandmodifyPrimaveraXERfilespriortoimportingtheXERfilesintoa productiondatabase.Thistoolmakesitsafertoimportprojectsfromnonproductiondatabasesby mappingcodesfromtheXERfiletocodesinyourproductiondatabasesorbymappingthecodestoa desirednamingconvention.Thisutilityisnotdesignedtocreatenewcodesthatdonotexistinthe receivingdatabaseasthereisnowaytoinputtheneededunderlyingelements. XENAXERgivesyouanaddedlevelofsecurityforyourproductiondata.XERfilescanbesafelyimported intoyourdatabasewithouttheriskofcorruptingtheproductionconfiguration.Thissavesthetimeand energyofimportingXERfilesintoastagingdatabaseandcleaningupnonstandardcodes,resources, calendarsandUnitsofMeasure. TheXENAXERtoolsuitefacilitates: Protectingyourproductiondatabase SafelyImportingupdatesfromContractorsandexternalsources MovingprojectsbetweenDepartmentsusingseparatePrimaveradatabases(i.e.Engineeringto ProjectsorMaintenancetoTurnaround Movingprojectsbetweendatabases ChangetheversionofXERfromv5.0tov7.0 XENAXERtoolallowstheusertoreviewcodingstructurescontainedwithintheXERfile,thenmap, modifyordeletethemtomatchtherequireddatabaseconfiguration.Usinganintuitivesetofmapping tabs,XENAXERdisplaystheinformationnecessarytocreatearevisedXERfile,basedontheusers conversionrequirements.TheseconversionsettingsaresavedintemplatestoensurethatXERfilescan beconvertedthesavewayeverytime.TheXENAXERImportUtilityisorganizedintothefollowingtypes ofconversiondata: General ActivityCodes ActivityCodeValues ProjectCodes ResourceCodes Calendars UDFTypes(UserDefinedFields) UOM(UnitsofMeasure) Resources NotebooksTopics MultipletemplatescanbecreatedandsavedsoXERfilescanbeefficientlyhandledfrommultiple sources.XENAXERalsohandlestheconversionbetweenPrimaveraversions. IfthereareanyquestionsabouttheXENAXERImportUtilityorthisUserGuide,pleaseseetheXENA Supportinformationattheendofthisdocument.
ProvidedbyXENAUtilities.com
Page3
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
b) AQuickExampleUsingXENAXER
Oncethisutilityisinstalledandoperationalanewusermaybenefitbythisquickexampleofusingthe XENAXERImportUtility. (1) LogintoXENAXERasadmin. (2) GotoUtilitiesmenuandselectImport/ExportAnalyzer.
ProvidedbyXENAUtilities.com
Page4
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
(5) GototheOriginalXER:fieldandbrowsetothelocationofasampleXERfile.(Youcan createonebyperforminganXERexportfromPrimavera.FormatType=XERPrimavera PM,ExportType=Project) (6) GototheRevisedXER:field.Copyandpastethefilenameandlocationfromstep5and changethefilenamesoyouknowitistherevisedXERfile. (7) ThenselecttheImportButton.WhentheimporthasfinishedselecttheFinishbutton. (8) Younowhavedatatoviewandchangeifyouwish.ForeachofthetabsofActivity Codes,ActivityCodeValues,ProjectCodes,ResourceCodes,etc.youcanseethedata fromtheoriginalXERfile. (9) EachtabthathasdatatherewillbeafieldheaderNew____(ActivityCode,etc.)where youcanenteranewentry. (10)AfteryouhaveenteredNew_____,youcannowcreateaRevisedXERfile.Selectthe savebuttonandthenreopenthesametemplatebyselectingtheUseTemplatebutton.
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
2) XENAXERVersionandPrimaveraVersionChanges
c) XENAXERVersion
ThiscopyoftheUserGuideiswrittenforaparticularversionoftheXENAXERImportUtility.Inorderto improvethesoftwarefunctionality/qualityandtorespondtocustomerenhancementrequests,itis possiblethatchangeswillbemadetothisapplicationmoreoftenthantotheUserGuide.Totrackthe differentreleasesastandardindicatorisusedsuchas,v1.2.1.4.Minormodificationsmaynotimpactthe UserGuide,buttheReadMe.Txtfileincludedinthedownloadpackagewilladdressallchanges. IftheversionoftheUserGuidediffersfromthatoftheXENAXERImportUtilityinuse,refertothe ReadMe.TxtfilefortheminorchangesnotimpactingtheUserGuide.
d) PrimaveraVersionChanges
Primaverasoftwarefunctionandstructurehasbeenenhancedovertheyears.Thishasimpactedthefile structureoftherelatedXERfiles.ThedevelopersoftheXENAXERImportUtilityhaveworkedto providethemostuptodateforward/backwardversionchangecompatibilitybetweenv5.0andP6v7.0. XERtoolmaybeusefultomigratePrimaverav4.0XERfilestolaterversions,butatthecurrentXERtool releasethereisnoattempttoadjustforthelackofanActivityCodescopefieldinthev4.0XERfile layout.ItisrecommendednottomakechangestotheActivityCodescopeinv4.0XERfiles.
3) InstallingtheXENAXERImportUtility
e) Prerequisites
.NET3.5 SQLServer2005(orlater) SupportedOS's:WinXPProServicePack3,VistaHome,VistaBusiness,andWindows7 Note:XENAXERconnectstoSQLServer(orSQLServerExpress).Thiscanbeinstalled automaticallyfromthePrimaveraCDsbyinstallingthestandaloneP6orbyrunningthe setup.exefileintheinstall\sqlserverfolderonCD1or SQLServer2008ExpresscanbedownloadedfromMicrosoft'swebsiteat http://www.microsoft.com/express/Database/InstallOptions.aspx TheXENAXERapplicationisinstalledbyrunningthesetup.exefileintheXENA.zipfile. PreviousversionsofXENAXERmustbeuninstalledbeforebeginning Ifyouareupgradingfromanearlierversion,youshouldinstallthenewversioninthesame locationasthepriorversion. WheninstallingtheXENAdatabase,thenameassignedtothedatabasemustbeunique.Do notattempttousethePrimaveradatabase.XENAXERdoesnotattachtoPrimaveraoruse thePrimaveradatabase.
ProvidedbyXENAUtilities.com
Page6
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
ForWindows7andVistacomputers,thepermissionsmustbechangedfortheusertoFULL accessontheXENAfolder(ex:c"\ProgramFiles\XENA"or"C:\ProgramFiles(x86)\XENA)
NOTE:OninitialstartupofXENAwithSQLServer2008,anErrormaybedisplayedindicatingthattheSQL Instanceisnotavailable.ClickOKandwait10to20seconds.The"DatabaseSetupScreen"willbedisplayed thenclickonthe"Use'SelectDatabase"option,thenselectyourDatabaseServerthenenterXENAasthe DatabaseName.ThedelaysareduetorequeststoSQLServerandifSQLServerisnotrunningyet,ittakes timetostartSQLServer.
f) Installation
Note:FordetailofinstallationseetheXENAXERImportUtilityInstallationGuide.
g) UpdatinganExistingXENAXERinstallation
ToinstallanewXENAXERversiontoanexistingXENAXERinstallation,pleasefollowthese steps: NotifyallXENAuserstoexitapplicationandtellthemtostayoutofXENAXERuntilthe updateiscomplete. BackupyouexistingXENAXERdatabase.(XENAUtilities.com,MustangTechnologiesand AcceleratedPMwillnotberesponsibleforlostdata.)XENAusersareresponsiblefor backups.BackupsareperformedfromSQLServer. o Tobackup,runSQLServeranddoubleclickonDatabases. o SelecttheXENAdatabase.Pleasenote,thenameoftheXENAdatabaseisuser definedsoyourdatabasemaynotbecalledXENA. o Afterselectingthedatabasename,clicktherightbuttonandselectTasksthen selectBackup. o Addadestinationforthebackup. o ClickOK. o Ifthebackupwasunsuccessfuloryouhavedifficultlydoingthebackup,please contactyourITdepartmentyourITdepartmentmayalreadyhaveabackup processinplaceforyourdatabase. UninstallXENAoneachworkstation.(YoumaywanttoinstallXENAXERandreinstallon1 workstationbeforeyouinstallXENAontoeveryXENAXERworkstation.) OpentheXENA.ZipfileandreadtheReadMe.Txtfileforspecialinstallationinstructions. RunSetup.EXEintheXENA.Zipfile.(Theuserdoingtheupgrademusthaveadministrative databaserights.) AfterXENAisinstalled,runXENA. XENAwilldetectifthereareanydatabaseupdates.IfXENAisgoingtoupdateyour database,XENAwillprompttheusertoverifythattheybackedupthedatabasebefore XENAupdatesthedatabase. Aftertheinstallationiscomplete,XENAwilldisplayLogonscreen.
ProvidedbyXENAUtilities.com
Page7
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
h) Registering
TheXENAXERImportUtilitycomeswitha30DayDemoLicense.Tocontinueusingthe toolortoenablemultipleusers,youmustpurchaseandregisterXENAXER.Youwill thenbeemailedaregistrationkeyafterpaymentisreceived. Afterreceivingyourregistrationkey,starttheXENAapplication.Ontheloginscreen, clicktheregisterbuttonandentertheregistrationkey.
Itisbesttocopyandpastethekeyfromtheregistrationemail.
NOTE:SeeXENASupportinformationattheendofthisdocumentforanyquestions.
ProvidedbyXENAUtilities.com
Page8
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
4) UsingtheXENAXERUtility
a) ConfiguringUsers
Note:Youwillonlybeabletoaddusersifyouhaveamultipleuserlicense.Likewise,thesecurity functionisenabledbyyourlicense. WhenloggingintoXENAthefirsttime,loginwiththedefaultusernameofadminandwithapassword ofadmin.
ProvidedbyXENAUtilities.com
Page9
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
(Comingsoon:TurnontherightsdesiredfortheuserandselectaLanguagefromthedropdownbox)
a) Configuration(LimitValuestoAuthorizedList)
TheConfigurationscreenisusedtodeterminewhichcodesarerequiredtomatchtheAuthorizedValues list.ToaccesstheConfigurationscreenselecttheMaintenancemenufromXENAMainScreenand thenselectConfiguration.Tochangeasetting,selectthecheckboxonoroffandclicktheSavebutton.
ProvidedbyXENAUtilities.com
Page10
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
AlluserpasswordscanbemaintainedbyusersthathavetheAdmincheckboxcheckedbyjust typingthenewpasswordforthatuser.
i) ForeignLanguages
Comingsoon:(TheLanguageoptionisspecifiedforeachindividualuserontheuserconfigurationscreen undertheMaintenancemenu.Thisoptionwilltranslatealloftheapplicationlabelsandmessagesto thelanguageselected.ThetranslationsarestoredintheXENAdatabasetableMESSAGES.Any languagecanbesupportedbyenteringthetranslatedmessagesinthistable.Ifthelanguageyouneedis notcurrentlytranslated,contactMustangTechnologiesusingtheHelpAboutscreen.)
j) ModifyingLabelsandMessages
AnyAdminusercanmodifyanyorallofthelabelsandmessagesbyloadinganewmessagefile.From theXENAMainScreenmenu,selectMaintenance>LoadMessages,selecttheBrowsebuttontogoto thedesiredtextfile,selectOpenandselectLoad.(Changescanbemadetotheoriginalmessagefile, XENAMessages.txt.ThisfilewillbelocatedwhereXENAwasinstalledonthelocalPC.Tochange messagesgotothedesiredmessageinthetextfile,changetheEnglishtextandthenloadthatmessage text.
ProvidedbyXENAUtilities.com
Page11
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
k) MaintainingAuthorizedValues
TheXERtoolallowsanyAdminuser(seeConfiguringUsers)toenter/modifyapredefinedlistof AuthorizedValuesforActivityCodes,ProjectCodes,Resources,ResourceCodes,UDFTypes,Notebook TopicsandCalendars.Thesepredeterminedvaluescanbeusedtoasadropdownselectionchoicefor therevisedXERfileorcanbeusedastherequiredlisttobecontainedintherevisedXERfilesdepending ontheConfigurationsettings. AnAdminusercanaccessandchangesettingsintheConfigurationwindow,fromtheXENAMain ScreenselectMaintenance>Configuration.Tolimitrevised/outputXERfilestocontainonlyvaluesina givenauthorizedlist,checkthecheckboxnexttothedesiredcomponenttoturnonthesecurityfeature.
ProvidedbyXENAUtilities.com
Page12
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
TheXENACalendarListScreencanbedisplayedfromtheMaintenancemenuorthecomponenttabas shownabove.
NewvaluescanbeaddedtoagivelistbyselectingtheAddbuttondisplayingaMaintenancewindow. EnterthedesiredvalueandselecttheSavebutton.
ProvidedbyXENAUtilities.com
Page13
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
Thefunctionalityforothercomponents/listsofAuthorizedValuesisthesame.
ProvidedbyXENAUtilities.com
Page14
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
l) AddingaNewTemplate
AddanewtemplatetocreateandstoreconversionsettingsusedinXERconversionprojects. 1. FromtheMenu,selectUtilitiesImport/ExportAnalyzer 2. ClickAddTemplate
3. 4. 5. 6. 7.
m)CopyingaTemplate
TomakeanexactcopyofatemplateselecttheCopyTemplatebuttonintheXENAImport/Export AnalyzerScreen,shownabove.
ProvidedbyXENAUtilities.com
Page15
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
n) ConvertingtheXERfile
i) GeneralTab
Atemplatethathasbeenpreviouslycreatedcanbeusedoverandover.Thisisusefulwhenhandling XERfilesrepeatedlyfromthesamesource,i.e.acontractor. 1. FromtheMenu,selectUtilitiesthenImport/ExportAnalyzer 2. SelectaTemplateandClickUseTemplate 3. ToexportanewXERfile a. ClickUseTemplatebutton b. Makesurethereisavalidexportfilename c. SelectthePrimaveraversionnumberfromtheRevisedVersiondropdownlist tomatchthedestinationPrimaveradatabasewheretherevisedfilewillbe imported. d. ClickProcessbutton,thentheFinishbutton.
AftertheProcessingiscompleted,thefollowingmessagewillappear,selectFinish.
ProvidedbyXENAUtilities.com
Page16
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
Whenanexistingtemplateisreusedsuchasthenextprojectupdatefromacontractor,theXER toolkeepstrackofthechangesinthesourceXERfileandnotifiestheuser.
Seethediscussiononeachofthetabsfollowingthissection.
ProvidedbyXENAUtilities.com
Page17
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
ATextPrefixcanbeenteredthatcanbeautomaticallyappliedtoanyoralloftheXERcode structuresshowninthePrefixesbox.Prefixesareautomaticallyappliedduringimport. 1. EnteraPrefixandselectthecheckboxestheprefixshouldbeappliedto. a. Ifyouenternoprefix,thentheimportwillimportallcodeswithanactionof DontChange. b. Ifyouenteraprefix,andcheckoneoftheboxes,Importwilluseanaction ofChangeonallchangedcodesPLUSitwilllisttheactualcodethatwillbe exported. c. Ifdifferentprefixesareneeded,thiscanbeaccomplishedbyusing2 templateswithdifferentprefixsettings,thenusingtheminsequence. Foradditionalimportsexecutedafterthefirstimportwiththesametemplate,theprefixes willONLYbeappliedtocodeswithanactionofDontChange.Codeswithanactionof DeleteorChangewillnotbeaffectedbytheImportprocess. NOTE:Wheneveraprefixsettingischanged,theXERfilemustbereimported.
ProvidedbyXENAUtilities.com
Page18
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
ii) ActivityCodesTab
ClicktheActivityCodestabtomodifyorviewtheActivityCodes.OnceanXERfilehasbeen imported,theActivityCodescontainedintheXERfilewillbedisplayedonthistab.TheLeft SectionofthetabshowsthevaluesimportedfromtheXERfile.TheRightSectionofthetab showsthevaluesthatwillbeexportedtothenewXERfile. TheNewActivityCodecolumnonthefarrightshowshowtheActivityCodewillbewrittenin thenewfile.Tochangeanactivitycodeortomapittoanactivitycodeinyourdestination database,simplyeditthisfieldtobethevaluedesired.Alternativelyaprefixcanbeassignedto allthecodesusingthefunctionalityontheGeneraltab.
TheScopecolumnintheleftsectionshowswhethereachactivitycodeisGlobal,EPSorProject initsscope.TheNewScopecolumnintherightsectionisusedtochangethenewactivitycode toadifferentscope.UsuallythiswillbeusedtochangeanactivitycodefromGlobaltoProject. WhenchanginganactivitycodetoProjectscope,theuserMUSTspecifyaNewProjectShort Name.ThissimplyindicatestowhichprojectintheXERfiletheactivitycodeshouldbe attached. TheActionscolumninthemiddledisplaystheactionthatwillbeperformedontheactivitycode duringprocessing.Thiswillupdateautomaticallywhenchangesaremadetoanyofthecolumns intherightsectionoritcanbechangedmanually.IftheActionscolumnischangedtoDelete thentheactivitycodewillbedeletedfromtheXERandwillnotimportintoPrimaveraandany accompanyingActivityCodeValueswillbedeletedaswell. TheClearRowbuttonwillclearthehighlightedrowfromthetemplatesothatitcanbe refreshedwiththenextimportoftheoriginalXERfileortoremovethatrowfromthetemplate ifitnolongerexistsintheoriginalXERfile.
ProvidedbyXENAUtilities.com
Page19
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
TheunmarkedbuttontotherightofeachlistedActivityCode(ViewValuesbutton)isusedfor viewingthevaluesthatareassignedtothatparticularactivitycode.Thisviewingoptiononly worksafteranImportXENAXERdoesnotstoreallthevaluesinitsDB.Thereforeifyouare viewinganexistingtemplateandhavenotyetimportedtheXERfile,theViewValuesbuttonwill notshowanyvalueseventhoughtheActivityCodesareshown. NOTEImportingasecondtimedoesNOTOVERWRITEexistingdatabutitwilladd anyadditionalcodetypesthatdonotexistinthetemplate.Ifyouwantedtore importselecteditems(perhapstogettheoriginalnames),deletetheindividualcode typesfromthetemplatethenImportthefileagain. ThebuttontotherightoftheNewActivityCodecolumniscanbeusedtolist(andallowselection of)ApprovedActivityCodes.
SeetheMaintainingAuthorizedValuessectionearlierinthisdocument.Thisfunctionalityisalso availableforProjectCodes,Resources,ResourceCodes,Calendars,UDFTypesandNotebookTopics.
ProvidedbyXENAUtilities.com
Page20
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
iii) ActivityCodeValuesTab
ClicktheActivityCodeValuestabtomodifyorviewtheActivityCodeValuesforanActivity Code.OnceanXERfilehasbeenimported,ActivityCodeValuescanbeviewedbyselectingan ActivityCodefromtheActivityCodesdropdownlist.TheLeftSectionofthetabshowsthe valuesimportedfromtheXERfile.TheRightSectionofthetabshowsthevaluesthatwillbe exportedtothenewXERfile.TheNewActivityCodeValuecolumnonthefarrightshowshow theActivityCodeValuewillbewritteninthenewfile.Tochangeanactivitycodevalueorto mapittoanactivitycodevalueinyourdestinationdatabase,firstselectanActivityCodefrom thedropdownlist.AfterselectinganActivityCode,thevaluesforthatActivityCodewillbe displayed.Tochangeanactivitycodevalue,simplyeditthevalueintheNewActivityCode Valuecolumn.Alternativelyaprefixcanbeassignedtoallthevaluesusingthefunctionalityon theGeneraltab.
TheActionscolumninthemiddledisplaystheactionthatwillbeperformedontheactivitycode valueduringprocessing.TheActionwillupdateautomaticallywhenchangesaremadetothe NewActivityCodeValueortheActioncanbechangedmanually.IftheActionscolumnis changedtoDeletethentheactivitycodevaluewillbedeletedfromtheXERandwillnot importintoPrimavera. ToresetthevalueintheNewActivityCodeValuecolumn,changetheActiontoDont Change.ToanActivityCodeValuefromthegrid,clicktheDeletebutton. DuringImport,XENAwilladdanynewActivityCodeValuesfoundintheXERfile.Therefore,if youdeleteanActivityCodeValuefromthegridandreimporttheXERfile,theActivityCode Valuewillbeaddedtothegrid. TheClearRowbutton(nearthebottomofthetemplatescreen)willclearthehighlightedrowfromthe templatesothatitcanberefreshedwiththenextimportoftheoriginalXERfileortoremovethatrow fromthetemplateifitnolongerexistsintheoriginalXERfile.
ProvidedbyXENAUtilities.com
Page21
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
iv) ProjectCodesTab
ClicktheProjectCodestabtomodifyorviewtheProjectCodes.OnceanXERfilehasbeen imported,theProjectCodescontainedintheXERfilewillbedisplayedonthistab.TheLeft SectionofthetabshowsthevaluesimportedfromtheXERfile.TheRightSectionofthetab showsthevaluesthatwillbeexportedtothenewXERfile.TheNewProjectCodecolumnon thefarrightshowshowtheProjectCodewillbewritteninthenewfile.TochangeaProject CodeortomapittoaProjectCodeinyourdestinationdatabase,simplyeditthisfieldtobethe valuedesired.Alternativelyaprefixcanbeassignedtoallthecodesusingthefunctionalityon theGeneraltab.
TheActionscolumninthemiddledisplaystheactionthatwillbeperformedontheProjectCode duringprocessing.Thiswillupdateautomaticallywhenchangesaremadetoanyofthecolumns intherightsectionoritcanbechangedmanually.IftheActionscolumnischangedtoDelete thentheProjectCodewillbedeletedfromtheXERandwillnotimportintoPrimavera. IfProjectCodeshavethecheckboxmarkedonintheConfigurationscreen,onlycodeslisted undertheapplicableAuthorizedValueslistwillbepermittedintheoutputXERfile.Seethe MaintainingAuthorizedValuessectionearlierinthisdocument. TheClearRowbutton(nearthebottomofthetemplatescreen)willclearthehighlightedrow fromthetemplatesothatitcanberefreshedwiththenextimportoftheoriginalXERfileorto removethatrowfromthetemplateifitnolongerexistsintheoriginalXERfile.
ProvidedbyXENAUtilities.com
Page22
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
v) ResourceCodesTab
ClicktheResourceCodestabtomodifyorviewtheResourceCodes.OnceanXERfilehasbeen imported,theResourceCodescontainedintheXERfilewillbedisplayedonthistab.TheLeft SectionofthetabshowsthevaluesimportedfromtheXERfile.TheRightSectionofthetab showsthevaluesthatwillbeexportedtothenewXERfile.TheNewResourceCodecolumn onthefarrightshowshowtheResourceCodewillbewritteninthenewfile.Tochangea ResourceCodeortomapittoaResourceCodeinyourdestinationdatabase,simplyeditthis fieldtobethevaluedesired.Alternativelyaprefixcanbeassignedtoallthecodesusingthe functionalityontheGeneraltab.
TheActionscolumninthemiddledisplaystheactionthatwillbeperformedontheResource Codeduringprocessing.Thiswillupdateautomaticallywhenchangesaremadetoanyofthe columnsintherightsectionoritcanbechangedmanually.IftheActionscolumnischangedto DeletethentheResourceCodewillbedeletedfromtheXERandwillnotimportinto Primavera. IfResourceCodeshavethecheckboxmarkedonintheConfigurationscreen,onlycodeslisted undertheapplicableAuthorizedValueslistwillbepermittedintheoutputXERfile.Seethe MaintainingAuthorizedValuessectionearlierinthisdocument. TheClearRowbutton(nearthebottomofthetemplatescreen)willclearthehighlightedrow fromthetemplatesothatitcanberefreshedwiththenextimportoftheoriginalXERfileorto removethatrowfromthetemplateifitnolongerexistsintheoriginalXERfile.
ProvidedbyXENAUtilities.com
Page23
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
vi) CalendarsTab
SelecttheCalendarstabtomodifyorviewtheCalendars.OnceanXERfilehasbeenimported, theCalendarscontainedintheXERfilewillbedisplayedonthistab.TheLeftSectionofthetab showsthevaluesimportedfromtheXERfile.TheRightSectionofthetabshowsthevaluesthat willbeexportedtothenewXERfile. TheNewCalendarcolumnonthefarrightshowshowtheCalendarwillbewritteninthenew file.TochangeaCalendarortomapittoaCalendarinyourdestinationdatabase,simplyedit thisfieldtobethevaluedesiredorclickonthebuttontomaintainand/selectthe predefinedlistofcalendars.Alternativelyaprefixcanbeassignedtoallthecodesusingthe functionalityontheGeneraltab.
TheActionscolumninthemiddledisplaystheactionthatwillbeperformedontheCalendar duringprocessing.Thiswillupdateautomaticallywhenchangesaremadetoanyofthecolumns intherightsectionoritcanbechangedmanually. Sometabs(suchastheActivityCodetab)donotallowduplicatesintheNewValuecolumn however,theCalendarstabdoesallowduplicatesinNewCalendarcolumn.Ifthiscolumnhas duplicates,P6willmergethecalendarsduringimport. IfCalendarshavethecheckboxmarkedonintheConfigurationscreen,onlycodeslistedunder theapplicableAuthorizedValueslistwillbepermittedintheoutputXERfile.Seethe MaintainingAuthorizedValuessectionearlierinthisdocument. TheClearRowbutton(nearthebottomofthetemplatescreen)willclearthehighlightedrow fromthetemplatesothatitcanberefreshedwiththenextimportoftheoriginalXERfileorto removethatrowfromthetemplateifitnolongerexistsintheoriginalXERfile.
ProvidedbyXENAUtilities.com
Page24
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
vii)
UDFTypesTab(UserDefinedFields)
TheActionscolumninthemiddledisplaystheactionthatwillbeperformedontheUDFTitles duringprocessing.Thiswillupdateautomaticallywhenchangesaremadetoanyofthecolumns intherightsectionoritcanbechangedmanually.IftheActionscolumnischangedtoDelete thentheUDFTitlewillbedeletedfromtheXERandwillnotbeimportedintoPrimavera. IfUDFTypeshavethecheckboxmarkedonintheConfigurationscreen,onlycodeslistedunder theapplicableAuthorizedValueslistwillbepermittedintheoutputXERfile.Seethe MaintainingAuthorizedValuessectionearlierinthisdocument. TheClearRowbutton(nearthebottomofthetemplatescreen)willclearthehighlightedrow fromthetemplatesothatitcanberefreshedwiththenextimportoftheoriginalXERfileorto removethatrowfromthetemplateifitnolongerexistsintheoriginalXERfile.
ProvidedbyXENAUtilities.com
Page25
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
viii) UnitofMeasureTab
ClicktheUnitofMeasuretabtomodifyorviewtheUnitsofMeasure.OnceanXERfilehasbeen imported,theUnitsofMeasurecontainedintheXERfilewillbedisplayedonthistab.Oftenan XERfilewillcontainthousandsofunusedUnitsofMeasure.Thisisautomaticallycleanedupby XENA.DuringtheimporttoXENA,theUnitsofMeasurethatareactuallyassignedtoan indentifiedresourcearemarkedasDontChange.Theseidentifieditemswillbesortedtothe topofthedisplay.TheremainingUnitsofMeasurearedefaultedtobeDeleted.Theuser shouldalsonotifythesourceoftheoriginalXERfiletodeletetheunuseddatafromtheUnitsof MeasuretabinPrimaveraontheAdminCategoriesdialogbox. TheLeftSectionofthetabshowsthevaluesimportedfromtheXERfile.TheRightSectionof thetabshowsthevaluesthatwillbeexportedtothenewXERfile. TheNewUnitofMeasurecolumnonthefarrightshowshowtheUnitofMeasurewillbe writteninthenewfile.TochangeaUnitofMeasureortomapittoaUnitofMeasureinyour destinationdatabase,simplyeditthisfieldtobethevaluedesired.Alternativelyaprefixcanbe assignedtoalltheUnitsofMeasureusingthePrefixfunctionalityontheGeneraltab.
ProvidedbyXENAUtilities.com
Page26
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
ix) ResourcesTab
ClicktheResourcestabtomodifyorviewtheResources.OnceanXERfilehasbeenimported, theResourcescontainedintheXERfilewillbedisplayedonthistab.TheLeftSectionofthetab showsthevaluesimportedfromtheXERfile.TheRightSectionofthetabshowsthevaluesthat willbeexportedtothenewXERfile. TheNewResourceShortNamecolumnonthefarrightshowshowtheResourceIDwillbe writtenintheoutputXERfile.TochangeaResourceIDortomapittoaResourceIDinyour destinationdatabase,simplyeditthisfieldtobethevaluedesired.Alternativelyaprefixcanbe assignedtoallthecodesusingthefunctionalityontheGeneraltab.
ProvidedbyXENAUtilities.com
Page27
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
Sometabs(suchastheActivityCodetab)donotallowduplicatesintheNewValuecolumn however,theResourcestabdoesallowduplicatesinNewResourceShortNamecolumn.If thiscolumnhasduplicates,P6willmergetheresourcesforyouduringimport. TheClearRowbutton(nearthebottomofthetemplatescreen)willclearthehighlightedrow fromthetemplatesothatitcanberefreshedwiththenextimportoftheoriginalXERfileorto removethatrowfromthetemplateifitnolongerexistsintheoriginalXERfile. TheSetAllResourcestoDeletebuttonwillmarkallResourcerowsActioncolumntoDelete. IfResourceshavethecheckboxmarkedonintheConfigurationscreen,onlycodeslistedunder theapplicableAuthorizedValueslistwillbepermittedintheoutputXERfile.Seethe MaintainingAuthorizedValuessectionearlierinthisdocument.
x) NotebooksTab
ClicktheNotebookstabtomodifyorviewtheNotebookTopics.OnceanXERfilehasbeen imported,theNotebookscontainedintheXERfilewillbedisplayedonthistab.TheLeftSection ofthetabshowsthevaluesimportedfromtheXERfile.TheRightSectionofthetabshowsthe valuesthatwillbeexportedtothenewXERfile.TheNewMemoTypecolumnonthefarright showshowtheNotebookTopicwillbewritteninthenewfile.TochangeaNotebookTopicor tomapittoaNotebookTopicinyourdestinationdatabase,simplyeditthisfieldtobethevalue desired.Alternativelyaprefixcanbeassignedtoallthecodesusingthefunctionalityonthe Generaltab.
ProvidedbyXENAUtilities.com
Page28
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
ProvidedbyXENAUtilities.com
Page29
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
5) RemoveFunction
AttimesthereisaneedtoremovecertainselectedtypesofdatafromanXERfilebeforeitis giventoanotherareaoranotherorganization.WiththeXENAXERtooluserscanselectfroma listofremoveoptions.Whenoneormoreoftheremoveoptionsarechecked,XENAXERwill removetheassociatedinformation.Somesettingsautomaticallycheckoruncheckother settingstoensuredataintegrity. RemoveOptionsinclude: a.RemoveActivityProgress b.RemoveActivitySteps c.RemoveActivityRelationships d.RemoveActivityUnits(selecteitherActual,Planned,Remaining,orall) e.RemoveActivityCosts(selecteitherActual,Planned,Remaining,PricePerUnit,orall) f.RemoveExpenses(selecteitherActual,Planned,Remaining,PricePerUnit,orall) g.RemoveOtherCosts(selecteitherResourceRates,RoleRates,UDFCosts,orall) h.RemoveBudgets(selecteitherBudgetLog,SpendingPlans,FundingSources,CurrentBudget orall) i.RemoveTimesheets j.RemoveRoles
ProvidedbyXENAUtilities.com Page30
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
RemovePrimaveraFieldChart
Thefieldchartbelowisaguideforimpactofthevariouscheckboxselectionswithintheremoval function. PrimaveraFieldsAffected Checkbox RemoveActivityProgress [Whenthischeckboxisselected,RemoveActivity Units/Remaining&ActualplusRemoveActivityCosts/Remaining& Actualarecheckedseefieldsdetailedbelow]
RemoveActivitySteps
ProvidedbyXENAUtilities.com
Page31
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
valuesdonotdisplay)*RemainingNonlaborUnits(maydisplay BudgetedNonlaborUnits,canalsoselectRemoveActivity Units/Plannedifnotcheckedtoassurevaluesdonotdisplay)[Whenthis checkboxisselected,RemoveActivityCosts/Remainingisalsoselected.]
RemoveActivityUnits/Actual *ActualLaborUnits*ActualNonlaborUnits*ActualThisPeriod LaborUnits*ActualThisPeriodNonlaborUnits[Whenthischeckboxis selected,RemoveActivityCosts/Actualisalsoselected.] RemoveActivityCosts [Whenthischeckboxisselectedall4checkboxesinthissection areselected.] RemoveActivityCosts/Planned *BudgetedMaterialCosts*BudgetedNonlaborCosts *BudgetedLaborCosts(all3maydisplayvalueswithremoveselected, canalsoselectRemovePriceperUnitstoassurenovaluesdisplay) RemoveActivityCosts/Remaining *RemainingLaborCostand*RemainingMaterialCost(may displayvalueswithremoveselected,canalsoselectRemoveActivity Costs/PriceperUnitsifnotcheckedtoassurevaluesdonotdisplay) *RemainingNonlaborCosts(maydisplayBudgetedNonlaborCosts,can alsoselectRemoveActivityCosts/Plannedifnotcheckedtoassure valuesdonotdisplay) RemoveActivityCosts/Actual *ActualLaborCost*ActualMaterialCost*ActualNonlaborCost (all3maydisplayvalueswithremoveselected,canalsoselectRemove ActivityUnits/Actualtoassurenovaluesdisplay) RemoveActivityCosts/PriceperUnit *Price/Unit RemoveExpenses [Whenthischeckboxisselectedall4checkboxesinthis sectionareselected.] RemoveExpenses/Planned *BudgetedExpenseCost RemoveExpenses/Remaining *RemainingExpenseCost RemoveExpenses/Actual *ActualExpenseCost(maydisplayvalueswithremoveselected, canalsoselectRemoveExpense/PriceperUnittoassurenovalues display) RemoveExpenses/PriceperUnit *Price/Unit RemoveOtherCosts [Whenthischeckboxisselectedall3checkboxesinthis sectionareselected.] RemoveOtherCosts/Resourcerates *Price/Unit(Resources){Override/CustomRatesarenot removedunlessActivityCostsPriceperUnitarealsoremoved.} RemoveOtherCosts/RoleRates *Price/Unit(Roles){Override/CustomRatesarenot removedunlessActivityCostsPriceperUnitarealsoremoved.} RemoveOtherCosts/UDFCosts *ActivitiesUserDefinedFieldswhereDataTypeequalsCost RemoveBudgets [Whenthischeckboxisselectedall4checkboxesinthis sectionareselected.] RemoveBudgets/BudgetLog *AllentriesintheBudgetLogtabofProjectDetails RemoveBudgets/SpendingPlans *AllentriesintheSpendingPlantabofProjectDetails RemoveBudgets/FundingSources *AllentriesintheFundingtabofProjectDetails RemoveBudgets/CurrentBudget *AllCurrentBudgetfieldintheBudgetLogandBudget SummarytabsofProjectDetails RemoveTimesheets *Timesheetentries RemoveRoles *AllRoleAssignments
ProvidedbyXENAUtilities.com
Page32
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
NoteaboutRemovalFunction:
Primaveraisasophisticatedapplicationmanyinterrelatedfieldsandcalculationsthatareaffectedby settingsatavarietyoflevels.Somefieldrelationshipsmaynotbeobviousatfirstglancesuchasthe examplebelow.Wemadenoattemptheretodocumentallsuchrelationshipsasitisbeyondthescope ofthisdocument.Pleasecontactuswithanyquestions. Anexampleofanotsoobviousrelationshipis:IfthecheckboxActivitypercentcompletebasedon activitystepsintheProjectCalculationstabischecked,Activity%willnotbereducedto0%bythe RemoveActivityProgressselectioninXENAunlessRemoveActivityStepsisalsoselected.
DataRemovalDisclaimer:
IfyouhavesensitiveinformationthatmustberemovedfromanXERfile,testtheRevisedXERfileafter outputfromtheutilitytoassuresensitiveinformationisnotdisplayedviatherevisedXERfile.Donot relyonlyonthedocumentationaboveaswecannotpredictwhichsettingsareinuseorwhatdataisin yourdatabase.
ProvidedbyXENAUtilities.com
Page33
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
6) RecommendedImportSettingsinPrimavera
ProvidedbyXENAUtilities.com Page34
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
AppendixA,XENASupport
TechnicalSupport:
PaulCiszewski Phone:(920)8839048 Email:paul@dynamicconsulting.net
ApplicationSupport:
TerrySchaefer Phone:(618)9791114 Email:tschaefer@acceleratedpm.com Or TomBrannan Phone:(940)7364888 Email:tbrannan@acceleratedpm.com
ProvidedbyXENAUtilities.com
Page35
September23,2010
[XENAXERIMPORTUTILITYUSERGUIDEV1.2]
AppendixB,PrimaveraTechnicalTermsandTheirTitles
Introduction InsomeareasoftheXENAXERImportUtilitythetechnicaltermisusedwhichmaycauseconfusion. Thistablewillserveasaquickreferncebetweenthetechnicaltermsandthetitlesasshownin Primavera. TechnicalTermandlocationusedinXENA TitleinPrimavera AS_EPS,ActivityCodestab ActivityCodeScopeofEPS AS_Global,ActivityCodestab ActivityCodeScopeofGlobal AS_Project,ActivityCodestab ActivityCodeScopeofProject CA_Base,Calendartab CalendarScopeofGlobal CA_Project,Calendartab CalendarScopeofProject CA_Rsrc,Calendartab CalendarScopeofResource DOCUMENT WorkProductsandDocuments MemoType,Notebookstab NotebookTopic PROCITEM,TableNameinUDFTypestab ActivityStepItems PROJCOST,TableNameinUDFTypestab ProjectExpenses PROJECT,TableNameinUDFTypestab Project PROJISSU,TableNameinUDFTypestab Issues PROJRISK,TableNameinUDFTypestab Risks PROJWBS,TableNameinUDFTypestab WBS(WorkBreakdownStructure) RSRCTableName,TableNameinUDFTypestab Resource TASK,TableNameinUDFTypestab Activities TASKPROC,TableNameinUDFTypestab ActivitySteps TASKRSRC,TableNameinUDFTypestab ActivityResourceAssignments UsedinRSRC,UnitofMeasuretab UsedinResourcetable UDFTypes,variouslocations UserDefinedField
ProvidedbyXENAUtilities.com
Page36