Revenue Execution

Revenue Execution admin guide

Not yet published. Revenue Execution is not on AppExchange and has no installation package yet. Items marked Publish blocker must be resolved before this guide goes to customers. Installed, every component Revenue Execution adds carries the OpsGS namespace, as written here (OpsGS__Revenue_Risk__c); a setting whose value names one stays unprefixed, as shipped (Revenue_Risk__c). This guide is hosted at revenue.opsgs.com, which Admin / Setup links to; Viewers have the User guide.

Follow the sections in order:

  1. Before you install
  2. Install
  3. Grant access
  4. Get started and Health
  5. Map your fields
  6. Risk tags
  7. Verify
  8. Roll out
  9. Deal Alerts
  10. Troubleshooting
  11. Get help

To point someone at a step, name the section and subsection, for example “Admin guide: Map your fields > Outcome date”. Record your decisions in the configuration worksheet.

Before you install

Revenue Execution adds four read-only dashboards (Revenue Overview, Pipeline Schedule, Sales Outcomes, and Product Overview) and administrator-only Admin / Setup and Deal Alerts pages.

  1. Check your edition. You need Lightning Experience and an edition that runs Apex and custom metadata types, such as Enterprise, Unlimited, or Developer Edition. Publish blocker: the supported-edition list is not yet confirmed.
  2. Check your admin access. You need Download AppExchange Packages (to install), Customize Application, View Setup and Configuration, Assign Permission Sets, and Manage Profiles and Permission Sets (for your field-access permission set, tab visibility, and permission set groups). A System Administrator has all five.
  3. Check your data. The dashboards read Opportunities with their Accounts and owners. Product Overview and product detail also need Products, price books, and Opportunity Products.
  4. Choose quarters. Calendar quarters are the default. To use Salesforce fiscal quarters, check Setup > Company Settings > Fiscal Year. With a standard fiscal year, the start month is all you need. With custom fiscal years, define the year covering today, and the next one before the current quarter ends.
  5. Know the currency rule. If multiple currencies are enabled, every dashboard hides combined amounts and keeps counts exact; Pipeline Schedule still shows each deal’s own amount and currency. Revenue Execution does not convert currencies. Product Overview’s Needs help then compares lost and won deal counts.
  6. Start in a sandbox.
  7. Know what it never does. The dashboards are read-only:
    • They never create, edit, or delete records (including Tasks), send email or notifications, call an outside service, run scheduled or background jobs, or change sharing, profiles, or permission sets.
    • Revenue Execution writes only its own settings, when an administrator you have allowed saves them in Admin / Setup or Deal Alerts; once Deal Alerts is on, it also writes its send log and sends its emails. Setup still works if you would rather save there.
    • Every query runs as the viewing user, with that user’s sharing and object and field access. Salesforce computes every figure; the browser only displays it.
    • Otherwise, Admin / Setup only reads your setup and reports on it.
  8. Know what it adds.
    • The Revenue Execution app, with tabs Revenue Overview, Pipeline Schedule, Sales Outcomes, Product Overview, Opportunities, Admin / Setup, and Deal Alerts.
    • Permission sets Revenue Execution Viewer (OpsGS__Revenue_Execution_Viewer), Revenue Execution Configuration Health (OpsGS__Revenue_Execution_Config_Health) for the Admin / Setup tab, and Revenue Execution Mapping Editor (OpsGS__Revenue_Execution_Mapping_Editor), which grants only the class that saves mappings and is assigned to no one. No permission set group is included.
    • Custom permission Revenue Execution Edit Mappings (OpsGS__Revenue_Execution_Edit_Mappings), granted by none of the included permission sets.
    • Custom metadata type Revenue Execution Setting (OpsGS__Revenue_Execution_Setting__mdt) with one record, Default, and Revenue Risk Tag (OpsGS__Revenue_Risk_Tag__mdt) with four inactive records.
    • Opportunity picklist fields Required Response (OpsGS__Required_Response__c), Escalation State (OpsGS__Escalation_State__c), and Revenue Risk (OpsGS__Revenue_Risk__c). No page layouts and no Product fields are included.
    • Deal Alerts components, off and assigned to no one: the Deal Alerts tab (OpsGS__Deal_Alerts); custom metadata types Deal Alert Rule (OpsGS__Deal_Alert_Rule__mdt, three inactive samples) and Deal Alert Setting (OpsGS__Deal_Alert_Setting__mdt, record Default); objects OpsGS__Deal_Alert_State__c, OpsGS__Deal_Alert_Run__c, and OpsGS__Deal_Alert_Notice__c; permission sets OpsGS__Revenue_Execution_Deal_Alerts (the tab, its read class, and read) and OpsGS__Revenue_Execution_Deal_Alerts_Manager (the save class, and create, edit, and delete on those three objects only); and custom permission OpsGS__Revenue_Execution_Manage_Deal_Alerts, granted by none of the included permission sets.

