Merge branch 'master' into dependabot/npm_and_yarn/babel/traverse-7.23.2

.github/workflows/build-deploy-docs.yml

@@ -14,7 +14,7 @@ jobs:
       # Build doc with sfdx-hardis
       - uses: actions/setup-node@v3
         with:
-          node-version: 16
+          node-version: 20
       - run: yarn
       - run: yarn prepack
       - run: npm i @salesforce/cli -g

LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2023, Salesforce.com, Inc.
+Copyright (c) 2024, Salesforce.com, Inc.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

example/cpqSettings.json

@@ -1,113 +1,112 @@
 {
-  "Documents": {
-    "Document Folder": "User Personal Documents",
-    "Attachment Target": "Document Only",
-    "Hide Document Name": false,
-    "Post to Feed?": false,
-    "Full Page Preview": false,
-    "Enable Multi-Language Translations": false,
-    "Exclude Hidden Lines In Group Totals": false
-  },
-  "Groups": {
-    "Solution Groups Enabled": true,
-    "Require Group Name": true,
-    "Object": "SBQQ__SolutionGroup__c",
-    "Name Field": "Group Name",
-    "Description Field": "Description"
-  },
-  "Line Editor": {
-    "Hide Renewed Assets When Editing": false,
-    "Actions Column Placement": "Left",
-    "Visualize Product Hierarchy": true,
-    "Enable Multi Line Delete": true,
-    "Preserve Bundle Structure": true,
-    "Product Configuration Initializer": "",
-    "Keep Bundle Together": true,
-    "Enable Asset Upgrades": false,
-    "Totals Field": "Default",
-    "Group Subtotals Field": "Default",
-    "Line Subtotals Total Field": "Default",
-    "Wrap Buttons": true,
-    "Large Quote Threshold": "0",
-    "Validate Large Quotes": false,
-    "Quote Batch Size": "",
-    "Enable Compact Mode": false,
-    "Enable Expand/Collapse Bundles": false,
-    "Enable Large Quote Experience": true,
-    "Default Bundle Setting": "Expanded",
-    "Enable Column Resizing": false
-  },
-  "Plugins": {
-    "Legacy Page Security Plugin": "",
-    "Electronic Signature Plugin": "",
-    "Billing Plugin": "",
-    "Product Search Plugin": "",
-    "Recommended Products Plugin": "",
-    "Legacy Quote Calculator Plugin": "",
-    "Document Store Plugin": "",
-    "Quote Calculator Plugin": "",
-    "Order Management Plugin": "OrderPlugin",
-    "QLE Custom Action Plugin": ""
-  },
-  "Pricing and Calculation": {
-    "Currency Symbol": "",
-    "Use Inactive Prices": false,
-    "Unit Price Scale": "2",
-    "Calculate Immediately": false,
-    "Enable Quick Calculate": false,
-    "Disable Background Calculation Refresh": false,
-    "Allow Non-Consecutive Custom Segments": false,
-    "Enable Usage Based Pricing": false,
-    "Enable Pricing Guidance": false,
-    "Hide uncalculated quote warning": false,
-    "Quote Line Edits for Usage Based Pricing": false,
-    "Use Legacy Calculator": false
-  },
-  "Subscriptions and Renewals": {
-    "Renewal Model": "Contract Based",
-    "Disable Add Subscriptions": false,
-    "Allow Renewal Quotes Without Assets": false,
-    "Subscription Term Unit": "Month",
-    "Subscription Prorate Precision": "Proration Day of Month (Calendar Monthly + Daily)",
-    "Include Net-new Products in Maintenance": false,
-    "Contract In Foreground": false,
-    "Re-evaluate Bundle Logic on Renewals": false,
-    "PoT Renewals (Contracting from Orders)*": true,
-    "Legacy Amend/Renew Service": false,
-    "Amend Contracts in Background": false,
-    "Disable Product Bundle Sub Type Checks": false,
-    "Bypass Preserve Bundle Structure": false,
-    "Use Current Subscription on Assets": true
-  },
-  "Quote": {
-    "Disable Initial Quote Sync": false,
-    "Disable Quote Address Defaulting": false,
-    "Disable Quote Contact Defaulting": false,
-    "Primary Quote Keeps Opportunity Products": false,
-    "Allow Option Deletion": false,
-    "Default Quote Validity (Days)": "30"
-  },
-  "Order": {
-    "Require Approved Quote": false,
-    "Allow Multiple Orders": true,
-    "Default Order Start Date": "-- None --",
-    "Create Orders Without Opportunities": false
-  },
-  "Additional Settings": {
-    "Triggers Disabled": false,
-    "Product Results Group Field Name": "-- None --",
-    "Quantity Scale": "2",
-    "Product Description Field": "Product Description",
-    "Sort Products In Memory": false,
-    "Theme": "-- None --",
-    "Multiple Bundles View": "Classic",
-    "Use Global Header Permission": false,
-    "External Configurator URL": "",
-    "Service Region": "Europe",
-    "Third Party Configurator": false,
-    "Enable Product Option Drawer": false,
-    "Open Search Filter By Default": false,
-    "Enable Large Configurations": false,
-    "Improve Browser Performance": true
-  }
+    "Documents": {
+      "Document Folder": "User Personal Documents",
+      "Attachment Target": "Document Only",
+      "Hide Document Name": false,
+      "Post to Feed?": false,
+      "Full Page Preview": false,
+      "Enable Multi-Language Translations": false,
+      "Exclude Hidden Lines In Group Totals": false
+    },
+    "Groups": {
+      "Solution Groups Enabled": true,
+      "Require Group Name": true,
+      "Object": "SBQQ__SolutionGroup__c",
+      "Name Field": "Group Name",
+      "Description Field": "Description"
+    },
+    "Line Editor": {
+      "Hide Renewed Assets When Editing": false,
+      "Actions Column Placement": "Left",
+      "Visualize Product Hierarchy": true,
+      "Enable Multi Line Delete": true,
+      "Preserve Bundle Structure": true,
+      "Product Configuration Initializer": "",
+      "Keep Bundle Together": true,
+      "Enable Asset Upgrades": false,
+      "Totals Field": "Default",
+      "Group Subtotals Field": "Default",
+      "Line Subtotals Total Field": "Default",
+      "Wrap Buttons": true,
+      "Large Quote Threshold": "0",
+      "Validate Large Quotes": false,
+      "Quote Batch Size": "",
+      "Enable Compact Mode": false,
+      "Enable Expand/Collapse Bundles": false,
+      "Enable Large Quote Experience": true,
+      "Default Bundle Setting": "Expanded",
+      "Enable Column Resizing": false
+    },
+    "Plugins": {
+      "Legacy Page Security Plugin": "",
+      "Electronic Signature Plugin": "",
+      "Billing Plugin": "",
+      "Product Search Plugin": "",
+      "Recommended Products Plugin": "",
+      "Legacy Quote Calculator Plugin": "",
+      "Document Store Plugin": "",
+      "Quote Calculator Plugin": "",
+      "Order Management Plugin": "OrderPlugin",
+      "QLE Custom Action Plugin": ""
+    },
+    "Pricing and Calculation": {
+      "Currency Symbol": "",
+      "Use Inactive Prices": false,
+      "Unit Price Scale": "2",
+      "Calculate Immediately": false,
+      "Enable Quick Calculate": false,
+      "Disable Background Calculation Refresh": false,
+      "Allow Non-Consecutive Custom Segments": false,
+      "Enable Usage Based Pricing": false,
+      "Enable Pricing Guidance": false,
+      "Hide uncalculated quote warning": false,
+      "Quote Line Edits for Usage Based Pricing": false,
+      "Use Legacy Calculator": false
+    },
+    "Subscriptions and Renewals": {
+      "Renewal Model": "Contract Based",
+      "Disable Add Subscriptions": false,
+      "Allow Renewal Quotes Without Assets": false,
+      "Subscription Term Unit": "Month",
+      "Subscription Prorate Precision": "Calendar Monthly + Daily",
+      "Include Net-new Products in Maintenance": false,
+      "Contract In Foreground": false,
+      "Re-evaluate Bundle Logic on Renewals": false,
+      "PoT Renewals (Contracting from Orders)*": true,
+      "Legacy Amend/Renew Service": false,
+      "Amend Contracts in Background": false,
+      "Disable Product Bundle Sub Type Checks": false,
+      "Bypass Preserve Bundle Structure": false,
+      "Use Current Subscription on Assets": true
+    },
+    "Quote": {
+      "Disable Initial Quote Sync": false,
+      "Disable Quote Address Defaulting": false,
+      "Disable Quote Contact Defaulting": false,
+      "Primary Quote Keeps Opportunity Products": false,
+      "Allow Option Deletion": false,
+      "Default Quote Validity (Days)": "30"
+    },
+    "Order": {
+      "Require Approved Quote": false,
+      "Allow Multiple Orders": true,
+      "Default Order Start Date": "-- None --",
+      "Create Orders Without Opportunities": false
+    },
+    "Additional Settings": {
+      "Triggers Disabled": false,
+      "Product Results Group Field Name": "-- None --",
+      "Quantity Scale": "2",
+      "Product Description Field": "Product Description",
+      "Sort Products In Memory": false,
+      "Theme": "-- None --",
+      "Multiple Bundles View": "Classic",
+      "Use Global Header Permission": false,
+      "External Configurator URL": "",
+      "Service Region": "Europe",
+      "Third Party Configurator": false,
+      "Enable Product Option Drawer": false,
+      "Open Search Filter By Default": false,
+      "Enable Large Configurations": false
+    }
 }

