{"id":44356093,"url":"https://github.com/vertigis/workflow-activities-cityworks","last_synced_at":"2026-02-11T16:08:50.895Z","repository":{"id":64181516,"uuid":"317623606","full_name":"vertigis/workflow-activities-cityworks","owner":"vertigis","description":"A collection of VertiGIS Studio Workflow activities for interacting with the Cityworks REST API","archived":false,"fork":false,"pushed_at":"2024-10-19T10:22:37.000Z","size":4624,"stargazers_count":3,"open_issues_count":6,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-16T22:55:53.691Z","etag":null,"topics":["cityworks","geocortex","vertigis","workflow"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vertigis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-01T17:53:25.000Z","updated_at":"2025-08-18T07:14:18.000Z","dependencies_parsed_at":"2023-01-15T03:01:13.761Z","dependency_job_id":"ab18505a-5d96-45fc-b1e3-d95a1919de65","html_url":"https://github.com/vertigis/workflow-activities-cityworks","commit_stats":{"total_commits":53,"total_committers":5,"mean_commits":10.6,"dds":"0.37735849056603776","last_synced_commit":"a9964934a41c362acc076d25574fedeb437e45cf"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/vertigis/workflow-activities-cityworks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-cityworks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-cityworks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-cityworks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-cityworks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vertigis","download_url":"https://codeload.github.com/vertigis/workflow-activities-cityworks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-cityworks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29337204,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T16:00:30.228Z","status":"ssl_error","status_checked_at":"2026-02-11T16:00:25.398Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cityworks","geocortex","vertigis","workflow"],"created_at":"2026-02-11T16:08:49.927Z","updated_at":"2026-02-11T16:08:50.889Z","avatar_url":"https://github.com/vertigis.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cityworks Activities\n\n[![CI/CD](https://github.com/vertigis/workflow-activities-cityworks/workflows/CI/CD/badge.svg)](https://github.com/vertigis/workflow-activities-cityworks/actions)\n[![npm](https://img.shields.io/npm/v/@vertigis/workflow-activities-cityworks)](https://www.npmjs.com/package/@vertigis/workflow-activities-cityworks)\n\nThis project contains activities for interacting with the Cityworks REST API in a [VertiGIS Studio Workflow](https://www.vertigisstudio.com/products/vertigis-studio-workflow/).\n\nThis project uses version `15.8.3` of the Cityworks TypeScript SDK. To use this activity pack you must have a license to use the Cityworks REST API.\n\n## Usage\n\nTo use the Cityworks activities in [VertiGIS Studio Workflow Designer](https://apps.vertigisstudio.com/workflow/designer/) you need to register an activity pack and then add the activities to a workflow.\n\n### Register the Cityworks activity pack\n\n1. Sign in to ArcGIS Online or Portal for ArcGIS\n1. Go to **My Content**\n1. Select **Add Item \u003e An application**\n    - Type: `Web Mapping`\n    - Purpose: `Ready To Use`\n    - API: `JavaScript`\n    - URL: The URL to this activity pack manifest\n        - Use https://unpkg.com/@vertigis/workflow-activities-cityworks@1.0.0/activitypack.json for a specific version\n        - Use https://unpkg.com/@vertigis/workflow-activities-cityworks@1/activitypack.json for the latest revision of a specific major version\n        - Use https://unpkg.com/@vertigis/workflow-activities-cityworks/activitypack.json for the latest version (not recommended for production use)\n        - Use https://localhost:5000/activitypack.json for a local development version\n    - Title: Your desired title\n    - Tags: Must include `geocortex-workflow-activity-pack`\n1. Reload [VertiGIS Studio Workflow Designer](https://apps.vertigisstudio.com/workflow/designer/)\n1. The Cityworks activities will now appear in the activity toolbox in various `Cityworks` categories\n\n### Use the Cityworks activities in a workflow\n\n1. Establish a connection to the Cityworks service\n    1. Add the `Create Cityworks API Service` activity to a workflow\n    1. Set the `URL` input to the root URL of your Cityworks server. For example, `https://cloud01.cityworks.com/\u003corganization\u003e`.\n    1. If you have an existing Cityworks access token, assign it to the `Token` input\n    1. If you have a username and password, assign them to the `Username` and `Password` inputs\n    - **IMPORTANT:** tokens 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.\n1. Use the Cityworks service\n    1. Add one of the other Cityworks activities to the workflow. For example, `Get Service Requests`.\n    1. Set the `Service` input of the activity to be the output of the `Create Cityworks API Service` activity\n        - Typically this would use an expression like `=$cwApi.service`\n    1. Supply any additional inputs to the activity\n    1. Supply the `result` output of the activity to the inputs of other activities in the workflow\n1. Run the workflow\n\n## Development\n\nThis project was bootstrapped with the [VertiGIS Studio Workflow SDK](https://github.com/geocortex/vertigis-workflow-sdk). Before you can use this activity pack in the [VertiGIS Studio Workflow Designer](https://apps.vertigisstudio.com/workflow/designer/), you will need to [register the activity pack](https://developers.vertigisstudio.com/docs/workflow/sdk-web-overview#register-the-activity-pack).\n\n## Available Scripts\n\nInside this project, you can run some built-in commands:\n\n### `npm run generate`\n\nInteractively generate a new activity or form element.\n\n### `npm start`\n\nRuns 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.vertigisstudio.com/docs/workflow/sdk-web-overview/#configuring-a-https-certificate) section on the [VertiGIS Studio Developer Center](https://developers.vertigisstudio.com/docs/workflow/overview/).\n\n### `npm run lint`\n\nRuns linter to perform static analysis.\n\n### `npm run test`\n\nRuns all unit tests.\n\n### `npm run test -- --coverage`\n\nRuns all unit tests with coverage.\n\n### `npm run build`\n\nBuilds the activity pack for production to the `build` folder. It optimizes the build for the best performance.\n\nYour custom activity pack is now ready to be deployed!\n\nSee the [section about deployment](https://developers.vertigisstudio.com/docs/workflow/sdk-web-overview/#deployment) in the [VertiGIS Studio Developer Center](https://developers.vertigisstudio.com/docs/workflow/overview/) for more information.\n\n## Documentation\n\nFind [further documentation on the SDK](https://developers.vertigisstudio.com/docs/workflow/sdk-web-overview/) on the [VertiGIS Studio Developer Center](https://developers.vertigisstudio.com/docs/workflow/overview/)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for contributing guidelines.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertigis%2Fworkflow-activities-cityworks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvertigis%2Fworkflow-activities-cityworks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertigis%2Fworkflow-activities-cityworks/lists"}