Install

Publish blocker: no installation link exists yet. Until the package is released, Revenue Execution is available only as source metadata that a Salesforce developer deploys. After that deployment, continue at Grant access. A source deployment runs Apex tests that create fictional Opportunities and roll them back, so validation rules or automation that block new Opportunities can stop it.

When the package is released:

  1. Log in to the target org (a sandbox first) as a System Administrator.
  2. Open the Revenue Execution installation link.
  3. Choose Install for Admins Only. You grant everyone else access in the next section.
  4. Review the package details and terms, then click Install.
  5. After the confirmation email arrives, check that Revenue Execution appears in Setup > Apps > Packaging > Installed Packages.

Grant access

Admin / Setup > Get started lists this work in order: check the core fields (Map your fields), assign Viewers, then grant field access.

Revenue Execution Viewer is designed to grant the app, the four dashboard tabs and their Apex classes, Read on Account, Opportunity, Opportunity Product, Price Book, and Product, and Read on the three included Opportunity fields and some Product and Opportunity Product fields. It never grants Edit. Revenue Execution Configuration Health grants only the Admin / Setup tab and its Apex class. Revenue Execution Mapping Editor grants only the Apex class that saves mappings: no tab, no data, no system permission.

  1. Assign the Viewer to dashboard users. Setup > Users > Permission Sets > Revenue Execution Viewer > Manage Assignments > Add Assignment. Select the sellers, managers, and executives who use the dashboards, click Next, then click Assign.
    • Or add Revenue Execution Viewer to a permission set group your org owns (Setup > Users > Permission Set Groups > your group > Permission Sets in Group > Add Permission Sets), assign the group, and wait until its status is Updated.
  2. Assign administrators. Assign both Revenue Execution Viewer and Revenue Execution Configuration Health to administrators who hold View Setup and Configuration. Assign Revenue Execution Configuration Health to no one else: only its holders see Admin / Setup, unless a profile or permission set shows the tab; Health warns when one lacks View Setup and Configuration. Publish blocker: confirm whether Install for Admins Only gives administrator profiles this page’s Apex classes and tab.
    • Optional: let an administrator save settings in Admin / Setup. Also assign Revenue Execution Mapping Editor, and grant that administrator the Revenue Execution Edit Mappings custom permission through a permission set your org owns (Custom Permissions > Edit). Saving there also needs a full Salesforce licence and Modify Metadata Through Metadata API Functions, which itself requires View Setup and Configuration and View Roles and Role Hierarchy. Without any of this, everything still works through Setup.
  3. Leave the included permission sets unchanged. Don’t edit or clone them. Health reports a Fail if Revenue Execution Viewer, Configuration Health, or Mapping Editor gains access or loses its app, tabs, classes, or object reads. Health also checks the two Deal Alerts sets, who holds them, and who else shows their tab. Give any extra access through a permission set your org owns.
  4. Grant field access with your own permission set. Setup > Users > Permission Sets > New. Enter a label, for example Revenue Execution Field Access, leave License as –None–, and click Save. Then:
    1. Object Settings > Opportunities > Edit. Under Field Permissions, select Read Access for Next Step (unless you map Next step to another field), Amount (unless you map Deal value to another field), and every Opportunity field you map in Map your fields or use in a risk tag that Revenue Execution didn’t add. Click Save.
    2. Object Settings > Products > Edit. Select Read Access for each Product field you map. Click Save.
    3. Object Settings > Accounts > Edit. Select Read Access for the Account segment field, if you map one. Click Save.
    4. If Salesforce asks, allow Read on the object. Never grant Edit, View All, or Modify All here.
    5. Assign this permission set to the same users as the Viewer, or add it to the same group.
  5. Verify standard object and field reads. Don’t assume them; check them:
    1. Make sure at least one dashboard user other than you holds the Viewer.
    2. Open Admin / Setup > Health, choose All, and click Recheck.
    3. Under Access and assignment, confirm that “Revenue Execution Viewer is as shipped” and “All … checked Viewers can read every field” (or “The checked Viewer can read every field”) show Pass. “Only you have Revenue Execution Viewer” means no Viewer was checked: administrators read every field.
    4. If a “… fields need Viewer read access” row lists fields, grant Read Access on them in step 4, then Recheck.
    5. If a row still fails, follow Troubleshooting > Access and assignment.

    Publish blocker: it is not yet verified that a package install carries the Viewer’s standard object and field reads.

