[Components] ninjaone - WIP

Author: jcortes

components/ninjaone/actions/create-ticket/create-ticket.mjs

@@ -0,0 +1,128 @@
+import app from "../../ninjaone.app.mjs";
+
+export default {
+  key: "ninjaone-create-ticket",
+  name: "Create Ticket",
+  description: "Create a new support ticket in NinjaOne. [See the documentation](https://app.ninjarmm.com/apidocs/?links.active=core#/ticketing/create).",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    app,
+    clientId: {
+      label: "Client ID",
+      description: "The identifier of the client. Organization identifier.",
+      propDefinition: [
+        app,
+        "organizationId",
+      ],
+    },
+    ticketFormId: {
+      propDefinition: [
+        app,
+        "ticketFormId",
+      ],
+    },
+    subject: {
+      type: "string",
+      label: "Subject",
+      description: "The subject of the ticket. Eg. `CPU with problems`.",
+    },
+    status: {
+      propDefinition: [
+        app,
+        "ticketStatus",
+      ],
+    },
+    type: {
+      type: "string",
+      label: "Ticket Type",
+      description: "The type of the ticket.",
+      optional: true,
+      options: [
+        "PROBLEM",
+        "QUESTION",
+        "INCIDENT",
+        "TASK",
+      ],
+    },
+    assignedAppUserId: {
+      propDefinition: [
+        app,
+        "assignedAppUserId",
+      ],
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "The description of the support ticket",
+      optional: false,
+    },
+    isDescriptionPublic: {
+      type: "boolean",
+      label: "Description Public",
+      description: "Whether the description of the ticket is public.",
+      optional: true,
+    },
+    parentTicketId: {
+      type: "string",
+      label: "Parent Ticket ID",
+      description: "The identifier of the parent ticket.",
+      optional: true,
+    },
+    priority: {
+      type: "string",
+      label: "Ticket Priority",
+      description: "The priority of the ticket",
+      optional: true,
+      options: [
+        "NONE",
+        "LOW",
+        "MEDIUM",
+        "HIGH",
+      ],
+    },
+  },
+  methods: {
+    createTicket(args = {}) {
+      return this.app.post({
+        path: "/ticketing/ticket",
+        ...args,
+      });
+    },
+  },
+  async run({ $ }) {
+    const {
+      createTicket,
+      clientId,
+      ticketFormId,
+      subject,
+      status,
+      type,
+      assignedAppUserId,
+      description,
+      // isDescriptionPublic,
+      parentTicketId,
+      priority,
+    } = this;
+
+    const response = await createTicket({
+      $,
+      data: {
+        clientId,
+        ticketFormId,
+        subject,
+        status,
+        type,
+        assignedAppUserId,
+        description,
+        // isDescriptionPublic,
+        parentTicketId,
+        priority,
+      },
+    });
+
+    $.export("$summary", "Successfully created ticket.");
+
+    return response;
+  },
+};

components/ninjaone/actions/update-device-custom-fields/update-device-custom-fields.mjs

@@ -0,0 +1,50 @@
+import app from "../../ninjaone.app.mjs";
+import utils from "../../common/utils.mjs";
+
+export default {
+  key: "ninjaone-update-device-custom-fields",
+  name: "Update Device Custom Fields",
+  description: "Update custom fields for a device in NinjaOne. Requires a device identifier. Optionally update the device name, group, or status. [See the documentation](https://app.ninjarmm.com/apidocs/?links.active=core#/devices/updateNodeAttributeValues).",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    app,
+    deviceId: {
+      propDefinition: [
+        app,
+        "deviceId",
+      ],
+    },
+    data: {
+      type: "object",
+      label: "Custom Fields",
+      description: "Additional custom fields to update.",
+    },
+  },
+  methods: {
+    updateDeviceCustomFields({
+      deviceId, ...args
+    } = {}) {
+      return this.app.patch({
+        path: `/device/${deviceId}/custom-fields`,
+        ...args,
+      });
+    },
+  },
+  async run({ $ }) {
+    const {
+      updateDeviceCustomFields,
+      deviceId,
+      data,
+    } = this;
+
+    const response = await updateDeviceCustomFields({
+      $,
+      deviceId,
+      data: utils.parse(data),
+    });
+
+    $.export("$summary", "Successfully updated device custom fields.");
+    return response;
+  },
+};

components/ninjaone/common/constants.mjs

@@ -0,0 +1,15 @@
+const BASE_URL = "https://app.ninjarmm.com";
+const VERSION_PATH = "/api/v2";
+const LAST_CREATED_AT = "lastCreatedAt";
+const DEFAULT_LIMIT = 50;
+const DEFAULT_MAX = 600;
+const WEBHOOK_ID = "webhookId";
+
+export default {
+  BASE_URL,
+  VERSION_PATH,
+  DEFAULT_MAX,
+  LAST_CREATED_AT,
+  DEFAULT_LIMIT,
+  WEBHOOK_ID,
+};

components/ninjaone/common/utils.mjs

@@ -0,0 +1,24 @@
+import { ConfigurationError } from "@pipedream/platform";
+
+function emptyStrToUndefined(value) {
+  const trimmed = typeof(value) === "string" && value.trim();
+  return trimmed === ""
+    ? undefined
+    : value;
+}
+
+function parse(value) {
+  const valueToParse = emptyStrToUndefined(value);
+  if (typeof(valueToParse) === "object" || valueToParse === undefined) {
+    return valueToParse;
+  }
+  try {
+    return JSON.parse(valueToParse);
+  } catch (e) {
+    throw new ConfigurationError("Make sure the custom expression contains a valid object.");
+  }
+}
+
+export default {
+  parse,
+};