messages/profile.convert.md

@@ -0,0 +1,35 @@
+# summary
+
+convert a Profile to a Permission Set [BETA]
+
+# description
+
+this command converts in the target org a Profile to a Permission Set.
+
+It will not use Profiles stored locally in your project but it will:
+
+- dynamically retrieve the full Profile from your target org
+- convert it to a Permission Set
+- deploy it to the target org
+
+No update to local Profile or Permission Set is done, but you'll be able to manually retrieve the created/updated Permission Set
+
+# examples
+
+sf texei profile convert --profile-name 'My Profile'
+
+# warning
+
+This command is in BETA, test the converted Permission Sets, and report any issue at https://github.com/texei/texei-sfdx-plugin/issues
+
+# flags.profile-name.summary
+
+name of the Profile in the target org to convert to a Permission Set
+
+# flags.override-name.summary
+
+override Permission Set Name generated from Profile name
+
+# flags.override-api-name.summary
+
+override API Name generated from Profile name

messages/skinnyprofile.create.md

@@ -0,0 +1,25 @@
+# summary
+
+create a profile on target org with minimum access
+
+# description
+
+This command:
+
+- looks at all Profiles in your target org
+- looks at all custom Profiles in your project that are not in your target org
+- create all custom Profiles missing in your target org as empty Profiles
+
+The command creates Profiles one by one, so if one Profile creation fails (for instance a local Profile is using a license not available in the org), all previous Profiles will still be created in the org.
+
+# examples
+
+sf texei skinnyprofile create
+
+# flags.path.summary
+
+path to profiles folder. Default: default package directory
+
+# flags.ignoreerrors.summary
+
+if any profile creation fails, command exits as succeeded anyway

messages/skinnyprofile.retrieve.md

@@ -2,6 +2,24 @@
 
 export a skinny profile with just profile-specific metadata
 
+# description
+
+This command will retrieve Profiles, and keep only what can't be on a Permission Set. All other reference to metadata will be removed.
+Only access to what's in your project will be listed in the Profile metadata.
+
+The command:
+
+- list all Profiles in local project
+- look at Page Layouts, Record Types and Custom Applications in your local project
+- will retrieve listed Profiles with access rights for metadata from the previous step
+- will keep access for Page Layouts, default Record Types and Default custom application
+- will remove everything that should be on a Permission Set(Field Level Security, Apex Classes access, Tab visibilities, etc...)
+- save the Profiles locally
+
+# examples
+
+sf texei skinnyprofile retrieve --target-org MyScratchOrg
+
 # flags.timeout.summary
 
 timeout(ms) for profile retrieve (Default: 60000ms)