Get started and Health

  1. Open it. From the App Launcher, search for Admin / Setup. If you also hold Revenue Execution Viewer, it follows Opportunities in the Revenue Execution app. It opens on Get started until setup is ready, then on Configure Fields.
  2. Work through Get started. Four steps count toward “… of 4 done”: Check core fields, Assign Viewers, Give Viewers field access, and Fix remaining issues. Choose optional fields and Deal Alerts are optional. Next marks the step to do now and its Health row or setting. Show how opens the steps (for field access, also the fields to grant) with Copy; Review opens the setting or Health row. Waiting means an earlier step or your access comes first; “Too many permission entries to check here” means check it by hand (Troubleshooting). When all four are done it reads You’re ready; a later problem brings the steps back.
  3. Check your access. Health runs as you. Access checks need View Setup and Configuration; without it, rows end “can’t check with your access”.
  4. Pick a view. Besides Get started, Configure Fields shows each setting, what it is for, where it shows up, and a field list or values (Use Configure Fields). Health lists every check below.
  5. Read the Health line. Under the Health heading, it shows the date checked and how many Viewers were checked: up to 25 recent Viewer holders, never named.
  6. Read the counts. The summary shows how many rows are Fail, Warning, Info, and Pass.
  7. Choose a filter.
    • Needs attention (the default) shows every Fail and Warning, rows Health couldn’t fully check, and Info rows that still need an action: field-access gaps before a Viewer other than you is checked, a Viewer whose actual access differs, permission set groups not yet recalculated, and you as the only Viewer. With none, it reads “Nothing needs attention.”
    • All shows every row, including Pass and Info rows that carry steps and optional features that are off. Use All before you sign off.
  8. Read each status.
    • Fail: a dashboard is blocked, or a permission set doesn’t match what Revenue Execution expects. Fix these first.
    • Warning: a feature is hidden or degraded. Fix it or turn the feature off.
    • Info: a fact or a choice. Some Info rows carry steps.
    • Pass: checked and working.
  9. Read the basis note when a row has one.
    • “Could not verify with your access”: get View Setup and Configuration, then Recheck.
    • “Not fully checked”: the row was skipped or cut short to stay within Salesforce limits. A row ending “not checked this time” needs only a Recheck; one ending “too many entries to check” repeats on every Recheck, so check it by hand (Troubleshooting).
    • “Not applicable until the prerequisite above is fixed”: fix the earlier row, then Recheck.
  10. Read the row. Rows are grouped by area, Access and assignment first, and start collapsed to their status, a short title saying what is wrong, and how many To fix steps they hold (for example “3 steps”); click one, or press Enter or Space, to open it. To fix comes first: the action, the Setup path, then Recheck. Then come the settings and fields it acts on (Configuration; fields by label), the impact, and the dashboards affected. Details names the guide section; Open setting opens that setting’s card in Configure Fields.
  11. Recheck after every change. Health always reads fresh. Dashboards cache their figures, so Viewers refresh their page after a fix.

