Interface Workbook
activeCustomView: undefined | CustomView;
activeSheet: Sheet;
name: string;
publishedSheetsInfo: SheetInfo[];
activateSheetAsync(sheetNameOrIndex: string | number): Promise<Sheet>;
changeParameterValueAsync(
name: string,
value: string | number | boolean | Date,
): Promise<Parameter>;
getCustomViewsAsync(): Promise<CustomView[]>;
getParametersAsync(): Promise<Parameter[]>;
removeCustomViewAsync(customViewName: string): Promise<CustomView>;
revertAllAsync(): Promise<void>;
saveCustomViewAsync(customViewName: string): Promise<CustomView>;
setActiveCustomViewAsDefaultAsync(): Promise<void>;
showCustomViewAsync(
customViewName?: null | string,
): Promise<undefined | CustomView>;
}
Methods
activateSheetAsync
Parameters
- sheetNameOrIndex: string | number
Returns Promise<Sheet>
changeParameterValueAsync
- changeParameterValueAsync(
name: string,
value: string | number | boolean | Date,
): Promise<Parameter>Modifies the given parameter and assigns it a new value. The new value must fall within the domain restrictions defined by
allowableValues. If the domain restriction isParameterValueType.Range, be sure to check theallowableValuesbefore assigning a new value. If the new value is out of range, the updated value will be set to either theminValueor themaxValueof the allowable range. If a step size is also specified and the new value does not fall on the step intervals, the updated value will be set to the closest, lower step, or closest, earlier date. If the domain restriction is typeParameterValueType.List, and there are aliases defined for the list, the aliased value should be passed to the method.Parameters
- name: string
The name of the parameter
- value: string | number | boolean | Date
The new value to assign to this parameter.
NoteFor changing
Dateparameters, UTC Date objects are expected.
Returns Promise<Parameter>
The updated
Parameter. The promise is rejected ifnameorvalueis invalid. However, if the domain restriction is typeAllowableValuesType.Range, and thevalueis out of the range bounds, the parameter gets set to theminValueor themaxValueof the range (whichever is closer). If the range has astepSizeordateStepPeriod, the parameter gets set to the closest, lower step, or the closest, earlier date. - name: string
getCustomViewsAsync
Gets the collection of CustomView objects associated with the workbook.
Returns Promise<CustomView[]>
getParametersAsync
Returns Promise<Parameter[]>
A collection of all the Tableau parameters that are used in this workbook.
removeCustomViewAsync
revertAllAsync
Reverts the workbook to its last saved state.
Returns Promise<void>
saveCustomViewAsync
Saves the current state of the workbook by assigning a custom view name.
Parameters
- customViewName: string
Returns Promise<CustomView>
setActiveCustomViewAsDefaultAsync
Sets the active custom view as the default. If there is no active custom view, the default view is the original view.
Returns Promise<void>
showCustomViewAsync
Changes the visualization to show the named saved state.
workbook.showCustomViewAsync("Awesome" ).then(function() { // do something });To reset a custom view to the original view, do not provide the customViewName parameter.workbook.showCustomViewAsync().then(function() { // do something });Parameters
OptionalcustomViewName: null | string
Returns Promise<undefined | CustomView>
Properties
ReadonlyactiveCustomView
Gets the currently active custom view, or undefined if no custom view is active.
ReadonlyactiveSheet
Gets the currently active sheet (the active tab).
Readonlyname
Gets the name of the workbook saved to the server. Note that this is not necessarily the file name.
ReadonlypublishedSheetsInfo
Note that this is synchronous, meaning that all of the sheets are expected when loaded.
Activates the sheet, either by name or index, and returns a promise of the sheet that was activated.