[dagster-tableau] Update Tableau docs with custom materialization exa…

…mple (#25672)

## Summary & Motivation

As title.

docs/content/integrations/tableau.mdx

@@ -302,6 +302,72 @@ defs = dg.Definitions(
 )
 ```
 
+### Customizing how Tableau assets are materialized
+
+Instead of using the out-of-the-box <PyObject module="dagster_tableau" method="build_tableau_materializable_assets_definition" /> utility, you can build your own assets definition that trigger the refresh of your Tableau workbooks. This allows you to customize how the refresh is triggered or to run custom code before or after the refresh.
+
+```python file=/integrations/tableau/materialize-tableau-assets-advanced.py
+from typing import Sequence
+
+from dagster_tableau import (
+    TableauCloudWorkspace,
+    load_tableau_asset_specs,
+    parse_tableau_external_and_materializable_asset_specs,
+)
+
+import dagster as dg
+
+tableau_workspace = TableauCloudWorkspace(
+    connected_app_client_id=dg.EnvVar("TABLEAU_CONNECTED_APP_CLIENT_ID"),
+    connected_app_secret_id=dg.EnvVar("TABLEAU_CONNECTED_APP_SECRET_ID"),
+    connected_app_secret_value=dg.EnvVar("TABLEAU_CONNECTED_APP_SECRET_VALUE"),
+    username=dg.EnvVar("TABLEAU_USERNAME"),
+    site_name=dg.EnvVar("TABLEAU_SITE_NAME"),
+    pod_name=dg.EnvVar("TABLEAU_POD_NAME"),
+)
+
+
+# Assets definition factory which triggers workbooks refresh and sends a notification once complete
+def build_tableau_materialize_and_notify_asset_def(
+    specs: Sequence[dg.AssetSpec], refreshable_workbook_ids: Sequence[str]
+) -> dg.AssetsDefinition:
+    @dg.multi_asset(
+        name="tableau_sync",
+        compute_kind="tableau",
+        specs=specs,
+    )
+    def asset_fn(context: dg.AssetExecutionContext, tableau: TableauCloudWorkspace):
+        with tableau.get_client() as client:
+            yield from client.refresh_and_materialize_workbooks(
+                specs=specs, refreshable_workbook_ids=refreshable_workbook_ids
+            )
+            # Do some custom work after refreshing here, such as sending an email notification
+
+    return asset_fn
+
+
+# Load Tableau asset specs
+tableau_specs = load_tableau_asset_specs(
+    workspace=tableau_workspace,
+)
+
+external_asset_specs, materializable_asset_specs = (
+    parse_tableau_external_and_materializable_asset_specs(tableau_specs)
+)
+
+# Use the asset definition builder to construct the definition for tableau materializable assets
+defs = dg.Definitions(
+    assets=[
+        build_tableau_materialize_and_notify_asset_def(
+            specs=materializable_asset_specs,
+            refreshable_workbook_ids=["b75fc023-a7ca-4115-857b-4342028640d0"],
+        ),
+        *external_asset_specs,
+    ],
+    resources={"tableau": tableau_workspace},
+)
+```
+
 ### Related
 
 - [`dagster-tableau` API reference](/\_apidocs/libraries/dagster-tableau)

examples/docs_snippets/docs_snippets/integrations/tableau/materialize-tableau-assets-advanced.py

@@ -0,0 +1,59 @@
+from typing import Sequence
+
+from dagster_tableau import (
+    TableauCloudWorkspace,
+    load_tableau_asset_specs,
+    parse_tableau_external_and_materializable_asset_specs,
+)
+
+import dagster as dg
+
+tableau_workspace = TableauCloudWorkspace(
+    connected_app_client_id=dg.EnvVar("TABLEAU_CONNECTED_APP_CLIENT_ID"),
+    connected_app_secret_id=dg.EnvVar("TABLEAU_CONNECTED_APP_SECRET_ID"),
+    connected_app_secret_value=dg.EnvVar("TABLEAU_CONNECTED_APP_SECRET_VALUE"),
+    username=dg.EnvVar("TABLEAU_USERNAME"),
+    site_name=dg.EnvVar("TABLEAU_SITE_NAME"),
+    pod_name=dg.EnvVar("TABLEAU_POD_NAME"),
+)
+
+
+# Assets definition factory which triggers workbooks refresh and sends a notification once complete
+def build_tableau_materialize_and_notify_asset_def(
+    specs: Sequence[dg.AssetSpec], refreshable_workbook_ids: Sequence[str]
+) -> dg.AssetsDefinition:
+    @dg.multi_asset(
+        name="tableau_sync",
+        compute_kind="tableau",
+        specs=specs,
+    )
+    def asset_fn(context: dg.AssetExecutionContext, tableau: TableauCloudWorkspace):
+        with tableau.get_client() as client:
+            yield from client.refresh_and_materialize_workbooks(
+                specs=specs, refreshable_workbook_ids=refreshable_workbook_ids
+            )
+            # Do some custom work after refreshing here, such as sending an email notification
+
+    return asset_fn
+
+
+# Load Tableau asset specs
+tableau_specs = load_tableau_asset_specs(
+    workspace=tableau_workspace,
+)
+
+external_asset_specs, materializable_asset_specs = (
+    parse_tableau_external_and_materializable_asset_specs(tableau_specs)
+)
+
+# Use the asset definition builder to construct the definition for tableau materializable assets
+defs = dg.Definitions(
+    assets=[
+        build_tableau_materialize_and_notify_asset_def(
+            specs=materializable_asset_specs,
+            refreshable_workbook_ids=["b75fc023-a7ca-4115-857b-4342028640d0"],
+        ),
+        *external_asset_specs,
+    ],
+    resources={"tableau": tableau_workspace},
+)