/
The Basics (Client Organizations)

The Basics (Client Organizations)



Searches

APEXA is built so that Advisor, contract, licence, E&O coverage and address records are all housed in separate areas. While these pieces of information are linked to one another, searching within one area will return records of that type. For example, if you search in the Advisor area and indicate licence = expired as your search criteria, only Advisor Records which have an expired licence associated with their account will be returned.

Therefore, the APEXA portal allows you to search for any of the following types of records, based on different criteria:

  • Tasks
  • Contracts
  • Contract Requests
  • Banking Information
  • Advisors  
  • Licences
  • E&O
  • Name Change
  • Addresses
  • Phone Numbers
  • Emails
  • Disciplinary Action          

Using Search

The search feature allows you to find all records, a specific record, or a set of records based on specific criteria. For example, you can search for all your contracts, you can search for a specific contract, or you can search for a list of contracts in an “active” status.

How To – Find All Records
  1. Select Search from the left-hand menu
  2. Select the appropriate record type from the sub-menu
  3. Select the Search button from the top right corner (do not enter any search criteria)
How To – Find a Specific Record or Records
  1. Select Search from the left-hand menu
  2. Select the appropriate record type from the sub-menu
  3. Enter the appropriate search criteria (e.g. Contract ID = 123456 or Contracts with an Effective date = 06/15/2016)
  4. Select the Search button from the top right corner
How To – Export Search Results
  1. Select Search from the left-hand menu
  2. Select the appropriate record type from the sub-menu
  3. Enter the appropriate search criteria (e.g. Contract ID = 123456 or Contracts with an Effective date = 2016-06-15)
  4. Select the Search button from the top right corner
  5. Click Extract to Excel from the top right-hand corner of the search results screen.
  6. Your search results will be downloaded and saved, as an Excel spreadsheet within a .ZIP file.


Saved Searches

To make it easier to access and/or export a frequently used set of search criteria, APEXA allows you to save any search and gives you the option to share that search with users across your organization. 

How To – Create and Edit Saved Searches

To create a new saved search, follow these steps:

  1. Select Search from the left-hand menu.
  2. Select the appropriate record type from the sub-menu.
  3. Enter the appropriate search criteria (e.g. Contracts with an Effective date = 2016-06-15).
  4. Select the Search button from the top right corner.
  5. From the results page, select the Save button from the top right corner.
  6. Enter a Name for your saved search.
  7. Your search criteria will be saved as an entry within the Search > Saved Views sub-menu.


To edit an existing saved search, follow these steps:

  1. Select Search from the left-hand menu.
  2. Select Saved Views from the resulting sub-menu
  3. To edit the name of the saved search, select the  icon from beside the search name.
  4. To edit the saved search criteria, select the icon. To delete the saved search, select theicon.
  5. To run the saved search, click the View Name.

Dashboard, Tasks & Notifications

Dashboard

After logging in, you will always land on your dashboard, and can access it any time by selecting Dashboard from the left-hand menu. The dashboard displays two lists of tasks: a list of “Outstanding & Unassigned” tasks, alongside “My Outstanding Tasks”, which is a list of all incomplete tasks assigned to you.

Triggers

APEXA will allow a partner organization to create a set of triggers for which you wish to see tasks created. Triggers are set so that each time an event of that nature occurs, this “triggers” the system to create a task for that item. For example, if you set a trigger for contracts with a status of active, the system will create a “task” each time a contract moves into the active status. A trigger can be created for any set of search criteria.

Triggers are set at an organization level. Once they have been created, triggers will be available to anyone within the organization. It is a best practice to limit the number of people in your organization with permission to create, edit or delete triggers.

The first step to creating a trigger is understanding the type of task you wish to generate, and then thinking about the search criteria required to create that task. Once you have your set of criteria, follow the steps below.

How To – Create a Trigger
  1. Select Search from the left-hand menu.
  2. Select the area of the system for which you wish to create a trigger (e.g. “Name Change”).
  3. Enter your search criteria (e.g. “Legal name change”).
  4. Select the Create Trigger button from the top right-hand corner
  5. Enter a Name for your Trigger and a Description to help users understand the purpose of the trigger.
  6. Click OK.


Commonly Used Triggers & Saved Searches

