The eDocBuilder Plugin for Adobe InDesign can be installed by getting the download for your version of InDesign, and installing the files from the download into your InDesign Plugins folder. Some common issues involving installing the files from the download, if InDesign is saving preferences and settings, and generally working as expected, are detailed below.
1) Make sure InDesign is not running, and have the download for your installation of InDesign available before continuing with the steps below. Unzip or extract the downloaded file, which should create a new folder. The new folder can be placed into the /Plug-ins folder for your version of InDesign. The location of the plug-ins folder depends on your version of InDesign, and could be different for any computer or operating system.
2) The eDocBuilder plugin for InDesign does require all of it's associated files and folders to be installed completely. This includes the plugin files for eDocBuilder and BasicPersistentInterface, and their respective folders and contents, from the downloaded archive file. All of the folders and files in the download, as shown below, comprise the eDocBuilder plugin.
3) The plugins need to be installed into the /Plug-Ins directory for your version of InDesign. This location could be different on any computer depending on the operating system and version of InDesign installed.
4) The plugin can be installed in a subfolder in the /Plug-Ins folder. So you can create a eDocBuilder folder in /Plug-Ins and copy in all the files and folders from the download archive into that folder.
5) When the plugin is first loaded and InDesign is launched, the plugin will try to create a file EDOCBUILDER.cfg in the directory containing the plugin. If the permissions for the user account running InDesign do not allow that account to modify or create a file in that directory, you may see an error when InDesign starts up or when attempting to use the plugin, it will also not save the plugin preferences details.
6) Preferences for the eDocBuilder plugin are available from menu commands Edit > Preferences > eDocBuilder once the plugin is loaded in InDesign.
7) You should be able to load the plugin into the directory folders, start InDesign, go to menu commands Edit > Preferences > eDocBuilder, and enter your eDocBuilder master account credentials. Note that these MUST be the credentials for your master eDocBuilder account that were provided in your welcome email when you signed up for the eDocBuilder service. It has to be the master eDocBuilder account credentials, it cannot be a user you created in your eDocBuilder account.
For the Server setting, the server address will depend upon the web address that you use to log into eDocBuilder.
If you login at creator.edocbuilder.com then use: http://engine.edocbuilder.com
If you login at creator-sg.edocbuilder.com then use: http://engine-sg.edocbuilder.com
If you login at creator-ams.edocbuilder.com then use: http://engine-ams.edocbuilder.com
9) If you restart InDesign after entering your account credentials, your preference settings should be saved and will be available after you restart InDesign. Try restarting InDesign and re-opening the preferences window to make sure it is saving your preferences as expected. Note that the preferences window does display the version of the plugin that you have loaded, as well as the version of InDesign you are running.
10) If it is not saving the preferences that you entered when InDesign restarts, and you are on Windows, you can try enabling InDesign to run as an administrator. Go to the application program icon and use the right-click context menu to access Properties for InDesign.exe. Set Run as Administrator and try launching the application again.
11) On a Macintosh, the plugin expects to be placed in a folder named eDocBuilder inside of the InDesign Plug-Ins folder. So a folder like /Applications/Adobe InDesign CC 2019/Plug-Ins/eDocBuilder/, depending on the version of InDesign installed. If the plugin does not have adequate permissions to read and write to the configuration file, then your preference settings from Preferences > eDocBuilder may not be getting saved when testing the plugin and restarting InDesign. You may need to make some manual adjustments to the folders in Plug-Ins, in your InDesign application folder. Quit out of the InDesign application when making these folder changes, or restart InDesign once these changes are made.
You can manually create an eDocBuilder folder in the Plug-Ins folder, and manually create a text file called EDOCBUILDER.cfg in that same folder if these folders and file are not being created when running the eDocBuilder plugin in your copy of InDesign. Then right-click on the /Plug-Ins/eDocBuilder folder, choose Get Info, and look at the Permissions settings. Add your user and set permissions to Read & Write, so that your user has access to the /Plug-Ins/eDocBuilder/ to Read and Write to the EDOCBUILDER.cfg file.
It is important to understand that features in InDesign that do not also exist in eDocBuilder will not work. As an example, you can not create tables in an eDocBuilder template so if you have a table in your InDesign file, it will not be able to import and you will receive an error. Make sure your InDesign file is set up considering eDocBuilder and the features that eDocBuilder supports. For some considerations when preparing documents for use with eDocBuilder, please see the article Tips, Tricks and Warnings for using the InDesign Plugin.
13) Once the plugin is installed and saving your preferences, try creating a new, blank document with one text field. Open the palette from menu command Window > eDocBuilder, select the text field with the item tool and give that field name and prompt values.
14) The area of the selected text box on the InDesign document will become a field in the eDocBuilder template when uploaded. Remeber that Field names must be alphabetical characters only (A-Z or a-z). Numbers or special characters cannot be used. Names may not contain spaces. No duplicate names are allowed, all field names must be unique.
15) Once you have your test document created, you can upload that to eDocBuilder by going to the flyout menu at the upper-right corner of the palette and choosing Upload Template.
Give the new template a name and choose the Template Type the uploaded document will become.
If the plugin is working as expected, you will see a progress bar and some messages relating to uploading the template, and then it will confirm if the template has been created successfully.
18) Now you can log into eDocBuilder admin and continue editing and testing your template online. Once a document has been uploaded to eDocBuilder, it will require some adjustments to the field settings.For example, the Force-Fit option will be enabled for new fields on the Format tab under Field Setup. You may wish to disable that on the fields if you do not want to see the text inside of those fields changing in font size and spacing.
19) Once a document has been uploaded to an eDocBuilder template, that document contains information that relates it to that specific eDocBuilder template in your account. That relationship will be saved when the InDesign document is saved. That relationship can only be broken by using the Upload as New command from the eDocBuilder palette flyout menu. You may wish to save a version of any of your live documents, prior to uploading a document to eDocBuilder.
To make good use of your time using the eDocBuilder Plugin for InDesign, please review all of the points on the tips and tricks article. eDocBuilder and InDesign are very different envronments, with very different capabilities, so there are differences and considerations. To understand some basic considerations, please review the points on the following article. Tips, Tricks and Warnings for using the InDesign Plugin
If you are having any trouble with installation or operation of the eDocBuilder plugin for Adobe InDesign, please open a new ticket to us at support.aleyant.com