Tableau Migration SDK 5.1.1
  • Articles
  • Code Samples
  • Python API Reference
  • C# API Reference
Show / Hide Table of Contents
  • tableau_migration
    • migration
      • get_service
      • get_service_provider
      • PyMigrationResult
      • PyMigrationManifest
      • PyMigrationCompletionStatus
      • PyContentReference
      • PyContentLocation
      • PyPipelineProfile
      • PyResult
    • migration_api_rest
      • PyRestIdentifiable
    • migration_api_rest_models
      • PyAdministratorLevels
      • PyContentPermissions
      • PyLabelCategories
      • PyLicenseLevels
      • PyPermissionsCapabilityModes
      • PyPermissionsCapabilityNames
      • PySiteRoles
      • PyExtractEncryptionModes
    • migration_api_rest_models_types
      • PyAuthenticationTypes
      • PyDataSourceFileTypes
      • PyWorkbookFileTypes
    • migration_content
      • PyCloudSubscription
      • PySubscription
      • PySubscriptionContent
      • PyTag
      • PyUser
      • PyUserAuthenticationType
      • PyUsernameContent
      • PyServerSubscription
      • PyView
      • PyWithOwner
      • PyWithTags
      • PyWithWorkbook
      • PyWorkbook
      • PyWorkbookDetails
      • PyWithDomain
      • PyPublishedContent
      • PyPublishableGroup
      • PyConnection
      • PyConnectionsContent
      • PyContainerContent
      • PyCustomView
      • PyDataSource
      • PyDataSourceDetails
      • PyPublishableWorkbook
      • PyDescriptionContent
      • PyGroup
      • PyGroupUser
      • PyLabel
      • PyProject
      • PyPublishableCustomView
      • PyPublishableDataSource
      • PyExtractContent
    • migration_content_permissions
      • PyPermissions
      • PyGranteeType
      • PyGranteeCapability
      • PyCapability
    • migration_content_schedules
      • PyInterval
      • PyFrequencyDetails
      • PyExtractRefreshTask
      • PyExtractRefreshContentType
      • PySchedule
      • PyWithSchedule
    • migration_content_schedules_cloud
      • PyCloudSchedule
      • PyCloudExtractRefreshTask
    • migration_content_schedules_server
      • PyServerSchedule
      • PyServerExtractRefreshTask
    • migration_engine
      • PyServerToCloudMigrationPlanBuilder
      • PyMigrationPlanBuilder
      • PyMigrationPlan
      • PyContentMigrationItem
    • migration_engine_actions
      • PyMigrationActionResult
    • migration_engine_endpoints_search
      • PySourceContentReferenceFinder
      • PySourceContentReferenceFinderFactory
      • PyDestinationContentReferenceFinderFactory
      • PyDestinationContentReferenceFinder
    • migration_engine_hooks
      • PyMigrationHookBuilder
      • PyMigrationHookFactoryCollection
    • migration_engine_hooks_filters
      • PyContentFilterBuilder
    • migration_engine_hooks_filters_interop
      • PyContentFilterBase
    • migration_engine_hooks_interop
      • PyInitializeMigrationHookBase
      • PyMigrationActionCompletedHookBase
      • PyContentBatchMigrationCompletedHookBase
    • migration_engine_hooks_mappings
      • PyContentMappingContext
      • PyContentMappingBuilder
    • migration_engine_hooks_mappings_interop
      • PyContentMappingBase
      • PyTableauCloudUsernameMappingBase
    • migration_engine_hooks_postpublish
      • PyContentItemPostPublishContext
      • PyBulkPostPublishContext
    • migration_engine_hooks_postpublish_interop
      • PyContentItemPostPublishHookBase
      • PyBulkPostPublishHookBase
    • migration_engine_hooks_results
      • PyInitializeMigrationHookResult
    • migration_engine_hooks_transformers
      • PyContentTransformerBuilder
    • migration_engine_hooks_transformers_interop
      • PyXmlContentTransformerBase
      • PyContentTransformerBase
    • migration_engine_manifest
      • PyMigrationManifestEntryEditor
      • PyMigrationManifestEntryStatus
      • PyMigrationManifestSerializer
      • PyMigrationManifestEntry
    • migration_engine_migrators
      • PyContentItemMigrationResult
      • PyMigrator
    • migration_engine_migrators_batch
      • PyContentBatchMigrationResult
    • migration_engine_options
      • PyMigrationPlanOptionsBuilder
      • PyMigrationPlanOptionsCollection
    • migration_engine_pipelines
      • PyMigrationPipelineContentType
      • PyServerToCloudMigrationPipeline
    • migration_enum
    • migration_logger
      • MigrationLogger
    • migration_services
      • ScopedMigrationServices

