Additional tips for ERExcelLook
ERExcelLook-specific Rules
For quick reference:
1. How do I change the default name of the downloadable spreadsheet?
100: pageConfiguration = 'ListExcelFooBar' => excelFileName = "FooBar Report" [Assignment]
If you want the excelFileName to be dynamic (i.e. pulled from a value in your code) you can use ERDDelayedKeyValueAssignment to assign its value from a keypath:
100: pageConfiguration = 'ListExcelFooBar' => excelFileName = "session.excelFileName" [ERDDelayedKeyValueAssignment]
2. How do I customize the columns that will appear within the downloadable spreadsheet?
100 : pageConfiguration = 'ListExcelPerson' => displayPropertyKeys = (familyName, givenName,"currentContactAddress.address1",
"currentMContactAddress.address2", "currentContactAddress.city", "currentContactAddress.province", "currentContactAddress.postalCode",
"currentContactAddress.country", "currentContactAddress.email") [com.webobjects.directtoweb.Assignment]
3. How do I customize the titles used by the columns that will appear on the downloadable spreadsheet?
100 : pageConfiguration = 'ListExcelPerson' and propertyKey like '*address1' => displayNameForProperty = "Street Address" [com.webobjects.directtoweb.Assignment]
4. How do I customize the worksheet names within the downloadable spreadsheet? You can specify the worksheet name by adding it in parenthesis as the first item in your displayPropertyKeys array. i.e: "Contact List" for the rule below
100 : pageConfiguration = 'ListExcelPerson' => displayPropertyKeys = ("(Contact List)", familyName, givenName,
"currentContactAddress.address1", "currentMContactAddress.address2", "currentContactAddress.city", "currentContactAddress.province",
"currentContactAddress.postalCode", "currentContactAddress.country", "currentContactAddress.email") [com.webobjects.directtoweb.Assignment]
Alternately: You can use the key excelSheetName and assign it a value using a rule similar to tip 1
100: pageConfiguration = 'ListExcelFooBar' => excelSheetName = "session.myExcelSheetName" [ERDDelayedKeyValueAssignment]
5. How do I display email addresses in the downloadable spreadsheet?
100 : propertyKey like '*email' => componentName = "ERD2WDisplayString" [com.webobjects.directtoweb.Assignment]
6. How do I use ERExcelLook when Click to Open is enabled? (Note the low priority number) This disables ClickToOpen for these Excel pages only
10 : pageConfiguration like '*Excel' => clickToOpenEnabled = "false" [com.webobjects.directtoweb.BooleanAssignment]