Professional Third-party Interface

Top  Previous  Next

 

With the Professional Third-party Interface a third-party software program can create a merge file which it then executes. MS Windows recognises that the merge file (.TPM) belongs to ADLForms and automatically opens ADLForms to process it. The merge file can contain any number if instances of the one form (eg. multiple entry notices for different tenants).

 

There are two stages to the merge process as follows:

 

Merge Stage #1

 

Once ADLForms opens the merge file you may be* presented with an options screen as follows:

 

ThirdPartyMergeOptions2

 

Within the merge screen you have options to:

 

Change/Choose the Forms Package to be Used**
Change/Choose the Form to Merge to**
Choose a Template to Use for the Selected Form
Choose Whether to Save Forms Automatically
Choose  Whether to Lock the Form Upon Saving
Choose the File Name Format for Automatically Saved Forms
Choose the Merge Action Required

 

* Depending on the third-party program merging with ADLForms, some of these options may be locked and not changeable. If all of these options are locked  this screen will not appear at all and you will be presented with merge stage #2 immediately upon starting the merge process from within the third-party program.

 

** It doesn't matter what form you select to print to from within the third-party program. You may change your mind and select any form within any ADLForms package that you subscribe to. ADLForms uses generic field names for all fields on all forms. As long as the fields required on the form you selected in the third-party program are the same fields (or mostly the same) on the form you select in the ADLForms Third-party Merge Options screen, most or all of the information will still merge successfully (Some third-party software packages output all possible fields required for the appropriate department {Property Management or Sales}, regardless of the form being printed - trial and error will tell whether the third-party software you use follows this approach). The only information that may not merge is for those fields that are not common between both forms.

 

Changing the Forms Package to Use

 

Within the 'Forms Package' box select the forms package that contains the form you wish to merge to.

 

Changing the Form to Merge to

 

Within the 'Forms' table select the form you wish to merge to.

 

Choosing a Template to Use for the Selected Form

 

Within the 'Select a Template to Use' list box, select a template to use for this merge. It will default to the 'Default Template' you have selected within 'Setup Options' in the <Third-party Interface> tab.

 

Automatic Saving

 

ADLForms will automatically save forms when printed if you select this option (Default is 'No'). For this option to work correctly a 'File Name Format' must be set (See below).

 

Automatic Locking of Saved Files

 

This option, although not available in normal ADLForms operations, allows merged forms to be saved and locked so that they cannot be edited again. You may still open a locked form and print it, but you may not change it in any way. This feature ensures that forms are kept secure for future reference.

 

File Name Format

 

This option allows you to specify a file name format for automatically saved forms, either as forms or .pdf files (See pop-up format list below). This does not affect any forms that you may save manually during the merge process, which you can name manually.

 

ThirdPartyFileNameFormats

 

If the third-party application does not output any of the Codes mentioned (ie. Owner, Property & Tenant), then the format options using that code will not appear in the list.

 

Merge Action

 

There are three actions that you can take to merge your data. They are:

 

* Print to Printer

If you select this option ADLForms will automatically print all forms in the merge file without allowing any further user intervention. If you select this option there may be certain fields that may not be filled in because the third-party application has not output that information. Only use this option if you are absolutely sure that all information for each form is present in the merge file.

 

Also, when using this option you can take advantage of the 'Automatic Saving' option to ensure a form file is saved for each  form printed.

 

* Output to PDF

If you select this option ADLForms will automatically save all forms in the merge file to a .pdf file (Adobe Acrobat © ) without allowing any further user intervention. If you select this option there may be certain fields that may not be filled in because the third-party application has not output that information. Only use this option if you are absolutely sure that all information for each form is present in the merge file.

 

Also, when using this option you can take advantage of the 'Automatic Saving' option to ensure a form file is saved for each  form saved to pdf.

 

* View

This option allows you to scroll backwards and forwards between all forms to be merged. As you display each form you can save, save to PDF or print as required. As you scroll backwards and forwards between forms there will be indicators to show whether you have already printed, saved or saved the form to PDF (See 'Merge Stage #2').

 

Merge Stage #2

 

After selecting all the merge options as outlined above and clicking the 'Merge' button the first form in the merge file will be displayed to the screen. The screen will look similar to a normal form completion screen, except that you will be given the opportunity to scroll backwards and forwards between forms, processing them one at a time. If you make any mistakes you can go back to any form and re-process as required. Indicators will show the total number of forms to be merged, how many forms have been view, printed, saved and saved to PDF and whether the current form has been printed, saved or saved to PDF. The screen should look similar to the snapshot below.

 

ThirdPartyMergeEntryScreen

 

Merge Process:

 

1.

From within your Real Estate software application follow the processes required to merge to ADLForms. This will vary from application to application and appropriate help should be available within your real estate application.

 

2.

If the 'ADLForms Third-party Merge Options' screen appears, set all required preferences and click the <Merge> button.

 

3.

Process each form in turn, saving, printing or printing to PDF as required.

 

4.

Once all forms are processed to your satisfaction (The 'Merge Status Bar' will show the status of all processing), you may simply click on the <Quit> button to finalise the merge process.

 

5.

A Merge Results screen will appear showing the results of the current merge.

 

ThirdPartyMergeCompletion

At this stage you have the opportunity to click the 'Cancel' button to complete the processing of any forms you may have missed.

 

6.

To complete the merge process click the <OK> button. ADLForms will unload and you will be return to your real estate management application.