Skip to content
A programmable automation server
JavaScript Vue HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
api tidy Jan 22, 2020
bin
client tidy Feb 12, 2020
commands organize files, add server side validation Jan 28, 2020
config
graphql organize files, add server side validation Jan 28, 2020
lib init Dec 5, 2019
resources
scaffold use SAO Dec 30, 2019
system force build Jan 29, 2020
.eslintrc.js init Dec 5, 2019
.gitignore prevent Jan 22, 2020
.nvmrc add password based login and tools Jan 22, 2020
LICENSE init Dec 5, 2019
README.md update readme Jan 29, 2020
nuxt.config.js add password based login and tools Jan 22, 2020
package.json v0.2.1 Jan 29, 2020
yarn.lock upgrade deps Jan 29, 2020

README.md

Centric Server

A programmable automation server

license npm version

Installation

Install centric

$ npm install -g centric

Option 1 - Use centic scaffold

centric scaffold will create a basic centric project with examples that you can modify to suit your needs.

  • Run the below command in the folder you want to create the project.
$ centric scaffold
  • After that, start the server using the command:
$ centric start

And your done!

Option 2 - Create the files yourself

Folder Structure for a centric project.

    .
    ├── services               # Service Files
    ├── tasks                  # Task Files
    ├── config.js              # Configuration file

Services

The services folder contains all your projects service files. A service file has the following signature.

module.exports = async function ({ config }) {
  // Service Logic goes here...
  const testLogging = function () {
    console.log('this is a test')
  }

  return { testLogging }
}

Services are useful for any logic you wish to share between tasks (like a database connection).

Creating a new task

Create a new file in the tasks folder that matches the following signature.

The name of the task in the centric web interface is equivalent to the name of the task file name.

module.exports = {
  description: 'task description', // Viewable in the web UI
  locks: null,
  defaultData: function () {
    // Return the default data for the task.
    // This will be the default "taskData" in the run method.
    return {}
  },
  run: async function ({ config, services, opData, saveOpData, taskData, saveTaskData, logInfo, logWarning, logError, isCancelled }) {
    // Run method is called when the task is executed.
    // Logic for the task goes here.
  }
}

The run method provides following listed parameters:

Argument Description
config configuration exported from config.js
services object containing all exported values from all service files
opData Current running task's operation-data.
saveOpData Method to be called to save the curremt operation data.
taskData Task data of the current running task.
saveTaskData Method to be called to save the current running task data.
logInfo logInfo is method to log the info entry showing information log of the operation.
logWarning logWarning is method to log the warnings entry showing warnings of the operation.
logError logError is method to log the errors entry showing errors of the operation.
isCancelled Method to check whether the task is active for running or has been cancelled.

The screen-shot below shows the list of tasks under the tasks folder. Tasks

Schedule a task

Go to the tasks list page and click over the task item for which need to schedule a task and follow the following steps:

  1. Enable the task

  2. Click the Create Schedule button

Tasks-Schedule

  1. Create Schdule form page will be displayed.

Add new schedule:

Field Description
Name Name of the schedule
cronTime Time interval to determine how often to run the task
enabled? Enable or disable this schedule
data Set the tasks operation data when started with this schedule
  1. Click the Save button. Tasks-Schedule

Creating a new user

Select Users menu from home page, users list page looks like Users

To create new user click over "CREATE USER" button and add the detail of the user to be created.

Task History

The task processed are listed in the history menu under sidemenu list. History

  • It provides the list of task operations processed with following details.
    • Operation Number.
    • Task name of respective operation.
    • Status of the operation (i.e) Completed, Terminated, Active, Failed, Cancelled.
    • Run date of the operation.
    • Entry count: The number of logs written while the processing of the task operation.
    • Last entry message and data.

Dashboard

The dashboard page provides the list of currently running task detail.

Dashboard

You can’t perform that action at this time.