Configuring Check Layouts. Version 10.0

Transcription

1 MICR Configuring Check Layouts User Guide User Guide Version 10.0

2 Copyright 2010, Mekorma Enterprises. All Rights Reserved. Your right to copy this documentation is limited by copyright law and the terms of the software license agreement. As the software licensee, you may make a reasonable number of copies or printouts for your own use. Making unauthorized copies, adaptations, compilations, or derivative works for commercial distribution is prohibited and constitutes a punishable violation of the law. Unless otherwise noted, all names of companies, products, street addresses, and persons contained herein are fictitious and are used solely to document the use of this product. Warranty Mekorma disclaims any warranty regarding the sample code contained in this documentation, including the warranties of merchantability and fitness for a particular purpose. Limitation of Liability The content of this documentation is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Mekorma. Mekorma assumes no responsibility or liability for any errors or inaccuracies that may appear in this documentation. Neither Mekorma nor anyone else who has been involved in the creation, production or delivery of this documentation shall be liable for any indirect, incidental, special, exemplary or consequential damages, including but not limited to any loss of anticipated profit or benefits, resulting from the use of this documentation or sample code. License Agreement Use of this product is covered by a license agreement provided by Mekorma, Inc., with the software product. If you have any questions, please call the Mekorma Sales Department at 888-MEKORMA ( ). Company Address Mekorma is located at 8265 West Sunset Boulevard, Suite 207B, West Hollywood, CA Office Telephone: 888-MEKORMA ( ), Office Fax: (US & Canada). i

3 Table of Contents Getting Started... 4 Overview... 4 Compatibility between Versions... 5 Installing the Configurator... 5 Launching the Configurator... 7 As a Standalone Application Setting Security to Mekorma Windows The Configurator Interface Introduction Toolbars and Menus The File Menu The Quick Access Toolbar The Home Toolbar The Layout Toolbar The Options Toolbar The Display Toolbar The Help Toolbar The Configurator Windows The Design Window The Navigation Window The Properties Window Selecting a Check Format Overview Upgrading the.stb Check Stub Format Creating a New Stub File Stub File Properties Using a Pre Configured Stub File Copying Stub File Information Using Snippets Adding a Snippet Creating a Snippet Adding Elements to the Stub File Introduction Adding Check or Stub Regions Selecting Regions Region Properties Adding Fields Overview Adding Mekorma MICR easyadd Fields ii

4 Using the Right Click Context Menu Multi Text and Single Text Fields Deleting Fields Data Type Field Properties Using the Continued Field Adding Labels and Static Text Adding a Label from the Label Category Adding Static Text Labels To Add Text to the Label Adding Boxes Box Type Field Properties Adding Lines Line Type Field Properties Adding Images Picture Type Field Properties Adding a Signature Adding a Signature Line Modifying the Check Layout Adjusting Placement of the MICR Line Working with Field Sizes Formatting Multiple Fields Formatting Fonts, Dates and Currency Fields Changing Font Properties Using the White on Black Property Formatting Date Fields Formatting Currency Fields Additional Resources and Support Documentation Mekorma KnowledgeBase Technical Support iii

5 Version 10.0 Getting Started This section provides information on the following topics: Overview Installing the Configurator Launching the Configurator Overview The Mekorma MICR Configurator is a WYSIWYG (What You See Is What You Get) report editing tool that allows you to modify Mekorma generated checks and stubs. The Configurator handles any size paper and any system font. Use the Configurator in conjunction with the pre prepared stub files provided in the Mekorma Check Format Library to create check stub formats designed specifically for your company s check printing needs. The Configurator is a feature rich, easy to use editing tool with drag n drop functionality, multiple windows, menus, and toolbars. 4

6 Version 10.0 You can add or remove fields quickly, and easily change the layout and display to create the check stub format you want. When creating or editing.stb files, it may be helpful to have the following items available to assist you in fine turning the layout of your check stubs: MICR Gauge Ruler Envelope with Clear Window (if applicable for your checks) NOTE For information about the pre configured check format (.stbx) files provided in the Mekorma MICR Check Format Library, please see the Mekorma MICR Check Format Library Reference.pdf. Compatibility between Versions The Mekorma Configurator 2.0 contains features and functionality not available in the prior version of the Mekorma Configurator. To ensure compatibility with all versions of the Mekorma Print Engine, some fields and properties can only be used with the Mekorma Stub Library files provided with Configurator 2.0. The Configurator 2.0 files use a.stbx extension instead of a.stb extension. The following elements are only available when using the.stbx stub file format: The Upside Down, Backwards, and Vertical properties for Test, Date, Amount and Numeric fields. The Continued field in the Logical Fields category of the Add Elements dialog box. Multi line text Label fields saved to the.stb files (older version) do not have the newline characters. A newline character starts each new character in the field on a new line. Installing the Configurator You can install the Mekorma Configurator when you install Mekorma MICR or at any time by launching Mekorma_MICR_v.00.0b*.exe (where v represents the version number and b* represents the build number) and running the installation wizard. 5

