Overview The InDesign Scripting DOM provides full access to the creation and manipulation of all content within InDesign. By combining this the speed of Lua with the data access and control facilities of EasyCatalog, it’s possible to create data driven content in virtually any format. Accessing The InDesign Scripting DOM can be accessed via Lua […]

Use this option when a custom field has no computed content, and the content is provided exclusively using a Lua script. This is a special type, designed to prevent the editing of raw content and restricting the user interface to applicable field options. Any existing field content is cleared before the script is executed to […]

If you’re recently requested assistance from 65bit, you may have received a number of files that demonstrate how to configure EasyCatalog. Here’s a run-through of what you may have received and what you should do with them: Data Source Folder This is typically sent over as a zip file, so unzip it before going into […]

The custom report option allows provides a mechanism to inspect data source or document related information and output it in virtually any format.   LuaSocket support is enabled for custom reports, which can be exported in a variety of ways, such as files, posted via HTTP or shown in a browser. The pencil icon provides access […]

The Adopt Fields->Custom menu facilitates the development of custom scripts to manipulate individual links in the current document. The dialog displays the active documents links on the left, and the links after processing by the script. Pressing the Test button will execute the code for each link and present the results in the right hand column. […]

Once a Formatting Rule has been populated with data, it can be processed before final placement using Lua code. Typical uses for this would be to position frames relative to one another,  position a series of images,  or incorporate other Formatting Rules to build a layout. It’s also possible to create the entire content via […]

The EasyCatalog preference panel provides access to Advanced preferences. Relaunch InDesign To Apply Any Changes. EasyCatalog Workspace Multi User Workspace Defines the the default setting when the preferences are rebuilt. Cache Formatted Data  When true, EasyCatalog stores the ‘formatted’ content of a field for quicker data source loading. When it’s false, the formatted content is rebuilt […]

The “ENV” custom field command can be used to determine environmental properties of EasyCatalog, such as the version of InDesign that’s running or the platform (Mac/Windows) that EasyCatalog is running on.

The “ENV” command takes a single parameter, which the name of the attribute you would like to retrieve:

The Apply Swatch Named in Field “Pagination Rule” can apply either a named swatch or an RGB or a CMYK value if that value is in a field.   For RGB, the value should be: #RRGGBB Where each part is a 2 digit hexadecimal value. For CMYK the value should be: cNNNmNNNyNNNkNNN Where NNN is the […]

EasyCatalog attempts match the tag name to a character or paragraph stylesheet. In this example:

EasyCatalog attempts to apply a stylesheet called “ul” before performing the default behaviour. Since there is a nested <ul> inside a <li> tag, EasyCatalog attempts to apply a tag called “ul>ul” for a single level of nesting. For three […]

For images that are sourced externally but are not URL or File based, the “Custom” option can be chosen in the picture location section of the field options. When this is set, EasyCatalog looks for a file called ‘CustomImageImport.jsx’ in the ‘Scripts’ folder of a data source. Here’s a simple example that displays the field […]

Specifying defaults for the Workspace folder location The default location for your EasyCatalog workspace folder can be specified creating a preference file in your preferences folder, which on the Mac can be found at:

on Windows it can be found at (although it depends on the version of Windows):

The file should be […]

The Versions Panel allows the quick and easy creation of multi-version content. To use this functionality, data must contain a record for each version of a product. The related records need share common field content in order to identify them as a single ‘product’.  A very simple data set might look like: page number position product […]

To Generate Web Hyperlink QR Codes:

Create an empty picture frame, then show the ‘Script Label’ panel (from the Window > Utilities menu). Change the ‘URL’ to be the name of the field containing the URL you want to link to.  Once you’ve entered that, you’ll need to click off the frame so that InDesign […]

EasyCatalog can automatically tag fields in existing documents by looking for patterns in the text defined by a regular expression. This feature – Auto Pickup – is designed to mark up documents that have already been created (either by hand or by another automation method) and is useful for updating prices, for example.  Auto Pickup […]

Defaults for data providers can be specified by creating a preference file in your preferences folder, which on the Mac can be found at:

on Windows it can be found at (although it depends on the version of Windows):

