You are on page 1of 13

V

File Manager 22.2 Release Notes January 2013

Fileman/ Lab Agile Project

Copyright2013byVISTAExpertiseNetwork.LicensedunderCreative CommonsAttributionShareAlike3.0.Detailsareavailableat http://creativecommons.org/licenses/bysa/3.0/. UpdateHistory: October2012:FirstVersionwrittenbyKathyIce January2013:UpdatedbasedontestingandcomparisonwithlatestFOIA bySamHabiel.

ReleaseNotes

File Manager 22.2 Release Notes


1. Principal Enhancements
1.1. Screenman Enhancements
1.1.1. Use of Mouse in Screenman Forms TouseyourmousewithScreenmanforms,yourterminalemulatorneedsto beabletoreceiveANSIstandardcontrolsequencestoturnthemouseon andoff.Setupyourterminalemulatorsothatthekeyboardemulationisin VT100+mode.OnceyouareinaScreenmanform,clickthemouseatthe commandlineoranyofthefieldsintheform. IfyoudonotwantScreenmantorecognizemouseclicks,usetheKernel parameter(createdbyrunning^DINIT)thatisnamedDISCREENMAN NOMOUSE. 1.1.2. Record Selection as a Full Screenman Page TheScreenmanRecordSelectionpagecannowbeafullScreenmanpage usingacomputedmultiplepointer,sothattheusercanselectanentryby scrollingupordown.Thisnewfeatureletsformscontainembedded lookups. Youcansetthisupautomaticallywhenyoucreateaform.AtthequeryDo youwantyourFormtobeginwithadisplayofallentries,forselection, answerYes.Theinitialpositioncanbesettobetheuserslastselection, ratherthanfirst,last,ornew.

Fileman22.2

January2013

ReleaseNotes

1.1.3. Expanded Multiples MultipleswithinasingleScreenmanpagecannowbemorethanoneline deep. 1.1.4. Custom Colors Option TheCustomizeColorssuboptionwithinScreenmanallowsselectionof ANSIcolorsforallScreenmanpresentations,onaparameterizedbasis (user,institution,etc.)usingKernelparameters. 1.1.5. Quick Exit from Word Processing Pages EditingaScreenmanwordprocessingpageendswithtwoemptylines,so that"F1E"isnotrequiredtoleavethepage. 1.1.6. Indication of Word-processing Data A+nowindicatesinaScreenmanformwhetherawordprocessingfield alreadycontainsdata. 1.1.7. Screen Print F1Pallowsprintingofthescreen(includingallmultiples).

1.2. Internationalization
1.2.1. Fileman is Translation-ready AllhardcodeddisplaystringsinFileManagerhavebeenconvertedtothe FilemansDialogframework,sotranslationcanbetabledriven.

January2013

Fileman22.2

ReleaseNotes

1.2.2. New Entries in Dialog File (.84) ManynewentrieshavebeenaddedtotheDialogfiletohandleallenduser interactions. 1.2.3. Many New Languages in File .85 TheLanguageFile(.85)cannowbeextendedbyrunning^DMLAINITto includeallISO639standardlanguages. 1.2.4. New Dialog Framework for Data Dictionary Elements Filenames,fieldlabels,setvalues,andhelpmessagescanbeenteredinto the^DDschemaforanyofthelanguageslistedinFile.85. 1.2.5. New Entry Points to Help Translate DD Elements NewdirectmodetoolshavebeencreatedtohelptranslateDDelements. Forexample,toenterSpanish:DOSPANISH^DIALOGZorDO LANG^DIALOGZ(3). 1.2.6. Consistent Date Formatting Formattingofdateoutputisnowconsistentlydonethroughoutalltheend userroutines.Changingtheglobalnode^DD(DD)willchangetheway allFilemandatesareoutput.Rerunning^DINITwillnotchangethisnode. 1.2.7. International Date Input Filemansinternationalizationframeworkhasbeenextendedtoimprove supportforinternationaldates.Internationaldateinput(Iparameter) allowsalphadatesandformssuchas2010131,20100131,and31Jan 2010.

Fileman22.2

January2013

ReleaseNotes

1.2.8. Upper/Lowercase Translations are Consistent Filemansinternationalizationframeworkhasbeenmadeconsistently independentoftheASCIIcharacterset,toimprovesupportfor internationalcaseconversion. 1.2.9. Two- and Three-letter Language Abbreviations TheLanguagefile(.85)nowcanstoretwoandthreeletterabbreviationsfor languages.