7 To install the Mekorma Configurator: 1. After launching the Mekorma_MICR_v.00.0b*.exe file, follow the onscreen instructions. When you click Next on the Release Notes screen, you see the Select Components screen: 2. By default, the Mekorma Configurator is selected for installation. If you are installing Mekorma MICR for the first time, we recommend installing the Mekorma Configurator Format Library containing the pre configured check format files. 3. To install the Mekorma Configurator Format Library, click on the arrow next to the Mekorma Configurator component to display the install options: 6

8 Version Select the Will be installed on local hard drive option to install the Mekorma Configurator Format Library component. 5. Click Next to proceed with the installation. You see the Destination Folders for Mekorma MICR 10.0 screen: 6. The Mekorma Configurator is installed to a folder called Configurator which is created in the Mekorma MICR folder of the GP root directory during the installation process. 7. Click Next to proceed and follow the onscreen instructions to complete the installation process. Launching the Configurator You can launch the Configurator from the Mekorma MICR Check Setup (Payables, US Payroll, or Canadian Payroll) dialog box, or as a standalone application (see the following section). For the purposes of this documentation, we will use the Mekorma MICR Setup screen for the Payables module. You can also launch the Configurator from the Mekorma MICR Setup screen for US Payroll (Microsoft Dynamics GP Tools Setup Payroll Mekorma MICR US Payroll Mekorma MICR Setup). 7

9 To launch the Configurator from the Mekorma MICR Setup screen: 1. Select Microsoft Dynamics GP Tools Setup Purchasing Mekorma MICR Payables Mekorma MICR Setup to display the Mekorma MICR Setup (Payables) dialog box: 8

10 Version Enter or select the Checkbook ID you want to work with. Click the lookup button to select from a list of existing checkbooks. NOTE You can open the Configurator without selecting a Checkbook ID. 3. Click the Check Face or Overflow Stub Format hyperlink fields to launch the Configurator. This field can be empty, or you can select a stub layout format and then launch the Configurator: For Payroll, you can click on the Primary Check Format field hyperlink: 9

11 4. If a check format file is displayed in the field when the hyperlink is clicked, the corresponding format is opened when the Configurator launches (in this case you can skip Steps 6 7). 5. If there is no format shown in the field, when you click the hyperlink, you see the following screen: 10

12 Version To select an existing check stub format in the Configurator, click the Open icon and choose a format from the Mekorma Check Format Library files: 7. You can also create a new stub format by clicking the New icon (see the Creating a New Stub File section of this guide for more information). As a Standalone Application You can launch the Mekorma Configurator as a standalone application, independent of Mekorma MICR and Microsoft Dynamics GP. To launch the Configurator as a standalone application, choose from the following options: Double click the MekormaCfg.exe file located in the Configurator folder under the Mekorma MICR folder of your Dynamics GP directory (for example, C:\Program Files\Microsoft Dynamics\GP\Mekorma MICR\Configurator). Double click on any of the.stbx files located in the folder where you installed the Mekorma Check Format Library files (the default folder is C:\Program Files\Microsoft Dynamics\GP\Mekorma MICR\StubLib). 11

13 Setting Security to Mekorma Windows A new user does not have access to any 3 rd party windows and reports in GP unless they are assigned for that security role. For a non administrator user to have access to Mekorma MICR windows and reports, a Security Task containing access to Mekorma MICR windows must be created and eventually assigned to the user. Within that security task, in order to print checks using Mekorma MICR, a user must have access to the Mekorma Check Printing window listed under the Company series. NOTE The Mekorma MICR User Guide.PDF located in the Mekorma MICR folder of your GP root directory contains instructions on creating a Security Role in Dynamics GP to access Mekorma MICR windows and reports. Please refer to the Dynamics GP Security Setup chapter of the user guide. 12

14 Version 10.0 The Configurator Interface This section provides information on the following topics: Toolbars and Menus The Configurator Windows Introduction The Configurator for Mekorma MICR is an easy to use interface containing resizable windows and a collection of toolbar ribbons grouped together for convenience and quick access. Using the toolbar and menu options you can: Open multiple stub files Add pre configured check and/or stub regions (Snippets) Redo/undo the last action Save and test your stub layout Add fields and elements to your stub Zoom in/out on the check stub file Change the display colors Modify object properties Adjust the spacing between fields Change the alignment of objects Match multiple fields to the same size Display a ruler View and edit font properties Contact Technical Support Launch online help 13

15 Toolbars and Menus This section explains the functionality of the options available on the Configurator toolbars and menus. The File Menu The File menu options include standard Windows commands, in addition to an option to view recently opened files and an option to save and test the check layout. The File menu options can be accessed from the File menu button: or from the File group on the Home toolbar. 14

16 Version 10.0 The following options are available on the File menu: New: (CTRL+N) Opens the New Stub File dialog box: TIP See the section called Creating a New Stub File for more information on this screen. Open: (CTRL+O) Launches the Open dialog box and automatically navigates to the default location of the Mekorma Check Format Library stub files (StubLib). 15

