Write good formulas in Adaptive

Mastering the Art of Formula Writing in Workday Adaptive Planning

Have you ever encountered a formula in Workday Adaptive Planning that seemed like a cryptic puzzle that made your eyes sting or cry? We've all been there. While formulas are the backbone of powerful models, poorly written ones can hinder understanding, efficiency, and maintainability.

To ensure your formulas are clear, concise, and easy to comprehend, let's explore these four essential principles:

1. Use and abuse the SPACE BAR (talking about keyboard here!)

Just as a well-formatted document is easier to read, a formula with ample white spacing is easier to decipher too! This simple technique will significantly improve the redability.

  • Visual Cues: Use spaces between operators, functions, and variables to visually separate elements. DontwriteyourformulaslikethisbasicallyOK?
  • Here is an example of a formula that calculates the benefits for a fulltime employee whether they are USA based or International: 
🥺 SKIBIDI: 

iff(ROW.EmployeeType="FTE",iff(ROW.Country="USA",ASSUM.BenefitsAmount_USA,ASSUM.BenefitsAmount_International)*ROW.Headcount,0)

A little better:

iff (ROW.EmployeeType = "FTE", iff (ROW.Country = "USA", ASSUM.BenefitsAmount_USA, ASSUM.BenefitsAmount_International) * ROW.Headcount, 0)

2. Leverage Line Breaks

  • Modularize Your Formulas: Break down complex formulas into smaller, more manageable chunks by using line breaks to separate logical sections. This technique helps you and others grasp the formula's intent more quickly.
Much better:

iff (ROW.EmployeeType = "FTE", 
iff (ROW.Country="USA", 
ASSUM.BenefitsAmount_USA, 
ASSUM.BenefitsAmount_International) * ROW.Headcount, 0)

 

3. Employ Indentation

  • Hierarchical Organization: Indent nested expressions to visually represent their hierarchy.
  • This technique highlights the relationship between different parts of the formula and makes debugging much faster! For example we can see more easily what IF statement a closing parenthesis is related to!
Fantastamazing:

iff (ROW.EmployeeType = "FTE", 
        iff (ROW.Country="USA", 
                ASSUM.BenefitsAmount_USA,  
                ASSUM.BenefitsAmount_International 
        ) * ROW.Headcount,  
        0  
)

 

4. Harness the Power of Comments

  • Explain Your Intent: Use comments to clarify the purpose of specific parts of your formula.
  • Future-Proof Your Work: Comments help others (and your future self) understand the rationale behind your choices.
  • Best Practices: Add comments to complex calculations, non-obvious logic, and any assumptions made.
  • In Workday Adaptive, start your comments with the # symbol. Anything after a # symbol until you press Enter is considered a comment and is not interpreted by the formula.

🤩 GOATED! 

# Benefits for Fulltime employees only, else 0 
iff (ROW.EmployeeType = "FTE", 
        iff (ROW.Country="USA", 
                ASSUM.BenefitsAmount_USA,               # USA Benefits Amount
                ASSUM.BenefitsAmount_International   # Other Countries
        ) * ROW.Headcount,  
        0                                                                         # else 0 for non fulltimers
)


Beyond the Basics

For more in-depth guidance on formula writing, consult the Workday Adaptive Planning Help Guide.

Need Expert Assistance?

Please reach out!


By adhering to these principles, you can create formulas that are not only functional but also elegant and fluid. Remember, well-written formulas are a testament to your modeling prowess and a valuable asset to your organization.

Check my video if you don't like reading!



Location: San Francisco, CA, USA

Comments

Post a Comment

Popular posts from this blog

Adaptive REST API Calls for Platform Customers with User Sync Enabled

How to Make Adaptive REST API Calls for Platform Customers with User Sync Enabled If you’re a platform customer (HCM + FINS + Adaptive) or using Workday HCM or Financials alongside Adaptive and want to create custom scripts leveraging Adaptive’s REST API (XML), you’ve likely encountered a key requirement: providing Adaptive user credentials (username and password). For standalone customers or those not using user sync, this typically involves creating an integration user in Adaptive. Easy peasy.  But what if you’re using user sync? How do you supply credentials for API calls in the XML input? In this article, I’ll guide you through the steps to generate the necessary credentials when user sync is enabled. I’ll also share helpful links to official documentation to ensure a smooth integration process. 1. Overview The process allows Workday-synchronized users to make API calls to Adaptive Planning using Workday credentials . The key steps involve: Generating an OAuth token using Work...
Read more

Introduction to Adaptive's API

To integrate data in Workday Adaptive Planning, customers typically use the integration module to connect with ERPs, SFTPs, AWS S3, Snowflake, SalesForce, Excel, and Google Sheets, etc.  You can also use third party platforms such as Tray.ai , Boomi , Matilion etc. which leverage Adaptive's APIs in a user friendly setup.  And lastly, you can write your very own scripts (C#, Python, Powershell...) to make these API calls.  Most  common Adaptive's API use cases Import Data from ERPs Actual summaries Actual transactions Assets, amortization, depreciation Transactional details by Supplier Payroll details and taxes Import Sales data from CRMs or datalakes Pipeline, churn, opportunities and customer list Billings and bookings ARR and MRR Import Headcount data from an HRIS Current headcount Terminated Hired, not started Wages and compensation plans Benefits Other Demographics Import Other data: Exchange Rates Weather Import Meta data: currencies, attributes, dimensions such...
Read more

What is OAuth 2.0 and how to set it up in Adaptive?

Image
Uh Oh... OAuth? Was ist das? Adaptive can connect with other applications's via REST APIs using the OAuth 2.0 authentication.  I will explain what OAUTH is so you will no longer ask: "What is this?" (Was ist das?) and feel like someone is talking a foreign language to you!   What is OAUTH 2 really? How does it work and what do you need to do in Adaptive? Let me give you 2 sets of explanations: a real life illustration to demistify OAuth 2.0 and a more technical summary. And lastly high level steps on the setup in Adaptive. If you have no idea what OAUTH is, continue reading, otherwise jump to the 2nd section.  In this example: imagine you need to connect to Microsoft Sharepoint and you want to bring CSV files  into Adaptive. 1) Illustrational explanation for total newbs: OAuth Access vs Hotel Access! OAuth 2.0 can sound overwhelming at first, but it's essentially a way for applications to securely talk to each other and access data. Let me break it down into sim...
Read more