@pipedream/salesforce_rest_api 0.4.3 → 0.4.5

package/README.md

@@ -0,0 +1,25 @@
+# Getting Started
+
+You can install the Pipedream Salesforce app in the [Accounts](https://pipedream.com/accounts) section of your account, or directly in a workflow.
+
+### Webhooks
+
+If you happen to stumble on the error: `UNKNOWN_EXCEPTION: admin operation already in progress` when creating an **Instant** trigger, you can follow the steps below to use the Salesforce Flow Builder to be able to use webhooks with Pipedream. This is a known error in Salesforce.
+
+1. Create a New Workflow on [Pipedream](https://pipedream.com) and [add a HTTP trigger](https://pipedream.com/docs/workflows/steps/triggers/#http).
+2. Login and go to your [Salesforce Setup Menu Page](https://help.salesforce.com/s/articleView?id=sf.basics_nav_setup.htm&type=5).
+3. On the left hand Quick Find Bar, search for **Outbound Messages** in **Process Automation -> Workflow Actions**.
+4. Click on the **New Outbound Message** button in the middle of the page.
+5. Select the **Object Type** and click **Next**.
+6. Fill in the **Name, Unique Name, and Available Fields to Send** fields in the form. On the **Endpoint URL** field, paste the **URL endpoint** generated by the HTTP trigger created earlier and then click **Save**.
+7. Back to the left hand Quick Find Bar, search for **Flows** in **Process Automation**.
+8. Click on **New Flow** button on the upper right hand corner and then select on **Record-Trigged Flow** and click on Create.
+9. Select the same **Object Type** as before and select the appropriate flow trigger.
+10. Optionally set **Entry Conditions**, keep **Actions and Related Records** selected, and click on **Done**.
+11. Click on the plus sign below the newly created trigger and click on **Action**.
+12. Search for **Outbound Message** and on the search bar select the trigger that was created previously.
+13. Insert a **Label** and an **API Name** and then click on **Done**.
+14. Save the flow by clicking on the **Save** button, insert a **Flow Label** and a **Flow API Name** and then click on **Activate** next to the Save button.
+15. Back to the Pipedream Workflow, create a new step with the **Salesforce Convert SOAP Object** action.
+16. In the **XML Soap Object** field, select the path from the trigger or type in `{{steps.trigger.event.body}}`.
+17. That's it! You can now deploy the workflow and you will receive instant updates from Salesforce.

package/actions/convert-soap-xml-to-json/convert-soap-xml-to-json.mjs

@@ -0,0 +1,61 @@
+import salesforce_rest_api from "../../salesforce_rest_api.app.mjs";
+import converter from "../../../helper_functions/actions/xml-to-json/xml-to-json.mjs";
+
+export default {
+  key: "salesforce_rest_api-convert-soap-xml-to-json",
+  name: "Convert SOAP XML Object to JSON",
+  description: "Converts a SOAP XML Object received from Salesforce to JSON",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    salesforce_rest_api,
+    xml: {
+      type: "string",
+      label: "XML Soap Object",
+      description: "The object received from Salesforce that will be converted.",
+    },
+    extractNotificationOnly: {
+      type: "boolean",
+      label: "Extract Notifications Only",
+      description: "Extracts only the notification parts from the XML. Default: `true`.",
+      optional: true,
+      default: true,
+    },
+    failOnError: {
+      type: "boolean",
+      label: "Fail on Error",
+      description: "If should fail on error when extracting notifications. Default: `false`.",
+      optional: true,
+      default: false,
+    },
+  },
+  async run({ $ }) {
+    const json = await converter.run.bind({
+      input: this.xml,
+      compact: false,
+    })({
+      $,
+    });
+
+    if (!this.extractNotificationOnly) {
+      return json;
+    }
+
+    try {
+      const notifications = json.elements[0].elements[0].elements[0].elements
+        .filter(({ name }) => name === "Notification");
+      return {
+        notifications,
+      };
+    } catch (e) {
+      const errorMessage = "Successfully converted to JSON, but was unable to extract notifications";
+      if (this.failOnError) {
+        $.export("$summary", errorMessage); // overrides exported $summary in converter
+        throw new Error(errorMessage);
+      }
+
+      $.export("$summary", `${errorMessage}. Will return the whole JSON.`);
+      return json;
+    }
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/salesforce_rest_api",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Pipedream Salesforce (REST API) Components",
   "main": "salesforce_rest_api.app.mjs",
   "keywords": [

package/sources/new-object-instant/new-object-instant.mjs

@@ -1,5 +1,4 @@
 import startCase from "lodash/startCase.js";
-
 import common from "../common-instant.mjs";
 
 export default {
@@ -8,7 +7,29 @@ export default {
   name: "New Object (Instant, of Selectable Type)",
   key: "salesforce_rest_api-new-object-instant",
   description: "Emit new event immediately after an object of arbitrary type (selected as an input parameter by the user) is created",
-  version: "0.1.1",
+  version: "0.1.2",
+  hooks: {
+    ...common.hooks,
+    async deploy() {
+      const objectType = this.objectType;
+      const nameField = await this.salesforce.getNameFieldForObjectType(objectType);
+      this.setNameField(nameField);
+
+      // emit hisorical events
+      const { recentItems } = await this.salesforce.listSObjectTypeIds(objectType);
+      const ids = recentItems.map((item) => item.Id);
+      for (const id of ids.slice(-25)) {
+        const object = await this.salesforce.getSObject(objectType, id);
+        const event = {
+          body: {
+            "New": object,
+            "UserId": id,
+          },
+        };
+        this.processEvent(event);
+      }
+    },
+  },
   methods: {
     ...common.methods,
     generateMeta(data) {