17 Recent Files: Displays a list of the last stub files opened: Save: (CTRL+S) Saves any changes you made to the currently selected stub file. Save As: (F12) Opens the Save As dialog box to allow you to save the stub file under a different name. Save Snippet As: Click to save the selected check or stub region as a Snippet in the Snippet library. See for Using Snippets more information on Snippets. Save and Test: Allows you to preview and/or print your stub file. Exit: (CTRL+F4) Closes the Configurator. 16

18 Version 10.0 The Quick Access Toolbar The Quick Access toolbar is a customizable toolbar. By default, the toolbar contains the Redo and Undo options. Right click the toolbar to add icons: Or remove icons from the toolbar: You can also change the location of the toolbar: 17

19 The Home Toolbar The Home toolbar contains the File, Edit, Fields, and Zoom groups. Use this toolbar to open and save files, cut, copy, and paste, view font information, and add or delete fields. File Options The options on the File group of the Home toolbar are the same as the File Menu options. Edit Options The following options are available on the Edit group: Cut: Removes the selected object. This option is not available on property settings. Copy: Copies the selected object. This option is not available on property settings. 18

20 Version 10.0 Paste: Pastes the selected object. This option is not available on property settings. Undo: Reverts the format back one step for all changes in undo history. The undo history contains all changes from either a save point or initial document opening Redo: Grayed out until an undo event has taken place. Redo is available only until there are no more undo actions to revert, or the user has attempted some other action than an undo. Fields Group Options The following options are available on the Fields group: Add Snippet: If you have selected a check or stub region, click this option to launch the Open screen and add the selected region as a Snippet in the SnippetLib directory (see Using Snippets for more information on Snippets): 19

21 Add Elements: Launches the Add Elements dialog box: NOTE Please see the section on Adding Elements to the Stub file for more information on using this screen. Delete Fields: Deletes the selected field or fields from the stub layout. TIP The Fields Group options are also available from the Layout Toolbar. Zoom Options 20

22 Version 10.0 The following options are available on the Zoom group: Zoom In: Click to zoom in on the portion of the stub file that is displayed in the Design window. Zoom Out: Click to zoom out from the portion of the stub file that is displayed in the Design window. Zoom: Select a zoom percentage from the drop down menu. Click the Full Page option to display the entire stub file in the Design window. The Layout Toolbar The Layout toolbar contains the Align, Size, Horizontal, Vertical, Table, and Fields groups. Use this toolbar to modify the alignment and spacing of elements, add/delete fields, and group fields together using the Make Table option. Align Group Options 21

23 The following options are available on the Align group: Align Left: Left aligns the selected objects (fields, boxes, lines, and so on). Align Center: Center aligns the selected objects (fields, boxes, lines, and so on). Align Right: Right aligns the selected objects (fields, boxes, lines, and so on). Align Top: Top aligns the selected objects (fields, boxes, lines, and so on). Align Middle: Middle aligns the selected objects (fields, boxes, lines, and so on). Align Bottom: Bottom aligns the selected objects (fields, boxes, lines, and so on). NOTE When selecting a group of objects to align, the objects are aligned based on the location of the first object selected. Size Group Options The following options are available on the Size group: Same Width: Sets all the selected objects (fields, boxes, lines, and so on) to the same width as the first selected object. Same Height: Sets all the selected objects (fields, boxes, lines, and so on) to the same height as the first selected object. Same Size: Sets all the selected objects (fields, boxes, lines, and so on) to the same size as the first selected object. 22

24 Version 10.0 Horizontal Group Options The following options are available on the Horizontal group: Equal Spacing: Sets the same amount of horizontal space between all of the selected objects (fields, boxes, lines, and so on). Increase Spacing: Increases the amount of horizontal space between the selected objects (fields, boxes, lines, and so on). Decrease Spacing: Decreases the amount of horizontal space between the selected objects (fields, boxes, lines, and so on). Vertical Group Options The following options are available on the Vertical group: Equal Spacing: Sets the same amount of vertical space between all of the selected objects (fields, boxes, lines, and so on). Increase Spacing: Increases the amount of vertical space between the selected objects (fields, boxes, lines, and so on). Decrease Spacing: Decreases the amount of vertical space between the selected objects (fields, boxes, lines, and so on). 23

25 Table Group Options The following option is available on the Table group: Make Table: Makes all the selected fields the same height with no space in between them. Users can select multiple fields and click this option to make all the fields the same height (ignoring the Total line) and concatenate them in the order that they were selected. NOTE The Make Table option does not apply to check and stub regions. The Layout toolbar also contains the same Fields group options located on the Home toolbar. 24

26 Version 10.0 The Options Toolbar The Options toolbar contains the Defaults and Components groups. Use this toolbar to modify fonts, select a stub file to open on startup, and add fields for the Mekorma MICR optional components to the Add Elements dialog box. Defaults Group Options The following options are available on the Defaults group: Default Font: Displays the default font for all new fields added to the stub file. Click on this field to launch the Font dialog box and change the font properties: Open Last Used File at Startup: Check this option open the most recent stub file used when you launch the Configurator. 25

