Release/4.3.0

Release 4.3.0

Author: pvshn

.github/workflows/dotnet-test.yml

@@ -26,12 +26,12 @@ jobs:
       run: dotnet build '${{ vars.BUILD_SOLUTION }}' -c ${{ matrix.config }}
     - name: Test solution with ${{ matrix.config }} configuration
       run: |
-        dotnet test '${{ vars.BUILD_SOLUTION }}' --no-build -c ${{ matrix.config }} --verbosity normal --logger trx --results-directory "TestResults-${{ matrix.os }}-${{ matrix.config }}" -- RunConfiguration.TestSessionTimeout=${{ vars.MIGRATIONSDK_TEST_CANCELLATION_TIMEOUT_MILLISECONDS }}
+        dotnet test '${{ vars.BUILD_SOLUTION }}' --no-build -c ${{ matrix.config }} --verbosity normal --logger junit --results-directory "TestResults-${{ matrix.os }}-${{ matrix.config }}" -- RunConfiguration.TestSessionTimeout=${{ vars.MIGRATIONSDK_TEST_CANCELLATION_TIMEOUT_MILLISECONDS }}
     - name: Upload test results
       # Use always() to always run this step to publish test results when there are test failures
       if: ${{ always() }}
       uses: actions/upload-artifact@v4
       with:
         name: dotnet-results-${{ matrix.os }}-${{ matrix.config }}
         path: TestResults-${{ matrix.os }}-${{ matrix.config }}
-        if-no-files-found: error
+        if-no-files-found: error

.gitignore

@@ -80,8 +80,6 @@ instance/
 # Scrapy stuff:
 .scrapy
 
-# Sphinx documentation
-docs/_build/
 
 # PyBuilder
 .pybuilder/
@@ -179,14 +177,6 @@ launchSettings.json
 UpgradeLog.htm
 *.*.ini
 *.*.json
-/src/Python/Documentation/_build
-/src/Python/Documentation/_static
-/src/Python/Python.pyproj.user
-/src/Documentation/_python
-/src/Python/Documentation/generated
-/tests/Python.TestApplication/manifest.json
-/.git2gus
-/src/Python/scripts/publish-package.ps1
 
 # Public repo ignores
 .github/pull_request_template.md

Directory.Build.props

@@ -4,7 +4,7 @@
 		<Nullable>enable</Nullable>
 		<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
 		<EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
-		<Version>4.2.0</Version>
+		<Version>4.3.0</Version>
 		<Authors>Salesforce, Inc.</Authors>
 		<Company>Salesforce, Inc.</Company>
 		<Copyright>Copyright (c) 2024, Salesforce, Inc. and its licensors</Copyright>

examples/Csharp.ExampleApplication/Hooks/Filters/SharedCustomViewFilter.cs

@@ -0,0 +1,25 @@
+using System;
+using Microsoft.Extensions.Logging;
+using Tableau.Migration.Api.Rest.Models;
+using Tableau.Migration.Content;
+using Tableau.Migration.Engine;
+using Tableau.Migration.Engine.Hooks.Filters;
+using Tableau.Migration.Resources;
+
+namespace Csharp.ExampleApplication.Hooks.Filters
+{
+    #region class
+    public class SharedCustomViewFilter : ContentFilterBase<ICustomView>
+    {
+        public SharedCustomViewFilter(
+            ISharedResourcesLocalizer localizer,
+            ILogger<IContentFilter<ICustomView>> logger)
+                : base(localizer, logger) { }
+
+        public override bool ShouldMigrate(ContentMigrationItem<ICustomView> item)
+        {
+            return !item.SourceItem.Shared;
+        }
+    }
+    #endregion
+}

examples/Csharp.ExampleApplication/Hooks/Transformers/CustomViewDefaultUsersTransformer.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging;
+using Tableau.Migration;
+using Tableau.Migration.Content;
+using Tableau.Migration.Engine.Hooks.Transformers;
+using Tableau.Migration.Resources;
+
+namespace Csharp.ExampleApplication.Hooks.Transformers
+{
+    #region class
+    public class CustomViewExcludeDefaultUserTransformer(
+        ISharedResourcesLocalizer localizer,
+        ILogger<CustomViewExcludeDefaultUserTransformer> logger)
+        : ContentTransformerBase<IPublishableCustomView>(localizer, logger)
+    {
+        public IList<string> ExcludeUsernames { get; } = new List<string>() {"User1", "User2"};
+            
+
+        private readonly ILogger<CustomViewExcludeDefaultUserTransformer>? _logger = logger;
+
+        public override async Task<IPublishableCustomView?> TransformAsync(IPublishableCustomView itemToTransform, CancellationToken cancel)
+        {
+            var newDefaultUsers = itemToTransform.DefaultUsers.Where(user => !ExcludeUsernames.Contains(user.Name)).ToList();
+
+            itemToTransform.DefaultUsers = newDefaultUsers;
+
+            _logger?.LogInformation(
+                @"Excluding default users {newDefaultUsers}",
+                newDefaultUsers);
+
+            return await Task.FromResult(itemToTransform);
+        }
+    }
+    #endregion
+}

