Step 6 - Streamlining the Website's Bin Folder and Running the Synchronizer

After updating the website with the e-Business updates, streamline the website's bin folder to remove extraneous files and then run the Object Repository Synchronizer for your e-Business Sync Repository Objects record only (do not download all of the objects to the bin folder). This topic describes the process in more detail.

Aptify e-Business deploys a streamlined set of files to the website's bin folder so it encapsulates only the functionality used by the out-of-the-box user controls and clients can add additional DLLs to the list as needed.

The set of Aptify Object Repository Objects required by e-Business are specified in the e-Business Sync Repository Objects record. Whenever you run the Object Repository Synchronization Utility against an e-Business website, you should select the Specify a Sync Repository Objects Record option and select the e-Business entry (or your site's Sync Repository Objects record if you create one) from the drop-down list box.

For updates to existing sites, the bin folder will already contain all of the objects from the Aptify Object Repository, so you need to perform a one-time operation to clean out that bin, as described below. Note that setting up your own Sync Repository Objects package may require some trial and error before you have the complete set of objects identified.

1. In Aptify, review the set of objects contained in the e-Business Sync Repository Objects record.
2. Create a backup copy of the site's current bin folder for reference.
3. Compare the e-Business Sync Repository Objects list with the contents of the site's bin folder. You should be able to remove the majority of the Aptify objects, such as images, icons, and XML files. You can also delete Aptify DLLs since the required DLLs will be added the next time you run the sync tool for the e-Business Repository Objects package.
   • Do not delete any third party controls.
   • If in doubt, Aptify recommends that you leave the file in the bin folder or contact Aptify Technical Support for assistance.
      
4. Run the Object Repository Synchronizer against the bin folder, only downloading the files from the e-Business Sync Repository Objects package.
5. Launch the e-Business site.
6. If the site fails to load due to a missing object, identify the name of the missing object. The exception recorded to the Error Log should identify the name of a missing file.
7. Locate the missing file in the backup copy of the bin folder you created earlier or in the Aptify Program Files folder from a computer that connects to your database with the Aptify Desktop client.
8. Copy the missing file to the website's current bin folder.
9. Launch the site again. Repeat steps 6 through 8 until you resolve all of the missing file errors and the site loads as expected.
   • Typically it will be a manual, iterative process to identify missing files. In other words, as you resolve one missing file error, you may then encounter the next missing file error. Also, you may not learn of a missing file until you browse to a particular page. So, be sure to test all of your pages prior to go-live.
      
10. Log in to Aptify as an administrator and browse to the Object Repository application.
11. Open a new record in the Sync Repository Objects service. If the service does not appear in the application, you may need to add it from the Application Services selection dialog.
12. Clone the e-Business Sync Repository Objects record. Before saving, change the name of the new record (for example, by adding your organization's abbreviations as a prefix).
13. After saving the record, click the Sync Repository Object Files tab and add the files required by your website to the list of objects. (That is, add all of the files you had to manually drop into the web site's bin folder in steps 6 to 9 above.)
14. Anytime you need to run the Object Repository Synchronizer to update your site's bin folder with the latest objects, select the Specify a Sync Repository Objects Record option and choose your organization's e-Business Sync Repository Objects record so all of the objects for your site are updated as expected.