27 Components Group Options The following options are available on the Components group: Optional Components: Click the drop down arrow to select an optional component, such as Canadian Payroll (for Mekorma MICR), then click OK to add the component s fields to the list of fields on the Add Elements dialog box. The Display Toolbar The Display toolbar contains the Display, Colors and Zoom groups. Use this toolbar to show the ruler, select a skin theme, modify the display colors, and change the zoom percentage of the stub file. Display Group Options The following options are available on the Display group: Show Ruler: Check to display a ruler in the Design window. 26

28 Version 10.0 Colors Group Options To change the color, click on the drop down arrow for the specific option: The following options are available on the Colors group: Field Background: Changes the color of the background for all fields. Field Border: Changes the color of the border for all fields. Selected: Changes the color for selected fields. Check Region: Changes the color of the check region on the selected stub file. Stub Region: Changes the color of the stub regions on the selected stub file. Scale Background: Changes the color displayed behind the ruler (scale). Scale Text: Changes the color of the ruler (scale) text. Skin: Select a skin or theme for the Configurator. The skin selected is displayed on the Configurator windows and toolbars, but the stub file is not affected. Reset Colors: Click to reset all colors and skins to the default selection. 27

29 Zoom Group Options The Zoom options on the Display toolbar are identical to the Zoom group options on the Home toolbar. The Help Toolbar The Help toolbar contains version information about the Mekorma Configurator, links to the Mekorma website and Technical Support, and access to online help. About Group Options The About group displays the Mekorma Configurable Stubs version and copyright information. Help Group Options The following options are available on the Help group: Mekorma.com: Click this link to go to the Mekorma web page. FAQ: Click this link to go to the Mekorma KnowledgeBase web page. Tutorials.com: Click this link to go to the Mekorma web page containing a list of User Guides and Tutorials. 28