1.3. Data Analysis Tools


1.3.1. Check all Pointers into a Given File AfourthDataDictionaryutility(findpointersintoafile)checksallfiles withpointersintoagivenFile.Theutilitygives4kindsofoutput(here usingPatientfile(2)asanexample):
1 2 3 4 Template One particular PATIENT Entry All PATIENT Entries Non-existent PATIENT Entries Entries from a PATIENT Search

1.3.2. Automatic Auditing Toimproveversioncontrolfordatadictionaries,DDchangesarealways audited(inFile.6).ThereisnoneedtoturnonDDauditingfilebyfile. 1.3.3. Showing Past Changes to Data Dictionary TheShowPastChangestoDDsauditingsuboptionshowsallDD changessinceacertaindate.

January2013

Fileman22.2

ReleaseNotes

1.3.4. Showing Changes by a Specific User MonitoraUserisnowthesecondauditingoption.Itshowseveryentry inanauditedfiletouchedbyagivenuserinanauditedfile. 1.3.5. Modified Auditing Menu Theauditingmenuhasbeenmodifiedtobebetterorganizedandmore intuitive. 1.3.6. Entry Access Audit TheentrypointACCESSED^DIETwillrecordaccesstoafileentryinthe auditfile.PreviouslyFilemancouldonlyrecordauditsforadded, modified,ordeletedfields.Nowitcanrecordaccesstoaspecificentryina file. 1.3.7. The Meta Data Dictionary Run^DDDduringFilemaninstalltocreatethenewMetaDataDictionary file(.9).TheMetaDataDictionarylistsallfieldsinallfilesinasearchable format. 1.3.8. Improvements to the Verify Fields Utility TheVerifyFieldutilityhashadmanyimprovements.Itnowlooksfor duplicatesanddanglingpointersincrossreferences.Ithasbeenmade interruptible.IfafieldhasanOutputTransform,itisnowvalidatedto makesureitproducesvalidinputthatwouldbeacceptedbythefields InputTransform.Itdoublechecksthirtycharacterlimitindexvaluesto makesuretheyareproperlyextractedandset.Itdisplaysthetranslated fieldlabel,ifany.Abugwasfixedtosuppresstheaccidentalechoofdates whenverifyingadatetypefield.

Fileman22.2

January2013

ReleaseNotes

1.3.9. Comparing Data and Data Dictionaries across Environments AnewTransfermenuoption,NamespaceCompare,letsyouidentify differencesindataandDDsbetweendifferentMUMPSenvironments,to helpwithversioncontrol. 1.3.10. New Verify Pointers Option TheVerifyFieldsoptionhasbeenconvertedintoanewVerifyDatamenu, whichcontainsVerifyFieldsandanewVerifyPointersoption.Verify Pointerswillfindandreportdanglingandbadlydefinedpointers.

2. Other Enhancements
2.1. User Interface Changes
2.1.1. Select Prompt: Extended Selection by IEN Lookupenhancement:ifthe.01fieldofthefilebeingselectedfromisa pointertoanotherfile,youcanuseadoubleaccentgrave(``)topicka pointedtoentrybyitsIEN. 2.1.2. Allow Terminal Emulators Deeper Than 24 Lines Filemannowsupportslongerscreens. 2.1.3. Printing Multiples in Sorted Order Untilnow,whenprintingsortedrecords,anysubentrieswithinthose recordsweredisplayedunsorted,inorderbyinternalentrynumber.Anew Bprintspecifierwillensurethatsubentriesaredisplayedinorder.

January2013

Fileman22.2

ReleaseNotes

2.1.4. Enhanced Control of Input Templates Withininputtemplates,subfilescannowbeeditedinmorethanoneplace withinthetemplate,sothatdifferentsubfieldscanbeeditedeachtime. 2.1.5 Fileman Browser Enhancements Filemanwillbeoptimisticandassumetheterminalemulatorsupportsthe browser,ratherthanconsulttheKernel. YoucannowquitthebrowserusingCTRLE. YoucannowprintthetextbeingbrowsedusingF1F1P.

2.2. API Changes


2.2.1. Enhancements to FIND^DIC and LIST^DIC 1)Thirdargument(fields)cannowbeacomputedexpression,notjusta field. 2)NewEflagreturnsthecompletelistofmatcheseveniferrorsare encounteredduringthegenerationoftheresults. 3)Eighthparameter(index)ofLIST^DICcannowbeeitherasorttemplate orafieldoracomputedexpression,ifthenewXflagisincluded. 2.2.2. New API to Create Sort Templates Silently BUILDNEW^DIBTEDwillsilentlycreateasorttemplate.

