Add OrganizationSettings global variable resolver and update document… (#208)

* Add OrganizationSettings global variable resolver and update documentation

* Releasing and promoting a new package version.

Author: cesarParra

docs/public/packages.json

@@ -1,4 +1,4 @@
 {
-  "packageId": "04tRb0000037T8PIAU",
+  "packageId": "04tRb000003L5m9IAC",
   "componentPackageId": "04tRb0000012Mv8IAE"
 }

docs/src/app/docs/referencing-org-data/page.md

@@ -83,3 +83,12 @@ The `timeZone` property of the `$UserSettings` global variable returns a map con
 Object result = expression.Evaluator.run('$UserSettings.timeZone.name');
 Object gmtOffset = expression.Evaluator.run('$UserSettings.timeZone.gmtOffset');
 ```
+
+## Organization
+
+You can reference information about the current organization through the `$Organization` global variable.
+
+Available references are:
+
+* `OrgId`
+* `Name`

expression-src/main/src/interpreter/Environment.cls

@@ -23,6 +23,7 @@ public with sharing class Environment {
         GLOBAL_VARIABLES.put('$action', new ActionVariableResolver());
         GLOBAL_VARIABLES.put('$user', new UserVariableResolver());
         GLOBAL_VARIABLES.put('$usersettings', new UserSettingsVariableResolver());
+        GLOBAL_VARIABLES.put('$organizationsettings', new OrganizationSettingsVariableResolver());
 
         // Placeholder value for whatever the called Action returned. Not used by language,
         // but can be used by the caller to get the return value of the Action.

expression-src/main/src/interpreter/variable-resolvers/OrganizationSettingsVariableResolver.cls

@@ -0,0 +1,21 @@
+public with sharing class OrganizationSettingsVariableResolver implements IGlobalVariableResolver {
+    public Object get(String referenceName, List<Object> args) {
+        switch on referenceName.toLowerCase() {
+            when 'name' {
+                return getOrganizationSettings().name;
+            }
+            when 'orgid' {
+                return getOrganizationSettings().orgId;
+            }
+            when else {
+                throw new OrganizationSettingsVariableResolverException('Unknown reference name: ' + referenceName);
+            }
+        }
+    }
+
+    private static ConnectApi.OrganizationSettings getOrganizationSettings() {
+        return ConnectApi.Organization.getSettings();
+    }
+
+    public class OrganizationSettingsVariableResolverException extends Exception {}
+}

expression-src/main/src/interpreter/variable-resolvers/OrganizationSettingsVariableResolver.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>60.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

expression-src/spec/language/global-variables/OrganizationSettingsVariableTest.cls

@@ -0,0 +1,21 @@
+@IsTest
+private class OrganizationSettingsVariableTest {
+    // ConnectApi methods are not supported in data siloed
+    // tests, so we need to use SeeAllData=true.
+
+    @IsTest(SeeAllData=true)
+    static void canRetrieveOrganizationName() {
+        String expression = '$OrganizationSettings.name';
+        Object result = Evaluator.run(expression);
+        Assert.isTrue(result instanceof String);
+        Assert.isNotNull(result);
+    }
+
+    @IsTest(SeeAllData=true)
+    static void canRetrieveOrganizationId() {
+        String expression = '$OrganizationSettings.orgId';
+        Object result = Evaluator.run(expression);
+        Assert.isTrue(result instanceof String);
+        Assert.isNotNull(result);
+    }
+}

expression-src/spec/language/global-variables/OrganizationSettingsVariableTest.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>60.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

sfdx-project_packaging.json

@@ -3,8 +3,8 @@
     {
       "path": "expression-src",
       "package": "Expression",
-      "versionName": "Version 1.33",
-      "versionNumber": "1.33.0.NEXT",
+      "versionName": "Version 1.34",
+      "versionNumber": "1.34.0.NEXT",
       "default": false,
       "versionDescription": "Expression core language",
       "ancestorVersion": "HIGHEST"
@@ -62,6 +62,7 @@
     "Expression@1.30.0-2": "04tRb0000036iJBIAY",
     "Expression@1.31.0-2": "04tRb0000037GO5IAM",
     "Expression@1.32.0-1": "04tRb0000037HYfIAM",
-    "Expression@1.33.0-1": "04tRb0000037T8PIAU"
+    "Expression@1.33.0-1": "04tRb0000037T8PIAU",
+    "Expression@1.34.0-3": "04tRb000003L5m9IAC"
   }
 }