Chrome and Firefox extension to add a metadata layout on top of the standard Salesforce UI to improve the productivity and joy of Salesforce configuration, development, and integration work.
We all know and love Salesforce Inspector: As the great Søren Krabbe did not have the time to maintain it anymore. Thomas Prouvot decided to take over and fork the original project but I do not share the same vision of him.
My goal are :
- to have fun 😉 because open source is fun 🎉!
- to achieve functionnal goals:
- kill dev console needs with SOSL, apex runner, debugger, profiler, static ressource support
- streaming API monitoring
- better suggestions in data export, import and inspect
- switch to a real editor instead of textarea : (color text, suggestion over text,...)
- flow improvment: cleanup old flow versions, debug custom lwc reactive, better naviguation, detect DML before callout in transaction, detect DML, SOQL in loop,...
- monitor external package version are up to date
- to achieve some technical goals:
- Avoid dom and have only react components
- switch to up to date version of dependencies
- have CI/CD build with unit test/integration test in build
- switch to typescript
So I decided to fork on a new project in a more collaborative way.
The goal of this project is to focus on improving key features for administrator: export, import and inspect. Then add new features to make life easier and avoid API call. In order to rich this goal, I have take a closer look to the full backlog of original project and from collegues, friends who work on salesforce but I need feedback from community.
Important
Roadmap is here : #5
Note
User guide for using the extension.
- Export SOQL: suggest in subquery, field valud with IN/LIKE, format query, respect order of column, Download CSV file
- Export SOSL
- Inspect: suggest value for picklist
- Import: assignment rules
- Apex Runner: execute batch, enqueue job or just anonymous code, poll log, auto suggest className,
- Log: profiler, search with autoscroll, download
The Salesforce Inspector browser extension/plugin communicates directly between the user's web browser and the Salesforce servers. No data is sent to other parties and no data is persisted outside of Salesforce servers after the user leaves the Salesforce Inspector pages. The Inspector communicates via the official Salesforce webservice APIs on behalf of the currently logged in user. This means the Inspector will be capable of accessing nothing but the data and features the user has been granted access to in Salesforce.
All Salesforce API calls from the Inspector re-uses the access token/session used by the browser to access Salesforce. To acquire this access token the Salesforce Inspector requires permission to read browser cookie information for Salesforce domains.
To validate the accuracy of this description, inspect the source code, monitor the network traffic in your browser or take my word.
Follow steps described in how-to documentation. Note: you must complete these steps to use the extension in orgs where "API Access Control" is enabled.
- Chrome Web Store
- Firefox Browser Add-ons
- Edge Add-ons : used chrome extension from edge store
- Download or clone the repo.
- Checkout the master branch.
- Open
chrome://extensions/. - Enable
Developer mode. - Click
Load unpacked. - Select the
addonsubdirectory of this repository.
- If Salesforce Inspector is not available after installation, the most likely issue is that your browser is not up to date. See instructions for Google Chrome.
- When you enable the My Domain feature in Salesforce, Salesforce Inspector may not work until you have restarted your browser (or until you have deleted the "sid" cookie for the old Salesforce domain by other means).
Contributions are welcome!
To submit a PR, please create a branch from master branch. This branch will be taged when the new version is published on web store.
Make sure to update CHANGES.md file by describing the improvement / bugfix you realised.
In order to make sure everyone who reads documentation is aware of your improvement, you can update the 'how-to' page to document / expose this new functionality.
Linting : to assure indentation, formatting and best practices coherence, please install ESLint extension.
- Install Node.js with npm
npm install
npm run chrome-dev-build- Open
chrome://extensions/. - Enable
Developer mode. - Click
Load unpacked. - Select the
addonsubdirectory of this repository.
npm run firefox-dev-build- In Firefox, open
about:debugging. - Click
Load Temporary Add-on…. - Select the file
addon/manifest.json.
- Set up an org (e.g. a Developer Edition) and apply the following customizations:
- Everything described in metadata in
test/. Push to org withsf deploy metadata -d test/ -o [your-test-org-alias]or legacysfdx force:source:deploy -p test/ -u [your-test-org-alias]. - Make sure your user language is set to English.
- Ensure Allow users to relate a contact to multiple accounts is enabled (Setup → Account Settings).
- Ensure the org has no namespace prefix (Setup → Package Manager).
- Assign Permission Set
SfInspectorto your user.
- Everything described in metadata in
- Navigate to one of the extension pages and replace the file name with
test-framework.html, for examplechrome-extension://example/test-framework.html?host=example.my.salesforce.com. - Wait until "Salesforce Inspector unit test finished successfully" is shown.
- If the test fails, open your browser's developer tools console to see error messages.
npm run eslint
(we don't live up to all of them. pull requests welcome)
- Stay completely inactive until the user explicitly interacts with it. The tool has the potential to break Salesforce functionality when used, since we rely on monkey patching and internal APIs. We must ensure that you cannot break Salesforce just by having the tool installed or enabled. For example, we won't fix the setup search placeholder bug.
- For manual ad-hoc tasks only. The tool is designed to help administrators and developers interact with Salesforce in the browser. It is after all a browser add-on. Enabling automation is a non-goal.
- User experience is important. Features should be intuitive and discoverable, but efficiency is more important than discoverability. More advanced features should be hidden, and primary features should be central. Performance is key.
- Automatically provide as much contextual information as possible, without overwhelming the user. Information that is presented automatically when needed is a lot more useful than information you need to explicitly request. For example, provide autocomplete for every input.
- Provide easy access to the raw Salesforce API. Enhance the interaction in a way that does not break the core use case, if our enhancements fails. For example, ensure we can display the result of a data export even if we cannot parse the SOQL query.
- It is fine to implement features that are already available in the core Salesforce UI, if we can make it easier, smarter or faster.
- Ensure that it works for as many users as possible. (for system administrators, for standard users, with person accounts, with multi currency, with large data volumes, with professional edition, on a slow network etc.)
- Be conservative about the number and complexity of Salesforce API requests we make, but don't sacrifice the other principles to do so.
- Focus on system administrators, developers and integrators.
By Olivier Dufour forked from Thomas Prouvot who forked from Søren Krabbe and Jesper Kristensen
 Olivier Dufour   |
 Guillaume Dufour |