drill()
Home > @gooddata/sdk-ui-dashboard > drill
drill() function
This API is provided as an alpha preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
Creates the IDrill command. Dispatching this command will result into dispatching IDashboardDrillResolved event.
This is general dashboard drill command with details about all possible more granular drill interactions that can follow. Reason for this general drill command is that it may happen that multiple drill interactions are possible for one drill event.
Example: some attribute on the insight has drill down set and also widget has drill to insight set. Then this command must be dispatched with both and definitions.
- This must be always the first command that occurs after the drill interaction and must be dispatched before more granular drill commands. - Specific drill commands that can follow this general drill command are: IDrillDown, IDrillToInsight, IDrillToDashboard, IDrillToCustomUrl, IDrillToAttributeUrl, IDrillToLegacyDashboard
Signature:
export declare function drill(drillEvent: IDashboardDrillEvent, drillContext: IDashboardDrillContext, correlationId?: string): IDrill;
Parameters
|
Parameter |
Type |
Description |
|---|---|---|
|
drillEvent |
original drill event, that triggered this particular drill interaction. | |
|
drillContext |
context in which the drill interaction was triggered (widget and insight details - if available). | |
|
correlationId |
string |
(Optional) specify correlation id. It will be included in all events that will be emitted during the command processing. |
Returns:
drill command