Map your fields

Every setting is a field on one record, the Default Revenue Execution Setting.

Use Configure Fields

Configure Fields helps you choose fields and settings, and saves them when your user may; otherwise save them in Setup.

  1. Open it. In Admin / Setup, choose Configure Fields. Core settings come first; the rest are grouped by the dashboard they mainly affect. Each card starts collapsed, showing its name, status, and current value; click it, or press Enter or Space, to open it, and several can stay open. An open card shows what the setting is for, its current value, Where it shows up, and what happens when it is blank or off. A card also opens when Open setting, a Preview, or a Save result points to it.
  2. Choose a field. Click the field box or its arrow, or press Down Arrow, to list every field that passes that dashboard’s own checks: label, API name, type, and how many checked Viewers can read it. Type to narrow it; use the arrow keys and Enter to choose, and Escape to close. Not listed? explains why other fields you can read don’t qualify. Fields you can’t read appear only if you have View Setup and Configuration (never for Deal value, Pipeline date, or Owner credit).
  3. Choose a setting. Quarter basis, Close history, Escalation manager, and Pipeline products list the values Setup offers, with the current one selected. Press Tab to reach the list and the arrow keys to pick a value, or click one. Undo returns to the saved value.
  4. Labels. Type the wording you want in the label box next to the field, up to the character limit it shows; leave it alone to keep what is there. An empty box is not accepted: to clear a label, turn its field off, or clear it in Setup. If a label is blank and you type nothing, the steps propose the field’s own label. Labels appear on the dashboards, and Salesforce records label changes in the Setup Audit Trail in plain text.
  5. Preview. Preview checks all your choices together, including an outcome start date that matches the outcome date or a Product family that matches Product line, and warns if a choice would stop a dashboard from loading. Choosing Salesforce fiscal quarters also checks your fiscal periods; if they need attention, see Periods. If a choice is unusable, Preview names the setting; undo it or choose again. For each field you change, it also shows how many of the records you can see have a value now and with your choice, for example “412 of 530 open deals have a value”, and where the rest would show. “Only you have Revenue Execution Viewer” means no real Viewer was checked yet.
  6. Save. If your user can save here, Save lists each setting’s prior and new value; click Save these changes to write them, or Cancel to go back. Save stays off while a change would stop dashboards for Viewers, such as a deal value field they can’t read; grant the access Preview lists, then Preview again. Save stays off until that save is checked, usually within seconds. The result names what happened; see Saving in Configure Fields. Undo this save puts back every previous value it can, and Restore previous value one setting, through the same preview and save; a value this page can’t list is restored in Setup (for an explicit Amount, Close Date, Owner, Next Step, or Product Family, the blank option does the same). Otherwise use Save in Setup, which lists the Setup path and, for each change, the setting’s label and API name, what to enter or choose (a setting’s value as Setup shows it, with its API value), the prior value, and a To undo list. Click Copy steps, or select the text if copying isn’t allowed. Keep this page open while you save.
  7. Check saved value. It confirms each saved value and, once all are saved, reloads the cards. If you left the page, or for other settings, use Health.
  8. Ask Viewers to refresh open dashboards.

Deal-size bands, close timing, sample size, and risk tags show where they appear but never their values; edit them in Setup. Stage has no card: it follows your Salesforce stage setup. To roll stages into your own phases, use Stage group.

What Viewers see after a change

Deal value

Owner credit

Pipeline date

Outcome date

Outcome sample size

Quarter basis

Outcome start date

Timeline start date

Close history

Required action

Next step

Account segment

Stage group

Escalation state

Escalation manager

Pipeline products

Deal-size bands

Close timing

Product family

Product line

Product tier

Loss reason

Risk tags

