The SASEXFSD Interface Engine (Experimental)

The ExtractFormulaHistory Factlet

The ExtractFormulaHistory factlet extracts one or more items for one security, for an index, or for a list of securities over time. It uses the FactSet Query Language (FQL). The ExtractFormulaHistory factlet uses the options listed in Table 43.10, such as the IDS= option, which specifies the ID for one or more securities, or the ISON= and ISONPARAMS= options, which specify an FQL formula that extracts the universe along with any ISON parameters required by the ISON code. You can use the START=, END=, and FREQ= options or the DATES= option to specify a date range for selecting time series data. You can select data items by using the ITEMS= option, but only the name/value pairs syntax (not the standard FQL syntax) is supported. The ITEMS= option designates multiple shortcut items or item/statistic combinations. You can use any instance of the formula library to specify the ITEMS= option.

The PERIOD= option is used for FactSet Fundamentals codes to specify the estimate period of the data that you want to select. The CAL= option enables you to set your calendar in the same way that the PSETCAL function in FQL does. You can specify the CAL= option to be LOCAL, FIVEDAY, FIVEDAYEOM, SEVENDAY, or an exchange code. The list of exchange codes is available on page ID 16610 of the FactSet Online Assistant. The ORIENTATION= option is supported only for ETI (entity time item), so that your SAS output data set is sorted by key entities such as CUSIP or ticker symbol, and by the time ID (DATE), with observations appearing in time series order so that each column represents a selected time series (Item). ETI (entity time item) is the default setting for orientation.

Table 43.10: ExtractFormulaHistory Factlet Options

Option

Description

IDS=

One or more securities; for example, IDS=IBM,MSFT,FDS.

ISON=

FQL value that extracts universe; for example, ISON_SP500 is entered as ISON=SP500; ISON_MSCI_WORLD(0,1) is entered as ISON=MSCI_WORLD.

ISONPARAMS=

ISON codes that use parameters; for example, ISON_MSCI_WORLD(0,1) is written as ISONPARAMS=0,1.

DATES=

YYYYMMDD:YYYYMMDD:F; relative dates -1b:-4b:m.

START=

Valid FQL date; START=0 (default).

END=

Valid FQL date; END=0 (default).

FREQ=

Valid FQL frequencies; for example, M, D, Y. See Table 43.18.

ITEMS=*

One or more FQL items (only the name/value pair syntax is supported; for example, ff_sales, p_price).

PERIOD=

Valid time intervals between the data points (observations) in a time series; for example, ANN, QTR, or SEMI-ANN; PERIOD=ANN (default).

ORIENTATION=

Optional orientation (default is ETI).

CAL=

Calendar setting replicating PSETCAL function; for example, LOCAL, FIVEDAY, FIVEDAYEOM, or SEVENDAY, for exchange code CAL=AAM (for a list of exchange codes, see page ID 16610 in the FactSet Online Assistant).

* SAS 9.3 supports only the data items that return numeric values.