{"id":44356106,"url":"https://github.com/vertigis/workflow-activities-salesforce","last_synced_at":"2026-02-11T16:08:55.342Z","repository":{"id":216873528,"uuid":"735429468","full_name":"vertigis/workflow-activities-salesforce","owner":"vertigis","description":"Salesforce activities for VertiGIS Studio Workflow","archived":false,"fork":false,"pushed_at":"2024-10-19T13:54:35.000Z","size":1395,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-08-08T23:52:24.930Z","etag":null,"topics":[],"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":"2023-12-24T22:40:35.000Z","updated_at":"2024-06-18T22:54:36.000Z","dependencies_parsed_at":"2024-01-18T01:28:24.043Z","dependency_job_id":"09560754-79b4-4cfa-9473-5ec0d2d471f8","html_url":"https://github.com/vertigis/workflow-activities-salesforce","commit_stats":null,"previous_names":["vertigis/workflow-activities-salesforce"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/vertigis/workflow-activities-salesforce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-salesforce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-salesforce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-salesforce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-salesforce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vertigis","download_url":"https://codeload.github.com/vertigis/workflow-activities-salesforce/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertigis%2Fworkflow-activities-salesforce/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29337209,"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:54.682Z","updated_at":"2026-02-11T16:08:55.336Z","avatar_url":"https://github.com/vertigis.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Salesforce Activities\n\n[![CI/CD](https://github.com/vertigis/workflow-activities-salesforce/workflows/CI/CD/badge.svg)](https://github.com/vertigis/workflow-activities-salesforce/actions)\n[![npm](https://img.shields.io/npm/v/@vertigis/workflow-activities-salesforce)](https://www.npmjs.com/package/@vertigis/workflow-activities-salesforce)\n\nThis project contains activities for accessing an organization's data via the Salesforce REST API. [Click here](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_rest.htm) for more information on the resources and requests available via the Salesforce REST API.\n\n## Requirements\n\n### Cross-Origin Resource Sharing (CORS) \nThe target Salesforce instance must include the requesting origin of the application running the workflow in its Cross-Origin Resource Sharing (CORS) Allowlist. For example: `https://acme.apps.vertigisstudio.com`. [Learn more](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/extend_code_cors.htm).\n\n### OAuth2 App\n\nA connected app and an OAuth 2.0 authorization flow must be configured in Salesforce to facilitate the sign in to Salesforce from the application running the workflow. [Learn more](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_oauth_and_connected_apps.htm).\n\n### OAuth2 Callback Page\n\nThis activity pack requires that you host a HTML page on a web server you control that uses [`postMessage`](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage) to provide the OAuth callback result URL back to the browser window running the workflow. For example:\n\n```\n\u003c!DOCTYPE html\u003e\n\u003chtml lang=\"en\"\u003e\n\u003chead\u003e\n    \u003cmeta charset=\"UTF-8\" /\u003e\n    \u003cmeta name=\"viewport\" content=\"initial-scale=1, maximum-scale=1, user-scalable=no\" /\u003e\n    \u003cmeta http-equiv=\"X-UA-Compatible\" content=\"ie=edge\" /\u003e\n    \u003ctitle\u003eOAuth2 Callback\u003c/title\u003e\n    \u003cscript\u003e\n        window.opener.postMessage(location.href, \"*\");\n        setTimeout(() =\u003e window.close(), 500);\n    \u003c/script\u003e\n\u003c/head\u003e\n\u003cbody\u003e\n    ...\n\u003c/body\u003e\n\u003c/html\u003e\n```\n\nNote: It is important to change the target origin from `\"*\"` to the actual origin of the application running the workflow. For example: `https://acme.apps.vertigisstudio.com`.\n\n### VertiGIS Studio Workflow Versions\n\nThese activities are designed to work with VertiGIS Studio Workflow versions `5.36.0` and above.\n\n## Usage\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.\n\n### Register the Salesforce 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-salesforce/activitypack.json for the latest version\n        - Use https://unpkg.com/@vertigis/workflow-activities-salesforce@1/activitypack.json for the latest revision of a specific major version\n        - Use https://unpkg.com/@vertigis/workflow-activities-salesforce@1.0.0/activitypack.json for a specific version\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. These activities will now appear in the activity toolbox in a `Salesforce` category\n\n### Use the Salesforce activities in a workflow\n\n1. Authenticate with the Salesforce service\n    1. Add the `Create Salesforce Service` activity to a workflow\n    1. Set the `URL` input to the root URL of your Salesforce instance. For example, `https://acme.my.salesforce.com`.\n    1. Set the `Version` input to the desired version of the Salesforce REST API to use. For example, `59.0`.\n    1. Set the `Client ID` input to the Client ID of your Salesforce connected app\n    1. Set the `Redirect URI` input to the URL of your OAuth2 callback page\n1. Use the Salesforce service\n    1. Add one of the other Salesforce activities to the workflow. For example, `Get Salesforce Object`.\n    1. Set the `Service` input of the activity to be the output of the `Create Salesforce Service` activity\n        - Typically this would use an expression like `=$sfService1.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/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).\n\n## Available Scripts\n\nInside the newly created 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 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\n1. Find [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/)\n2. REST API documentation can be found on the [Salesforce REST API Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_rest.htm).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertigis%2Fworkflow-activities-salesforce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvertigis%2Fworkflow-activities-salesforce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertigis%2Fworkflow-activities-salesforce/lists"}