feat: Add Cloud Function execution on Parse Object in data browser

README.md

@@ -42,6 +42,7 @@ Parse Dashboard is a standalone dashboard for managing your [Parse Server](https
  - [Other Configuration Options](#other-configuration-options)
  - [Prevent columns sorting](#prevent-columns-sorting)
  - [Custom order in the filter popup](#custom-order-in-the-filter-popup)
+ - [Custom Cloud Code scripts](#custom-cloud-code-scripts)
 - [Running as Express Middleware](#running-as-express-middleware)
 - [Deploying Parse Dashboard](#deploying-parse-dashboard)
  - [Preparing for Deployment](#preparing-for-deployment)
@@ -329,13 +330,70 @@ If you have classes with a lot of columns and you filter them often with the sam
  {
  "name": "email",
  "filterSortToTop": true
- } 
+ }
  ]
  }
  }
 ]
 ```
 
+### Custom Cloud Code scripts
+
+You can specify custom cloud code scripts with the `scripts` option:
+
+
+```json
+"apps": [
+ {
+ "scripts": [
+ {
+ "title": "Delete Account",
+ "classes": ["_User"],
+ "cloudCodeFunction": "deleteAccount"
+ }
+ ]
+ }
+]
+```
+
+Next, define a cloud function within the connected Parse Server.
+
+**Parse Server 2.1.4 > 4.4.0**
+
+```js
+Parse.Cloud.define('deleteAccount', async (req) => {
+ if (!req.master || !req.params.object) {
+ throw 'Unauthorized';
+ }
+ req.params.object = Parse.Object.fromJSON(req.params.object);
+ req.params.object.set('deleted', true);
+ await req.params.object.save(null, {useMasterKey: true});
+});
+```
+
+**Parse Server 4.4.0 > 6.2.0**
+
+```js
+Parse.Cloud.define('deleteAccount', async (req) => {
+ req.params.object = Parse.Object.fromJSON(req.params.object);
+ req.params.object.set('deleted', true);
+ await req.params.object.save(null, {useMasterKey: true});
+}, {
+ requireMaster: true
+});
+```
+
+**Parse Server 6.2.0+**
+
+```js
+Parse.Cloud.define('deleteAccount', async (req) => {
+ req.params.object.set('deleted', true);
+ await req.params.object.save(null, {useMasterKey: true});
+}, {
+ requireMaster: true
+});
+```
+
 # Running as Express Middleware
 
 Instead of starting Parse Dashboard with the CLI, you can also run it as an [express](https://github.com/expressjs/express) middleware.
@@ -452,7 +510,7 @@ With MFA enabled, a user must provide a one-time password that is typically boun
 
 The user requires an authenticator app to generate the one-time password. These apps are provided by many 3rd parties and mostly for free.
 
-If you create a new user by running `parse-dashboard --createUser`, you will be asked whether you want to enable MFA for the new user. To enable MFA for an existing user, 
+If you create a new user by running `parse-dashboard --createUser`, you will be asked whether you want to enable MFA for the new user. To enable MFA for an existing user,
 run `parse-dashboard --createMFA` to generate a `mfa` secret that you then add to the existing user configuration, for example:
 
 ```json

src/components/BrowserCell/BrowserCell.react.js

@@ -15,7 +15,6 @@ import React, { Component } from 'react';
 import styles from 'components/BrowserCell/BrowserCell.scss';
 import baseStyles from 'stylesheets/base.scss';
 import * as ColumnPreferences from 'lib/ColumnPreferences';
-
 export default class BrowserCell extends Component {
  constructor() {
  super();
@@ -276,6 +275,29 @@ export default class BrowserCell extends Component {
  });
  }
 
+ const validScripts = (this.props.scripts || []).filter(script => script.classes?.includes(this.props.className));
+ if (validScripts.length) {
+ onEditSelectedRow && contextMenuOptions.push({
+ text: 'Scripts',
+ items: validScripts.map(script => {
+ return {
+ text: script.title,
+ callback: async () => {
+ try {
+ const object = Parse.Object.extend(this.props.className).createWithoutData(this.props.objectId);
+ const response = await Parse.Cloud.run(script.cloudCodeFunction, {object: object.toPointer()}, {useMasterKey: true});
+ this.props.showNote(response || `${script.title} ran with object ${object.id}}`);
+ this.props.onRefresh();
+ } catch (e) {
+ this.props.showNote(e.message, true);
+ console.log(`Could not run ${script.title}: ${e}`);
+ }
+ }
+ }
+ })
+ });
+ }
+
  return contextMenuOptions;
  }
 

src/components/BrowserRow/BrowserRow.react.js

@@ -100,7 +100,11 @@ export default class BrowserRow extends Component {
  markRequiredFieldRow={markRequiredFieldRow}
  setCopyableValue={setCopyableValue}
  setContextMenu={setContextMenu}
- onEditSelectedRow={onEditSelectedRow} />
+ onEditSelectedRow={onEditSelectedRow}
+ showNote={this.props.showNote}
+ onRefresh={this.props.onRefresh}
+ scripts={this.props.scripts}
+ />
  );
  })}
  </div>

src/dashboard/Data/Browser/BrowserTable.react.js

@@ -155,6 +155,9 @@ export default class BrowserTable extends React.Component {
  setContextMenu={this.props.setContextMenu}
  onEditSelectedRow={this.props.onEditSelectedRow}
  markRequiredFieldRow={this.props.markRequiredFieldRow}
+ showNote={this.props.showNote}
+ onRefresh={this.props.onRefresh}
+ scripts={this.context.scripts}
  />
  <Button
  value="Clone"
@@ -207,6 +210,9 @@ export default class BrowserTable extends React.Component {
  setContextMenu={this.props.setContextMenu}
  onEditSelectedRow={this.props.onEditSelectedRow}
  markRequiredFieldRow={this.props.markRequiredFieldRow}
+ showNote={this.props.showNote}
+ onRefresh={this.props.onRefresh}
+ scripts={this.context.scripts}
  />
  <Button
  value="Add"
@@ -263,7 +269,11 @@ export default class BrowserTable extends React.Component {
  setRelation={this.props.setRelation}
  setCopyableValue={this.props.setCopyableValue}
  setContextMenu={this.props.setContextMenu}
- onEditSelectedRow={this.props.onEditSelectedRow} />
+ onEditSelectedRow={this.props.onEditSelectedRow}
+ showNote={this.props.showNote}
+ onRefresh={this.props.onRefresh}
+ scripts={this.context.scripts}
+ />
  }
 
  if (this.props.editing) {

src/lib/ParseApp.js

@@ -44,7 +44,8 @@ export default class ParseApp {
  supportedPushLocales,
  preventSchemaEdits,
  graphQLServerURL,
- columnPreference
+ columnPreference,
+ scripts
  }) {
  this.name = appName;
  this.createdAt = created_at ? new Date(created_at) : new Date();
@@ -71,6 +72,7 @@ export default class ParseApp {
  this.preventSchemaEdits = preventSchemaEdits || false;
  this.graphQLServerURL = graphQLServerURL;
  this.columnPreference = columnPreference;
+ this.scripts = scripts;
 
  if(!supportedPushLocales) {
  console.warn('Missing push locales for \'' + appName + '\', see this link for details on setting localizations up. https://github.com/parse-community/parse-dashboard#configuring-localized-push-notifications');