# @geocortex/workflow-activities-elementsxs

> Elements XS activities for Geocortex Workflow

Latest version **0.2.3** (published 2021-02-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install @geocortex/workflow-activities-elementsxs
pnpm add @geocortex/workflow-activities-elementsxs
yarn add @geocortex/workflow-activities-elementsxs
bun add @geocortex/workflow-activities-elementsxs
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.3 |
| Published | 2021-02-26 |
| First published | 2021-01-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 55.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | VertiGIS |
| Maintainers | scottanderson, ianschmitz, rcooney, vertigis-phunter, vertigis-sa |
| Keywords | VertiGIS, Geocortex, Workflow, Elements XS, Novotx, ArcGIS, GIS |

## Links

- npm: https://www.npmjs.com/package/@geocortex/workflow-activities-elementsxs
- Repository: https://github.com/geocortex/workflow-activities-elementsxs
- Homepage: https://github.com/geocortex/workflow-activities-elementsxs#readme
- Issues: https://github.com/geocortex/workflow-activities-elementsxs/issues
- npm.io page: https://npm.io/package/@geocortex/workflow-activities-elementsxs

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 0.2.3 (latest) — 2021-02-26
- 0.2.2 — 2021-01-20
- 0.2.1 — 2021-01-19
- 0.2.0 — 2021-01-19
- 0.1.3 — 2021-01-16
- 0.1.2 — 2021-01-16
- 0.1.1 — 2021-01-15
- 0.1.0 — 2021-01-15

## README

# Elements XS Activities

[![CI/CD](https://github.com/geocortex/workflow-activities-elementsxs/workflows/CI/CD/badge.svg)](https://github.com/geocortex/workflow-activities-elementsxs/actions) 
[![npm](https://img.shields.io/npm/v/@geocortex/workflow-activities-elementsxs)](https://www.npmjs.com/package/@geocortex/workflow-activities-elementsxs)

This project contains activities for interacting with the [Elements XS REST API](https://salesapi.novotx.com/) in a [Geocortex Workflow](https://www.geocortex.com/products/geocortex-workflow/).

## Usage

To use the Elements XS activities in [Geocortex Workflow Designer](https://apps.geocortex.com/workflow/designer/) you need to register an activity pack and then add the activities to a workflow.

### Register the Elements XS activity pack

1. Sign in to ArcGIS Online or Portal for ArcGIS
1. Go to **My Content**
1. Select **Add Item > An application**
   - Type: `Web Mapping`
   - Purpose: `Ready To Use`
   - API: `JavaScript`
   - URL: The URL to this activity pack manifest
     - Use https://unpkg.com/@geocortex/workflow-activities-elementsxs/activitypack.json for the latest version
     - Use https://unpkg.com/@geocortex/workflow-activities-elementsxs@0.1.0/activitypack.json for a specific version
   - Title: Your desired title
   - Tags: Must include `geocortex-workflow-activity-pack`
1. Reload [Geocortex Workflow Designer](https://apps.geocortex.com/workflow/designer/)
1. The Elements XS activities will now appear in the activity toolbox in an `Elements XS` category

### Use the Elements XS activities in a workflow

1. Establish a connection to the Elements XS service
    1. To connect to the Elements XS service as an application:
       1. Add the `Authenticate App` activity to a workflow
       1. Set the `URL` input to the root URL of your Elements XS server. For example, `https://salesapi.novotx.com`.
       1. Set the `AppName`, `CompanyAccount` and `Secret` inputs
    1. To connect to the Elements XS service as a user:
       1. Add the `Authenticate User` activity to a workflow
       1. Set the `URL` input to the root URL of your Elements XS server. For example, `https://salesapi.novotx.com`.
       1. Set the `Username` and `Password` inputs
    - **IMPORTANT:** secrets and passwords are credentials that should not be hard coded into workflows. These values should be acquired by the workflow at runtime from the end user or from another secure system.
1. Use the Elements XS service
    1. Add one of the other Elements XS activities to the workflow. For example, `Get Work Item`.
    1. Set the `Service` input of the activity to be the output of the `Authenticate App|User` activity
        - Typically this would use an expression like `=$xsService1.service`
    1. Supply any additional inputs to the activity
    1. Supply the `result` output of the activity to the inputs of other activities in the workflow
1. Run the workflow

## Development

This project was bootstrapped with the [Geocortex Workflow SDK](https://github.com/geocortex/vertigis-workflow-sdk). Before you can use your activity pack in the [Geocortex Workflow Designer](https://apps.geocortex.com/workflow/designer/), you will need to [register the activity pack](https://developers.geocortex.com/docs/workflow/sdk-web-overview#register-the-activity-pack).

## Available Scripts

Inside the newly created project, you can run some built-in commands:

### `npm run generate`

Interactively generate a new activity or form element.

### `npm start`

Runs the project in development mode. Your activity pack will be available at [http://localhost:5000/main.js](http://localhost:5000/main.js). The HTTPS certificate of the development server is a self-signed certificate that web browsers will warn about. To work around this open [`https://localhost:5000/main.js`](https://localhost:5000/main.js) in a web browser and allow the invalid certificate as an exception. For creating a locally-trusted HTTPS certificate see the [Configuring a HTTPS Certificate](https://developers.geocortex.com/docs/workflow/sdk-web-overview/#configuring-a-https-certificate) section on the [Geocortex Developer Center](https://developers.geocortex.com/docs/workflow/overview/).

### `npm run test`
Runs all unit tests.

### `npm run lint`
Runs linter to perform static analysis.

### `npm run build`

Builds the activity pack for production to the `build` folder. It optimizes the build for the best performance.

Your custom activity pack is now ready to be deployed!

See the [section about deployment](https://developers.geocortex.com/docs/workflow/sdk-web-overview/#deployment) in the [Geocortex Developer Center](https://developers.geocortex.com/docs/workflow/overview/) for more information.

## Documentation

Find [further documentation on the SDK](https://developers.geocortex.com/docs/workflow/sdk-web-overview/) on the [Geocortex Developer Center](https://developers.geocortex.com/docs/workflow/overview/)

---
_Source: https://npm.io/package/@geocortex/workflow-activities-elementsxs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._