Breadcrumbs

SI.EXPANDCUSTOMERRANGE

Overview

The SI.EXPANDCUSTOMERRANGE function returns an array containing one or more Sage Intacct Customer IDs (based on the specified range).

Syntax

=SI.EXPANDCUSTOMERRANGE(
    ConnectionName, 
    Range, 
    Status
)

Arguments

The SI. EXPANDCUSTOMERRANGE function uses the following arguments:


Argument

Required/ Optional

Description

ConnectionName

Optional

Provide one of the following values:

OR

Omit the argument to return results for all compatible connections with default aggregation settings.

Range

Optional

A range filtering specifying the Customer IDs to be displayed. See Filtering Velixo Functions.

Status

Optional

An indicator of which status(es) of customers to include in the results.

"A" - active

"I" - inactive

"N" - Active non-posting

(a combination may be used - e.g., "AN" or "NI")

(available in version 2023.8 and higher)

Examples

Example 1

=SI.EXPANDCUSTOMERRANGE(
    "Sage",
    "*"
)


Description

Returns the Customer ID for every customer in the specified connection.

Results

https://s3.ca-central-1.amazonaws.com/cdn.velixo.com/helpdesk/byULOx2LuMXgN479IG4ENEgGtdMzafpRug.png


Example 2

=SI.EXPANDCUSTOMERRANGE(
    "Sage",
    "*;-100??"
)


Description

Returns every Customer ID which does not start with 100.

Results

https://s3.ca-central-1.amazonaws.com/cdn.velixo.com/helpdesk/xexQ4T-6kR_X5Mn5D1kxPV6arH_qnM0n_g.png


Example 3

=SI.EXPANDCUSTOMERRANGE(
    "Sage",
    "10100:20000"
)


Description

Returns every Customer ID between 10100 and 20000 (inclusive).

Results

https://s3.ca-central-1.amazonaws.com/cdn.velixo.com/helpdesk/M50zUxN1l0A8s9OaXw-8DHhgf4AVob97_A.png


Example 4

Assuming the following configuration within Sage Intacct:

https://s3.ca-central-1.amazonaws.com/cdn.velixo.com/helpdesk/Jd-4LVKmOq8d31fftikgpFJDeEJM0u6akg.png


=SI.EXPANDCUSTOMERRANGE(
    "Sage",
    "10100:20000",
    "NI"
)


Description

Returns every non-inactive Customer ID between 10060 and 10200 (inclusive).

Results

https://s3.ca-central-1.amazonaws.com/cdn.velixo.com/helpdesk/Geh8fvALn2SKdZeLlD-bP0eYMbXwrKESig.png


Inactive customers 10082 and 10083 are not included