{"id":44356052,"url":"https://github.com/vertigis/workflow-activities-configurable-queries","last_synced_at":"2026-02-11T16:08:40.567Z","repository":{"id":208710497,"uuid":"721775724","full_name":"vertigis/workflow-activities-configurable-queries","owner":"vertigis","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-04T21:31:39.000Z","size":575,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-11-04T23:23:00.467Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-21T18:47:00.000Z","updated_at":"2025-11-04T21:29:12.000Z","dependencies_parsed_at":"2024-06-19T02:11:38.898Z","dependency_job_id":"b29baf49-dcd9-4c2c-b0d4-a4bf0855a30a","html_url":"https://github.com/vertigis/workflow-activities-configurable-queries","commit_stats":null,"previous_names":["vertigis/workflow-activities-configurable-queries"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/vertigis/workflow-activities-configurable-queries","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-configurable-queries","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-configurable-queries/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-configurable-queries/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-configurable-queries/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vertigis","download_url":"https://codeload.github.com/vertigis/workflow-activities-configurable-queries/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-configurable-queries/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29337195,"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":[],"created_at":"2026-02-11T16:08:39.839Z","updated_at":"2026-02-11T16:08:40.558Z","avatar_url":"https://github.com/vertigis.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CI/CD](https://github.com/vertigis/workflow-activities-configurable-queries/workflows/CI/CD/badge.svg)](https://github.com/vertigis/workflow-activities-configurable-queries/actions)\r\n[![npm](https://img.shields.io/npm/v/@vertigis/workflow-activities-configurable-queries)](https://www.npmjs.com/package/@vertigis/workflow-activities-configurable-queries)\r\n\r\nThis project contains activities for generating and executing configurable queries.  A configurable query workflow is comprised of a dynamically generated form and dynamically generated where clause to be applied to an ArcGIS Feature Query.  Queries are configured using a collection of `SearchFields`, which define the field, form element and operation to be applied to a Feature Layer query. The project also includes a complete Workflow implementation.\r\n\r\n## Requirements\r\n\r\n### VertiGIS Studio Workflow Versions\r\n\r\nThese activities are designed to work with VertiGIS Studio Workflow versions `5.30.1` and above.\r\n\r\n## Usage\r\nTo use these 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.\r\n\r\n### Register the Configurable Queries activity pack\r\n\r\n1. Sign in to ArcGIS Online or Portal for ArcGIS\r\n1. Go to **My Content**\r\n1. Select **Add Item \u003e An application**\r\n    - Type: `Web Mapping`\r\n    - Purpose: `Ready To Use`\r\n    - API: `JavaScript`\r\n    - URL: The URL to this activity pack manifest\r\n        - Use https://unpkg.com/@vertigis/workflow-activities-configurable-queries/activitypack.json for the latest version\r\n        - Use https://unpkg.com/@vertigis/workflow-activities-configurable-queries@1.0.0/activitypack.json for a specific version\r\n        - Use https://localhost:5000/activitypack.json for a local development version\r\n    - Title: Your desired title\r\n    - Tags: Must include `geocortex-workflow-activity-pack`\r\n1. Reload [VertiGIS Studio Workflow Designer](https://apps.vertigisstudio.com/workflow/designer/)\r\n1. These activities will now appear in the activity toolbox in a `Configurable Queries` category\r\n\r\n### Search Field \r\nThe [Add Query Elements](../main/src/activities/AddQueryElements.ts) activity accepts an array of Search Field JSON objects as an input.  [The SearchFields.json](../main/src/samples/SearchFields.json) file provides an example.\r\n\r\n#### Search Field Schema\r\n```js\r\n{\r\n  /* The name of layer field to search (Required) */\r\n  field: string,\r\n  /* The SQL operator to apply to the field (=, !=, \u003c, \u003e, \u003e=, \u003c=, IN, and BETWEEN) (Required) */\r\n  operator: string,\r\n  /* The name of the field to use as the parent in a cascading relationship. (Optional)*/\r\n  dependsOn: string,\r\n  /* The form element type to use for the search. (Required) */\r\n  type: \"AutoComplete\" |\r\n        \"CheckBox\" |\r\n        \"CheckGroup\" |\r\n        \"DatePicker\" |\r\n        \"DateRangePicker\" |\r\n        \"DateTimePicker\" |\r\n        \"DropDownList\" |\r\n        \"ItemPicker\" |\r\n        \"ListBox\" |\r\n        \"Number\" |\r\n        \"NumberRangeSlider\" |\r\n        \"NumberSlider\" |\r\n        \"RadioGroup\" |\r\n        \"TextArea\" |\r\n        \"TextBox\" |\r\n        \"TimePicker\",\r\n    \r\n  /* The title to appear for the search element. (Required) */\r\n  title: string,\r\n  /* The description to appear for the search element. (Optional) */\r\n  description: string,\r\n  /* The default value of the search field.  Only applies when cascade is false.  (Optional) */\r\n  value : defs.Value,\r\n  /* The events to be used for the element. If cascade is set to true then a 'populate' event must be set.  If the type is Autocomplete then the\r\n     suggest event must be set.  (Optional) */\r\n  events: {\r\n    changed: string | undefined,\r\n    clicked: string | undefined,\r\n    populate: string | undefined,\r\n    suggest: string | undefined,\r\n    validate: string | undefined,\r\n  },\r\n  /* A form element JSON object.  This is useful when finer grained control over the form is required. (Optional) */\r\n  element: defs.Element\r\n}\r\n```\r\n### Configured Query Workflow\r\nThe [Configured Query Workflow](../main/workflows/ConfiguredQuery/content.json) is a full implementation of a configurable query form.  It can be used as-is, run as a SubWorkflow from another Workflow or modified to meet your needs.\r\n\r\n#### Usage\r\nTo use the Configured Query Workflow, download the content.json to your local machine and import it into your Portal using VertiGIS Studio Workflow designer.  \r\n\r\n##### Workflow Inputs:\r\n - layerId (Required): The layer Id for the layer to run the stored query against.  Supported layer types include [FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html), [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SubtypeGroupLayer.html), [SubtypeSubLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SubtypeSublayer.html) and [MapImageLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapImageLayer.html).\r\n - sublayerId (Optional): The sublayer to query from a MapImageLayer.\r\n - formTitle (Required): The title to appear in the form.\r\n - formDescription (Optional): The description text to appear with the form's title.\r\n - searchFields (Required): An array of SearchField objects.\r\n - eventSubWorkflow (Optional): The Url to a subworkflow to be executed when a form event is fired. The SearchFields, event type, event data and form state are passed to the subworkflow.\r\n\r\n ##### Workflow Outputs:\r\n - action: The form action.\r\n - formState: The state of the form.\r\n - queryResults: The results of the configured query if the workflow was not cancelled.\r\n\r\n### Select Query Workflow\r\n The [Select Query Workflow](../main/workflows/SelectQuery/content.json) presents the user with a list of queries to execute and runs the Configured Query Workflow in a Run Workflow activity.\r\n\r\n#### Usage\r\nTo use the Select Query Workflow, download the content.json to your local machine and import it into your Portal using VertiGIS Studio Workflow designer.\r\n\r\n##### Workflow Inputs:\r\n- formWorkflow (Required): The Url to the Configured Query Workflow\r\n- inputModel: An array of json objects that include the inputs for the Configured Query Workflow. See the [Input Model](../main/src/samples/InputModel.json) for an example of how to configure this parameter.\r\n- eventSubWorkflow (Optional): The Url to a subworkflow to be executed when a form event is fired. The SearchFields, event type, event data and form state are passed to the subworkflow.\r\n\r\n## Development\r\n\r\nThis project was bootstrapped with the [VertiGIS Studio Workflow SDK](https://github.com/vertigis/vertigis-workflow-sdk). Before you can use your 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).\r\n\r\n## Available Scripts\r\n\r\nInside the newly created project, you can run some built-in commands:\r\n\r\n### `npm run generate`\r\n\r\nInteractively generate a new activity or form element.\r\n\r\n### `npm start`\r\n\r\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/).\r\n\r\n### `npm run build`\r\n\r\nBuilds the activity pack for production to the `build` folder. It optimizes the build for the best performance.\r\n\r\nYour custom activity pack is now ready to be deployed!\r\n\r\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.\r\n\r\n## Documentation\r\n\r\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/)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertigis%2Fworkflow-activities-configurable-queries","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvertigis%2Fworkflow-activities-configurable-queries","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertigis%2Fworkflow-activities-configurable-queries/lists"}