• Skip to main content
  • Skip to footer
Revelwood Logo

Revelwood

Your SUPER-powered WP Engine Site

  • Who We Are
    • About Us
      • Our Company
      • Our Team
      • Partners
    • Careers
      • Join Our Team
  • What We Do
    • Solutions
      • Workday Adaptive Planning
      • IBM Planning Analytics
      • BlackLine
    • Services
      • Implementation Services
      • Customer Care
        • Help Desk
        • System Administration as a Service
      • Training
        • Adaptive Planning Training
        • IBM Planning Analytics / TM1 Training
    • Products
      • DataMaestro
      • LightSpeed
      • IBM Planning Analytics Utilities
  • How We Help
    • Workday Adaptive Planning Use Cases
    • IBM Planning Analytics Use Cases
    • BlackLine Use Cases
    • Client Success Stories
  • How We Think
    • Knowledge Center
    • Events
    • News
  • Contact Us

IBM Planning Analytics Tips & Tricks

IBM Planning Analytics Tips & Tricks: The SCAN Function

 

January 25, 2022

By Lee Lazarow

Have you ever needed to parse data by looking for a specific character within your source records? Maybe you want to filter an employee’s last name from a “Lazarow, Lee” or maybe you want to define the year from “12/25/2021”.

All of this can be done with the SCAN function. The SCAN function is used to provide a number that defines the starting location of the first occurrence of a substring. If the substring does not occur in the given string, the function returns 0.

The syntax of the command is:

SCAN (substring, string)

For example:

SCAN (‘b’, ‘abcdef’) returns 2

The scan function can be used to find a specific character or to find a substring that consists of multiple characters.

SCAN (‘def’, ‘abcdef’) returns 4

This can be used in conjunction with the SUBST formula to filter text.

For example:

strTextValue = ‘Lazarow, Lee’;
numCommaLocation = SCAN(‘,’, strTextValue);
strLastName = SUBST (strTextValue, 1, numCommaLocation);

The above code would result in “Lazarow,” since the scan function gives the location of the comma. We can then remove the comma by subtracting 1 from the numCommaLocation value and the result would be “Lazarow”.

And what about a situation where you need to scan twice? Maybe you have a time stamp of “12/25/2021” and you want to pull out the year. We can do this by looking for the first slash, trimming the record, and then looking for the second slash within the remaining text.

strTextValue = ‘12/25/2021’;
numFirstSlashLocation = SCAN (‘/’, strTextValue);
strAfterFirstSlash = SUBST (strTextValue, numFirstSlashLocation + 1, 7);
numSecondSlashLocation = SCAN (‘/’, strAfterFirstSlash);
strAfterSecondSlash = SUBST (strAfterFirstSlash, numSecondSlashLocation + 1, 4);

Put this together and there is nothing you cannot parse!

IBM Planning Analytics, which TM1 is the engine for, is full of new features and functionality. Not sure where to start? Our team here at Revelwood can help. Contact us for more information at info@revelwood.com. And stay tuned for more Planning Analytics Tips & Tricks weekly in our Knowledge Center and in upcoming newsletters!

Read more IBM Planning Analytics Tips & Tricks:

IBM Planning Analytics Tips & Tricks: Fill Function

IBM Planning Analytics Tips & Tricks: The Aggregate Function

IBM Planning Analytics Tips & Tricks: TM1Ellist

Author

  • Lee Lazarow
    Lee Lazarow

    View all posts

    • Categories

      • Awards & Recognition
      • Financial Close & Consolidation
      • FP&A Done Right
      • IBM Planning Analytics Tips & Tricks
      • News & Events
      • Success Stories
      • Tech Bulletins
      • Workday Adaptive Planning Insights
      • Workday Adaptive Planning Tips & Tricks

    Popular Posts

    Authors

    Adam Riskin
    Adam Riskin
    Ailenette Cruz
    Ailenette Cruz
    Alex Goldman
    Alex Goldman
    Ben Alcock
    Ben Alcock
    Brian Combs
    Brian Combs
    Dave Miersch
    Dave Miersch
    Dillon Rossman
    Dillon Rossman
    Gary Leiffer
    Gary Leiffer
    John Pra Sisto
    John Pra Sisto
    Ken Wolf
    Ken Wolf
    Koury Reid
    Koury Reid
    Lee Lazarow
    Lee Lazarow
    Lisa Minneci
    Lisa Minneci
    Marc Assenza
    Marc Assenza
    Mary Luchs
    Mary Luchs
    Michelle Song
    Michelle Song
    Nina Inverso
    Nina Inverso
    Revelwood
    Revelwood
    Robert Nordhagen
    Robert Nordhagen
    Tara Byrnes
    Tara Byrnes
    Wesley DeMarco
    Wesley DeMarco

    Sign up for our newsletter

    Connect

Footer

Revelwood Overview

Revelwood helps finance organizations close, consolidate, plan, monitor and analyze business performance. As experts in solutions for the Office of Finance, we partner with best-in-breed software companies by applying best practices guidance and our pre-configured applications to help businesses achieve their full potential.

EXPERTISE

  • Workday Adaptive Planning
  • IBM Planning Analytics
  • BlackLine

ABOUT

  • Who We Are
  • What We Do
  • How We Help
  • How We Think
  • Privacy

CONNECT

Contact:

25B Vreeland Road, Suite 111 Florham Park, NJ 07932
201.984.3030
info@revelwood.com

Copyright © 2023 · Revelwood Inc. All rights reserved. Revelwood® and the Revelwood logo are registered marks of Revelwood Inc.