A risk tag turns an Opportunity field value into a Pipeline Schedule signal. Four tags are included, all inactive and all matching Revenue Risk (OpsGS__Revenue_Risk__c) with Equals: Critical, High, Watch, and Low. Revenue Execution Viewer grants Read on Revenue Risk.

  1. Decide whether your team will keep Revenue Risk, or another field, up to date. A tag on a field nobody maintains shows nothing useful.
  2. Open Setup > Custom Metadata Types > Revenue Risk Tag > Manage Records.
  3. Click Edit next to a tag and review each field:
    • Label: the chip text Viewers see, up to 40 characters.
    • Field API Name: a direct Opportunity picklist, number, percent, checkbox, or date field. Currency, Date/Time, and text fields are rejected.
    • Operator: Equals, Does not equal, Is one of (picklists only), Is blank, Is not blank, or Greater than, Greater than or equal, Less than, and Less than or equal (numbers and dates only).
    • Match Value: a picklist API value, a number, true or false, or a date as YYYY-MM-DD. For Is one of, enter 1 to 50 values separated by semicolons. Is blank and Is not blank ignore it.
    • Explanation: required, up to 255 characters. Viewers see it as the tooltip.
    • Severity: changes appearance only.
    • Icon Name: one of utility:alert, utility:error, utility:flag, utility:info, utility:priority, utility:success, or utility:warning.
    • Display Order: 0 or more. Lower numbers show first.
  4. If the tag uses a field other than Revenue Risk, grant Viewers Read Access on it in your field-access permission set (Grant access, step 4). A Viewer who can’t read a tag’s field doesn’t see that tag.
  5. Select Active and click Save. To add a tag, click New instead.
  6. Keep 25 or fewer tags active. Invalid tags, and tags beyond 25, are excluded one at a time; the page still loads.
  7. Recheck. Under Risk tags, “… active risk tags are valid” should show Pass.
  8. Tags appear on Pipeline Schedule in the Signals group under Filters & focus, in the Customer risk filter, and in the Customer risk section of rows and cards.

To turn a tag off, clear Active and click Save.

Verify

  1. Open Admin / Setup > Get started: it reads You’re ready once its four steps are done. Info rows needing no action (sharing, currency) never hold it back; an org too large to check never gets there (Troubleshooting).
  2. Open Health and click Recheck.
  3. Choose All.
  4. Fix every Fail, then every Warning, using Troubleshooting. Recheck after each fix.
  5. Under All, open each Info or Pass row that shows a step count, then complete its To fix steps or record in the worksheet why you won’t.
  6. Repeat until no Fail or Warning remains and every row with steps is done or recorded.
  7. Check each dashboard as a Viewer. If administrators can log in as users (Setup > Login Access Policies), open Setup > Users > Users and click Login next to one Viewer. Otherwise, ask one Viewer to open each dashboard and report any “Revenue Execution setup needs attention” message. None should show it.
  8. Sign off in the configuration worksheet.

Roll out

  1. Let people maintain the included fields. Revenue Execution never writes Required Response, Escalation State, or Revenue Risk. Add the ones you use to Opportunity page layouts or Lightning record pages (Setup > Object Manager > Opportunity > Page Layouts or Lightning Record Pages). Grant Edit on them through a permission set your org owns, never through Revenue Execution Viewer. Until Required Response is filled in, Pipeline Schedule rows show “Required Response missing”.
  2. Assign the remaining Viewers as in Grant access, then Recheck.
  3. Tell Viewers about the User guide, and that the dashboards are read-only, show only what their Salesforce access allows, and need a page refresh after setup changes; in multi-currency orgs, also tell them the currency rule (step 5).
  4. Change settings safely. Record the prior value in the worksheet before each change, then Recheck.
  5. Roll back by restoring prior values in the Default setting, clearing Active on tags, or removing users in Setup > Users > Permission Sets > Revenue Execution Viewer > Manage Assignments.

Deal Alerts