Fileman22.2

January2013

ReleaseNotes

2.3. Data Dictionary Changes


2.3.1. Auditable Word Processing Fields Filemansecurityhasbeenimprovedbyallowingwordprocessingfieldsto beaudited. 2.3.2. Word Processing Fields Can be Made Uneditable Referencefilesandclinicallysignificanttextcannowbeprotectedfrom subsequentchange. 2.3.3. Set Explicit Maximum Length for Free-text Fields MaximumFieldLengthisnowanindependentfieldattribute,notjusta sideeffectofthecodecontainedinthefieldsInputTransform. 2.3.4. Override of Character Limit in Globals ^DD(STRING_LIMIT),ifset,overridesthestandard255characterlimit throughoutFileManager. 2.3.5. Set Cross-references as Non-re-runnable Crossreferencescanbedefinedsothattheyareneverrefiredaftertheir initialexecution(Remedyticket#447336).

2.4. Installation and Distribution Changes


2.4.1. DIFROM: Keys and New-style Indexes DIFROMhasbeenextendedtobeabletotransportkeysandnewstyle indexes.

January2013

Fileman22.2

ReleaseNotes

2.4.2. DINIT: Virgin Install Filemanhasbeenchangedtorestoreitsabilitytoruncorrectlywithoutany oftherestofVISTAbeinginstalled.

3. Bug Fixes
3.1. Computed Expressions: Multiple Contains with Word-processing Fields Thecomputedexpression(WP1["GREEN")!(WP2["GREEN")isnow correctlyhandled(whereWP1andWP2arenamesofWordprocessing fields). 3.2. Lookup: Input Value Longer Than 30 Characters Lookupswithinputvalueslongerthan30charactersnowworkcorrectly. 3.3. Cross-reference a Field or File: Duplicate Index Names Duplicateindexnamesarenolongerallowed. 3.4. Uppercasing FilemanuppercasingcodeinDILIBFisnowUserLangaugeaware. PreviouslyitworkedonlyforEnglishonly. 3.5. Captioned Fields in Screenman when language isn't English Filemandidn'tallowyoutocreateaCaptionOnlyfieldinScreenman EditorwhentheUserLanguageisn'tEnglish.Thishasbeenfixed. 3.6 DIFROM Maximum Routine Size DIFROMdidn'tuse^DD(ROU)todeterminethemaximumroutinesize, butratherhadithardcodedto9999.
Fileman22.2 January2013

10

ReleaseNotes

3.7 DIFROM Routine size calculation DIFROMdidn'tcorrectlycountthesizeofroutinesitcreatedmaking routineslargerthanthemaximumsize. 3.8 Browser display routines didn't work on Cache DR^DDBRUdidn'tworkonCacheduetotheway%RSELworksonCache. 3.9 Maximum routine size did not get set with the first installation of Fileman. Thenode^DD(ROU)doesnotgetinitializedwheninstallingFilemanfor thefirsttime. 3.10 Browser now works without Kernel TheFilemanBrowsernowworkswithoutthedevicefileandcanbe invokedfromFilemandirectly. 3.11 Replace/With Maximum Length Thereplacepromptonlysupportedinputupto245characterslong.Nowit supportsanylengthupto^DD(STRING_LIMIT) 3.12 Reverse collation on Complex New Style Indexes when doing partial matches Previously,acompoundnewstyleindexconfiguredtosortinreverseorder stillsortedinforwardorderuponpartialmatchesevenwhenitsortedin reversewhenlistingentriesusing??.Now,itwillcorrectlysortinreverse orderwhendisplayingpartialmatches. 3.13Uflagon^DICandQflagonLIST^DICandFIND^DICandpartial numericmatchesonpointervalues Previously,usingtheUflagon^DICandtheQflagonDBSDICcalls
January2013 Fileman22.2

ReleaseNotes

11

causednumericmatchesonpointerfieldstobepartiallymatchedalatext matches.Now,partialnumericmatchesarenotallowedinthese circumstances.

4. Unit Tests
Fileman22.2comeswithUnitTestsforclassicaldate/timecallsandnew featuresoftheDBSLISTERandFINDER.Allunittestsareunderthe namespaceDMU.

Fileman22.2

January2013