The Microsoft Excel File Format - OpenOffice.org

4 Worksheet/Workbook Stream
• External Names
In Excel, formulas can use defined names located in another workbook, called “external names”. In this case for each
name an EXTERNALNAME record (➜5.39) occurs after the EXTERNALBOOK record. The EXTERNALNAME
record contains the name itself and the one-based index to the sheet name of the EXTERNALBOOK record. Again the
index zero indicates a global name. If an EXTERNALBOOK contains external names, a special REF entry will be
created in the EXTERNSHEET record. It contains the index to the EXTERNALBOOK and the sheet range –2…–2.
Inside of a formula an external name is represented by the token tNameX (➜3.9.14). It contains the index to the special
REF entry inside of the EXTERNSHEET record and the index to an EXTERNALNAME record (one-based).
Example: A document contains the formulas
=example.xls!GlobalName (location: ExtSheet3!C33; contents: 33),
=[example.xls]ExtSheet3!LocalName (location: ExtSheet1!B22; contents: “ABCD”), and
=[example.xls]ExtSheet1!LocalName (location: ExtSheet1!A11; contents: 11).
EXTERNALBOOK 0
EXTERNALNAME 1
EXTERNALNAME 2
EXTERNALNAME 3
XCT
Document = “example.xls”
Sheet 0 = “ExtSheet1”
Sheet 1 = “ExtSheet2”
Sheet 2 = “ExtSheet3”
Name = “GlobalName”, sheet (one-based) = 0 (Global),
Formula = “=[example.xls]ExtSheet3!C33”
Name = “LocalName”, sheet (one-based) = 3 (ExtSheet3),
Formula = “=[example.xls]ExtSheet1!B22”
Name = “LocalName”, sheet (one-based) = 1 (ExtSheet1),
Formula = “=[example.xls]ExtSheet1!A11”
Number of CRN = 2, sheet = 0 (ExtSheet1)
CRN 0 Cell range = A11, contents = 11
CRN 1
XCT
Cell range = B22, contents = “ABCD”
Number of CRN = 1, sheet = 2 (ExtSheet3)
CRN 0 Cell range = C33, contents = 33
EXTERNSHEET
REF 0 = {EXTERNALBOOK = 0, sheet range = –2…–2}
All formulas in the example above contain the token tNameXV with a reference to REF 0 in the EXTERN-
SHEET record. REF 0 refers to EXTERNALBOOK 0 with the special sheet indexes for defined names.
Therefore the EXTERNALNAME records of EXTERNALBOOK 0 are used.
The token of the first formula refers to EXTERNALNAME 1, the token of the second formula refers to EXTER-
NALNAME 2, and the token of the last formula refers to EXTERNALNAME 3.
• Add-In Functions
If a workbook uses add-in functions, a special EXTERNALBOOK containing the byte sequence 01 H 3A H will occur. It
is followed by the names of all used add-in functions, each inside of an EXTERNALNAME record. A special REF entry
with the sheet range –2…–2 will be inserted into the EXTERNSHEET reference list.
Example: A document contains the formulas =ISODD(1) and =ISEVEN(1).
EXTERNALBOOK 0
EXTERNALNAME 1
EXTERNALNAME 2
EXTERNSHEET
01 H 3A H (add-in)
Name = “ISODD”
Name = “ISEVEN”
REF 0 = {EXTERNALBOOK = 0, sheet range = –2…–2}
The add-in function names are represented by tNameXR tokens in the formula, here referring to REF 0 and to
the respective EXTERNALNAME record. The token is the first argument of the EXTERN.CALL function,
which invokes the call of the add-in function.
108