Monday, March 22, 2021

FuseIT SFDC Explorer 3.16.21081.2 - Spring '21

Another roundup of some of the changes to the FuseIT SFDC Explorer since the 3.15.20209.3 release.

Apex class and trigger version highlighting

Ideally all apex classes and triggers within an org would be kept within the last 3 years releases (the last 9 API versions). The API version column will be coloured to indicate how far behind a particular class or trigger is.

Export metadata packages from package builder

Added buttons to "Deploy Selected Files" package builder to export the selected metadata as a package. Either a complete zip or just the package.xml

Other changes 3.16

  • SFDCExplorer: Surface exceptions when listing Salesforce reports via a dialog.
  • The sObject metadata DataCache no longer internally stores unique mappings for field describes, relationships, or childrelationships. These are still accessible via existing methods.
  • Complete update to Spring `21 (v51.0). Update the Bulk API XSD.
  • SFDCExplorer: Detect if there are metadata API version changes when building up a package to deploy
  • SFDCExplorer: double click to login as an SFDX CLI org.
  • SFDCExplorer: Context menu option to format a SOQL query in a debug log row.
  • SFDCExplorer: Improve Executed Units support for workflow and flow events.
  • Improve support for deploying Profile metadata
  • Salesforce MetadataServiceWrapper - Expose CreatePackageXmlAsString to create the package.xml for a collection of metadata paths and return it as a string.
  • SFDCExplorer: Expose the debug log request identifier in the logs view.
  • SFDCExplorer: Highlight Flow errors in the Apex log timeline
  • SFDCExplorer: Authenticate from serverId and URL in query string
  • Split out OAuth (RefreshToken) and JWT LoginDetails to dedicated objects. Added new SfdxLoginDetails for connection strings against the SFDX CLI.
  • Improve formatting of SalesforceResultException FailedSaveResults.
  • Support for metadata deployment of static resources
  • SalesforceIdKeyPrefix - Raise warnings if there is a keyprefix conflict for the current Salesforce user.
  • WSDL2Apex: Expand ability to search for missing XML Namespaces
  • Support for deploying Profile Metadata
  • SFDC Explorer: Improve error handling when there is a timeout retrieving the sObject metadata to populate the entity tree. Retry with a reduced batch size from the detault 100 sObjects.
  • Weekly Data Export tooling - handle premature response stream termination. Improve logging status messages related to downloading data exports.
  • SFDCExplorer: Deploy Profile Metadata
  • SFDCExplorer: handle exceptions with checking test status via polling

Thursday, February 11, 2021

Salesforce Glossary - An unofficial list of Salesforce terms and acronyms

This list is by no means exhaustive. It's more a random collection to terms and acryoums that get thrown around with Salesforce work that might not always be readily apparent. There is an official Glossary provided by Salesforce.

Where terms may have alternative meanings I've focused on the Salesforce usage.

I've been slowly compiling this over time with the intention of publishing it when it reaches some addiquate level of completness. However, it has become apparent that this will be more of a living blog post that I'll update over time. Please let me know if there are gaps or mistakes that need to be corrected.

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

A

AE
"Account Executive" - Sales point of contact at Salesforce that handles the client relationship. Sells product licenses.
ACV
Annualized Contractual Value
Apex
Apex is a strongly typed, object-oriented programming language that allows developers to execute flow and transaction control statements on Salesforce servers in conjunction with calls to the API. Using syntax that looks like Java and acts like database stored procedures, Apex enables developers to add business logic to most system events, including button clicks, related record updates, and Visualforce pages. Apex code can be initiated by Web service requests and from triggers on objects.
Source
Aura
Aura Components were the predecessor to Lightning Web Components before more of the implementation stack was supported by web standard. See Introducing Lightning Web Components
AmpScript
The proprietary scripting language for Marketing Cloud
Aloha Apps
Older terminology for App Exchange apps that didn't count towards your orgs limits. Source
APAC
Asia Pacific & Australia regions
AMER
US, Canada & Latin America regions

B

Bulkified / Bulkification
Code and processes that are designed to work on multiple records at once rather than one at a time (I.e. in bulk). This is particularly relavant to SOQL queries and DML operations where doing operations on records individually may lead to limits being hit.
Black Tab
An internal tab available to Salesforce employees and support that can toggle specific features and sdjust limits in customer orgs. See What is the Black Tab?

C

CMDT
Custom Metadata Type
CPQ
(Configure, Price, Quote) - formerly Steelbrick. This has now been rebranded Revenue Cloud.
CFP
Call for Presenters
COA
Partner Channel Order App - "enables you to create, submit, and track orders with Salesforce"
CLI
[SFDX] Command Line Interface
Comfortable Shoes
The battle cry of attending an inperson Dreamforce event where you will be doing a lot of walking.
Code Coverage
"Code coverage indicates how many executable lines of code in your classes and triggers have been exercised by test methods." - source
CIM
Cloud Information Model
Community Clould
Rebranded Experience Cloud

D

Daryl Shaber
"We Are Daryl Shaber" - Reference
Deployment Fish
The result of a bug in the changeset deployment monitoring UI that would stretch the circular control into veriaous shapes. Often fish like in nature.
DML
Data Manipulation Language. The Create, Update, and Delete parts of the database CRUD operations. Retrieve is handled via SOQL queries.
Dwarf
The occasional Oracle error code that leaks out of Salesforce will include references to one of the seven dwarfs. See Salesforce, Oracle and the Seven Dwarfs.
D&B
"Dun & Bradstreet" - D&B Company Fields
Dreamforce
Annual Salesforce user conference.
DRAES
Designing Record Access for Enterprise Scale. Reference

E

ESAPI
Enterprise Security API
Evergreen
Internal project code name for Salesforce Functions
Environment Hub
"allows partners to view, connect, create, and log in to multiple Salesforce organizations from one location" - Reference
EMEA
Europe, Middle East & Africa regions

F

[Salesforce] Functions
Previously known as Evergreen. The ability to write code that integrates with Salesforce data and events in a serverless environment.
Falcon
Salesforce CLI plugin built for AppExchange Partners Reference
Field Service Lightning
Rebranded Field Service

G

GACK
An internal Salesforce error. What Is A Gack?
GA
Generally Available - The point where a new Salesforce feature has passed the preview and beta phases and is ready for use.
GUS
Grand Unified System - Internal Salesforce tool that handles tickets, user stories, bugs, builds and releases. Meet GUS: The Grand Unified System That Keeps Salesforce Agile
GS0
Pre-release org instance for testing before a release reaches sandboxes.

H

Happy Soup
A phrase coined by Wade Wegner at TrailheadDX 2017 to describe how metadata was deployed to a production org without any strongly defined boundaries between applications/components.
Hyperforce
The capability to deploy Salesforce on major public cloud platforms like Azure, AWS, Google, and Alibaba. This helps address data residency and complicance requirements. Reference
Introducing Hyperforce - General Information & FAQ/dd>

I

IaaS
Infrastructure as a Service
ID
A Salesforce record identifier. Either 15 or 18 characters long - What are Salesforce ID's composed of?
ISV
Independent software vendor

J

Jorje
Internal codename for the Apex Language Server

K

Keyprefix
The first 3 characters of a Salesforce ID. These can be used to determine the sObject type.

L

LMA
License Management App - Used by ISV Partners to manage applications
LWC
Lightning Web Component
LWR
Lightning Web Runtime
Limits
"Because Apex runs in a multitenant environment, the Apex runtime engine strictly enforces limits so that runaway Apex code or processes don’t monopolize shared resources."
Source

M

Metadata
"Metadata are the assets in your org (assets being objects, tabs, classes, etc). These metadata assets are also called metadata components."
Source
Marketing Cloud
"Salesforce Marketing Cloud is a provider of digital marketing automation and analytics software and services."
Source
MSA
Master Subscription Agreement - Reference

N

O

OWD
Organization-Wide Defaults
OCLIF
Open CLI Framework
OLI
OpportunityLineItem / Opportunity Product
Org62
The Salesforce Org that they use internally to run Salesforce.

P

PaaS
Platform as a Service
Pod
A collection of Salesforce servers that is required to run the complete application. A.K.A Instance
PAM
Partner Account Manager
Polymorphic Lookup
A releationship field that can point to more than one entity.
PBO
Partner Business Org - a production Salesforce enviroment for Salesforce Partners - Docs
PDO
Product Development Outsourcers

Q

Quiddity
PHILOSOPHY "the inherent nature or essence of someone or something."
Exposed in Apex to represent the type of a transaction. Docs

R

S

SaaS
Software as a Service
Safe Harbor
The precursor to the forward-looking statement
S2S
Salesforce to Salesforce
SFDC
Salesforce Dot Com
SFDX
Salesforce DX (Developer Experience)
SOQL
Salesforce Object Query Language. A varient of SQL specifically for Salesforce that is used to query Salesforce data. Reference
SLDS
Salesforce Lightning Design System https://lightningdesignsystem.com/
Brand and product design guidelines, Design Patterns and Component Blueprints for creating unified UI in the Salesforce ecosystem.
SFDO
Salesforce.org
sControl
Deprecated customization control for Salesforce that was superseded by Visualforce pages. Docs
SObject
An abstract base class for Salesforce record types that are stored in the database. Docs
Stealbrick / CPQ
Stealbrick Quote Quickly (SBQQ)
Source of truth
The data source that contains the authoriative data about a whole object.
SI
Systems Integrators
Security Token
A case-sensitive alhanumberic key that is appended to the users password when authenticating against the Salesforce API. Docs
Site Switching
Each Salesforce instance is built and maintained in two geographically separate locations. An instance is actively served from one location (the active site) with transactions replicating in near real-time to the other completely redundant location (the ready site). A site switch means the locations of an instance’s active and ready sites are swapped, making the ready site the new active site and vice versa -- the instance name does not change.
Reference

T

Tableau CRM
Formerly Einstein Analytics
TDTM
Table-Driven Trigger Management - "a tool to managed apex triggers". Source

U

Upsert
A database operation that will adjust between an insert and update depending on the record in question. Reference
Universal Containers
A fictional shipping container company referenced by Salesforce, especially in various certification exam questions and Trailhead modules.

V

Visualforce
Visualforce is a framework that allows developers to build sophisticated, custom user interfaces that can be hosted natively on the Lightning platform. The Visualforce framework includes a tag-based markup language, similar to HTML, and a set of server-side “standard controllers” that make basic database operations, such as queries and saves, very simple to perform.
Source
Vlocity
Rebranded Salesforce Industries

W

WSDL2Apex
A Salesforce tool for generating stub Apex classes from a SOAP WSDL. Reference

X

Y

Z

#

1GP
First-Generation Managed Packaging - a Zip file of metadata components that can be deployed to an org via the Metadata API. They typically form an application or piece of functionality. For distribution via the app exchange they are created via a packaging org. Docs
2GP
Second-Generation Managed Packaging - Salesforce CLI (rather than Org) based packaging. Docs and Comparison of 2GP and 1GP Managed Packages

Tuesday, December 8, 2020

Dreamforce/DreamTX 2020 Session Picks

Here are some of my current picks for Dreamforce/DreamTX 2020 sessions. Many of these sessions have repeats to better accomidate other timezones if required.

Monday, December 14th PST | Tuesday, December 15th NZDT

Salesforce Platform: Innovation Roadmap

Join us to learn about the latest Salesforce Platform innovations and product roadmap. Whether you're building with low-code tools, developing scalable apps on Heroku, or working to deliver a better employee experience, this episode will highlight new and upcoming Salesforce Platform products and features that make your job easier.

Thusrday, December 17th PST | Friday, December 18th NZDT

DreamTX Welcome Day 4: Skill Up with Trailhead

Join us to learn about the latest innovation on the Salesforce Platform to go digital fast, scale with confidence, and empower everyone.

Ask the Experts Live Q&A: Developer Experience

Join us to ask about how Salesforce is helping to make you a more productive salesforce developer, with experts from Apex, Salesforce Developer Tools and APIs with your host Heather Storm.

Build Connected Experiences on Salesforce

Join us and learn how to build modern customer and employee experiences on the Salesforce Platform. We’ll explore the latest innovations in Lightning Web Components, event-driven architectures, and Salesforce Functions.

Building Amazing Integrations with Apex

Apex is the workhorse of Salesforce development. Increasingly, however, more and more of our business logic takes the form of asynchronous work. Join us to learn what's new and upcoming in Asynchronous Apex including Salesforce Functions.

What’s New With Lightning Web Components

UI is the foundation of every app, and the Lightning Web Component Framework provides the building blocks needed to create new experiences that work inside and outside of Salesforce. Learn how to create custom interactions using the new NPM Base Components package, customize those interactions with SLDS styling hooks, then extend those interactions with enhanced LockerService support for 3rd party libraries. Finally, we’ll share a sneak peak of an upcoming pilot feature that will make it even easier to add data to your UI.

Ask the Experts Live Q&A: Roadmap Insights For Partners

Where are we going from here? Learn from our AppExchange and Platform experts as they share what Salesforce technologies should be top of mind for partners and how these technologies will help you grow your business. This session is live and our panel looks forward to engaging into a passionate Q&A.

See the Future of APIs at Salesforce

APIs are the glue that holds together most complex business processes. But despite their importance, the developer experience behind API use is often ignored. Join us for a sneak peek at brand new capabilities for using APIs from across the Salesforce Platform. We'll dive into our latest API innovations, such as the new Composite Graph API, and showcase never before seen features that will change how you learn, discover, and employ APIs in your development process.

Everything New in Salesforce Developer Tools

Your productivity starts and ends with the tools you use. Learn how Salesforce Developer Tooling can help you collaborate more effectively with your whole team. We'll show you the latest updates in Dev Tools including the new SOQL Query Builder.

Note that most of these sessions have repeats in other timezones. You can use the Themes to filter search results by region.

Monday, October 12, 2020

Mapping between Salesforce Permission Name and the Label

I recently ran into a minor challenge when deploying a Profile's metadata to an org when it came back with the error message:

"You may not modify the permission Run Macros on Multiple Records while editing a Standard Profile"

The profiles metadata doesn't contain the string "Run Macros on Multiple Records", so how do I know which userPermissions element I need to modify? I was able to narrow it down from the source diff on the file to BulkMacrosAllowed.

So my primary problem was solved, but it did leave me wondering why I couldn't find a more complete mapping of permission API names and the corresponding UI labels.

A small amount of research revealed the required information was in the PermissionSet field metadata. So then I just needed to iterate that metadata and put it into a more useful format (I.e. something I can Google).

The following was hastily extracted from a Summer '20 Dev org and merged with a Scratch Org from the same vintage using the v49.0 API. Your results may vary.

Updated for Winter '21 (v50.0). Just to be confusing it appears Salesforce has changed a couple of the UI Labels. So I've started keeping a versioned history of the changes to this page.

API NameUI Label
AccessCMCAccess Community Management
AccessContentBuilderAccess drag-and-drop content builder
AccountSwitcherUserAccount Switcher User
ActivateContractActivate Contracts
ActivateOrderActivate Orders
ActivitiesAccessAccess Activities
AddAnalyticsRemoteConnectionsAdd Analytics Remote Connections
AddDirectMessageMembersAdd People to Direct Messages
AddWaveNotificationRecipientsNotification Emails: Add Recipients
AllowEmailICEmail-Based Identity Verification Option
AllowLightningLoginLightning Login User
AllowUniversalSearchKnowledge One
AllowViewEditConvertedLeadsView and Edit Converted Leads
AllowViewKnowledgeAllow View Knowledge
ApexRestServicesApex REST Services
ApiEnabledAPI Enabled
AssignPermissionSetsAssign Permission Sets
AssignTopicsAssign Topics
AuthorApexAuthor Apex
B2BMarketingAnalyticsUserCreate B2B Marketing Analytics Apps
BotManageBotsManage Bots
BotManageBotsTrainingDataManage Bots Training Data
BulkApiHardDeleteBulk API Hard Delete
BulkMacrosAllowedRun Macros on Multiple Records
CampaignInfluence2Campaign Influence
CanApproveFeedPostCan Approve Feed Post and Comment
CanEditDataPrepRecipeEdit Dataset Recipes
CanEditPromptsManage Prompts
CanInsertFeedSystemFieldsInsert System Field Values for Chatter Feeds
CanManageMapsManage Analytics Custom Maps
CanUseNewDashboardBuilderDrag-and-Drop Dashboard Builder
CanVerifyCommentVerify Answers to Chatter Questions
ChangeDashboardColorsChange Dashboard Colors
ChatterComposeUiCodesnippetAllow Inclusion of Code Snippets from UI
ChatterEditOwnPostEdit My Own Posts
ChatterEditOwnRecordPostEdit Posts on Records I Own
ChatterFileLinkCreate Public Links
ChatterInternalUserChatter Internal User
ChatterInviteExternalUsersInvite Customers To Chatter
ChatterOwnGroupsCreate and Own New Chatter Groups
CloseConversationsClose Conversation Threads
ConfigCustomRecsConfigure Custom Recommendations
ConnectOrgToEnvironmentHubConnect Organization to Environment Hub
ConsentApiUpdateUpdate Consent Preferences Using REST API
ContentAdministratorManage Salesforce CRM Content
ContentHubOnPremiseUserFiles Connect On-premises
ContentHubUserFiles Connect Cloud
ContentWorkspacesAccess Libraries
ConvertLeadsConvert Leads
CreateCustomizeDashboardsCreate and Customize Dashboards
CreateCustomizeFiltersCreate and Customize List Views
CreateCustomizeReportsCreate and Customize Reports
CreateDashboardFoldersCreate Dashboard Folders
CreateLtngTempFolderCreate Folders for Lightning Email Templates
CreateLtngTempInPubManage Public Lightning Email Templates
CreatePackagingCreate AppExchange Packages
CreateReportFoldersCreate Report Folders
CreateReportInLightningReport Builder (Lightning Experience)
CreateTopicsCreate Topics
CreateWorkBadgeDefinitionCreate custom Badge Definitions
CreateWorkspacesCreate Libraries
CustomizeApplicationCustomize Application
CustomMobileAppsAccessAccess Custom Mobile Apps
CustomSidebarOnAllPagesShow Custom Sidebar On All Pages
CustomTabBarOnMobileNew Salesforce Mobile App - Customizable Navigation (Winter '20 Pilot Only)
DataExportWeekly Data Export
DelegatedTwoFactorManage Multi-Factor Authentication in User Interface
DeleteActivatedContractDelete Activated Contracts
DeleteTopicsDelete Topics
DistributeFromPersWkspCreate Content Deliveries
EditActivatedOrdersEdit Activated Orders
EditBrandTemplatesManage Letterheads
EditCaseCommentsEdit Case Comments
EditEventEdit Events
EditHtmlTemplatesEdit HTML Templates
EditKnowledgeManage Articles
EditMyDashboardsEdit My Dashboards
EditMyReportsEdit My Reports
EditOppLineItemUnitPriceEdit Opportunity Product Sales Price
EditPublicDocumentsManage Public Documents
EditPublicFiltersManage Public List Views
EditPublicReportsManage Public Reports
EditPublicTemplatesManage Public Classic Email Templates
EditReadonlyFieldsEdit Read Only Fields
EditReportsCreate and Customize Reports
EditTaskEdit Tasks
EditTopicsEdit Topics
EmailAdministrationEmail Administration
EmailMassMass Email
EmailSingleSend Email
EmailTemplateManagementManage Email Templates
EnableCommunityAppLauncherShow App Launcher in Communities
EnableNotificationsSend Outbound Messages
ExportReportExport Reports
FeedPinningPin Posts in Feeds
FieldServiceAccessField Service Standard
FieldServiceDispatcherField Service Dispatcher
FieldServiceLastMileField Service Last Mile
FieldServiceMobileAppField Service Mobile
FieldServiceSchedulingField Service Scheduling
FlowUFLRequiredRequire Flow User Feature License
ForceTwoFactorMulti-Factor Authentication for User Interface Logins
FSCComprehensiveUserAccessUser license to access Lightning components and features delivered in Financial Services Cloud.
GiveRecognitionBadgeGive Recognition Badges in Lightning Communities
GovernNetworksManage Communities
HasUnlimitedNBAExecutionsUser Has Unlimited Next Best Action Strategy Executions
HeadlessCMSAccessEnable Salesforce CMS Integration
HideReadByListHide the Seen By List
IdentityConnectUse Identity Connect
IdentityEnabledUse Identity Features
ImportCustomObjectsImport Custom Objects
ImportLeadsImport Leads
ImportPersonalImport Personal Contacts
InsightsAppAdminManage Analytics
InsightsAppDashboardEditorCreate and Edit Analytics Dashboards
InsightsAppEltEditorEdit Analytics Dataflows
InsightsAppUploadUserUpload External Data to Analytics
InsightsAppUserUse Analytics
InsightsCreateApplicationCreate Analytics Apps
InstallPackagingDownload AppExchange Packages
IotUserIoT User
IsotopeAccessSalesforce Anywhere on Mobile
IsotopeCToCUserSalesforce Anywhere Integration Access
IsotopeLEXSalesforce Anywhere in Lightning Experience
LightningConsoleAllowedForUserLightning Console User
LightningExperienceUserLightning Experience User
ListEmailSendAllow sending of List Emails
LMEndMessagingSessionUserPermEnd Messaging Session
LMOutboundMessagingUserPermAgent Initiated Outbound Messaging
LtngPromoReserved01UserPermRemain in Salesforce Classic
ManageAnalyticSnapshotsManage Reporting Snapshots
ManageAuthProvidersManage Auth. Providers
ManageBusinessHourHolidaysManage Business Hours Holidays
ManageC360AConnectionsConnect Org to Customer 360 Audiences
ManageCallCentersManage Call Centers
ManageCasesManage Cases
ManageCategoriesManage Categories
ManageCertificatesManage Certificates
ManageChatterMessagesManage Chatter Messages and Direct Messages
ManageClearbitIntegrationManage your Clearbit Integration
ManageCMSCreate CMS Workspaces and Channels
ManageContentManage Content Permissions
ManageContentPropertiesManage Content Properties
ManageContentTypesManage record types and layouts for Files
ManageCssUsersManage Customer Users
ManageCustomManage Custom Permissions
ManageCustomReportTypesManage Custom Report Types
ManageDashbdsInPubFoldersManage Dashboards in Public Folders
ManageDashboardsManage Dashboards
ManageDataCategoriesManage Data Categories
ManageDataIntegrationsManage Data Integrations
ManageDynamicDashboardsManage Dynamic Dashboards
ManageEmailClientConfigManage Email Client Configurations
ManageEncryptionKeysManage Encryption Keys
ManageExchangeConfigManage Lightning Sync
ManageExternalConnectionsAllow user to modify Private Connections
ManageHealthCheckManage Health Check
ManageHubConnectionsConnect Org to Customer 360 Data Manager
ManageInteractionManage Flow
ManageInternalUsersManage Internal Users
ManageIpAddressesManage IP Addresses
ManageKnowledgeManage Salesforce Knowledge
ManageKnowledgeImportExportManage Knowledge Article Import/Export
ManageLeadsManage Leads
ManageLoginAccessPoliciesManage Login Access Policies
ManageMobileManage Mobile Configurations
ManageNetworksCreate and Set Up Communities
ManagePasswordPoliciesManage Password Policies
ManageProfilesetsManage Profiles and Permission Sets
ManagePropositionsManage Next Best Action Recommendations
ManagePvtRptsAndDashbdsManage All Private Reports and Dashboards
ManageRecommendationStrategiesManage Next Best Action Strategies
ManageReleaseUpdatesManage Release Updates
ManageRemoteAccessManage Connected Apps
ManageReportsInPubFoldersManage Reports in Public Folders
ManageRolesManage Roles
ManageSearchPromotionRulesManage Promoted Search Terms
ManageSecurityCommandCenterManage Security Center
ManageSelfServiceManage Self-Service Portal
ManageSessionPermissionSetsManage Session Permission Set Activations
ManageSharingManage Sharing
ManageSolutionsManage Published Solutions
ManageSubscriptionsManage Analytics Subscriptions
ManageSurveysManage Surveys
ManageSynonymsManage Synonyms
ManageTemplatedAppManage Analytics Templated Apps
ManageTwoFactorManage Multi-Factor Authentication in API
ManageUnlistedGroupsManage Unlisted Groups
ManageUsersManage Users
ManageZapierIntegrationManage your Zapier Integration
MassInlineEditMass Edits from Lists
MergeTopicsMerge Topics
ModerateChatterModerate Chatter
ModerateNetworkUsersModerate Community Users
ModifyAllDataModify All Data
ModifyDataClassificationModify Data Classification
ModifyMetadataModify Metadata Through Metadata API Functions
ModifySecureAgentsModify Secure Agents
NativeWebviewScrollingSalesforce Mobile App: Native scrolling on webviews
NewReportBuilderReport Builder
OptOutGeoLocationTrackingExclude Technician from Geolocation Tracking
Packaging2Create and Update Second-Generation Packages
Packaging2DeleteDelete Second-Generation Packages
PasswordNeverExpiresPassword Never Expires
PreventClassicExperienceHide Option to Switch to Salesforce Classic
PrivacyDataAccessAllow user to access privacy data
PublishPackagingUpload AppExchange Packages
QueryAllFilesQuery All Files
QuipMetricsAccessQuip Metrics
QuipUserEngagementMetricsQuip User Engagement Metrics
RecordVisibilityAPIEnable RecordVisibility API
RemoveDirectMessageMembersRemove People from Direct Messages
ResetPasswordsReset User Passwords and Unlock Users
RunFlowRun Flows
RunReportsRun Reports
SalesConsoleSales Console
SandboxTestingInCommunityAppEnables testing a sandbox community in the Mobile Publisher for Community Cloud app.
ScheduleReportsSchedule Reports
SelectFilesFromSalesforceSelect Files from Salesforce
SendAnnouncementEmailsSend announcement emails
SendCustomNotificationsSend Custom Notifications
SendExternalEmailAvailableSend Email through External Email Service
SendSitRequestsSend Stay-in-Touch Requests
ShareInternalArticlesShare internal Knowledge articles externally
ShowCompanyNameAsUserBadgeShow Company Name as Community Role
SkipIdentityConfirmationSkip Identity Confirmation at Login
SolutionImportImport Solutions
SubmitMacrosAllowedManage Macros Users Can't Undo
SubscribeDashboardRolesGrpsSubscribe to Dashboards: Send to Groups and Roles
SubscribeDashboardToOtherUsersSubscribe to Dashboards: Add Recipients
SubscribeReportRolesGrpsSubscribe to Reports: Send to Groups and Roles
SubscribeReportsRunAsUserSubscribe to Reports: Set Running User
SubscribeReportToOtherUsersSubscribe to Reports: Add Recipients
SubscribeToLightningDashboardsSubscribe to Dashboards
SubscribeToLightningReportsSubscribe to Reports
TraceXdsQueriesAccess Tracer for External Data Sources
TransactionalEmailSendSend Non-Commercial Email
TransferAnyCaseTransfer Cases
TransferAnyEntityTransfer Record
TransferAnyLeadTransfer Leads
TwoFactorApiMulti-Factor Authentication for API Logins
UseSubscriptionEmailsUse Subscription Emails
UseTeamReassignWizardsUse Team Reassignment Wizards
UseTemplatedAppUse Analytics Templated Apps
UseWebLinkAllow Access to Customized Actions
ViewAllActivitiesView All Activities
ViewAllCustomSettingsView All Custom Settings
ViewAllDataView All Data
ViewAllForeignKeyNamesView All Lookup Record Names
ViewAllProfilesView All Profiles
ViewAllUsersView All Users
ViewAnomalyEventsView Threat Detection Events
ViewContentView Content in Portals
ViewDataAssessmentAccess to view Data Assessment
ViewDataCategoriesView Data Categories in Setup
ViewDataLeakageEventsView Real-Time Event Monitoring Data
ViewEncryptedDataView Encrypted Data
ViewEventLogFilesView Event Log Files
ViewFlowUsageAndFlowEventDataView Flow Usage and Flow Event Data
ViewHealthCheckView Health Check
ViewHelpLinkView Help Link
ViewMyTeamsDashboardsView My Team's Dashboards
ViewOnlyEmbeddedAppUserAccess to View-Only Licensed Templates and Apps
ViewPlatformEventsView Login Forensics Events
ViewPrivateStaticResourcesView Private Static Resources
ViewPublicDashboardsView Dashboards in Public Folders
ViewPublicReportsView Reports in Public Folders
ViewRolesView Roles and Role Hierarchy
ViewSecurityCommandCenterView Security Center pages
ViewSetupView Setup and Configuration
ViewUserPIIView User Records with PII
WaveManagePrivateAssetsUserManage Analytics Private Assets
WaveTabularDownloadDownload Analytics Data
WorkCalibrationUserEnable WDC Calibration
WorkDotComUserPermEnable WDC

Monday, July 27, 2020

FuseIT SFDC Explorer 3.15.20209.3 - Summer '20

Another roundup of some of the changes to the FuseIT SFDC Explorer since the 3.13.20008.1 release.

Display the primary sObject type for a SOQL query in the executed units

When looking at the "Show Executed Units" for a debug log that includes SOQL queries there is a new "SOQL Primary sObject" column. This makes it easier to sort the SOQL queries in the transaction by the sObject they were operating over.

There is also a new context menu option in the executed units area to filter the main log view to just the selected events.

Other changes include tracking Flow executed units and SOQL Total Rows metrics from debug logs.

Add the MetadataComponentDependency API calls via the Bulk API 2.0

Previously the Metadata Dependencies tab was limited by the underlying MetadataComponentDependency API only supporting queries over 2,000 records in a single query. Switching to the bulk API expands this out to 100,000 dependency records.

There is also a new experimental graph format called "Microsoft Automatic Graph". This will use a built in graph layout tool. It is no where near as powerful as Gephi, but it is built in and allows you to gradually build the graph up. E.g. try starting with a single ID against "Where is it used" and then using the context menus to expand the graph incrementally.

Rebuilt login and authentication controls.

The various login and authentication controls that are displayed on app startup have a more consistent UI. For example, they have a consistent Login button.

Other changes 3.15

  • Update SalesforceSession so that all APIs are working against v49.0 - Summer 20
  • Apex logging - add SOQL_EXECUTE_EXPLAIN Log event
  • Update SOQLResult column names when the defaultNamespace is defined. Includes first level relationship fields.
  • SFDCExplorer: Executed Units Context Menu to set Apex Log filter
  • SFDCExplorer: Show a message if there are issues showing an individual entity
  • SFDCExplorer: Support for flow log message types. Guard against debug logs with recursive search depth that is too great.
  • SFDCExplorer: Exception Handling when showing reports.
  • wsdl2apex: Warn if the schemaTypeName is missing.
  • SFDCExplorer: Expand Graph search ability
  • SFDCExplorer: Format VF_ log events in the timeline Handle deeply nested log structures to prevent stack overflows.
  • SFDCExplorer: Format byte size of log. Handling clicking a record ID in the log that doesn't exist in the current org. Option to format Callout requests in the debug log.
  • SFDCExplorer: Ensure the popup window that shows SOQL sub query results has a unique name so that the caching key is unique.
  • Tooling API. Check access to the DebugLevel metadata before attempting to query it.
  • SFDCExplorer: always prompt for directory to save metadata to.
  • Update All API versions to Spring 2020 (v48.0)
  • SFDCExplorer: Update .NET Framework version to 4.7.2 and add support for scaling to high DPI monitors.
  • SFDCExplorer: Update to cs31623 to allow for variation in the instanceUrl provided by the SFDX CLI
  • SFDCExplorer: Auto expand the test class search node when searching. Detect test classes in the queued state
  • SFDCExplorer: Export the results of a Bulk CSV load. This is useful if there where errors with the operation on individual records.
  • SFDCExplorer: Log metrics for callouts
  • Tooling API: Correct updating the log levels on TraceFlags

Wednesday, May 20, 2020

Dreamforce 2019 Presentation - Reducing the Cost of Enforcing CRUD and FLS in the ESAPI

At Dreamforce this last year (2019) Chris Peterson and I gave a theater presentation on combining the new Apex Security.stripInaccessible method with the existing ESAPI library for enforcing Create, Retrieve, Update, Delete (CRUD) and field level security (FLS) in Apex.

Unfortunately the Dreamforce theater sessions weren't recorded in 2019 as they were in previous years 🤦‍♂️. To make up for that, below are the session slides. I'll also expand on the key points in this blog post. These will be my words rather than Chris's, although I'll try and cover most of the same content.

What is the ESAPI?

The ES stands for Enterprise Security. And the API... Well, hopefully you know what an API is.

The Salesforce ESAPI is a port of a Java library created by OWASP (Open Web Application Security Project).

To address why you would want it in your Salesforce org, here is a quote from the OWASP ESAPI project page:

The ESAPI libraries are designed to make it easier for programmers to retrofit security into existing applications. The ESAPI libraries also serve as a solid foundation for new development.

These seem like noble goals. We want to improve the security of existing applications and implement newer applications with the same level of security from the start.

The three core areas that the Salesforce ESAPI addresses are:

  1. Input Validation - is a given string a valid date? Is it a valid credit card number? A valid redirection URL?
    • E.g. ESAPI.validator.SFDC_isValidDate
  2. Output Encoding - is is safe to render the content back to the users browser via HTML?
    • E.g. ESAPI.encoder.SFDC_URLENCODE
  3. Access Control - enforce the built in access control mechanisms: CRUD, FLS, and Sharing.
    • insertAsUser/updateAsUser
    • DML on a limited set of fields
    • Override sharing for a single DML operation

(Re) Introducing the ESAPI

Salesforce originally released their version of the ESAPI library in 2010. In 2016 they added the new ESAPI.encoder.SFDC_BASE64_URLENCODE method. Other than that it was stalled for any maintenance or new development.

In 2019 Chris Peterson and Jake Meredith from Salesforce took ownership of the Github repo. Even better, they are accepting pull requests.

One of the first steps in rejuvenating the repo was to increase the built in code coverage from 54% to 93% on the security specific test methods. And, perhaps more importantly, add a number of meaningful assertions and negative test cases along the way. Overall project test coverage is now up by 39%.

One of the particular challenges with this was scripting out of the box test cases using only the built in Profiles and sObjects. The test cases needed to be portable to any org, so they couldn't rely on a specific custom Profile existing. At the time the "Read Only" profile was the most restrictive system profile available. Going forward I might revisit this with the still to GA Minimum Access profile.

With the better test coverage in place it was then possible to overhaul how the field and object level security was enforced. More on that later...

A Recap of the Security.stripInaccessible() method

The Spring '20 release included the GA version of the new Security.stripInaccessible method.

This new method provides a streamlined way to check both field and object level data permissions for the following access types:

  • AccessType.READABLE - Check the fields of an sObject for read access.
  • AccessType.CREATABLE - Check the fields of an sObject for create access.
  • AccessType.UPDATABLE - Check the fields of an sObject for update access.
  • AccessType.UPSERTABLE - Check the fields of an sObject for insert and update access.

The SObjectAccessDecision Object

After calling stringInaccessible() an SObjectAccessDecision object is returned. This provides a number of helpful methods.

getRecords() provides a new List<SObject> that has all the inaccessible fields removed. These are also detached from the source sObjects.

Two additional methods getModifiedIndexes() and getRemovedFields() provide details about which records and specific fields were modified.

How it works in practice to enforce security requirements

Using the newer stringInaccessible method has a number of advantages. It will cover all possible sObject field types. It will check relationship fields, including nested relationships. Sub-queries and polymorphic lookups are also covered.

The example in the image above shows a new Opportunity for "Appy's App" that was generated in the trusted system mode. As such, it could set the custom Standing__c and Value__c fields. This Opportunity is then passed through stringInaccessible with the AccessType.CREATABLE parameter. This does all the hard work for us of checking the users Profiles, Permission Sets, the Permission Set groups, the muting permission sets, etc... The output Opportunity has the fields that the user doesn't have create access to completely removed. The stripped fields aren't null: they're really undefined. This is important when it comes to subsequent DML as we don't want to inadvertently clear fields out.

Other advantages:

  • It's particularly useful when handling untrusted input (like from JavaScript controllers)
  • It's also great for gracefully degrading UI experiences like SFDC does natively

Example walk through code the changes to the ESAPI

The video shows the core structural changes that were made to the ESAPI methods to use the new methods.

Measuring the Performance changes - Methodology

Beyond enforcing the security requirements the next important consideration is changes to CPU Limit usage and Heap usage. Usually you trade more CPU for less Heap or vice versa. If we can cut both down we are doing well!

The general goal is always to see equal of better performance while enforcing the same security requirements. There may be some tradeoffs in performance made, but the security can't be compromised on. The coverage and assertions from the automated tests ensure we are still enforcing the same security requirements.

The performance differences in terms of Apex limits were measured using Test harness classes and Adrian Larsons LimitsProfiler framework. Performing multiple runs between the current/baseline implementation and the new version using the stripping methods allows the relative changes in limits to be measured.

During the testing it was important to have the debug logging completely off as it would otherwise affect the outcomes.

The testing below was done in ALL_OR_NONE mode. This is more demanding than the alternative BEST_EFFORT mode as it requires per field level checks.

To allow for the limits testing framework to repeatedly insert multiple records Savepoints were used as part of the setup and teardown steps. This prevented hitting the storage limits while still measuring the performance differences in the ESAPI.

Measured results for bulk inserting Contacts

The performance difference can vary greatly based on scenario:

  • There is negligible performance difference when checking object CRUD permissions. Note, the Apex ESAPI is still enforcing against the sObject Schema.SObjectType until 224 (Spring `20) with the fix.
  • There is a significant performance difference if there are a large number of requested fields that aren’t set on all the sObjects.

