Clip Manager 3 Manual Win
Contents
1. Script idz 1 name My Script includelnhdenuz True runFull amp ccessz False Step idz 87 name Show Custom Dialog enable True gt Title Calculation Clip Manager fCalculation lt Title gt Message Calculation Hello World lt Calculation If Analyze Clips is active which is the default setting the Clip Info pane will show informa tion about the tables fields portals scripts variables and objects that are referenced from the clip Analyze clips is toggled by clicking the info button on the bottom left of the Clip Manager window Page 5 Clip Information Table Occurrences myTable myField 1 Portals Scripts My Script Objects When double clicking an item in the Clip Information window it will be selected in the Clip Contents window Important note due to FileMaker limitations double clicking a portal object to select it is not currently supported The Browser menu shows a number of options create a new folder from the Clip Browser move a file or folder from the Clip Browser to the Recycle Bin reveal the current file or folder selection in Explorer diene History Window Help Mew Folder Ctrl Shift h Delete Folder Ctrl Shift Del Reveal Folder Ckrl Shift R Delete File Ctrl Del Reveal File Ctrl R You can store clips by object type by project etc You could also create separate clips folders e g for2. does this When you write your replacement pattern you can refer to the year only with the variable VI and the letters with M2 If you write d s B C A D BC AD then X2 would contain the matched letters Combining Patterns Much of the power of regular expressions comes from combining these elementary patterns to make up complex searches Here are some examples 0 9 d Matches dollar amounts with an optional dollar sign Page 19 d sB C One or more digits followed by a space followed by B C The Alternation Operator The alternation operator allows you to match any of a number of patterns using the logical or operator Place it between two existing patterns to match either pattern You can use more than one alternation operator in a pattern she s sshe s he or she catldoglpossum cat dog or possum O 9 sB C I 0 9 sA D or Years of the form yearNum B C or A D e g 0 9 s B C I A D 2 175 B C or 215 A D Search and Replace You use special patterns to represent the matched pattern Using replacement patterns you can append or prepend the matched pattern with other text R Contains the entire matched pattern If d d d d sB C finds 1541 B C then the replace ment pattern the year amp results in the year 1541 B C as the amp contains the string 1541 B C M M2 etc Contains the matched subpatterns d
3. myFMbutler Clip Manager 3 User Manual for Windows CM3 1W Dec 08 Table of Contents 1 What does it do 2 2 What do I need 2 3 How dol make this work 2 a Installation 2 b Get FileMaker clipboard information into Clip Manager 2 c Send a Clip Manager clip to the FileMaker clipboard 4 d Using the Clip Browser 5 e Editing a Clip Manager clip 7 f Using the Clip History 8 g Clip Manager Drag amp Drop 9 h About the Clip Manager interface window 10 i Clip Manager Preferences 12 j Clip Manager Advanced Search Regular Expressions 14 4 About the FileMaker clipboard 21 Page 1 1 What does it do myFMbutler Clip Manager is an application that allows you to store FileMaker fields tables scripts script steps custom functions and layouts in an easy to use library You can copy and store objects that have been copied to FileMaker s own clipboard and then re use them later Clip Manager also offers and integrated Find amp Replace that allows you to easily make batch changes to the clippings and then send the updated field script or layout back to FileMaker s clipboard 2 What do I need FileMaker Pro 8 or 9 Advanced or higher on Windows XP SP2 or Windows Vista 3 How do I make this work a Installation Run the Clip Manager Installer The program will be installed in C Program Files myFMbutler myFMbutler Clip Manager 3 Sample Clips will be installed in the user s Documents and Settings at My Documents
4. atara nanemoger 5 meeemeeemesdsamewsme Replacement Patterns Pattern Deeription Replaced with the entire target string before match The entire matched area this is identical to O and 0 Replaced with the entire target string following the matched text 0 50 0 50 evaluate to nothing if the the subexpression corresponding to the number doesn t exist 0 50 Replaced with the character represented by nn in Hex e g is Replaced with the character represented by nn in Octal cX Replaced with the character that is the control version of X e g cP is DLE data line escape Page 15 The basic idea of regular expressions is that it enables you to find and replace text that matches the set of conditions you specify It extends normal Search and Replace with pattern searching Wildcards Some special characters are used to match a class of characters EN Any single character except a line break including a space If you use the as the search pattern you will select the first character in the target string and if you repeat the search you will find each successive character except for Return charac ters The following wildcards match by position in a line Beginning of a line unless used ina Phone Finds lines that begin with character class see below Phone End of a line unless used in a char Finds the last character in the cur acter class rent line Character Classe
5. easy updating of an existing application Page 6 e Editing a Clip Manager clip After performing a Get operation or when you double click a clip in the browser window or use the ctrl down arrow shortcut the clip contents and other information will be shown in Clip Manager s contents and metadata fields Clip Manager provides optional syntax coloring to make the XML more readable and to al low you to make changes more easily This setting can be configured from the Editor tab in Preferences Using Find amp Replace you can easily make changes to the contents of a clip from within Clip Manager You can access the Find menu item from the Edit menu or use the ctrl F shortcut make sure you placed your cursor in the Clip Contents field first o Untitled Chips CipMetory Edo Updstes License Clo Contents d 3 External Editor Notepad exe is the detsut editor but you can change this to any editor notepad exe v Enable Syntax Coloring no 535 mm Strings in Togs SS __ Em Set FileMaker Clipboard CtrieShwt c Open in External Editor Crri Sh t E If you need to make more changes than just a basic Find amp Replace operation select Open in Text Editor from the Edit menu or ctrl shift E to open the current clip in a text editor notepad exe is the default editor but you can change this in the Editor tab in Preferences Most popular editors are supported The
6. editor makes it easy to perform batch change operations on a clipping file You can make the changes then copy paste the information back to Clip Manager and then send the clip ping back to the FileMaker clipboard by clicking Set Page 7 f Using the Clip History Clip Manager s Clip History allows you to automatically store all information you copy in File Maker i e all scripts script steps fields tables and layout elements Whenever you copy some thing in FileMaker Clip Manager will analyze it in the background and add it to a SOLite data base The Clip History contains a number of Smart Folders that should make it easier to quickly find the item you are looking for You can use the Clip History for all kinds of purposes the most obvious being to make sure you have backups when making changes to your solution Instead of the usual duplicating of a script when making changes you can now just hit Copy and work on the original If it turns out you have to go back to the previous version select the script s from the Clip History list in Clip Manager and you can set the FileMaker clipboard to paste it back Window Clip Browser Type TimeStamp Clip History all Today Ns Yesterday 41 Past Week 33 Layout Elements Tables 31 Fields 33 Scripts 33 Script Steps 3 Custom Functions scriptis layout scriptis Field s table s layout lay out 2008 06 16 10 36 39 2008 06 16 10 36 3
7. note when setting Custom functions Because Clip Manager has to drive the user interface to set custom functions keep the follow ing in mind when using this feature e using the keyboard or mouse while Clip Manager is getting the custom function will inter fere and produce unpredictable results e avoid using spaces in custom function names and parameters Clip Manager sometimes has to perform a double click to get to these values and this does not work with strings that have spaces in them Page4 d Using the Clip Browser The Clip Browser will show all clippings that have been stored in the Clip Manager Clips folder The default location of the Clips folder is at My Documents Clip Manager Clips but you can change this in the Preferences Clips tab Clip Browser File Name 3 myProjects Sample Custom Function xmef Apple Sample Fields xmfd FileMaker 3 Sample Clips Sample Layout xmlo Ej Sample Script Steps xmss Sample Scripts xmsc Sample Table xmtb Sample Text txt 5 myFolder Clip History all When you double click or ctrl down arrow a clip in the browser window the clip contents and other information from that file will be shown in Clip Manager s contents and metadata fields You can then use Set to send this clip to the FileMaker clipboard Clip script s Version TimeStamp 20080602 132002 Author Window name Manage Scripts myClipManagerTutorial Comments dummy
8. 3 2008 06 16 10 36 17 2008 06 16 10 35 52 2008 06 16 10 35 41 2008 06 16 10 35 25 2008 06 11 17 05 21 custom Function 2008 06 11 17 04 43 script s 2006 06 11 17 04 35 custom Function 2008 06 11 17 04 01 script s layout 2008 06 11 17 03 57 2008 06 11 17 03 52 custom Function 2008 06 11 17 03 33 layout 2008 06 11 17 03 29 Manage Scripts myClipManagerTutorial myClipManager Tutorial Manage Scripts myClipManager Tutorial Manage Database for myClipManagerTutorial Manage Database for myClipManager Tutorial my ClipManager Tutorial MailExample_jdbc Manage Scripts MailExample jdbc Manage Scripts MailExample jdbc MailEx ample jdbc MailEx ample idbc When selecting a clip from the Clip History database you can also Save as if you want to save the current selection as a standalone Clip Manager clip that you can then access from the Clip Browser or e g share with someone else Instead of constantly backing up a complete solution while working you can choose to only copy certain scripts layouts etc that you are working on Extra comment and version fields are provided in the Clip History window These fields can be edited by double clicking Page 8 The Clip History Filter allows you to only select a certain FileMaker data type Using the Search String a search will be performed according to the criteria you select 2523 Save As Search peen R Tutorial Entire Gp GEN conten
9. NClip Manager Clips b Get FileMaker clipboard information into Clip Manager There are two ways to get FileMaker clipboard information in Clip Manager either automati cally using the Clip History or manually using Clip Manager s Get as described below Open Clip Manager The Clip Contents window will be empty and the Get and Set buttons will be dimmed The Clip Browser will show a Sample Clips folder that you can navigate through If FileMaker is not yet running open it first along with any file of your choice Now copy a FileMaker layout object from your sample file then return to Clip Manager You will notice the Get button is now active Clicking Get or typing ctrl shift V will create a clip with the FileMaker clipboard information If the FileMaker clipboard object is a layout a thumbnail of that layout will also be shown You can then add comments for your clipping in the Comments field and there are a number of extra fields that allow you to store even more metadata in your clip such as a timestamp a version number and the author of the clip Page2 Once you are ready you can save it to a location of your choice we suggest in My Docu ments Clip Manager Clips which is the default path to the Clips folder You can change the lo cation of the Clip Manager clips folder from the Clips tab in Preferences o Clip Manager J Senple Clips FEE E FETU El anche Table tb E Samet int t
10. acter Matches Doo Any non digit character Repetition Characters Repetition characters are modifiers that allow you to repeat a specified pattern Repitition character Zero or more characters d finds no characters or one or more con secutive d s finds an entire line of text up to but not in cluding the return character One or more characters d finds one or more consecutive d s 0 9 finds a string of one or more consecu tive numbers such as 90404 1938 the 32 in Win32 etc Zero or one characters d finds no characters or one d Please note that since and match zero instances of the pattern they always succeed but may not select any text You can use them to specify an optional character as in the examples in the following section Greediness Clip Manager supports the as a greediness modifier for a subpattern in a regular expres sion By default greediness is controlled by the Greedy property of the RegExOptions class but can be overridden using the You can place a directly after a or to reverse the greediness setting That is if Greedy is True using the after a or causes it to match the minimum number of times possible For example consider the following Target Greedy Regular Expression String Extension Mechanism Page 18 We also support the regular expression extension mechanism used in Perl For instance For grouping with
11. ayouts FileMaker also puts a PDF representa tion of the layout into its clipboard and this PDF info is saved into the Clip Manager clips as well It is also used to display the thumbnail of the layout objects The following content types are available XMTB FileMaker table s XMLO FileMaker layout object s XMFD FileMaker field s XMCF FileMaker custom function s XMSC FileMaker script s TEXT plain text The content type is used as an extension when saving clips to your Clips folder e g myTable xmtb myLayout xmlo myCustomFunction xmcf etc When you have made changes to a clipping either from within the Clip Manager clip con tents field or with content pasted back from your external text editor Clip Manager will re Page 21 evaluate the content to check whether the XML format is still OK If it cannot find a valid XML content type Clip Manager will consider the clipping as just plain text Logically if you set the FileMaker clipboard with plain text contents that information will only become available in FileMaker from the standard OS Paste command and not from within Define database Script Editor or as a layout object Any questions Contact us via www myfmbutler com 2008 myFMbutler Page 22
12. e Cap levet Trneitaerrg 29089407 1238525 dator epee wide hare me Chom eregerT uto al erciotnegftect et 009007 enciesmngfacthomom 271 0009007 ercioungfecfogH 407 0099007 bject ypes Graphik Rages portals t rotations pect tops 20 200000 lem 0 000000 botor 153 000000 ngn407 0009007 Oyie breP ate 1 leith ImeColor Ww FFFEFDU Si ate 1 ME Sects SICOlon OF FFFFFOT gt ptf oman en Cotore ere Shear urest71 4 gt O pian ARAAAQCIMUY C TOPE y Zh goh 4 bD v aC ig I MOSS PODO TO TM IM EIN 37 Pt04L 242P90 PaO TOA aA UAPX Qa LARA A LAM PAS DATNRA ARN ted BO REMI ib TAA SE DAS E DEA This process will be identical for tables fields scripts and script steps The procedure for Clip Manager to Get a Custom Function is a little different however you need to make sure that in FileMaker you first open the custom function editor dialog of the function to be copied before going back to Clip Manager Important note when getting Custom functions Because Clip Manager has to drive the user interface to get custom functions keep the follow ing in mind when using this feature e using the keyboard or mouse while Clip Manager is getting the custom function will inter fere and produce unpredictable results avoid using spaces in custom function names and parameters Clip Manager sometimes has to perform a double click to get to these values and this does not work with strings that
13. e 9 from the clip history to the Desktop for layout items only the clip is copied to the Desktop as a Picture clipping It is a fully functional FileMaker clipboard item though and can still be dragged onto FileMaker from the clip list to FileMaker for layout items only the clip will be copied to the layout Note if the layout area accepting the drop is too small FileMaker will beep it will not propose to make the layout bigger from clip preview to FileMaker for layout items only the clip will be copied to the layout Note if the layout area accepting the drop is too small FileMaker will beep it will not propose to make the layout bigger h About the Clip Manager interface window The Clip Manager 3 interface offers a lot of customization options so you can adapt what is shown on screen depending on the type of work you are doing Split screen views allow you to show hide the following components in the interface window Contents field Metadata fields Layout preview You can toggle these options from the Window menu or you can change the views manually using the split handles or you can double click them to completely hide a part About Clip Manager Check For Updates Provide Clip Manager Feedback Close Ctrl Minimize Ctrl M Zoom Toggle Clip List Ctrl 1 Toggle Contents Ctrl 2 The next page shows a couple of examples that show how you can customize the Clip Man ager 3 in
14. e Sois evClghanager tutorial held o 2000 06 24 10 05 52 Mange Database for sees CigManage 7 torial babiels DOOD 24 10 35 41 Mange Database tor my iManage Tutorial Lrvone 20OR OK 54 10 08 25 ey pita spes tor larot 2000 0t 11 170521 Mal saemple xix Quit ore lyri 2008 06 31 13 98 3 erpel 2000 04 11 170435 Manage Scripts MaiEcamgie yc Cusiore furetion 2008 06 11 1706 01 sonet 2000 06 51 17 00 57 Manage Sonprs Vos ample etc layout 2006 00 11 170952 Matsample xix Outt ore het 2008 0951 12 399 38 layout 2000 00 11 17 0329 Mal xemple xit Cipo Hope Tene ttens 29082414 130341 Baker brressitrater Weeder nare Merege bopti me CoM a agerTutaonw Corenerts Page 11 i Clip Manager Preferences If you select Preferences from the Clip Manager menu you ll notice 5 tabs Clips Allows you to select the location for your Saved Clips This can either be a local or a network volume If you store clips on a network volume that volume will auto matically be mounted when Clip Manager starts up The Auto Paste in FileMaker Pro option will allow the Set option to not only Set the FileMaker clipboard but also to automati cally Paste in FileMaker if the appropriate window is active i e the Script Editor win i ae ft Wk c T Penh pl m ue ee ee i ee dow for scripts or a layout in layout mode for layout elements Analyze clips allows you to show information about the tables fields porta
15. efined by use of paren theses in the search string The search pattern d s B C A D BC AD looks for any number of digits followed by a space character followed by either B C BC A D or AD The M variable con tains the match to the d portion of the expression and 2 contains the match to the B C A D BC AD portion Page 20 Credits Clip Manager uses a modified version of the PCRE library package which is open source soft ware written by Philip Hazel and copyright by the University of Cambridge England The source to this library is available at ftp ftp csx cam ac uk pub software programming pcre This documentation is based on information from Realbasic http www realsoftware com products realbasic 4 About the FileMaker clipboard Ever since the arrival of FileMaker Pro 8 Advanced it became possible to copy scripts script steps tables and fields as well as layout objects When copied the information about these items is stored in an XML format However FileMaker does not provide a way to make this XML code available as editable text but instead stores it in clipboard flavors that are not directly recognizable by applications outside of FileMaker Clip Manager is able to analyze and translate these flavors back and forth making them avail able as editable UTF 8 text and translates this XML text back to the clipboard chunks File Maker recognizes as its internal clipboard For l
16. have Spaces in them Page 3 c Send a Clip Manager clip to the FileMaker clipboard Using the browser window you can navigate through your clip library Once you have found the clip file you want to send to FileMaker double click to select it and the Set button will become active Clicking the Set button or typing ctrl shift C will send the information in the current clipping to FileMaker s clipboard Now return to FileMaker Depending on the object type you can now paste the information for fields go to Define Database and you can Paste the field s for tables go to Define Database and you can Paste the table s for layout objects enter Layout Mode and select Paste to paste the objects for scripts open Script Editor and you will notice the Paste menu is active for custom functions open the Define Custom Functions dialog in FileMaker and make sure you have no existing custom function selected Now switch to Clip Manager select the custom function clip that you would like to copy to FileMaker and click Set If the Auto Paste in FileMaker Pro preference is set you can also automatically paste layout objects or scripts if the appropriate window is active and frontmost Important note as FileMaker allows you to copy multiple layout objects fields tables or scripts a single Clip Manager clip can also contain multiple fields etc Important
17. ls scripts vari ables and objects that are referenced from the clip Clip History Provides lots of customization options You can turn Clip History recording on or off If you have a slower Mac you might want to uncheck Record layout preview images to improve Clip Manager background proc essing Limit the number of clips to keep and for how long to keep them Optionally perform this check only on quit The Vacuum on quit option will optimize the SOLite data base for better performance pepesa ier eee a md Petey el ee emm eee ee t1 0 md morir be Ite pa 94 Pacta p teens dut eee moms ate ee You can manage how to make regular backups of your Clip History Page 12 Editor Lets you select the text editor you prefer The default editor is Notepad but most popular alternatives are supported Allows pay S50 you to toggle syntax coloring in the clip contents window and select your colors of Ee choice midias mm Updates Allows the program to automatically check for updates Clip Manager can check automatically at startup or you can also check manually Lec Ped NN 0 1 are Cre dies suos AA Om qo dana ad a abo ot paar aw 6 QW wape F imi LLL Eod Co i i License Allows you to register Clip Manager The Clip Manager demo version will expire after 30 days Page 13 j Clip Manager Advanced Search Regular Expressions Clip Manager has extensive su
18. out creating backreferences pattern A zero width positive look ahead assertion For example w t matches a word followed by a tab without including the tab in amp pattern A zero width negative look ahead assertion For example foo bar matches any occurrence of foo that isn t followed by bar A zero width positive look behind assertion For example lt t w matches a word that follows a tab without including the tab in amp Works only for fixed width look behind pattern A zero width negative look behind assertion For example lt bar foo matches any occurrence of foo that does not follow bar Works only for fixed width look behind Subexpressions You can use parentheses within your search patterns to isolate portions of the matched string You do this when you need to refer to subsections of the matched in your replacement string For example you would do this if you need to replace only a portion of the matched string or insert other text into the matched string Here is an example If you want to match any date followed by the letters B C you can use the pattern d sB C Any number of digits followed by a space character followed by the letters B C This will match dates such as 33 B C 1742 B C etc However if you wanted your replacement pattern to leave the year alone but replace the letters with something else you would use parens The search pattern d s B C
19. pport for search using regular expressions Although plenty of technical information about regex is available on the Internet here is a concise overview of the search functionality offered in Clip Manager O Q et e D J D N A UO f Decription Matches any character except newline a z0 9 Matches any single character of set a zO 9 Matches any single character not in set Matches a digit Same as 0 9 w t gt p ail Matches a non digit Same as 40 9 Matches an alphanumeric word character a zA Z0 9_ Matches a non word character a zA ZO 9 Matches a whitespace character space tab newline etc Matches a non whitespace character Matches a newline line feed Matches a return Matches a tab Matches a formfeed oO Matches a backspace Matches a null character 000 Also matches a null character because of the following nnn Matches an ASCII character of that octal value xnn Matches an ASCII character of that hexadecimal value cX Matches an ASCII control character metachar Matches the meta character e g V I Page 14 Used to create subexpressions Remembers the match for later back references Referenced by replacement patterns that use 1 2 etc Matches whatever first second and so on of parens matched Matches O0 or 1 x s where x is any of above Matches O or more x s Matches 1 or more x s aie aes
20. s A character class allows you to specify a set or range of characters You can choose to either match or ignore the character class The set of characters is enclosed in brackets If you want to ignore the character class instead of match it precede it by a caret Here are some exam ples Any one of the characters a e i O U Any character except a e i O U fae Any character in the range a e inclusive a zA Z0 9 Any alphanumeric character Note Case sensitivity is controlled by the CaseSensitive property of the RegExOptions class Page 16 C Finds a To find a a closing bracket place it immediately after the opening bracket Finds a character in the range a e or the caret character To find the caret character place it anywhere except as the first character after the opening bracket a c Finds a character in the range a c or the sign To match a place it at the beginning or end of the set Non printing Characters You can use the following notation to find non printing characters LII NEN REN V emm je ome ooo Other Special Characters The following patterns are wildcards for the following special characters Special character Matches 3 Any whitespace character space tab return linefeed form feed CE Any non whitespace character Any word character a z A Z 0 9 and Any non word character All characters not included by Ww Page 17 Special char
21. terface window Page 10 o History 14 cips foend File Cat Groweer ety Widow feb e KALAA bac ad Swe ks Seach Chg ww rl Teveitere 20080 1 1112 51 hhor more atten wu dun carne Manage Catabere fos mpChpMansgerTutanw Corrents Field u the Teterial Me umemy Fieis is name eid dxaType nerfs rerit A ok rter ioowag z F aue constant M ungana uw cacuatonzs y sit ding BA ST T Orrifart o Ma mf feidTyps A LAOT r ere abtahon pe stat rry reage she masLengmf ane vuei v chba F ale hety andatec hou ane E rroty vave F uo saw Valuer aoe le Exiting waives F alieni Zinc A Pe vau Irora rige index Non gobs she autein dim v Tras index angocagev t ng masMepetten gt Fietd ide namen ed daaTypev Text fetdTyper Weft cvevverte inier lockups she constants site tunganes t she cakustonr t alte allow ding fata Lata tart va MA vtof rhur9 abtahOn ype L tat rry meldiegevt ane masLengmsr ase vam CMocatunmonst ane adegy Vi ad ateC Mouton Not moy valve Joe vae la ing vaie va Por ee a eevee e eter fetta te p ttistory 14 clips found F e Et Browser Hoy Window Hib PALDA Pee Speis Seam Op Browser Type Tre amc Window NEL soe 2008 06 56 10 0609 Manage Scripts opagai eon o Sample Ope layout 2000 06 26 10 36 20 my CipManager Tutors Chp history a esrtis 20080616 10 96 17 Manag
22. ts Timestamp Window Comment 2008 06 16 10 36 39 Manage Scripts myClipManager Tutorial 2008 06 16 10 36 17 Manage Scripts myClipManager Tutorial 2008 06 16 10 35 52 Manage Database for myClipManagerTutorial 2008 06 16 10 35 41 Manage Database for myClipManagerTutorial The Clip History tab in Preferences provides lots of configuration options for your Clip History g Clip Manager Drag amp Drop Clip Manager 3 offers extensive Drag amp Drop functionality Here s an overview of how you can use drag amp drop to make clip management a lot easier from the clip file list to a browser folder the clip is moved from the source list to the other folder with option key the file is copied to the folder from the clip file list to the clip history the file will be copied to the history database Note clip list items cannot be dragged to the clip history smart selectors Clip Browser File Name W myProjects B Sample Layout xmlo LJ Apple 7 Sample Script Steps xmss LJ FileMaker 9 Sample Text txt E Sample Custom Function xmef E oamnpe fields amfd 7 Sample Table xmtb 7 Sample Scripts xmsc 9 Yesterday Past Week ERE ENR blc e from the clip history to a browser folder the file will be copied to the folder a Save As dialog will be displayed and the file will be saved in the folder you select the default name for a clip history items is clip history item Pag
Download Pdf Manuals
Related Search