30 Version 10.0 Technical Support: Click the drop down arrow to view the Technical Support options: You have the following options under the Technical Support menu: Contact Mekorma Support: Click this link to launch the Support Contact Form on the Mekorma website. You can also contact support at 888 MEKORMA (option #3). Trace Level: Click the drop down arrow to select a Trace Level. Trace information is used to help the support technician diagnose user issues. The levels are tiered to provide successively more detail (for example, the Trace Info level provides more detailed information than the Trace Errors level). You can turn the Trace feature off with the Trace Off option. TIP When asked to send the trace log file to Mekorma Technical Support, navigate to the Trace folder (for example, C:\Program Files\GP10\Mekorma MICR\Configurator\Trace) and send a copy of the most recent.log file. Trace Mark: Select this option to visually mark the Trace file. Equal (=) signs are added to the Trace file, making it easier to find information in the file. Configurator Help: Click to launch the Configurator context sensitive help system. You can also launch online help by pressing F1 on your keyboard. 29

31 The Configurator Windows The Configurator is designed with drag n drop functionality, making it easy to move or add objects, and to navigate within the program s workspace environment. The Design window contains the objects and regions, the Navigation window displays field names and values, and the Properties window displays the attributes of the selected object. Adjust the display size of the Navigation and Properties windows using the slider guides at the bottom of the window or the scroll bars: 30

32 Version 10.0 The Change Count value, located in the bottom left corner of the main Configurator window, displays the number of times the selected stub file has been modified. Next to the Change Count are the horizontal and vertical coordinates of the mouse. The Design Window The function of this window is to provide design capability and to visually represent the finished check when printed. When you open a stub file, it is displayed in the Design window. This window holds check regions, stub regions, fields, logos, lines, boxes, and any other object placed on the stub. In addition to visually displaying the content of the stub file, the Design window allows users to select and define the location and size of objects and regions. Any changes made to the appearance or location of objects and regions is reflected in the Design window. 31

33 Users can open multiple stub layouts and switch between stub files using the tabs located at the top of the Design window: The Navigation Window The navigation window shows the layout of the document textually in a hierarchical structure. 32

34 Version 10.0 All Design window items are listed in the Navigation window, enabling users to view and select items that may be difficult to see in the Design window. To move an item to the top in the Design window, click on it in the Navigation window. NOTE You cannot drag items from the Navigation window to the Design window. When an object is selected in the Navigation window, you can move the corresponding object in the Design window using the arrow ( ) keys on the keyboard. You can also move or resize the object using your mouse. When resizing with a mouse, all regions or fields selected with the mouse are resized. You can also drag n drop line items in the Navigation window within a stub or check region. For example, if you wanted to move the Voucher::Document Number field below the Voucher::Document Date field you could drag and drop it to the new position. 33

35 The Properties Window The Properties window allows users to change the properties of the objects and regions displayed in the Design window. Click in the Value column to edit the value of a property. In the Left, Top, Width, or Height properties, you can also use the arrow buttons change the numeric value. The properties displayed are dependent on what is selected a region or an object (such as a field, box, line, and so on). For example, if the user selected a Single Date field type, the Properties window would display the following properties: 34

36 Version 10.0 If a region is selected, the following properties are displayed: NOTE Check regions include the MICR line properties in addition to the standard region properties. If a Picture is selected, the following properties are displayed: If a Line is selected, the following properties are displayed: NOTE Please see the applicable section for information on adding fields, regions, or objects to the stub file. 35

37 Selecting a Check Format This section provides information on the following topics: Creating a New Stub File, following Using a Pre Configured Stub File Copying Stub File Information Using Snippets Overview The first step in working with the Configurator check layout tool is to select or create a stub format. You can create a new stub file and add the desired regions, fields and objects, or you can use one of the prepared stub files provided in the Mekorma Check Format Library included with Mekorma MICR. Upgrading the.stb Check Stub Format With Mekorma MICR Version 10.0b59 (and above), the file format for the check stubs has changed from.stb to.stbx. To upgrade your.stb format stub files to the new.stbx format, complete the following steps: 1. Open the Configurator 2.0 and select the.stb stub file you want to upgrade to the new format: 36

38 Version Click the Save As option on the Home toolbar: 3. In the Save As screen, select XML Stub File (*.stbx) for the Save as type option: 4. Click Save. The stub file format is upgraded from.stb to.stbx. 37

39 Creating a New Stub File To create a new stub file format, select File New from the Configurator button menu or click the New icon on the File group of the Home toolbar to display the New Stub File dialog box: You see the following fields on the New Stub File dialog box: File Name: Enter the name for the stub file. Form Size: Select a form size for the stub file. If you select the Custom option, you can enter specific dimensions in the blank boxes: Product: Select an option to determine which categories and fields are displayed on the Add Elements dialog box. Click OK to open the new stub file in the Configurator. You can now add regions, fields and objects to the stub file. See Adding Objects to the Stub File for more information. Stub File Properties When you select the stub file in the Design window, you see the following properties displayed in the Properties window: 38

40 Version 10.0 Stub File Path: Displays the location of the Mekorma Check Format Library preconfigured stub files. Stub File Name: Displays the name of the currently selected stub file. Product: Displays the option selected (Payables or Payroll) in the Product field of the New Stub File dialog box. Page Width: Displays the page width. Page Height: Displays the page height. Using a Pre-Configured Stub File Instead of creating a new check or stub from scratch, you can use one of the preconfigured formats provided in the Mekorma MICR Check Format Library. The library stub files can be used as is, or modified to fit your check format specifications. You can install the library during the Mekorma MICR installation process or at anytime by running the Mekorma_MICR_V.00.0b.exe file (where V is the version and b is the build number). TIP For more information about the Mekorma MICR Check Format Library, please refer to the Mekorma MICR Check Format Library Reference.pdf document located in the Mekorma MICR folder of your Dynamics GP directory. 39

41 To open a file from the library: 1. Select File Open from the Configurator menu or click the Open icon on the File group of the Home toolbar. You see the Open dialog box: NOTE The program automatically remembers the location of the last stub file opened and displays that location in the Open screen. You can also check the Open Last Used File at Startup option on the Options Toolbar to automatically display the last used stub file when you launch the Configurator. 40

42 Version Select a stub format and click Open. The stub file is displayed in the Configurator: Copying Stub File Information You can copy an entire check or stub region to another stub file, or select specific fields and copy just those fields. 1. Open the stub file that you want to copy from. 2. To copy a check or stub region (including all the fields in that region), click on the region to select it. 3. When you select the region in the Design window, the fields in the region are highlighted in the Navigation window: 41

43 4. To copy fields, click on the field to select it. Hold down the CTRL key to select multiple fields. 5. With the region or fields is selected, select the Copy option on the Home toolbar (or press CTRL+C). Open the stub file that you want to copy the objects to and select Paste (or press CTRL+V). All of the selected information is copied to the second stub file: 6. Save your changes and customize the stub file as desired. Using Snippets In addition to the pre configured.stb files provided in the Mekorma Check Format Library, a collection of pre configured elements called Snippets are included with the Configurator. Snippets are a collection of elements that can include regions, fields, and graphics. A snippet can also be an entire stub file. You can mix and match different check and stub Snippets to create a customized check stub format. Use a prepared Snippet from the library of Snippets stored in the SnippitLib folder where you installed the Configurator, or create a new Snippet from using elements or regions from an existing stub file. The Snippet directory contains standard stub and check regions for Payables and Payroll check formats. Adding a Snippet To add a prepared check or stub region Snippet to your check stub layout, complete the following steps: 1. Open the stub file you want to add the Snippet to in the Configurator, or create a new stub file. 42

44 Version Click the Add Snippet option on the Home or Layout toolbar to launch the Open screen. By default, the SnippetLib directory is displayed: 3. Select a check or stub region and click Open. The selected Snippet is placed in the specified location (top, bottom or middle) on the stub file: 4. Save your changes. 43

45 Creating a Snippet If you have customized a check layout and want to reuse your check and/or stub regions on other stub files, you can save them as Snippets and add them to the SnippetLib directory. To create a Snippet, complete the following steps: 1. Open the applicable stub file in the Configurator and click on the region you want to save. 2. When you click on a region in the Design window, all of the fields and objects in that region are selected: 44

46 Version Click the Save Snippet option on the Home toolbar to launch the Save As dialog box with the SnippetLib directory selected: 4. Enter a name for the Snippet in the File name field, for example, Custom AP Check Region Top.snip, and leave the Save as type format default of Snippet file (*.snip). 5. Click Save to save the selected region as a Snippet. 6. If you click the Add Snippet option on the Home or Layout toolbar, you see the files in the SnippetLib directory, including the new Snippet file you created. TIP You can also overwrite existing Snippets by saving the new region using one of the pre configured Snippet file names. We recommend making a backup copy of your Snippit library files in the event you need to restore an original file to the library. 45

47 Adding Elements to the Stub File This section provides information on the following topics: Adding Check or Stub Regions, following Adding Fields Adding Labels and Static Text Adding Boxes Adding Lines Adding Images Adding a Signature Introduction After opening an existing stub file, or creating a new stub file, you can customize the layout of the stub file to fit your company s check format specifications. With the Configurator, you can drag and drop objects onto the Design window and modify existing objects using the options on the toolbars. TIP If you are customizing an existing stub file, we recommend creating a backup copy of the file before you modify it. Adding Check or Stub Regions After you create a new stub file, before you add objects such as fields, logos and signatures, you need to add the check and stub regions to the blank format. IMPORTANT When creating a check region, it should be exactly the same size as the check portion on the actual check stock. 46

48 Version 10.0 To add new check or stub regions: 1. Click the Add Elements icon on the Home or Layout toolbar. You see the Add Elements Payables (or Payroll) dialog box: NOTE The Categories and Fields available on this screen depend on the module selected in the Product field of the New Stub File screen. TIP You can also add check or stub regions using the Add Snippet option on the Home and Layout toolbars. See the section on Adding a Snippet for more information. 47

49 2. Click the Add Check Region or the Add Stub Region command button. The new stub or check region is added to the stub file. A stub region displays as a blue toned square and a check region as a pink toned square: TIP You can change the color of regions using the Check Region Stub Region options on the Options Toolbar. and 3. You can drag the regions to the desired location in the Design window and use the Align options on the Layout toolbar to align the regions. 48

50 Version With the stub or check region selected, you can change the values in the Properties window to configure your stub and check proportions: TIP You can use the arrow buttons to change the numeric value of a field. 5. Save you changes. You can now add objects such as fields, boxes, logos, and more, to your stub file. Selecting Regions The following rules apply when selecting regions (either check or stub) in the Configurator: Click on a region to select all the fields in the region, along with the region. Click on the region name (such as Stub 1) in the Navigation window, to select all fields in the region, along with the region. Press CTRL and click on a region to select (or deselect) just the region and not the fields. 49

51 Deselect a field in a region by pressing CTRL and clicking on it. The options on the Layout toolbar are applied to all regions selected. For example, if you select multiple regions and click the Align Left option, all the selected regions are left aligned. If you select only one region, only the fields in the selected regions are left aligned. When moving regions, if a region is selected, all the fields in the region will be moved, including locked fields. If one region and one or more fields are selected, the region property values are displayed at the top Properties window. If more than one region is selected, the region properties are not displayed. To deselect all regions and fields, click outside of the region. Region Properties The following properties are displayed for check and stub regions: Field Type: Displays the type of element selected. Region Name: Displays the name of the region selected. Left: Defines the y axis location of the region (as measured by the ruler). Top: Defines the x axis location of the region (as measured by the ruler). Width: Defines the width of the region. Height: Defines the height of the region. MICR Line (Check Region Only): (Default value = checked) If checked, the MICR Line field is displayed on the check region. MICR Horizontal Adjustment: (Check Region Only) Edit the value to adjust the horizontal placement of the MICR Line field. MICR Vertical Adjustment: (Check Region Only) Edit the value to adjust the vertical placement of the MICR Line field. 50

52 Version 10.0 NOTE See Adjusting Placement of the MICR Line for more information on the MICR line adjustment fields. Lock: If checked, the region is locked in a position relative to the form. Locked regions cannot be moved or resized. You cannot modify properties on a locked region. Adding Fields This section provides information on the following topics: Overview, following Using the Right Click Menu Multi Text and Single Text Fields Deleting Fields Data Type Field Properties Using the Continued Field Overview When you design a stub file, you can select from available elements that are appropriate to the module (Payables or Payroll) you are creating the stub file for. Most fields in the Configurator print directly from Dynamics GP tables; however, there are a several special behavior fields that do not populate directly from the tables. 51

53 The following table lists the special behavior fields and their corresponding categories: Field Category Notes MICR Check Comments 1, 2 & 3 General Information General Information This is the OCR font that prints at the bottom of the check. This field is created from the information entered on the Mekorma MICR Setup dialog box for each checkbook. These are the comment fields that only appear on the Mekorma MICR Setup screens. They do not correspond to any Dynamics GP fields. EFT Non Negotiable Logical Fields This field prints the word Non Negotiable on Payables EFT and Payroll Direct Deposit payments. EFT Void Logical Fields This field prints the word Void on Payables EFT and Payroll Direct Deposit payments. Line 1 Logical Fields This is the line that the first signature rests on. The printing of this line is controlled by the settings on the Mekorma Password and Signature Setup dialog box. Line 2 Logical Fields This is the line that the second signature rests on. The printing of this line is controlled by the settings on the Mekorma Password and Signature Setup dialog box. Signature File 1 Logical Fields This is the.bmp image specified in the Signature 1 File Location field of the Mekorma Password and Signature Setup dialog box. Signature File 2 Logical Fields This is the.bmp image specified in the Signature 2 File Location field of the Mekorma Password and Signature Setup dialog box. All fields starting with Voucher Amount in Words with Word Wrapping GL Distribution Payment, Check These fields replicate the Voucher category fields. You cannot print the original voucher category fields on the same stub as the GL Distribution fields. Use the replicated voucher fields instead. This field wraps the amount in words (legal amount) to a second line if it is too long for a single line. 52

54 Version 10.0 Field Category Notes Payment Address Vendor This field prints Address lines 1, 2, & 3, city, state and zip from the Remit to address for the vendor. If any of the address lines do not have data, this field automatically resizes to eliminate blank lines. Payment Address with Country Vendor Name SAFE PAY Bank Address Company Address Vendor Vendor General Information General Information This field prints Address lines 1, 2, & 3, city, state, zip and country from the vendor Remit to address. If any of the address lines do not have data, the field automatically resizes to eliminate blank lines. This field prints the Vendor Check Name in capital letters to conform to the format of the positive pay file created by the Dynamics GP Safe Pay module. This field prints Address lines 1, 2, & 3, city, state and zip from the Bank Maintenance card for the Bank ID associated with the checkbook. If any of the address lines do not have data, this field automatically resizes to eliminate blank lines. This field prints Address lines 1, 2, & 3, city, state and zip from the Company Setup dialog box. If any of the address lines do not have data, this field automatically resizes to eliminate blank lines. New Amount Paid Voucher This field incorporates the logic laid out for the report writer calculated field. The purpose of this field is to print credit amounts as negative while including discounts and write offs in the paid invoice amounts. This field usually prints as the far right column for each voucher and shows the total being paid on the check at the bottom of the column. It substitutes for the standard Amount Paid field which prints credits as zeros. New Document Amount Employee Full Name SAFE PAY Social Security Number MASKED Voucher Employee Employee This field incorporates the logic laid out for the report writer calculated field called Enhanced Net Check Amount. This field works properly when applied order is selected for the Remittance List Document drop down. This field prints the Employee Name in all capital letters to conform to the format of the positive pay file created by the Dynamics GP Safe Pay module. Automatically masks all but the last four numbers of the employees social security number. 53

55 To add a field: 1. Open the stub file you want to add a field to. 2. Click the option on the Home or Layout toolbar. You see the Add Elements dialog box (for the purposes of this example, we are using the Payables fields and categories): 54

56 Version Expand the categories to select the desired field(s). For example, if you are adding the 1099 Amount YTD field, select the Vendor category: IMPORTANT If you are displaying GL fields, all fields pertaining to vouchers must be pulled from the GL Distribution category. If you are not displaying GL information, all voucher fields should be pulled from the Voucher category. Fields from the GL Distribution category cannot be combined with fields from the Voucher category. 4. Hold down the CTRL key to select multiple fields. 55

57 5. After selecting the field(s) you want to add, drag n drop them to the desired location on the Design window: 6. Drag the field to position it on the region. NOTE You can also add fields using the Add Elements command on the Add Elements screen. 56

58 Version 10.0 Adding Mekorma MICR easyadd Fields The Add Elements dialog box contains all of the fields associated with the Mekorma MICR easyadds. If you expand the next to an easyadd, you see the additional fields that need to be added to the check stub for the selected easyadd: You can download easyadds from (under the Mekorma MICR menu) or from the Mekorma MICR installation executable (for example, Mekorma_MICR_10.00b49.exe). For more information on Mekorma MICR easyadds, see the Mekorma MICR User Guide.pdf in the Mekorma MICR folder of your Dynamics GP directory. Using the Right-Click Context Menu In some workspace areas of the Configurator, you can right click to display a context menu containing several common actions, such as Copy, Paste, Delete, Expand or Collapse. If you right click on the Add Elements dialog box, you see the following menu: Click Expand All to display all the fields in all the categories and Collapse All to display just the categories. 57

59 The Expand/Collapse context menu is available from the navigation window to expand or collapse fields on the selected stub regions. There is also a right click context menu that allows you to cut, copy, paste, or delete multiple fields at the same time. The right click menu provides an easy way to copy and paste objects between stub files. When you use the Copy and Paste options on the right click menu, you create exact duplicates of the selected fields. You can then add those fields to another stub file, and they remain in the same relative position they were on the stub file you copied them from. Select several fields (or a single field) that you want to modify (hold down the CTRL button to select multiple fields) and right click to display the menu options: Select Cut to cut the selected fields. Use the Copy option or CTRL+V on the keyboard to paste the fields back on the stub form. Copy to copy the selected fields. Use the Paste option or CTRL+V on the keyboard to paste the fields back on the stub form. Paste to paste the selected fields back on the stub form. Delete to delete the selected fields. If you delete a field in error, you can click the Undo option to go back one command. 58

60 Version 10.0 Multi-Text and Single Text Fields For multi text fields, the Lines of Text field defines how many lines of information will print for the field on each page. For example, if the Voucher::Document Number Lines of Text property is set to 11, the Document Numbers for the first eleven vouchers will print on the first page. If more than 11 vouchers are being paid, the12 th number flows onto the Overflow format (if selected). NOTE The Overflow format is the format entered in the Overflow Stub Format field of the Mekorma MICR Setup (Payables) dialog box. 59

61 If the Field Type is Single Text (for example, a field with only one value per payment, like the Vendor ID field), the Lines of Text field is not displayed. TIP All related multi line fields on a region should be set to display the same number of lines. See the Working with Field Sizes section for detailed instructions. NOTE Font size, type, and style affect how much information can be displayed in each field. Deleting Fields If you add a field and then decide not to use it, or if you want to delete an existing field, use the Delete Fields option on the Home or Layout toolbar to delete the field. To delete a field, select the field (or fields) you want to delete and click the option. If you delete a field in error, you can click the Undo option to go back one command. Data Type Field Properties The following properties are displayed for data type fields (including Labels, Single Text, and Multi Text field types): Field Type: Displays the type of element selected. 60

62 Version 10.0 Field Name: Displays the name of the field selected. To change the field, click this property and select a different field from the Add Elements dialog box. Left: Defines the y axis location of the data field (as measured by the ruler). Top: Defines the x axis location of the data field (as measured by the ruler). Width: Defines the width of the data field. Height: Defines the height of the data field. Lines of Text: This read only field displays the number of lines of text that will fit in the field and is calculated based on the Height value of the field. This property is not displayed on label fields with a single line of text. Font: (default = Tahoma, 8, Black, Regular) Displays the font properties for the selected field. Click in the Value column to launch the Font dialog box and select from the font options available to Windows applications. White on Black: (default = False) Change to True to reverse the text color to white on black. See Changing Font Properties for more information on using this property. Alignment: Options available are Left, Center, and Right. Upside Down: If checked, the field name is inverted and displayed in an upside down position. Backwards: If checked, the field name is reversed and displayed in backwards from the original position. Vertical: If checked, the field name is displayed on the side of the field in a vertical position. Lock: If checked, the element is locked in a position relative to the form. Locked elements cannot be moved or resized and you cannot modify properties on a locked element. Locked elements are moved if the region they are located in is moved. 61

63 Field Properties Specific to the Date Data Type Date Format: Enter a date format if the label is a date. Field Properties Specific to the Currency Data Type Hide When Empty: (default = unchecked) If checked, hides the field when amounts reported are zero. Suppress Currency Symbol: (default = unchecked). If checked, suppresses the currency symbol. Field-Dependent Additional Properties Total Line: (default = unchecked). Check this option to display a total for the column. Note: The height of a field does not include the height of the Total line. Using the Continued Field On the Add Elements screen under the Logical Fields Category, there is a field called Continued. 62

64 Version 10.0 This field is used to define where you want the overflow information on your check stub to print. If you add the field to your check stub and click the Properties window, you see the following properties: You can change the value in the Text field by clicking it and entering a new value in the Enter Text screen. The default value in the Overflow Type field is First and Middle Pages, but you can choose from the following list of types: You can add any number of Continued fields to a check stub. 63

65 Adding Labels and Static Text Labels can be single or multi lined text wrapping fields. The Labels category contains a collection of the most common words and phrases used on checks and stubs. Using fields from the Labels category is an alternative to adding the words as a static text label. If the words or phrase you want does not exist in the Labels category, you must add it as static text (see the section on Adding Static Text Labels). Adding a Label from the Label Category To add a label from the Label category: 1. Open the.stb file you want to add the label to. Click the option on the Home or Layout toolbar. 2. You see the Add Elements dialog box (for the purposes of this example, we are using the Payables fields and categories): 64

66 Version Expand the Commonly Used Labels category and highlight the label you want to add: 4. Click either the Add Elements button to add the selected label(s) to the stub file. The label is added in the upper left corner of the stub file: 5. Position the label as desired and save your changes. Adding Static Text Labels If the words or phrase you want does not exist in the Labels category, you must add it as static text using the Label button on the Add Elements dialog box. You can add any text to checks and stubs as static text. Static text prints the same way on every check or stub using the format containing it. If the text you want to print is a common term, such as DATE, it may be listed in the Labels category and you can add it as a label instead of as static text. To add a static text label: 1. Open the.stb file you want to add the label to. Click the option on the Home or Layout toolbar. 65