account and quotas placeholders (#219)

* JE-53455 onBeforeInit quotas validation

* JE-53455 onBeforeInit new placeholders added

The ${account.(key)}, ${quota.(key)} and ${quota.data.(key)} placeholders added to Placeholders

* Error fixed

* JE-53455 onBeforeInit field owner added

* JE-53455 onBeforeInit shared-with-me pic added

* JE-53455 onBeforeInit owner pic added

* JE-53455 onBeforeInit event updated

* error fixed

* Update docs/creating-manifest/placeholders.md

---------

Co-authored-by: vlobzakov <39057925+vlobzakov@users.noreply.github.com>

Author: SlavaKatiukha

docs/creating-manifest/events.md

@@ -1366,14 +1366,71 @@ The *onBeforeInit* event is executed:
    installation dialog in the dashboard   
 -   on application installation
 
-
-Placeholders do not work inside *onBeforeInit*, since even *globals* can be defined dynamically.
 You can override all the parameters of the manifest, except for:
 
 -   `type`
 -   `name`
 -   `baseUrl`
 
+The *GetAppInfo* method has **ownerUid** parameter which allows to define a collaborator's account. Parameter is applied if the [owner](visual-settings/#owner) field is added to manifest. The [account](placeholders/#account-placeholders) and [quota](placeholders/#quota-placeholders) placeholders will be filled in depending on defined account.
+
+For example:
+
+@@@
+```yaml
+type: install
+name: Account And Quota Placeholders
+settings:
+  fields: 
+    - type: owner
+      caption: Owner
+      name: ownerUid
+  onBeforeInit: |
+     settings.fields.push({
+       type: "string",
+       caption: "Account",
+       name: "email",
+       value: "${account.email}"
+     }, {
+       type: "string",
+      caption: "Cloudlets",
+      name: "cloudlets",
+      value: "${quota.environment.maxcloudletsperrec}"
+     });
+     return settings;
+```
+```json
+{
+  "type": "install",
+  "name": "Account And Quota Placeholders",
+  "settings": {
+    "fields": [
+    {
+    "type": "owner",
+    "caption": "Owner",
+    "name": "ownerUid"
+    }
+    ],
+    "onBeforeInit": [
+        "settings.fields.push({",
+        "  type: 'string',",
+        "  caption: 'Account',",
+        "  name: 'email',",
+        "  value: '${account.email}'",
+        "},",
+        "{",
+        "  type: 'string',",
+        "  caption: 'Cloudlets',",
+        "  name: 'cloudlets',",
+        "  value: '${quota.environment.maxcloudletsperrec}'",
+        "});",
+        "return settings;"
+        ]
+  }
+}
+```
+@@!
+
 #### onBeforeInstall
 The *onBeforeInstall* event is executed before application installation but after *onBeforeInit*.
 The placeholders **\${globals.}** and **\${settings.}** can be used within *onBeforeInstall*. All of the manifest parameters can be overridden, except for:

docs/creating-manifest/placeholders.md

@@ -28,7 +28,13 @@ The following specific groups of placeholders are singled out:
 
 - [Array Placeholders](placeholders/#array-placeholders)                                       
 
-- [File Path Placeholders](placeholders/#file-path-placeholders)                                 
+- [File Path Placeholders](placeholders/#file-path-placeholders)      
+                           
+- [Engine Placeholder](placeholders/#engine-placeholder)      
+                           
+- [Account Placeholders](placeholders/#account-placeholders)
+
+- [Quota Placeholders](placeholders/#quota-placeholders)
 
 Placeholders like `env`, `nodes`, `targetNodes`, `response` are dynamically updated. They could be updated by their requests if they are required to be updated.
 
@@ -1247,6 +1253,106 @@ onInstall:
 ```
 @@!
 
+## Account Placeholders
+
+To ensure ability to process user's quotas and collaboration the following `${account.(key)}` placeholders are available:
+
+- `${account.}`  
+    - `${account.groupType}`
+    - `${account.bonus}`
+    - `${account.hardNodeGroups}` 
+    - `${account.createdOn}`
+    - `${account.updatedGroupOn}`
+    - `${account.defaultHardNodeGroup}`
+    - `${account.uid}`
+    - `${account.isCommerial}`
+    - `${account.balance}`
+    - `${account.isRegistered}`
+    - `${account.updatedStatusOn}`
+    - `${account.status}`
+    - `${account.group}`
+    - `${account.email}`
+
+Placeholders *${account.(key)}* are initialized on demand, that is, only if they are used and only at the moment they are required.
+Placeholder values are filled in depending on which user the installation is carried out for. That is, the placeholders will be filled with values for the collaborator selected during installation.  
+
+## Quota Placeholders
+
+To ensure ability to process user's quotas and collaboration the following `${quota.(key)` and `${quota.data.(key)}` placeholders are available:
+
+- `${quota.}`  
+    - `${quota.maxcloudletsperrec}`
+    - `${quota.maxcount}`
+    - `${quota.disk.iolimit}`
+    - ...
+   
+- `${quota.data.}`  
+    - `${quota.data.environment.maxcloudletsperrec.quota.name}`  
+    - `${quota.data.environment.maxcloudletsperrec.quota.description}`  
+    - `${quota.data.environment.maxcloudletsperrec.quota.id}`   
+    - `${quota.data.environment.maxcloudletsperrec.type}`  
+    - `${quota.data.environment.maxcloudletsperrec.value}  
+    - ...  
+    
+Placeholders `${quota.(key)}` are initialized on demand, that is, only if they are used and only at the moment they are required.
+Placeholder values are filled in depending on which user the installation is carried out for. That is, the placeholders will be filled with values for the collaborator selected during installation.  
+
+Placeholders `${quota.(key)}` are filled with quota values, where **key** is the name of the quota (for example: *${quota.environment.maxcloudletsperrec}*).  
+
+Placeholders `${quota.data.(key)}` allow you to get quota data (for example, *type: ${quota.data.environment.maxcloudletsperrec.type}*).
+
+Example:
+
+@@@
+```yaml
+type: install
+name: Account And Quota Placeholders
+
+settings:
+  fields: []
+  
+  onBeforeInit: |
+    settings.fields.push({
+      type: "string",
+      caption: "Account",
+      name: "email",
+      value: "${account.email}"
+    }, {
+      type: "string",
+      caption: "Cloudlets",
+      name: "cloudlets",
+      value: "${quota.environment.maxcloudletsperrec}"
+    });
+    return settings;
+```
+```json
+{
+  "type": "install",
+  "name": "Account And Quota Placeholders",
+  "settings": {
+    "fields": [
+
+    ],
+    "onBeforeInit": [
+        "settings.fields.push({",
+        "  type: 'string',",
+        "  caption: 'Account',",
+        "  name: 'email',",
+        "  value: '${account.email}'",
+        "},",
+        "{",
+        "  type: 'string',",
+        "  caption: 'Cloudlets',",
+        "  name: 'cloudlets',",
+        "  value: '${quota.environment.maxcloudletsperrec}'",
+        "});",
+        "return settings;"
+        ]
+  }
+}
+```
+@@!
+
 
 <br>       
 <h2> What’s next?</h2>                    

docs/creating-manifest/visual-settings.md

@@ -2136,6 +2136,34 @@ settings:
 Result:  
 ![Tooltip-composit-field](/img/tooltip-composit-field.png)</center>  
 
+### owner
+
+This field allows you to add the possibility of collaboration for packages with **type: install** without section nodes when installing environments in nested manifests.
+
+@@@
+```yaml
+- type: owner
+  caption: Owner
+  name: ownerUid
+```
+```json
+[
+  {
+    "type": "owner",
+    "caption": "Owner",
+    "name": "ownerUid"
+  }
+]
+```
+@@!
+
+![owner-field](/img/owner-field.png)
+
+The field is not displayed if there are no users defined in **Shared with Me**.
+
+![shared-with-me](/img/shared-with-me.png)
+
+Changing the *Owner* field value results in the data will be re-rerquested with *GetAppInfo* method and form re-rendered in case there is [onBeforeInit](events/#onbeforeinit) in the mainifest. Re-rendering will be performed according to the account and quotas of collaborator.
 
 ## Dynamic filling of the manifest fields
 Ability to dynamically determine UI in JPS manifest is accessible via [*onBeforeInit*  *onBeforeInstall*](events/#onbeforeinit) events.