The file should be created using a text editor (such as Notepad or TextEdit) […]

EasyCatalog has the ability convert XML tags to EasyCatalog tags via a simple LUA script that maps tag attributes to the elements of a link (key, data source, field name). The .lua script should be placed inside a folder called “Adopt Fields” in the “Scripts” folder of a data source.  The file name of the […]

The “Adopt Fields” method of relinking assumes field names and key field values are consistent between the existing links and the new data.  It was designed to link fields from one data source to another, and as such is limited to changing the key element of a link. In some circumstances it may be necessary […]

Full list of formatting codes, used in the input and output field options of a date/time field: %a Weekday as locale’s abbreviated name. Mon %A Weekday as locale’s full name. Monday %w Weekday as a decimal number, where 0 is Sunday and 6 is Saturday. 1 %d Day of the month as a zero-padded decimal […]

You need to include a preference file in your preferences folder, which on the Mac can be found at:

on Windows it can be found at (although it depends on the version of Windows):

The content of the file should be:

Overview Fields can contain tabular data, where each cell is treated as an independent link.  Tabular field data can come from a number of sources, including delimited field content, other data sources, HTML, XML, or built from conditional logic. Example In this example the field “AttributeValues” contains the following XML snippet:

The first stage is configure the field as ‘Tabular’ […]

There is a script called “PaginationProgress.jsx” which you can place in the Data Sources “Scripts” folder. This is passed script arguments: “datasource”  : The Data Source Name “stepindex”  : Current Step Index “stepcount” :  Total Number of Steps “step message” : Related Message You can access them like this: var stepCount = Number(app.scriptArgs.getValue(“stepcount”));

Paths are represented differently on Macintosh and Windows machines.  This has an impact when working in a cross-platform environment as a picture import path configured on Macintosh would not work on Windows and vice-versa. To overcome this, a Custom Field command can be used to determine the platform that EasyCatalog is running on:

The […]

Custom field functions and field formatting options can be used to format numeric values in a variety of ways.  For example, here the data contains ‘value’ and ‘appearance’ is at it should be displayed: value appearance 636000 636,000 20000 20,000 1400000 1.4 Million 6200000 6.2 Million 473000000 473 Million 40000000 40 Million 45000000 45 Million […]

When downloading an image from a URL, by default EasyCatalog will attempt to build a filename based on the format of the URL.  Sometimes, however, the filename used is not desirable: for example, the links shown in the Links panel in InDesign will sometimes be meaningless. EasyCatalog provides a feature to specify a file naming […]

‘Computed Fields’ have additional commands that allow behaviour based on the position of the field within a document: TAGPAGENUMBER() – Returns the page number the tag is on, or -1 for the pasteboard TAGPAGEX() – Returns the X position of the tag in points. TAGPAGEY() – Returns the Y position of the tag in points. TAGSPREADX() -Returns the X […]

Using the field options, the ‘cleansing’ edit area can be used to replace a specific unicode code point for another character. For example: REGEXV2:[\x{2028}]=^n; This replaces the hexadecimal code point 2028 with a soft return. In this specific case, the code ‘Numbers’ uses as a soft return.

EasyCatalog supports an embedded version of the Lua programming language.  When text is processed, any commands between  delimiters [[ and ]] are processed using Lua. EasyCatalog supplements Lua with functions to make data access easier. For example:

In this example, if the contents of the ‘new’ field are equal to ‘1’ the text NEW! will be output. […]

By default, Pagination Rules are not re-applied during an Update Document operation.  However,  holding down a keyboard modifier while selecting the ‘Update Document’ menu can force them to be reapplied: Shift key: if a box contains any field that has been updated its Pagination Rules will be reapplied Shift + Alt key: Pagination Rules will […]

The problem is actually InDesign drawing bold text in the user interface. The upgrade to Yosemite sometimes messes up the UI fonts used by InDesign. Launch your ‘Font Book’ application and look for Helvetica Nue. There should be a suggestion to fix problems relating to this font.

A common requirement is to construct a so-called Crosstab, in which multiple attributes are incorporated in a single table. For example, this data represents sets of trousers, with waist, length and price elements. XML Data:

