Working with Branch
Activate Branch
Welcome to the OpenBrIM branch system. With this branch system, any object within the library becomes an object you can work on, allowing you to see the developments you make in your own workspace.
First of all, if the branch system is desired to be used actively, dlibv = 1 should be used. Because using the final version of the object, which is used by overriding, will create a safer working environment for the user.
To get started, the user should navigate to their own folder under the 'author' section and click on the 'branch' button here.
Within the opened UI, first create a new branch or select the branch you want to work on.
After adding a branch, the library object to be overridden and the user's object with which it should be overridden should be introduced here. There are 2 methods for this. The first one is 'Add Library and Override Object...'. This button allows you to add the library object to the branch and your existing object. The second one is 'Pull Library Objects...'. This button retrieves the final state of the object from the library and saves it to the user's side by renaming it. This method is quite useful for getting the latest version of the library objects to work on.
Now, click on the 'Pull Library Objects...' button and select the library objects you want to work on in the opened UI. In this example, the OBPBase_SteelIGirderCodeCheck, OBPTemplate_SteelIGirderCodeCheck, and OBPDR_SteelGirderCodeCheck objects are selected, and the 'Pull' button is clicked.
After the process is completed, you can see the library objects and override objects within the branch. If you want to remove from the branch or delete the override object, you can proceed by clicking on 'X'. Additionally, you can click on the button on the right side of the row to examine the difference between the two objects.
Finally, by clicking the 'Copy' button, you can copy the link of the active branch to allow another user checkout or by clicking the 'Activate Branch' button, the selected branch becomes active. You need to share the link with the other user. To continue with this example, click on the 'Activate Branch' button.
First, navigate to the OverrideCodeCheck_OBPBase_SteelIGirderCodeCheck object and link the document name to an input parameter.
Secondly, go to the OverrideCodeCheck_OBPBase_SteelIGirderCodeCheck object and add a DocSection with the Title 'Section Properties Branch Test'.
Finally, go to the OverrideCodeCheck_OBPTemplate_SteelIGirderCodeCheck object and change the category and description of the 'UserPrefA6' parameter from A6 to C6.
Now let's go to a project where we use code check and examine the results of the changes made.
The newly added document name parameter appears as an input in the spreadsheet. The names given here are visible within the report.
Here, in the spreadsheet, it is visible that it displays the category and name as C6 instead of A6.
And finally, the document shows the 'Section Properties Branch Test' DocSection.
Share Branch
To share the branch with another user, click on the 'Copy' button and copy the provided link.
The other user can add the branch to their workspace by clicking on the 'Checkout Branch' button in the opened UI and pasting the copied link.
The branch has now been added to the other user's workspace. They can test the objects and examine the differences between the objects.
Use Branch at App
Finally, user can also access the branch settings from the app. Click on the 'Objects' button on the right, and in the opened UI, click on the 'branch' button.
Here, user can change active branch, add or remove objects from user branch, and checkout branches shared by other users.
Last updated