examples/Csharp.ExampleApplication/MyMigrationApplication.cs

@@ -113,6 +113,10 @@ public async Task StartAsync(CancellationToken cancel)
             #region UnlicensedUsersFilter-Registration
             _planBuilder.Filters.Add<UnlicensedUsersFilter, IUser>();
             #endregion
+            
+            #region SharedCustomViewFilter-Registration
+            _planBuilder.Filters.Add<SharedCustomViewFilter, ICustomView>();
+            #endregion
 
             // Add post-publish hooks
             #region UpdatePermissionsHook-Registration
@@ -138,6 +142,10 @@ public async Task StartAsync(CancellationToken cancel)
             #region StartAtTransformer-Registration
             _planBuilder.Transformers.Add<SimpleScheduleStartAtTransformer<ICloudExtractRefreshTask>, ICloudExtractRefreshTask>();
             #endregion
+            
+            #region CustomViewDefaultUsersTransformer-Registration
+            _planBuilder.Transformers.Add<CustomViewExcludeDefaultUserTransformer, IPublishableCustomView>();
+            #endregion
 
             // Add migration action completed hooks
             #region LogMigrationActionsHook-Registration

examples/Csharp.ExampleApplication/Program.cs

@@ -68,6 +68,10 @@ public static IServiceCollection AddCustomizations(this IServiceCollection servi
             #region UnlicensedUsersFilter-DI
             services.AddScoped<UnlicensedUsersFilter>();
             #endregion
+            
+            #region SharedCustomViewFilter-DI
+            services.AddScoped<SharedCustomViewFilter>();
+            #endregion
 
             #region UpdatePermissionsHook-DI
             services.AddScoped(typeof(UpdatePermissionsHook<,>));
@@ -90,6 +94,10 @@ public static IServiceCollection AddCustomizations(this IServiceCollection servi
             #region StartAtTransformer-DI
             services.AddScoped(typeof(SimpleScheduleStartAtTransformer<>));
             #endregion
+            
+            #region CustomViewDefaultUsersTransformer-DI
+            services.AddScoped<CustomViewExcludeDefaultUserTransformer>();
+            #endregion
 
             #region LogMigrationActionsHook-DI
             services.AddScoped<LogMigrationActionsHook>();

examples/Python.ExampleApplication/Hooks/Filters/shared_custom_view_filter.py

@@ -0,0 +1,11 @@
+from tableau_migration import (
+    ICustomView,
+    ContentMigrationItem,
+    ContentFilterBase)
+    
+
+class SharedCustomViewFilter(ContentFilterBase[ICustomView]):
+    def should_migrate(self, item: ContentMigrationItem[ICustomView]) -> bool:
+        if item.source_item.shared == True:
+            return False
+        return True

examples/Python.ExampleApplication/Hooks/mappings/project_rename_mapping.py

@@ -11,6 +11,6 @@ def map(self, ctx: ContentMappingContext[IProject]) -> ContentMappingContext[IPr
 
         new_location = ctx.content_item.location.rename("Production")
 
-        ctx.map_to(new_location)
+        ctx = ctx.map_to(new_location)
 
         return ctx

examples/Python.ExampleApplication/Hooks/transformers/custom_view_default_users_transformer.py

@@ -0,0 +1,14 @@
+from tableau_migration import (
+    ContentTransformerBase,
+    IContentReference,
+    IPublishableCustomView
+)
+
+class CustomViewDefaultUsersTransformer(ContentTransformerBase[IPublishableCustomView]):
+    
+    #Pass in list of users retrieved from Users API
+    default_users = []
+    
+    def transform(self, itemToTransform: IPublishableCustomView) -> IPublishableCustomView:
+        itemToTransform.default_users = self.default_users
+        return itemToTransform