The Chain

Summary

The chain consists of a number of main workflows aimed at en mass family updates:

• Reporting - of family properties :

  • REPORTING

  • SAVING MISSING FAMILIES

• Changing - Specific families with specific actions :

  • RENAMING

  • CHANGE FAMILY CATEGORY

  • CHANGE FAMILY SUB CATEGORIES

• Changing - All families with a default set of actions :

  • MODIFY DEFAULT

• Reloading - nested families into host families : HowTo_ReloadFamilies.rst

  • RELOADING

Putting it all together

The batch script ‘theChain.bat’ executes the 3 workflows in the following order:

1. Changing

2. Reloading

3. Reporting

In between executing flows, it will copy the following files from the flow just finished to the one about to be executed:

1. Changing

   • Change list ChangedFilesTaskList.csv

     • from folder: ___01_ModifyFamilyChange_Output

     • to folder: ___02_ModifyFamilyLibraryReloadAdvanced_Input

2. Reloading

   • no files copied to next flow

3. Reporting

   • FamilyBaseDataCombinedReport.csv

     • from folder: ___00_ReportFamilyData_OutputuserName

     • to folders:

       • ___00_ReportFamilyData_AnalysisYYMMDD

       • ___00_ReportFamilyData_Analysis_Current

       • ___01_ModifyFamilyChange_Input

       • ___02_ModifyFamilyLibraryReloadAdvanced_Input

Setting Up - The Chain

• copy folder structure from:

  \bvnDatastudioinfotechstandardsScriptsRevit PythonRBPWorkflowsTheChain to your project folder location

• change file path in all settings files in all _default folders per work flow: (use visual studio code: find and replace in files)

  • “taskScriptFilePath”: “C:\Users\chrjx\Documents\github\SampleCodeRevitBatchProcessor\Samples\Flows\TheChain\_00_ReportFamilyData\_Script\ReportFamilyData.py”,

  • “revitFileListFilePath”: “C:\Users\chrjx\Documents\github\SampleCodeRevitBatchProcessor\Samples\Flows\TheChain\_00_ReportFamilyData\_Users\jchristel\_TaskList\Tasklist_1.txt”,

  • “dataExportFolderPath”: “C:\Users\chrjx\Documents\github\SampleCodeRevitBatchProcessor\Samples\Flows\TheChain\_00_ReportFamilyData\_Users\jchristel\_Users\jchristel\SessionData”,

  • “preProcessingScriptFilePath”: “C:\Users\chrjx\Documents\github\SampleCodeRevitBatchProcessor\Samples\Flows\TheChain\_00_ReportFamilyData\_Script\Pre_MarkerFiles.py”,

  • “PostProcessingScriptFilePath”: “C:\Users\chrjx\Documents\github\SampleCodeRevitBatchProcessor\Samples\Flows\TheChain\_00_ReportFamilyData\_Script\Post_KillWSM.py”,

• check Revit version in _default settings to match your required version

  • “singleRevitTaskRevitVersion”: “Revit2020”

  • “batchRevitTaskRevitVersion”: “Revit2022”

• change file path to Revit library in python util files:

  • Report (utilModifyBVN.py), Modify (utilModifyBVN.py) & Reload (utilReloadBVN.py):

    • REVIT_LIBRARY_PATH = r’\bvndatastudioSharedAssetsRevitRevitContentCentralHealthLibrary_Kinship’

• run setupUser.bat located in ___A0_TheChain to create a user specific folder in each flow. Note: without a user specific folder the flow will not work.