[Forms] Add Edit Properties

Add the Edit Properties action, now that Forms are
available to support it. Integration of forms
component, WTD-593.

platform/commonUI/edit/src/actions/PropertiesAction.js

@@ -0,0 +1,82 @@
+/*global define*/
+
+/**
+ * Edit the properties of a domain object. Shows a dialog
+ * which should display a set of properties similar to that
+ * shown in the Create wizard.
+ */
+define(
+    ['./PropertiesDialog'],
+    function (PropertiesDialog) {
+        'use strict';
+
+        /**
+         * Construct an action which will allow an object's metadata to be
+         * edited.
+         *
+         * @param {DialogService} dialogService a service which will show the dialog
+         * @param {DomainObject} object the object to be edited
+         * @param {ActionContext} context the context in which this action is performed
+         * @constructor
+         */
+        function PropertiesAction(dialogService, context) {
+            var object = context.domainObject;
+
+            // Persist modifications to this domain object
+            function doPersist() {
+                var persistence = object.getCapability('persistence');
+                return persistence && persistence.persist();
+            }
+
+            // Update the domain object model based on user input
+            function updateModel(userInput, dialog) {
+                return object.useCapability('mutation', function (model) {
+                    dialog.updateModel(model, userInput);
+                });
+            }
+
+            function showDialog(type) {
+                // Create a dialog object to generate the form structure, etc.
+                var dialog = new PropertiesDialog(type, object.getModel());
+
+                // Show the dialog
+                return dialogService.getUserInput(
+                    dialog.getFormStructure(),
+                    dialog.getInitialFormValue()
+                ).then(function (userInput) {
+                    // Update the model, if user input was provided
+                    return userInput && updateModel(userInput, dialog);
+                }).then(function (result) {
+                    return result && doPersist();
+                });
+            }
+
+            return {
+                /**
+                 * Perform this action.
+                 * @return {Promise} a promise which will be
+                 *         fulfilled when the action has completed.
+                 */
+                perform: function () {
+                    var type = object.getCapability('type');
+                    return type && showDialog(type);
+                }
+            };
+        }
+
+        /**
+         * Filter this action for applicability against a given context.
+         * This will ensure that a domain object is present in the
+         * context.
+         */
+        PropertiesAction.appliesTo = function (context) {
+            return (context || {}).domainObject &&
+                (context || {}).domainObject.hasCapability("type") &&
+                (context || {}).domainObject.hasCapability("persistence");
+        };
+
+        return PropertiesAction;
+    }
+
+);
+