Use the Occurrence component

task brazil Updated Sep 10, 2026 1 min read use-utilities-stringutilities-occurrence.md

Count how many times a character or word appears in a text body by using the Occurrence component in RPA Desktop Design Studio.

Before you begin

Role required: none

About this task

You can configure the properties for the Occurrence component. For more information about these properties, see Properties of the String Utilities components.

Procedure

In the Toolbox pane, navigate to Utilities > String Utilities.
Drag the Occurrence component to the Design surface.
To configure the text fields, see Configure port properties.

Connect the data and control ports of the Occurrence component to the corresponding ports of the other components as described in the following table.

Port type	Purpose of connection	Mandatory?
Data In (Text)	Takes the text that the component searches from a previously executed component.	Yes
Data In (pattern)	Takes the word or character that the component searches for the number of occurrences from a previously executed component.	Yes
Data In (IgnoreCase)	Takes the Boolean value to indicate whether the component ignores the case while searching for occurrences from a previously executed component.	No
Data Out (Return)	Returns the number of occurrences of the character or word as an integer and passes to the next component.	Yes
Control In	Connects to the Control Out port of one or more components.	Yes
Control Out	Connects to the Control In port of another component or the default end component.	No

To test the component, under the DESIGN tab, click Run.

Parent Topic:String utilities

49 lines · 2.6 KB Wrap lines

---
title: Use the Occurrence component
description: Count how many times a character or word appears in a text body by using the Occurrence component in RPA Desktop Design Studio.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/integrate-applications/use-utilities-stringutilities-occurrence.html
release: brazil
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [String utilities, Utilities, Automation components, RPA Desktop Design Studio, Robotic Process Automation \(RPA\) Hub, Workflow Data Fabric]
---

# Use the Occurrence component

Count how many times a character or word appears in a text body by using the Occurrence component in RPA Desktop Design Studio.

## Before you begin

Role required: none

## About this task

You can configure the properties for the Occurrence component. For more information about these properties, see [Properties of the String Utilities components](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/integrate-applications/util-stringutil-prop.md).

## Procedure

1.  In the Toolbox pane, navigate to **Utilities** &gt; **String Utilities**.

2.  Drag the Occurrence component to the Design surface.

3.  To configure the text fields, see [Configure port properties](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/integrate-applications/configure-input-port-properties.md).

4.  Connect the data and control ports of the Occurrence component to the corresponding ports of the other components as described in the following table.

    |Port type|Purpose of connection|Mandatory?|
    |---------|---------------------|----------|
    |Data In \(Text\)|Takes the text that the component searches from a previously executed component.|Yes|
    |Data In \(pattern\)|Takes the word or character that the component searches for the number of occurrences from a previously executed component.|Yes|
    |Data In \(IgnoreCase\)|Takes the Boolean value to indicate whether the component ignores the case while searching for occurrences from a previously executed component.|No|
    |Data Out \(Return\)|Returns the number of occurrences of the character or word as an integer and passes to the next component.|Yes|
    |Control In|Connects to the Control Out port of one or more components.|Yes|
    |Control Out|Connects to the Control In port of another component or the default end component.|No|

5.  To test the component, under the **DESIGN** tab, click **Run**.


**Parent Topic:**[String utilities](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/integrate-applications/string-utilities.md)