Maintenance Request Oxmaint (Independent Publisher)

independent-publisher-connectors/MaintenanceRequestOxmaint/Readme.md

@@ -0,0 +1,47 @@
+# Request Maintenance Oxmaint Connector
+The **Request Maintenance Oxmaint Connector** allows users to create and manage **maintenance requests** seamlessly through **Power Automate**, **Power Apps**, or **Azure Logic Apps**. It streamlines the submission of maintenance tasks, ensuring issues are tracked, assigned, and resolved efficiently. This connector integrates with **CMMS**, enabling better **work order** management and improving overall maintenance workflows.
+
+## Publisher: Oxmaint Inc.
+
+## Prerequisites
+Before using the **Request Maintenance Oxmaint Connector**, ensure that you have:
+- Access to **Power Automate**, **Power Apps**, or **Azure Logic Apps**.
+- Credentials (username and password) for Oxmaint Maintenance Management System.​
+
+## Supported Operations
+This connector supports the following operations:​
+### Operation 1
+**Create Maintenance Request**
+Allows users to create a new maintenance request within the Oxmaint system. The request is logged, tracked, and assigned based on the asset or equipment's status, ensuring timely response and resolution.
+
+## Obtaining Credentials
+To use the Request Maintenance Oxmaint Connector, you will need to authenticate using valid user credentials. Follow these steps to obtain the credentials:
+
+1. Create an Account: Ensure you have an active Oxmaint account with appropriate access to the maintenance module or register here https://oxmaint.com/portal/signup.html
+2. Login Credentials: Use the registered email and password for your Oxmaint account to authenticate the connector.​
+3. API Key: If the connector requires an API key, obtain it by logging into the Oxmaint dashboard and navigating to your API settings.
+
+## Getting Started
+To get started with the Request Maintenance Oxmaint Connector:
+
+1. Add the connector to Power Automate, Power Apps, or Azure Logic Apps.
+2. Authenticate using your Oxmaint credentials (as described above).
+3. Set up your first flow or app by configuring actions such as Create Maintenance Request.
+4. Test your flow to ensure that maintenance requests are successfully submitted and tracked in Oxmaint.
+
+
+## Known Issues and Limitations
+- **Field Requirements**: Ensure all required fields are provided in the request to avoid errors.
+- **Limited Error Messages**: Error messages from failed maintenance requests may be generic or vague, requiring additional troubleshooting in the Oxmaint system.
+
+### **Support**
+For any issues or questions regarding the **Request Maintenance Oxmaint Connector**, please contact:
+- **Email**: [contact@oxmaint.com]
+
+
+### **Changelog**
+- **v1.0.0**: Initial release with the ability to create maintenance requests, including fields for title, description, priority, and location/asset information.
+
+
+### **Resources**
+- [Power Platform Custom Connectors Documentation](https://docs.microsoft.com/en-us/connectors/custom-connectors/)

independent-publisher-connectors/MaintenanceRequestOxmaint/apiDefinition.swagger.json

@@ -0,0 +1,152 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "1.0.0",
+    "title": "Maintenance Request - Oxmaint",
+    "description": "This is a Oxmaint Maintenance Request that can take care of your approvals.",
+    "contact": {
+      "name": "Oxmaint Support",
+      "url": "https://oxmaint.com/about-us",
+      "email": "contact@oxmaint.com"
+    }
+  },
+  "host": "prod-111.westeurope.logic.azure.com",
+  "basePath": "/",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/workflows/81fb7bc062f3419a8c0ba8ac0132d631/triggers/manual/paths/invoke": {
+      "post": {
+        "summary": "Maintenance Request - Oxmaint",
+        "description": "Maintenance Request - Oxmaint",
+        "operationId": "MaintenanceRequest-Oxmaint",
+        "parameters": [
+          {
+            "name": "api-version",
+            "default": "2016-06-01",
+            "in": "query",
+            "type": "string",
+            "required": true,
+            "x-ms-visibility": "internal"
+          },
+          {
+            "name": "sp",
+            "default": "/triggers/manual/run",
+            "in": "query",
+            "type": "string",
+            "required": true,
+            "x-ms-visibility": "internal"
+          },
+          {
+            "name": "sv",
+            "default": "1.0",
+            "in": "query",
+            "type": "string",
+            "required": true,
+            "x-ms-visibility": "internal"
+          },
+          {
+            "name": "sig",
+            "default": "7zabIRU45x3Syx725dxQyiiSUSNX3iIF0Jr-2wKcxY0",
+            "in": "query",
+            "type": "string",
+            "required": true,
+            "x-ms-visibility": "internal"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "schema": {
+              "type": "object",
+              "properties": {
+                "title": {
+                  "type": "string",
+                  "description": "title",
+                  "title": "Title",
+                  "x-ms-visibility": "important"
+                },
+                "description": {
+                  "type": "string",
+                  "description": "description",
+                  "title": "Description",
+                  "x-ms-visibility": "important"
+                },
+                "priority": {
+                  "type": "string",
+                  "description": "priority",
+                  "title": "Priority",
+                  "x-ms-visibility": "important"
+                },
+                "requested_by": {
+                  "type": "string",
+                  "description": "requested_by",
+                  "title": "Requestor",
+                  "x-ms-visibility": "important"
+                },
+                "date": {
+                  "type": "string",
+                  "description": "date",
+                  "title": "Date",
+                  "x-ms-visibility": "important"
+                },
+                "master_email": {
+                  "type": "string",
+                  "description": "master_email",
+                  "title": "Master Email",
+                  "x-ms-visibility": "important"
+                },
+                "api_key": {
+                  "type": "string",
+                  "description": "api_key",
+                  "title": "API Key",
+                  "x-ms-visibility": "important"
+                }
+              },
+              "default": {
+                "title": "Test WO Request",
+                "description": "Hello there Please create a WO request",
+                "priority": "Low",
+                "requested_by": "Sachin Upadhyay",
+                "date": "20-Feb-2024 11:12 AM",
+                "master_email": "nikita@gmail.com",
+                "api_key": "123456"
+              },
+              "x-ms-visibility": "important",
+              "required": [
+                "api_key",
+                "date",
+                "description",
+                "master_email",
+                "priority",
+                "requested_by",
+                "title"
+              ]
+            },
+            "required": true,
+            "x-ms-visibility": "important"
+          }
+        ],
+        "responses": {
+          "default": {
+            "description": "default",
+            "schema": {}
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {},
+  "responses": {},
+  "securityDefinitions": {},
+  "security": [],
+  "tags": [],
+  "x-ms-openai-manifest": {
+    "humanName": ""
+  }
+}

independent-publisher-connectors/MaintenanceRequestOxmaint/apiProperties.json

@@ -0,0 +1,8 @@
+{
+  "properties": {
+    "connectionParameters": {},
+    "iconBrandColor": "#f7f7f7",
+    "capabilities": [],
+    "publisher": "Ram Upadhayay"
+  }
+}