bassgPushy

bassgPushy Extension For Skyspark Documentation

1. Overview

This extension leverages the Pushy.me notification service to monitor arcnote and spark statuses in SkySpark, handle notification workflows, and facilitate communication between SkySpark and the Mobilytik mobile application through notifications.

2. Features

• Push notifications for Sparks and Arc Notes
• Device registry and management (iOS/Android)
• Topic creation and subscription (company/site/equip-aware)
• Snooze support and automatic dispatch
• Notification history and console views
• Axon API for automation and integrations

3. Installation & Requirements

3.1 Installation

You can integrate this extension into your project by searching for it on StackHub through the SkySpark UI. Alternatively, the package can be accessed directly from the following URL: bassgPushy 3.1.8.8 - Bassg Pushy :: StackHub

3.2 Requirements

• Mobilytik latest version
• iOS & Android devices
• SkySpark 3.1.8 – 3.1.9
• Active internet connection on the mobile device

4. App and Views

• App name: “Pushy Class” (figure 1.0)

  

• Company Management: Create / Delete company records (figure 1.1)

  

• Spark Notify Classes: Define spark notify classes (figure 1.2)

  

• Arc Notes Notify Classes: Define arc note notify classes (figure 1.3)

  

• Sparks Console: Spark event records and state (figure 1.4)

  

• Arc Note Console: Arc note event records and state (figure 1.5)

  

• Notification History: Unified notification history (figure 1.6)

  

• Device Management: Register/edit/delete devices (figure 1.7)

  

• Subscription Management: Pushy topics list and subscription helpers (figure 1.8)

  

5. Typical Workflow

Registering the Mobile Device :

• If you already have an existing connection (project) in your updated Mobilytik mobile application, log in and open the Notifications page from the bottom bar menu.(Figure 1.9)

  

• On the Notifications page, tap the Register to Notification Service button located at the bottom-right corner. (Figure 2.0)

  

• This action registers your mobile device to the bassgPushy extension on SkySpark.
• If you do not have an existing connection, when you create a new one, your device will be automatically registered in the same way.

Add a company :

• Create a company entry (the company name will be processed in Base64 format).

Create a record :

• Depending on the class type you want to configure, open the relevant section (Spark Notify Class or Arc Note Class) and create a new record.
• Note (Spark Notify requirements):
  • dis
  • sparkRule (Required: select one rule; create a separate class for each rule)
  • Sites (Required: select one site; create a separate class for each site)
  • company
• Note (Arc Note Notify requirements):
  • dis
  • Sites (Required: select one site; create a separate class for each site)
  • company

Verify Subscription Management :

• In the Subscription Management page, a corresponding topic will be automatically created for the class you have defined.

Subscribe to Topics :

• On your mobile device, go to the Notifications page and tap the Topics button to view the list of available topics.
• Select and subscribe to the relevant topic.(Figure 2.1)

  

Notification Delivery :

• For Spark Notify, the bassgPushy extension listens to your Spark rules and sends notifications when triggered.
• For Arc Note Notify, the extension checks all created ArcNotes every 5 minutes and sends notifications accordingly.

Managing Received Notifications :

• On your mobile device, you can manage incoming notifications using either the notification action buttons or by swiping left/right on a notification in the notification list. (Figure 2.2) (Figure 2.3).

  

• Notifications can be marked to remind again after 15 or 30 minutes, or you can acknowledge them as read.(Figure 2.4)

  

6. Schedulers and Tasks

Background processing is handled by a job and a task. These are created automatically by createJobsAndTasks() and can be rebuilt using restartScheduler().

• Job: "Snooze Time Job" - runs every 1 minute (updates snooze and sends due notifications)
• Task: "Check Spark and arcNote Classes" - runs every 5 minutes (populates Spark/Arc Note consoles)