ModusOne ModusOne MOT Version: 5 .2
Written by: Product Documentation, R&D Date: February 2013
© 2012 Perceptive Software. All rights reserved ModusOne is een handelsmerk van Lexmark International Technology SA dat is gedeponeerd in de V.S. en andere landen. Perceptive Software is een zelfstandige businessunit van Lexmark International Technology SA. Alle andere merken en productnamen die worden genoemd in dit document, zijn handelsmerken of gedeponeerde handelsmerken van hun respectieve eigenaren. Geen enkel onderdeel van deze publicatie mag zonder voorafgaande schriftelijke toestemming van Perceptive Software worden gereproduceerd, opgeslagen in een systeem voor het ophalen van gegevens of verzonden in welke vorm of op welke manier dan ook, waaronder op elektronische of mechanische wijze, of door middel van fotokopieën, opname of andere bestaande of toekomstige media.
Inhoud Voorwoord ................................................................................................................................................. 1 Functies ..................................................................................................................................................... 1
AssignBundleRef ................................................................................................................................... 1 AssignDocumentRef .............................................................................................................................. 1 CompilePrinter ....................................................................................................................................... 2 CreateValuehelp..................................................................................................................................... 2 ExportDocx ............................................................................................................................................ 3 FindScript............................................................................................................................................... 3 FindTrailingEmptyParagraph ................................................................................................................. 4 ImportDocx ............................................................................................................................................ 4 PatchCondition ...................................................................................................................................... 5 RebuildProcessRef ................................................................................................................................ 5 ReplaceGetObject ................................................................................................................................. 5 ReplaceScript ........................................................................................................................................ 6 ReportDataLinkCSV ............................................................................................................................... 7 ReportDocument ................................................................................................................................... 7 ReportUsedBlock .................................................................................................................................. 8 SearchDocx ........................................................................................................................................... 8 RtfScan .................................................................................................................................................. 9
iii
Voorwoord Met de MOT-opdrachtregeltool MOT.exe kunt u ModusOne-objecten op verschillende manieren bewerken. Elke functie wordt aangeroepen met de waarde die wordt opgegeven voor de parameter Cmd.
Functies AssignBundleRef Wijs een script toe aan een opgegeven gebeurtenis van alle bundelobjecten in een opgegeven modussysteem. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
AssignBundleRef
Property
Interne naam van de eigenschap Mogelijke waarden:
Script
•
AfterCreateDocumentsEvent
•
AfterDataSelectionEvent
•
BeforeCreateDocumentsEvent
•
BeforePrintAndArchiveEvent
•
BeforePrintDocumentEvent
•
OnInitializeDocumentCreationEvent
•
OnInitializePrintAndArchiveEvent
Naam van een script
Voorbeeld De volgende opdrachtregel wijst het script PrintArchive toe aan de gebeurtenis BeforePrintAndArchive voor alle bundels van het modussysteem met oid mytest. mot.exe -SysOId:mytest -Cmd:AssignBundleRef property:beforeprintandarchiveevent -script:PrintArchive
AssignDocumentRef Wijs een script toe aan een opgegeven gebeurtenis van alle tekstdocumentobjecten in een opgegeven modussysteem.
1
De MOT-opdrachtregeltool MOT.exe
Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
AssignDocumentRef
Property
Interne naam van de eigenschap Mogelijke waarden:
Script
•
LoadEvent
•
UnloadEvent
Naam van een script
Voorbeeld De volgende opdrachtregel wijst het script OnDocLoad toe aan de gebeurtenis OnLoad voor alle bundels van het modussysteem met oid mytest. mot.exe -SysOId:mytest -Cmd:AssignDocumentRef -property:loadevent script:OnDocLoad
CompilePrinter Hiermee worden alle printertypen in een systeem gecompileerd. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
CompilePrinter
Voorbeeld mot.exe -sysoid:mytest -Cmd:CompilePrinter
CreateValuehelp Leest een bepaald import-xml-bestand en maakt voor elk xml-element z:row (XPath: /xml/rs:data/z:row) een valuehelp-item in de opgegeven Modus-opslagplaats. Als een valuehelp-object in het xml-bestand al bestaat in de opslagplaats, wordt geen actie uitgevoerd. Parameters Parameter
Betekenis
2
De MOT-opdrachtregeltool MOT.exe
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
ImportFile
De naam van het xml-bestand met de valuehelp die moet worden gemaakt
Cmd
CreateValuehelp
Voorbeeld mot.exe -sysoid:mytest -Cmd:CreateValuehelp ImportFile:"c:\myfiles\Valuehelps.xml"
ExportDocx De docx-bestanden exporteren van alle documenten-/tekstcomponenten van een opgegeven modussysteem. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
ExportDocx
Dir
De map waarnaartoe de docx-bestanden worden weggeschreven
Voorbeeld De volgende opdrachtregel exporteert alle docx-bestanden van het modussysteem met oid mytest naar de map c:\temp\docx. mot.exe -SysOId:mytest -Cmd:ExportDocx -Dir:c:\temp\docx
FindScript Hiermee zoekt u in de inhoud van een script naar naar de opgegeven reguliere expressie. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
FindScript
Eigenschap
Reguliere expressie die wordt gezocht
Voorbeeld
3
De MOT-opdrachtregeltool MOT.exe
De volgende opdrachtregel zoekt alle scripts met de methodeaanroep xxx.DateStringToInt() of xxx.IntDateToString(). mot.exe -SysOId:mytest -Cmd:FindScript RegEx:"\w+[.](DateStringToInt|IntDateToString)\s*\("
FindTrailingEmptyParagraph Hiermee zoekt u naar lege laatste alinea's in blokdocumenten. Na migratie uit Modus 4 kan in dergelijke documenten aan het einde een lege alinea staan vanwege een fout in M-LZ-M. Omdat die fout niet voorkomt in de opvolger daarvan, EmptyLine, is de extra lege alinea niet meer nodig. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
FindTrailingEmptyParagraph
Count()
Geeft het aantal lege alinea's aan het einde aan
EmptyLineOnly
Geef alleen blokken weer die zijn ingesloten in een opdracht EmptyLine
Voorbeeld mot.exe -sysoid:mytest -Cmd:FindTrailingEmptyParagraph -Count:2 EmptyLineOnly:true
ImportDocx Hiermee importeert u alle docx-bestanden in een map terug in het opgegeven modussysteem. De docx-bestanden kunnen alleen worden geïmporteerd in hetzelfde systeem waaruit ze zijn geëxporteerd. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
ImportDocx
Dir
De map waaruit de docx-bestanden worden opgehaald
Voorbeeld
4
De MOT-opdrachtregeltool MOT.exe
De volgende opdrachtregel importeert alle docx-bestanden in de map c:\temp\docx in het modussysteem met oid mytest. mot.exe -SysOId:mytest -Cmd:ImportDocx -Dir:c:\temp\docx
PatchCondition Hiermee vervangt u de methode SelVariable door de nieuwe methode SelVariableEx in alle voorwaarden in het opgegeven systeem. Opmerking Gebruik deze functie alleen bij migratie van modus 4. Controleer of het echt noodzakelijk is om deze functie uit te voeren. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
PatchCondition
Voorbeeld De volgende opdrachtregel vervangt SelVariable door SelVariableEx in alle voorwaarden van het modussysteem met oid mytest. mot.exe -SysOId:mytest -Cmd:PatchCondition
RebuildProcessRef Hiermee maakt u alle verwijzingen naar een procesobject in de database opnieuw. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
RebuildProcessRef
Voorbeeld mot.exe -sysoid:mytest -Cmd:RebuildProcessRef
ReplaceGetObject Hiermee zoekt u in de inhoud van een script naar een specifieke methode en vervangt u die door een nieuwe methode.
5
De MOT-opdrachtregeltool MOT.exe
Zo nodig wordt ook een nieuw GetObject() toegevoegd en/of het oude GetObject() verwijderd. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
ReplaceGetObject
OldMethod
De methode van het object die moet worden vervangen
OldObject
Naam van de oude ActiveX-bibliotheek, bijv. MSLCalendar.Date
NewMethod
De methode van het nieuwe object
NewObject
Naam van het nieuwe MonaLisa-object, bijv. MLDate
Voorbeeld De volgende opdrachtregel vervangt in alle scripts de methodeaanroep xxx.DateStringToInt() door xxx.DateStringToInt64(). Bij het vervangen van methoden wordt ook het oude GetObject("xxx","MSLCalendar.Date") verwijderd als het bestaat, en/of wordt zo nodig een nieuw GetObject("xxx", "MLDate") toegevoegd. mot.exe -SysOId:mytest -Cmd:ReplaceGetObject -OldMethod:DateStringToInt OldObject:MSLCalendar.Date -NewMethod:DateStringToInt64 -NewObject:MLDate
ReplaceScript Zoeken en vervangen in alle scripts. Hiermee zoekt u naar een reguliere expressie en vervangt u die door een andere string. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
ReplaceScript
Old
Reguliere expressie die wordt gezocht (oude tekst)
New
Vervangende string voor de gevonden reguliere expressie
Casesensitive
Geeft aan of bij het zoeken al dan niet rekening moet worden gehouden met het verschil tussen hoofdletters en kleine letters Mogelijke waarden:
6
De MOT-opdrachtregeltool MOT.exe
True/False Voorbeeld De volgende opdrachtregel vervangt in alle scripts de exacte string 'mm.dd.yyyy' door 'MM.dd.yyyy'. Tip: Gebruik escape-tekens voor '.' omdat de punt anders wordt geïnterpreteerd als een joker voor een 'willekeurig teken'. mot.exe -sysoid:mytest -cmd:ReplaceScript -old:mm\.dd\.yyyy -new:MM.dd.yyyy casesensitive:true
ReportDataLinkCSV Hiermee maakt u een csv-rapportbestand met voor ieder document in het opgegeven systeem de informatie over gegevensbinding van tekstblok en tekstvariabele. Bovendien worden alle scripts/voorwaarden die gebruikmaken van de Monalisa-methoden SelVariable()/SelVariableEx() toegevoegd aan het rapport. Variabelen van tekstblokken die dynamisch worden ingevoegd met behulp van lookuptabellen, enz., worden niet in het rapport opgenomen. Het csv-bestand wordt gemaakt in de map 'Mijn documenten' van het Windows-account dat actief is, in standaardcodering van het Windows-systeem (in West-Europa: Windows 1252). Het gegenereerde bestand heeft voor de toegang van objecten tot het gegevensmodel een regel met de volgende indeling: naam van het document;objecttype;objectnaam;gegevensbron;datalink;attributeName Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
ReportDataLinkCSV
Voorbeeld mot.exe -sysoid:mytest -Cmd:ReportDataLinkCSV
ReportDocument Hiermee maakt u een rapport in een tekstbestand van een opgegeven document met alle attributen van de erin opgenomen tekstblokken en variabelen. Tekstblokken en variabelen die dynamisch worden ingevoegd worden niet in het rapport opgenomen! Het bestand wordt gemaakt in de map 'Mijn documenten' van het Windows-account dat actief is, met de naam van het document als bestandsnaam.
7
De MOT-opdrachtregeltool MOT.exe
Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Doc
De naam van het document
Cmd
ReportDocument
Voorbeeld mot.exe -sysoid:mytest -doc:Example_Document -Cmd:ReportDocument
ReportUsedBlock Hiermee maakt u een rapportbestand met alle documenten in het opgegeven systeem waarin tekstblokken zijn gebruikt. Alleen tekstblokken in hiërarchie van het document worden opgenomen. Tekstblokken die dynamisch worden ingevoegd met behulp van lookuptabellen worden niet in het rapport opgenomen. Het bestand wordt gemaakt in de map 'Mijn documenten' van het Windows-account dat actief is. Het gegenereerde bestand heeft regels met de volgende indeling: document_name;text-block_name Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
Cmd
ReportUsedBlock
Voorbeeld mot.exe -sysoid:mytest -Cmd:ReportDataLinkCSV
SearchDocx Hiermee zoekt u in de xml van alle docx-bestanden in een modussysteem naar de opgegeven reguliere expressie. Parameters Parameter
Betekenis
SysOId
Hiermee wordt de object-ID aangegeven van het gebruikte modussysteem
8
De MOT-opdrachtregeltool MOT.exe
Cmd
SearchDocx
RegEx
Reguliere expressie die wordt gezocht
Voorbeeld De volgende opdrachtregel zoekt in de xml van alle docx-bestanden in het modussysteem met oid mytest naar de string '@v' of '@b'. mot.exe -SysOId:mytest -Cmd:SearchDocx -RegEx:"@v|@b"
RtfScan Hiermee scant u alle RTF-bestanden in een bepaalde map op overbodige M-LZ-M-opdrachten, bijv. MLZ-M helemaal aan het begin van een alinea of als enige element in een alinea. Parameters Parameter
Betekenis
Cmd
RtfScan
Dir
De map waarin het RTF-bestand is opgeslagen
Voorbeeld mot.exe -Cmd:RtfScan -Dir:D:\Documents\RTFFiles
9
Index C
RTF-bestanden .................................................. 9
CompilePrinter ................................................... 2
S
csv-rapportbesetand ......................................... 7
Scripts toewijzen aan gebeurtenissen ............... 1
D
SelVariable ......................................................... 5
docx-bestanden ............................................. 3, 4
SelVariableEx ..................................................... 5
docx-bestanden exporteren .............................. 3
X
docx-bestanden importeren .............................. 4
XML .................................................................... 2
O
Z
Objectverwijzingen opnieuw maken .................. 5
Zoeken ............................................... 3, 4, 5, 6, 8
R Rapport .......................................................... 7, 8