DM2 Notifications Bundle Setup

Overview

The below information provides further details on steps that must be taken for CIMcloud / DM2 customers wanting to leverage the DM2 Notifications Bundle.

 

Since this process is not owned by CIMCloud there may be differences in current versions. Contact DM2/PDI for current details.

In Sage the operator will initially setup a customer to receive the Weblink notifications through the standard Outbox Contacts Maintenance screen in the A/R Customer Maintenance function. (A/R Customer Maintenance Outbox Contacts button). The following screen will be displayed for any Outbox-enabled document type:

The operator will select the desired Document Type. Then set recipient type to “Weblink” and click [OK].

Weblink can be combined with email/fax recipient types for the same document.

***Please note***

Once a customer is setup for Weblink, Sage will consider the customer an electronic delivery customer for that document and will not print the document to a printer.

How to Use:

During the normal printing routines, Weblink notifications will be generated automatically at the time you see the “Exporting to Outbox” notification window.

  • The PDF/TXT file is written to the specified network folder
    • Sample file name:

00CUSTABC-AS06-03-8027DE7F6C48EE454BE94CB63970D5C0D685301E.PDF

  • A record is written to the OBWxxx.soa table.
    • If there is an active internet connection and the portal is operational, then the OBW notification record is immediately posted to the CIMcloud.
    • Should the communication fail, OBW retains the record and attempts to resend the next time notifications are generated

How it Works with CIMcloud

After working with DM2/PDI to install Weblinks (see some general information below on Weblinks), The Sage owner will need to make sure that the documents are stored in a shared/public folder so they can be linked to from CIMCloud. The Sage owner will need to provide:

  1. Shared drive, accessible from MAS, to write PDF/TXT files to 
    1. On the backend, the DM server will need to place the appropriate files in the share
    2. Example \\servername\shared folder
  2. URL to access that shared drive location from the outside world
    1. URL needs to be HTTPS
    2. Example https://remote.companyname.com/shared folder
    3. Directory listing should be disabled
    4. Place a PDF file in this location so permissions can be tested through the link 
  3. External IP of MAS server for WSP firewall

 

2 – Sage owner purchases the CIMCloud Notifications Bundle

When the DM2 Notifications bundle is purchased CIMcloud will:

  1. Turn on the pages noted above
  2. Set up API authorization for DM2 notifications to be posted to CIMcloud
  3. Whitelist Sage owner IP addresses from servers generating the push notification
  4. Send Sage owner full push url from DM2/PDI to set up to push the notifications. These urls can vary based on the specific site and will contain a website and API key specific to the website.

Using this information the Sage owner will in the OB program folder, install the OBWLIB-xxx.opt file (which is similar to an INI file) received from programming (where xxx equals the company code).  This contains the connection information for the client’s shared folder and the web portal.

PDFURLBASE$ : The client’s URL address to the shared drive
PDFWEBBASE$: The client’s UNC path to the shared drive
WEBLINK_URL$: The web portal’s URL address
WEBLINK_URLPATH$: The web portal’s URL subdirectory for the notifications
WEBLINK_SECURE: 0 = http, 1 = https

Sample Post to CIMCloud:

Post Headers:

Content-Type = “application/x-www-form-urlencoded”
Charset = “utf-8”

Post Body:

<xml>
<record>
<ref_id>00-WSP000-2016-01-01-1234561FDDF5B469667847C1B300838EE6B9ABA.PDF</ref_id>
<date>2016/01/01</date>
<type>S/O Invoices</type>
<nm>Sample Invoice Report</nm>
<ds>DEALER #: WSP100-01</ds>
<pdf_url>http://www.websitepipeline.com</pdf_url>
<a_id>00-WSP100</a_id>
<status>1</status>
</record>
</xml>

3 – Sage Owner Sets Up and Tests Notification Push

After all the above is complete Notifications should flow to the CIMcloud and display.

Updated on September 23, 2021

Was this article helpful?

Related Articles