https://github.com/cityssm/node-faster-report-exporter

On demand exports of selected reports from the FASTER Web Fleet Management System.
https://github.com/cityssm/node-faster-report-exporter

asset-management faster-web fleet-management fmis puppeteer

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/cityssm/node-faster-report-exporter
• Owner: cityssm
• License: mit
• Created: 2024-08-21T18:19:09.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-09-27T17:52:57.000Z (3 months ago)
• Last Synced: 2024-11-11T03:23:43.335Z (about 1 month ago)
• Topics: asset-management, faster-web, fleet-management, fmis, puppeteer
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/@cityssm/faster-report-exporter
• Size: 669 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# FASTER Web Report Exporter

[![npm (scoped)](https://img.shields.io/npm/v/%40cityssm/faster-report-exporter)](https://www.npmjs.com/package/@cityssm/faster-report-exporter)

[![DeepSource](https://app.deepsource.com/gh/cityssm/node-faster-report-exporter.svg/?label=active+issues&show_trend=true&token=bslC1GSndvK7fVXDTJ9K4Lgi)](https://app.deepsource.com/gh/cityssm/node-faster-report-exporter/)

[![Maintainability](https://api.codeclimate.com/v1/badges/43c2a67bb2cb61d6220e/maintainability)](https://codeclimate.com/github/cityssm/node-faster-report-exporter/maintainability)

**On demand exports of selected reports from the

[FASTER Web Fleet Management System](https://fasterasset.com/products/fleet-management-software/)**.

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

```sh

npm install @cityssm/faster-report-exporter

```

## Usage

```javascript

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)

```

## More Code for FASTER Web

[FASTER Web Helper](https://github.com/cityssm/faster-web-helper)


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

[FASTER Web Report Parser](https://github.com/cityssm/node-faster-report-parser)


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

[Userscripts for FASTER Web](https://cityssm.github.io/userscripts/#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.