Following are lists of common Saved Searches and Triggers. Whether you create a Saved Search or Trigger will depend on how your company wants to manage the work.

  • Use Saved Searches if the information is “nice to have” and no action is required, or if you will take action but it’s not urgent (e.g. every Friday you run the search and use the results to update your back office systems).
  • Use Triggers if you want to act on the information as soon as possible, or if you want a task so you can keep track of what you still need to manage.

Contract-related triggers & saved searches

Carrier triggers & searchesMGA triggers & searches

Trigger: New contract requests received (one for all types…or more if you want them to be type specific.)

  • Search – Contract Requests
  • Created Within (Days) = 1

Trigger: New contract requests received (one for all types…or more if you want them to be type specific.)

  • Search – Contract Requests
  • Created Within (Days) = 1

Trigger: Pending contracts with <your company name>

  • Search – Contracts
  • Status = pending; Current party = my corporation

Trigger: Pending contracts with <your company name>

  • Search – Contracts
  • Status = pending; Current party = my corporation

Trigger: Comments added to a contract (excluding those from your company)

  • Search – Contracts
  • Comment party = MGA, AGA, Corp, Sub-Corp, Advisor
  • Comment type = General
  • Added within = 1 day

Trigger: Carrier comments added to a contract

  • Search – Contracts
  • Carrier role=all Carriers you work with;
  • Comment party=Primary
  • Comment type = General
  • Added within = 1 day

Trigger: Comments added to a contract (excluding those from your organization & Carriers)

  • Search – Contracts
  • Comment party=AGA, Corp, Sub-Corp, Advisor
  • Comment type = General
  • Added within = 1 day

Saved Search or Trigger: Banking changes

  • Search – Banking Information
  • Modified Within (Days) = # (1 for trigger; for saved search, a number based on frequency it will be checked)

Saved Search or Trigger: Banking changes

  • Search – Banking Information
  • Modified Within (Days) = # (1 for trigger; for saved search, a number based on frequency it will be checked)

Saved Search: Pending contracts

  • Search – Contracts
  • Status = pending

Saved Search: Pending contracts

  • Search – Contracts
  • Status = pending

Saved Search or Trigger: New Carrier contracts made active

  • Search – Contracts
  • Status = Active; Carrier role = all Carriers you work with; Contract code type = Selling; Contract code status = Active
  • if you're doing this as a search, you'll also want to include Code Modified Within (Days) = # (# being the frequency it will be checked - e.g. every week would be every 7 days)

Trigger: Transfers OUT (contracts being transferred away from your organization)

  • Search – Contracts
  • Transfers = From my corporation


Compliance-related triggers & saved searches

Common (for all Partners)

Trigger: Advisor/Corp Debt over $##### (could be total debt or an instance of debt)

  • Search – Advisors*
  • In Total debt OR Instance of debt, enter an amount for which you want to be notified

Trigger: Credit score below ###

  • Search – Advisors
  • Current credit score lower than or equal to = ###

Trigger: Public monitoring added to Advisor/Corp

  • Search – Advisors*
  • Monitoring level = Level 3, Level 4

Saved Search or Trigger: New disciplinary action added

  • Search – Disciplinary Action
  • Created Within (Days) = # (1 for trigger; for saved search, a number based on frequency it will be checked)

Trigger: Dependent contract issues

  • Search – Contracts
  • Dependent relationship health status = issues