Deal Alerts emails deal owners, their managers and people you choose when open deals are past due or missing a next step, and monthly when products need help or a salesperson’s win rate is under your threshold. It ships off: no alert is sent and nothing is scheduled until you turn it on.

  1. Give it to administrators only. Assign Revenue Execution Deal Alerts (OpsGS__Revenue_Execution_Deal_Alerts, the tab) and Revenue Execution Deal Alerts Manager (OpsGS__Revenue_Execution_Deal_Alerts_Manager, changes) only to administrators who have View Setup and Configuration and see every opportunity (View All Data, or View All on Opportunities). Grant the custom permission Revenue Execution Manage Deal Alerts through a permission set your org owns; without it the tab is read-only. A permission set that grants View Setup and Configuration must also grant View Roles. Saving also needs Modify Metadata Through Metadata API Functions. With Revenue Execution Viewer too, the tab is last in the Revenue Execution app; otherwise use the App Launcher.
  2. Let Salesforce send and deliver. Setup > Deliverability: Access level All email. Then verify the sender, because Salesforce silently drops mail from an unverified one: your own email address (in your personal settings, Personal Information; Salesforce emails you a verification link), or an organization-wide address (Setup > Organization-Wide Addresses) that you choose in Deal Alerts > Settings. Also authenticate your domain with DKIM keys (Setup > DKIM Keys) or Authorized Email Domains. Deal Alerts’ Get started > Check confirms Salesforce allows sending and an organization-wide sender is verified, and warns if your own address shows unverified; only an arriving test confirms delivery.
  3. Set rules. In Deal Alerts > Rules, turn on the sample Past-due deals or choose New rule. Saving shows the rule’s counts first. Cards also offer Copy, Reset (an edited sample) and Hide or Remove; hidden rules can be restored. Settings holds the send time, weekdays, sender, limits, retention and subjects. Two monthly samples are there too: products that need help (choose who gets it) and salesperson win rate (to each salesperson’s manager, and if you choose, the salesperson and the manager’s manager; turning it on first asks you to confirm your company allows alerts that name people).
  4. Preview. Deal Alerts > Preview shows which of your visible deals would email whom today, or why nobody would.
  5. Send yourself a test. Deal Alerts’ Get started > Send test email sends one deal email and one summary to you only, or just the summary when only monthly rules have something to show. When it arrives, choose Yes, it arrived; until you answer, the question comes back after a reload, and Not yet lists what to check. Once Deal Alerts is on, or after a sender change, send tests from Settings.
  6. Turn on. After a Preview, choose Turn on, then either email the deals that already match on the first run or start quietly. It then runs hourly as you and sends once a day, within three hours of the send time.
  7. Turn off at any time; nothing more is sent. Turn it off before a Deal Alerts deploy, upgrade or uninstall, and on again afterwards.
  8. Take over when the administrator it runs as leaves or loses access: another administrator with the same access previews, confirms a test for the sender (their own when emails come from the person it runs as) and chooses Take over. Runs stop if that person is deactivated.

What is sent, to whom. Only to active internal users, by user record, never to an email address. The owner gets one email per deal, with every reason, and after 10 in a day one list for the rest. Managers, managers’ managers and people named in a rule get one summary a day. Each email shows only the deals and fields that person can open; frozen users get nothing. When a day can’t run, the administrator it runs as gets “Deal Alerts did not send today” with the reason and the fix. The send log keeps who got which kind of email for the retention period, never the content.

Monthly checks. On the first send day of each month, product and win-rate rules check each recipient’s own view: figures count only deals that person can open and match their Product Overview or Sales Outcomes Team view, which the email links to. Someone whose view is over that dashboard’s limits, or who lacks Revenue Execution Viewer or a field it reads, gets nothing and is counted on the rule card. A salesperson who gets their own win rate sees only their own figure, matching their Sales Outcomes My results. Nothing about a result is stored.

Troubleshooting

Each subsection below matches one area heading in the Health view, in page order; the last covers saving in Configure Fields. Entries name rows by the short title Health shows. Choose All if you don’t see a row.

Access and assignment

Settings

Periods

Optional context

Outcome and product mappings

Risk tags

Currency

Stages

Sharing

Products

Deal Alerts

Saving in Configure Fields

Nothing changes unless the result says Saved.

Get help

Email support@opsgs.com (Support). Include:

  1. The Revenue Execution version from Setup > Apps > Packaging > Installed Packages.
  2. Your edition, and whether multiple currencies are enabled.
  3. The area, status, and title of each Fail or Warning row, and the steps you already tried.

Never send passwords, usernames, record IDs, or customer data.