Add-Ins are used to extend the base functionality of AddIns. You can add buttons at strategic locations in the interface that allow your users to open other web pages or even perform full program actions.


Add-Ins can be as simple as a web page link to take the user to another application or as complex as a DLL written specifically to perform a business function. 





General Settings


Name

The name that will be shown on all the Add-In buttons for this Add-In.


Description

This is only shown here for your notes


Type

This is where you specify the type of Add-In you wish to use. The other questions that appear will depend on the option you select here.


Web URL

If you specified any URL-based types this this is where you can put the URL value. You can use variables like [RecordID], [DocumentID], etc. to be able to send those IDs to the URL you are calling.


Web Target

The name of the window to use for showing the URL.







Where/When to Show Settings





Where to Show

Where to show the button(s) for this Add-In inside the DocMgt interface.


Top Toolbar List - This will show the button(s) on the toolbar. If only Add-In is set to display here then that will be the button that shows. If more than one are to display then a drop-down menu of available Add-Ins is shown.


Show Add-In in Lower Toolbar - This will show the Add-In button in the lower toolbar section. They will be just to the left of the Last Search button.


Toolbar Admin Panel - This will show the Add-In in the Admin panel. This is usually reserved for actions that are Administrative in nature. The option will only be visible to admin users.


Toolbar Reporting Panel - This will show the Add-In in the Reporting panel. This is usually reserved for actions that are Reporting in nature. The option will only be visible to reporting users.



Record Add-In List - This will show the button(s) on the Record screen in the Add-Ins panel.


Show in Main Record Screen - This will show the Add-In button at the top of the Record screen. It will also be available in the Add-Ins panel.


Add-In Will Have Opened / Checked Documents Available - If this options is OFF, then the Add-In will have the OPEN Documents available as the Active Document. If the option is ON, then the Add-In will have the CHECKED Documents available to it. In the latter case, the actions in the Add-In will run once per Document.


Search Add-In List - This will show Add-In in the search results page. The Add-In actions performed upon all checked Records OR on all searched Records if none selected.


Show in Main Screen - This will show the Add-In button at the top of the Search Results screen. It will also be available in the Add-Ins panel.


AddIn Pre-Process and Post-Process actions will/will NOT be sent Record IDs - If this options is OFF, then the Add-In's Pre-Process and Post-Process actions will NOT have access to the IDs of the Records that were found int he search. If is it ON then the IDs Records that were found in the search WILL be available to the Add-In's Pre-Process and Post-Process actions via the @RECORDIDS variable. The IDs will be a string with ; (semi-colon) as a delimiter.


RESTS Interface (API Calls) - This will allow the Add-In to be called via a REST API call.


Record Types

If you selected Record or Document above then you can specify the Record Types for which this Add-In is valid. If the user is in a Record for that Record type then this Add-In will be available.


Work Triggers

If you selected Record or Document above then you can specify the Workflow Triggers for which this Add-In is valid. If the user is in a Record and that Record is shown in the context or a Workflow Trigger and that Trigger is one you selected then this Add-In will be available.


When to Show

After the above options are evaluated and the Add-In passes those tests, you can also add in more visibility tests to give you greater control over when the Add-In is seen. For instance, you can specify to show the Add-In only when the current Record has a field named "City" that is not blank. Or you could have this Add-In only show when the "Age" field is greater than 50.




These activation rules are very similar to Workflow Activation Rules but are not dependent on having Workflow enabled.






Actions

Actions allow your Add-In to perform certain actions from the server side before triggering any other interface. For instance, your you might have the add-in update a Record variable before calling your custom add-in screen. You could also add notes and trigger workflow from your add-in button click.




Pre-Process and Post-Process Actions

When using an Add-In from the Search screen, the Add-In can run a set of actions BEFORE and AFTER the actual Records are run. This allows you to set up the environment then run the Records then reset things or finish the process after all Records.




These actions are very similar to Workflow Actions but are not dependent on having Workflow enabled.






Data Entry

You can prompt a user to enter or validate data when the Add-In is activated. This is a great way to have them confirm data amounts or select a user to send something to.







Confirmation Prompt

You can confirm a user's actions by using the Confirmation Prompt. 







Request Signature

You can pop up a signature field that asks for the current user to sign off on the action. This signature is saved into the Record(s) being run against in a field you designate.