Saved Search or Trigger: Public terminations (type of termination and/or terminated within # days)

  • Search – Advisors*
  • Public termination reason = choose the reasons you’re interested in and/or Terminated Within (Days) = # (1 for trigger; for saved search, a number based on frequency it will be checked)

Saved Search or Trigger: Added/modified licence** 

  • Search – Licences
  • Licence health = no issues; Modified Within (Days) = # (1 for trigger; for saved search, a number based on frequency it will be checked)

** If setting up as a trigger, you may want to consider creating two triggers. One for Alberta, British Columbia and Saskatchewan and a second one for all other provinces.

Saved Search or Trigger: Added/modified E&O

  • Search – E&O
  • Coverage health = no issues; Modified Within (Days) = # (1 for trigger; for saved search, a number based on frequency it will be checked)

* Debt, Monitoring and Terminations can be searched for under Advisors or Contracts. For the indicated triggers & searches you should use the Advisors search screen.

  • Searching Advisors, the results will include any public debt, monitoring or termination applied to an advisor with whom you work – even on contracts where you are not part of the contract chain.
  • When you search on Contracts, the results will relate only to the contracts of which you are part of the contract chain.

Tasks

Once the appropriate triggers have been set up, tasks will begin to be generated. You can customize your dashboard to display the tasks that pertain to you (determined by the trigger). For example, you may be responsible for managing name changes, so you would want to subscribe to that trigger. 

Tasks will begin to be generated after the trigger is created. When a user adds a trigger to their dashboard, any outstanding tasks will now appear on their dashboard.

Triggers do not create historical tasks for events that occurred before the trigger was created.

How To – Subscribe to Tasks
  1. Locate the Outstanding & Unassigned list on your Dashboard.
  2. Click the editicon.
  3. Find the trigger for which you want to receive tasks.

  4. Click Subscribe.

  5. Go back to your Dashboard and you will see a list of tasks that you subscribed to.

  6. You can reorder the items by clicking and dragging theicon, or the name of the Task.

When an event in the system triggers a “task,” the task is in an incomplete and unassigned state by default. On your Outstanding & Unassigned Tasks dashboard, you will see each type of task (indicated by the event that triggered it), the number of tasks of that type that are unassigned and the number of tasks of that type that are outstanding.


You can click on either number (unassigned or outstanding) to see the corresponding list of tasks. If you select the first number, you will see a list of all tasks of this type that are unassigned. If you select the second number, you will see a list of all tasks of this type that are outstanding. From this screen you can “claim” the task (which means it will now be assigned to you) by clicking Claim. Alternatively, you can assign the task to someone else in your organization (provided you have the proper permissions) by clicking Assign.

How To – Claim a Task
  1. Locate the Outstanding & Unassigned list on your Dashboard.
  2. Click on the second number in the list (number of outstanding tasks).
  3. Find the task you wish to Claim.
  4. Click Claim, followed by Ok on the confirmation screen.
  5. This item will now appear in your My Outstanding Tasks dashboard. Click the Task List name.
  6. You will see the specific task you claimed, and be able to Unassign it, Reassign it, or mark it as Complete.

After a task has been assigned to you, you can remove the item from your queue, assign it to someone else or mark the item as complete.

Clicking on the task type will show you a list of all tasks of that type that have been assigned to you. To remove the task from your queue, click Unassign. To assign the task to someone else, click Assign (see Assign a Task to Someone Else, above). To mark the task as complete, click Complete.

Once you have marked a task as complete, it will be removed from the user interface. There is no functionality that allows you to retrieve or review completed tasks.

Notifications

As described above, new tasks will appear on your dashboard, but you may also wish to receive a notification by email when there is a new task that requires your attention. You can select which triggers (task type) you wish to receive emails for. 

How To – Create a Notification
  1. Locate the Outstanding & Unassigned list on your Dashboard.
  2. Click the icon.
  3. Find the trigger for which you want to receive notifications.
  4. Click Notify Me. Note: you can only create notifications for Tasks you are currently Subscribed to. 


Tags

Tags allow a user to “tag” various items throughout the system with a word or phrase that can help to organize items and make searching for them easier. As an example, you may tag your agreements with an internal code, which would allow users to search for any agreement by that code instead of the document name. Tags can be added to any of the following items:

  • Logos & Sections (not all accounts have these items)
  • Agreements
  • Documents
  • Packages
  • Contracts

Assigning Tags

When you add a tag to an item, tags that have been created for your organization will appear as you begin to type as suggestions; you can choose one of the suggested tags instead of creating a new tag. If an existing tag is edited in the administration area, the tag will automatically update to the new value wherever it has been used. If you are responsible for the creation and/or maintenance of tags, please refer to Tag Administration.

Tags can be a single word or a whole phrase. You can assign multiple tags to an item.

How To – Assign a Tag
  1. Access the asset on which you wish to place a tag (a logo, a section, an agreement, a document, a package or a contract*).
  2. Find the “tag” section of the asset (e.g. Tags field on the first page of a package set-up wizard).
  3. Begin typing the name of the tag to find the tag you wish to attach. Select the tag from the list to add it to the contract.

* If you do not have permission to add, edit or delete a tag on a contract, you will not see the Tag button.

Related content