Skip to main content
Skip table of contents

iAdd2Cart iPart

Overview

The iAdd2Cart iPart provides a way to configure what invoices appear and can be selected to add to the cart. The iPart can use an IQA to define the invoices and information to be displayed and allows the user to select invoices and send them to the iMIS cart page. The iPart does NOT control what happens to the invoice once added to the cart and processed.

Requirements

The iAdd2Cart iPart works only for iMIS EMS versions.

Initial Deployment Steps

Deploy Client-Based iPart in iMIS

  1. In iMIS Staff Site, go to RiSE > Maintenance > Content Types

  2. Select the Custom folder

  3. Select New > Content Type

  4. Select Client-based (preferred)

  5. Name of Content Type = CSI iAdd2Cart

  6. Description of Content Type = CSI iAdd2Cart - iPart

  7. URL to the html file that is used to display items of this type at runtime = https://cdn.cloud.csiinc.com/apps/iadd2cart/display.html

  8. URL to the html file that is used to configure content items of this type = https://cdn.cloud.csiinc.com/apps/iadd2cart/configure.html

    image-20250506-123009.png
  9. Select Save

Create IQA

Create the IQA you would like to use that will include the invoice requirements you would like to display. A property of “Invoice ID” is required.

Example:

  1. Make a copy of the following core IQA: $/Accounting/DefaultSystem/Queries/Invoices/All open invoices

  2. Remove all filters to add the filters you prefer. In this example, we added a balance filter of not equal to zero so that invoices with a positive balance or negative balance (credits) will appear. We also added a filter for a URL parameter as we are adding this iPart to a Organization profile page.

    1. When using a URL parameter such as ID, the value should be formatted as “@url:ID”. The search option should be set to Optional and the search label should be formatted as @url:ID.

      image-20250506-123542.png
  3. Update your Display tab as desired. Invoice ID must be a display property but can be hidden using the “code_” prefix.

    image-20250506-123608.png
  4. Make a copy of your IQA path as you will need it for the iPart configuration. @url:ID

Configuration of the iPart

Once you have an IQA, you can add the iPart to a content page for use.

  1. Select to Edit the Content Page you would like to add the iPart to.

  2. Select Add Content

  3. Select the Custom folder

  4. Select the CSI iAdd2Cart iPart

  5. Select OK

  6. Paste in your IQA path into the “Open Invoices Query Path” field

  7. Tab out or click out of this field so that a preview of the IQA will appear to confirm the correct path.

  8. Adjust the results per page or pager location as desired.

    image-20250506-124406.png
  9. Select Ok

  10. Save and publish your content page.

  11. Navigate to the content page for an applicable record to confirm display.

Using the iPart

  1. The user will select the invoice items. (one or more)

    image-20250506-124817.png
  2. The user will select Proceed to Checkout which will direct them to the applicable cart page defined for the website currently in use.

  3. If credits are selected, they will appear in the credits applied section of the cart.

    image-20250506-124855.png
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.