PyMigrationPlanBuilder

class PyMigrationPlanBuilder

Bases: object

Default IMigrationPlanBuilder implementation.

__init__()

Default init.

Returns: None.

  • Return type: None

Methods

__init__() Default init.
append_default_extensions() Adds default hooks, filters, etc.
build() Finalizes the IMigrationPlan based on the current state.
clear_extensions() Clears all hooks, filters, mappings, and transformations.
for_server_to_cloud() Initializes the plan to perform a migration of content between a Tableau Server and Tableau Cloud site.
from_source(config) Sets or overwrites the configuration for the source endpoint to migrate content from.
from_source_tableau_server(server_url, ...) Sets or overwrites the configuration for the source Tableau Server site to migrate content from.
pipeline_profile() Gets the pipeline profile to execute.
to_destination(config) Sets or overwrites the configuration for the destination endpoint to migrate content to.
to_destination_tableau_cloud(pod_url, ...[, ...]) Sets or overwrites the configuration for the destination Tableau Cloud site to migrate content to.
validate() Validates that the plan that would be built has enough information to execute.

Attributes

filters Gets the filters to execute at various points during the migration.
hooks Gets the hooks to execute at various points during the migration, determined by hook type.
mappings Gets the mappings to execute at various points during the migration.
options Gets the per-plan options to supply.
transformers Gets the transformations to execute at various points during the migration.

property filters : PyContentFilterBuilder

Gets the filters to execute at various points during the migration.

property transformers : PyContentTransformerBuilder

Gets the transformations to execute at various points during the migration.

property options : PyMigrationPlanOptionsBuilder

Gets the per-plan options to supply.

property hooks : PyMigrationHookBuilder

Gets the hooks to execute at various points during the migration, determined by hook type.

property mappings : PyContentMappingBuilder

Gets the mappings to execute at various points during the migration.

pipeline_profile()

Gets the pipeline profile to execute.

  • Return type: PyPipelineProfile

from_source_tableau_server(server_url, site_content_url, access_token_name, access_token, create_api_simulator=False)

Sets or overwrites the configuration for the source Tableau Server site to migrate content from.

Args: : server_url: The base URL of the Tableau Server to connect to. site_content_url: The URL namespace of the site to connect to. access_token_name: The name of the personal access token to use to sign into the site. access_token: The personal access token to use to sign into the site. create_api_simulator: Whether or not to create an API simulator for the server_url.

Returns: The same plan builder object for fluent API calls.

  • Parameters:
    • server_url (str)
    • site_content_url (str)
    • access_token_name (str)
    • access_token (str)
    • create_api_simulator (bool)
  • Return type: Self

to_destination_tableau_cloud(pod_url, site_content_url, access_token_name, access_token, create_api_simulator=False)

Sets or overwrites the configuration for the destination Tableau Cloud site to migrate content to.

Args: : pod_url: The base URL of Tableau Cloud pod to connect to. site_content_url: The URL namespace of the site to connect to. access_token_name: The name of the personal access token to use to sign into the site. access_token: The personal access token to use to sign into the site. create_api_simulator: Whether or not to create an API simulator for the server_url.

Returns: The same plan builder object for fluent API calls.

  • Parameters:
    • pod_url (str)
    • site_content_url (str)
    • access_token_name (str)
    • access_token (str)
    • create_api_simulator (bool)
  • Return type: Self

for_server_to_cloud()

Initializes the plan to perform a migration of content between a Tableau Server and Tableau Cloud site.

Returns: The same plan builder object for fluent API calls.

  • Return type: PyServerToCloudMigrationPlanBuilder

build()

Finalizes the IMigrationPlan based on the current state.

Returns: The created IMigrationPlan.

  • Return type: PyMigrationPlan

clear_extensions()

Clears all hooks, filters, mappings, and transformations.

Returns: The same plan builder object for fluent API calls.

  • Return type: Self

append_default_extensions()

Adds default hooks, filters, etc. that are common between all migration scenarios.

Returns: The same plan builder object for fluent API calls.

  • Return type: Self

from_source(config)

Sets or overwrites the configuration for the source endpoint to migrate content from.

Args: : config: The endpoint configuration.

Returns: The same plan builder object for fluent API calls.

  • Parameters: config (IMigrationPlanEndpointConfiguration)
  • Return type: Self

to_destination(config)

Sets or overwrites the configuration for the destination endpoint to migrate content to.

Args: : config: The endpoint configuration.

Returns: The same plan builder object for fluent API calls.

  • Parameters: config (IMigrationPlanEndpointConfiguration)
  • Return type: Self

validate()

Validates that the plan that would be built has enough information to execute.

Returns: The validation result.

  • Return type: PyResult
In this article