The target layout involves a table with the distinct lengths horizontally, distinct waist sizes vertically and prices in each cell. This can […]

When a document is created using incorrect key fields, this can be corrected using the keyboard shortcut called “Change Document Keys”. Steps involved changing keys are: 1. Create a data source with the NEW key setup and select any record in the panel. 2. Use the keyboard shortcut “Change Document Keys” 3. Enter a comma separated […]

EasyCatalog can insert hyperlinks that link to other pages in the document or, if the document is stored in an InDesign Book, to pages in other documents in the book.  The most common usage of this to produce contents or index pages that can link to the actual page in the document when the user […]

It’s possible for EasyCatalog to build a path to an image from the data, but this only works in there is a clear structure to the way the images are stored.  For example, if all the images beginning with ‘A’ are stored in a folder called ‘A’ then you can build a path using custom […]

The movie below shows an XML Fragment being used to populate a series of fields and an entire table. The data sources is created with just two fields – one for the “Product ID” and one to contain the contents of the “ProductAttributes” node structure. XML Example:

Variations on the following “Computed Field” command are used […]

Field options can be applied based on the value contained within. Here’s an example that will format prices over a dollar like this: $1.00 ..and under a dollar like this: 50₵ To do this define a ‘custom’ format and enter: [PRECISION=2] [DECIMAL=.] [REMOVE=0.(

Occasionally it is necessary to change the key field configuration used in your data source: if, for example, the wrong key field was chosen when the data source was originally created. Fields in the document are linked by key field value, so changing the key field can break the links in your documents. However, there […]

Not directly, but it is possible. Here’s a reseller who has produced simple bar graphs using EasyCatalog… http://www.ozalto.com/en/bar-graphs-with-indesign-easycatalog/

The easiest way to remove EasyCatalog is to delete the “EasyCatalog” folder from your InDesign->Plug-ins folder.

Some fonts have a variety of bold and italic faces, so it’s not easy and sometimes impossible to figure out which to use in any given scenario. To overcome this there are a number of attributes that can be specified on the <i> and <b> tags, namely:

For Example:

When the tag is […]

When a field is flagged as “Formatted” using field options, EasyCatalog will try to match any HTML style tag to the name of either a paragraph or a character stylesheet and apply it. For example, in the following text:

If a paragraph style called “bullets” exists, this is applied automatically. The default behaviour of […]

User-interface elements of EasyCatalog can be suppressed (disabled) or hidden using a “SuppressedUI.xml” file in the root of the EasyCatalog workspace folder. The XML file must be well-formed, with a single SuppressedUI element at the root. The root element can contain any number of SuppressedMenu and SuppressedAction elements. SuppressedMenu elements have a menuName attribute, which […]

Here’s an example CALLSCRIPT script that references record data passed to it:

After EasyCatalog imports an image, it looks for a script called “PostImageImport.jsx” in both the Data Source->Scripts folder and the EasyCatalog Workspace Folder->Scripts folder. This can be used to manipulate an image after import. The example below applies the DETECT EDGES clipping path setting:

Custom Fields are fields that are created in EasyCatalog that are not present in the source data. Their content is created using one of our in-built functions, in a similar way to using functions in Excel. So, for example, it’s possible to create a custom field that summarises data from a collection of records. Custom […]

If by panel you mean ‘data source’, then yes. Close all your existing panels using the “Windows->EasyCatalog Panels->Close All” menu option. Then locate your ‘EasyCatalog Workspace Folder’ via the Reveal button in the InDesign->Preferences->EasyCatalog section. Then just rename the appropriate folder in there and open them from File->New->EasyCatalog Panel

Holding the shift key down while dragging the left margin will fix the left-most column in the panel view:  

This example uses a formatted field and cleansing to make the decimal part of a price Superscript:  

The “Cell Finder” keyboard short can automatically tag existing table content based on the presence of key values in the table. Here’s a simple example of this in action:  

EasyCatalog can populate a table providing the table contains the key value of records in an associated data source. This is achieved using the ‘Auto Fill Tables’ keyboard shortcut. In this example, a table is populated using field names contained in the table header:

Select a cell in the table you can use the Table > Table Options menu from the data panel’s pop-out menu and set the ‘Expand’ pop-up to be ‘No Expansion’.

The easiest way of doing this is to prefix the field with a formatting tag: e.g. <mystyle>text text text</mystyle> If you set the field to be ‘Formatted’ in its Field Options, you should find that the character style named ‘mystyle’ will be applied to the text in the example above.  If you have a field […]

A Custom Field is a field the exists in your EasyCatalog panel but not in the source data.  A custom field can be populated using one of our inbuilt functions, and are often used to manipulate the source data into a form more suitable for appearance on the page or to summarize group data. To […]

On the Field Options dialog provide a list of valid image file extensions, separated by a semi colon: EasyCatalog will attempt to import images using the list of file extensions in the order given in the list, so if you would prefer Photoshop images to be imported instead of JPEGs ensure that the .psd file […]

The location of the images is determined by the Field Options: on the image box you will have tagged a Field Specifier, so take a look at the Field Options for that field. On the ‘Picture Content’ pane you should see the folder where EasyCatalog is looking for the images. Failing that, right click on […]

EasyCatalog will only look in the folder that you have specified in the Field Options for the field. This is mainly for performance reasons, as searching sub-folders each time an image is placed could adversely affect performance. However, if the path to the image can be determined using the content of other fields then custom […]

Yes, EasyCatalog supports both UTF-8 and UTF-16. If you’re seeing characters coming into EasyCatalog incorrectly check the data source configuration, and the ODBC driver configuration when using an ODBC data source.

EasyCatalog supports EAN13 and EAN8 barcodes through the use of a free barcode font. EasyCatalog that can take the 7/8 or 12/13 character EAN code and convert it into the necessary glyphs for the font, using a custom field: Right click in the centre of the panel Use the “New Custom Field” menu option Give […]

EasyCatalog requires that the values in the field(s) you have defined as being ‘key’ fields are unique. This is to enable it to uniquely identify each record in your source data so that if, for example, a record changes position in the data it can still be found. When loading data, EasyCatalog will check the […]

EasyCatalog has no upper limit on the number of records or fields. The only limit is physical memory. InDesign CC and above is a 64 bit application, so can handle very large data sets. Earlier versions of are 32bit and as such limited to addressing around 4GB of memory.

The field markers in the document will not be visible if: ‘Hide Field Markers’ has been selected from the data panel’s pop-out menu.  This setting is stored with the document. To show the field markers, use the ‘Show Field Markers’ menu option from the panel’s pop-out menu. The document is in ‘Preview’ mode.  Switch back […]

The easiest way to achieve this is to use the ‘Update Panel->With Page Numbers’ option…

Placed records can be identified outside of EasyCatalog by updating the panel with Page Numbers,..

The field definitions file is located in ‘EasyCatalog Workspace > DataSourceName > Data > Fields.xml’…

To edit multiple fields Alt-click in the column headers to select the fields then right click and use “Field Options…”….

This example uses a loop to fill a table. Each product has a colour code, which is the column…

Custom fields can be exported back to a data source by holding down SHIFT + ALT and selecting…

If you have contacted support and we need to recreate your configuration here, we will need…

When EasyCatalog sees a table in a Product Style, by default it will insert one row per record…

If lots of data sources are open on start up and they are causing InDesign to become slow or…

This is displayed when dragging an item to the page if you have the ‘EasyCatalog Library’ option checked…

EasyCatalog Lite is designed for simple ‘link and update’ tasks, so the user is responsible for…

It could be that there is a populated cell somewhere off the right hand side of the spreadsheet…

This dialog warns that the document was edited without EasyCatalog being loaded, which is not recommended…

Each field in the document is linked to the source data using a combination of…

Removing these empty fields can be done in one of three ways – here’s a typical example…

The header row in the table is not defined as an InDesign header row…

The EasyCatalog workspace folder is a folder on the computer that stores EasyCatalog’s configuration settings…

Ordinarily the workspace folder which contains data source configurations and a snapshot of the source data — i.e….