FASTER Web Report Exporter

On demand exports of selected reports from the FASTER Web Fleet Management System.

This module uses a headless Puppeteer browser to log into FASTER Web, navigate to the appropriate report, and select the preferred export format. Once downloaded, the module returns the path to the downloaded file.

Installation

npm install @cityssm/faster-report-exporter

Usage

import { FasterReportExporter } from '@cityssm/faster-report-exporter'

const reportExporter = new FasterReportExporter(
  fasterTenant,
  fasterUserName,
  fasterPassword
)

reportExporter.setDownloadFolderPath('C:\\Temp')

/*
 * Part Orders
 */

const partOrderReport =
  await reportExporter.exportPartOrderPrint(partOrderNumber)

console.log(partOrderReport)
// => "C:\Temp\70578b74-261c-499c-bdfe-1ca6c17967b1.pdf"

/*
 * Work Orders
 */

const technicianReport =
  await reportExporter.exportWorkOrderTechnicianPrint(workOrderNumber)

const customerReport =
  await reportExporter.exportWorkOrderCustomerPrint(workOrderNumber)

Enabling Debug Output

This package uses the debug package for debugging output. For convenience, the debug namespace used by this pacakge, and full namespace enable string are exported.

Debug output can be enabled programmatically, as shown in the example below.

import { DEBUG_ENABLE_NAMESPACES } from '@cityssm/faster-report-exporter/debug'
import Debug from 'debug'

Debug.enable(DEBUG_ENABLE_NAMESPACES)

Debugging output can also be enabled using environment variables, decribed in the debug package documentation.

More Code for FASTER Web

FASTER Web Helper
A service to support integrations with the FASTER Web fleet management system.

FASTER Web Report Parser
Parses select Excel and CSV reports from FASTER Web into usable data objects.

Userscripts for FASTER Web
Fixes some of the common irks when using FASTER Web. Includes userscripts to enforce field validation, correct varying header heights, and offer autocomplete.