Measured improvements on 25 iterations inserting 200 Contacts. 33 Standard fields

  • 25% Less CPU usage
  • 18.6% Less Heap usage

Links and Resource

Thursday, February 13, 2020

FuseIT SFDC Explorer 3.13.20008.1 - Winter '20

Another roundup of some of the changes to the FuseIT SFDC Explorer since the 3.12.19175.1 release.

Redesigned Apex Tests selector

The Apex test selection control has been reworked to include a top level node for the last known state of each test method. This allows you to monitor the accumulated test results from a single location. If you redeploy one of the test cases in question it will reset to an unknown status.

Updates to the Debug Log Executed Units

In the last release I put in the first version of the Executed Units control. This release builds on that.

It is now possible to mix and match the different log types. So you can focus on, for example, just the SOQL queries.

The same toolstrip includes a button to export the executed units data.

Smaller generated Wsdl2Apex classes

If you've ever looked closely at the Apex classes that Wsdl2Apex generates you'll notice a recurring string - the namespace of the the root element. Depending on the WSDL it's not uncommon for this same string to be repeated thousands of times in the generated Apex class. This update will now generate a single static final to handle the repeated usages.

New controls for exploring Execution overlays, including heap dumps

The developer console currently provides a viewer for execution overlay output created by a ApexExecutionOverlayAction record. This includes the Heap Dump, which has all sorts of interesting details about the data stored in heap/memory for the transaction at the the point of time the overlay was captured.

Right now it mostly just replicates the existing developer console functionality and allows browsing the stored objects by type.

Other changes 3.13

  • [cs32197] SFDCExplorer: Option to save a debug log directly to disk.
  • [cs32152] SFDCExplorer: Auto add metadata files when adding package components. Update display of Metadata Deploy results.
  • [cs32150] SFDCExplorer: Allow the target save directory to be specified when doing an unpackaged metadata export (if the working directory isn't accessible)
  • [cs32149] SFDCExplorer: Use internal list of known key prefixes with the Entity Explorer
  • [cs32148] SFDCExplorer: Option on running SOQL queries to include deleted rows
  • [cs32003] Update to Winter '20 release. v47.0
  • [cs31838] Wsdl2Apex: Handle an operation binding with no output. Raising a warning for a missing portType rather than an exception.
  • [cs31820] SFDCExplorer: Hide JavaScript errors during OAuth login