{"type":"doc","content":[{"type":"paragraph","content":[{"text":"To access the Object to Item Occurrence Configuration panel, select the following within the ","type":"text"},{"text":"dRofus Menu","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":748,"id":"8dfffc5c-4133-407a-bdb0-df95d03c488d","collection":"contentId-1346374848","type":"file","height":432}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Object <-> Item Occurrence Configuration Editor","type":"text","marks":[{"type":"em"}]},{"text":" dialog will then open as follows:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":924,"id":"a8717af0-818c-4e2b-afa5-a14d189f477f","collection":"contentId-1346374848","type":"file","height":677}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The main difference between the ","type":"text"},{"text":"Zone <-> Room Configuration Editor","type":"text","marks":[{"type":"em"}]},{"text":" and the ","type":"text"},{"text":"Object <-> Item Occurrence Configuration Editor","type":"text","marks":[{"type":"em"}]},{"text":" dialog panels","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"is that (unlike ","type":"text"},{"text":"Zones)","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Objects","type":"text","marks":[{"type":"em"}]},{"text":" do not have a common set of parameters. This is why the list of available ArchiCAD parameters within the ","type":"text"},{"text":"Object <-> Item Occurrence Configuration Editor","type":"text","marks":[{"type":"em"}]},{"text":" dialog contains parameters only pertaining to the currently selected ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" (or the default ","type":"text"},{"text":"Library Part","type":"text","marks":[{"type":"em"}]},{"text":" if there are no ","type":"text"},{"text":"Objects","type":"text","marks":[{"type":"em"}]},{"text":" selected, or only the common parameters if multiple-selected Objects have different sets of parameters).","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Info","type":"text"}]},{"type":"paragraph","content":[{"text":"The choice of selected ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" (or set as default) is important when the ","type":"text"},{"text":"Object <-> Item Occurrence Configuration Editor","type":"text","marks":[{"type":"em"}]},{"text":" dialog panel is opened. Only parameters from the ","type":"text"},{"text":"Library Part","type":"text","marks":[{"type":"em"}]},{"text":" of the currently selected ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" will be available within the dialog.","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition, IFC properties will not appear within the ","type":"text"},{"text":"Object <-> Item Occurrence Configuration Editor","type":"text","marks":[{"type":"em"}]},{"text":" dialog, unless you select at least one ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" prior to opening the dialog. This also applies prior to carrying out the ","type":"text"},{"text":"Sync Instance Data with dRofus","type":"text","marks":[{"type":"em"}]},{"text":" command.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"This means that you may want to create different configurations for parameters based on different groups of ","type":"text"},{"text":"Objects","type":"text","marks":[{"type":"em"}]},{"text":". An example of such a configuration is shown below:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":924,"id":"5d651a9d-7abf-42ff-88c3-a34d99ec246f","collection":"contentId-1346374848","type":"file","height":677}}]},{"type":"paragraph","content":[{"text":"When you create a configuration for one type of ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" (e.g. Chairs) and then switch to another type (e.g. Beds) and re-open the ","type":"text"},{"text":"Object <-> Item Occurrence Configuration Editor","type":"text","marks":[{"type":"em"}]},{"text":" dialog, you will note that some ArchiCAD parameters defined in the configuration will be marked as \"Missing parameters\". It means that the currently selected ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" type does not contain these parameters. However, this configuration can still be used for linking and synchronizing ","type":"text"},{"text":"Object Instance","type":"text","marks":[{"type":"em"}]},{"text":"s. It just means that writing in to or from those missing parameters will be skipped for those ","type":"text"},{"text":"Object Instances","type":"text","marks":[{"type":"em"}]},{"text":" that don't contain these parameters, but will be updated for the other ","type":"text"},{"text":"Object Instances","type":"text","marks":[{"type":"em"}]},{"text":" at the time of synchronization.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is also not necessary for the values within the ","type":"text"},{"text":"Key attribute used for comparing","type":"text","marks":[{"type":"em"}]},{"text":" to be common for all ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" types in the Project. Those ","type":"text"},{"text":"Objects","type":"text","marks":[{"type":"em"}]},{"text":" that don't have the parameter will not be linked when such a configuration is used.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Top Section:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chose Configuration:","type":"text","marks":[{"type":"strong"}]},{"text":" Drop down list of pre-defined configurations.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New:","type":"text","marks":[{"type":"strong"}]},{"text":" Create a new configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy:","type":"text","marks":[{"type":"strong"}]},{"text":" Makes a copy of the active configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete:","type":"text","marks":[{"type":"strong"}]},{"text":" Deletes the active configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Available to users","type":"text","marks":[{"type":"strong"}]},{"text":": If this is checked all Users can see / use this configuration. If not checked then only those who have BIM Administration access can use the configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Is Default Configuration","type":"text","marks":[{"type":"strong"}]},{"text":": The User with BIM Administration access can mark one of the configurations as default by checking this. This will set the configuration as the default configuration used in all related dialogs (i.e., for synchronizing ","type":"text"},{"text":"Item Occurrences","type":"text","marks":[{"type":"em"}]},{"text":", linking ","type":"text"},{"text":"Item Occurrences","type":"text","marks":[{"type":"em"}]},{"text":" etc.) for all Users.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Info","type":"text"}]},{"type":"paragraph","content":[{"text":"The configuration set as default will be used by all Users in the project. Please take care when changing configuration settings as it will affect the entire Project. As an alternative to changing the default configuration, you can select which configuration to use at a time when carrying out the linking or synchronization of ","type":"text"},{"text":"Object Instances","type":"text","marks":[{"type":"em"}]},{"text":" or when viewing the ","type":"text"},{"text":"Zone","type":"text","marks":[{"type":"em"}]},{"text":"(s)' ","type":"text"},{"text":"Model's Equipment","type":"text","marks":[{"type":"em"}]},{"text":" dialog.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The dRofus Addon always has a configuration called \"Default\" for ","type":"text"},{"text":"Object <-> Item Occurrence Configurations","type":"text","marks":[{"type":"em"}]},{"text":". This \"Default\" configuration cannot be edited, but you can copy it and then make modifications to the copied configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you set another configuration as ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]},{"text":", the configuration called \"Default\" will actually no longer be the ","type":"text"},{"text":"default","type":"text","marks":[{"type":"em"}]},{"text":" configuration.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"'Attributes not linked' Section:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dRofus attribute ","type":"text","marks":[{"type":"strong"}]},{"text":"(left-hand side)","type":"text"},{"text":":","type":"text","marks":[{"type":"strong"}]},{"text":" This is a list of all the available dRofus attributes which you can synchronize data to / from that are not already in the current configuration. Note that (in addition to dRofus ","type":"text"},{"text":"Items","type":"text","marks":[{"type":"em"}]},{"text":"' Type-based attributes), there are also dRofus ","type":"text"},{"text":"Item Occurrences","type":"text","marks":[{"type":"em"}]},{"text":"' Instance-based attributes available.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ArchiCAD parameter ","type":"text","marks":[{"type":"strong"}]},{"text":"(right-hand side)","type":"text"},{"text":":","type":"text","marks":[{"type":"strong"}]},{"text":" This is a list of all the available ArchiCAD parameters which you can synchronize data to / from that are not already in the current configuration. This list will be based on either the ","type":"text"},{"text":"Library Part","type":"text","marks":[{"type":"em"}]},{"text":" of the currently selected ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":", or only the common parameters (if multiple-selected Objects have different sets of parameters), or the default ","type":"text"},{"text":"Library Part","type":"text","marks":[{"type":"em"}]},{"text":" (if there are no ","type":"text"},{"text":"Objects","type":"text","marks":[{"type":"em"}]},{"text":" selected).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If any of the attributes or parameters are in grey tone, it means that it is a read-only attribute / parameter, and therefore you can only synchronize data ","type":"text"},{"text":"from","type":"text","marks":[{"type":"strong"}]},{"text":" this attribute / parameter and not ","type":"text"},{"text":"to","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"'Linked Attributes' Section:","type":"text"}]},{"type":"paragraph","content":[{"text":"Select a Key Attribute to be used for matching:","type":"text","marks":[{"type":"strong"}]},{"text":" S","type":"text","marks":[{"type":"em"}]},{"text":"elect a dRofus Attribute and an ArchiCAD Parameter, then click on \"Link ==\". Every configuration is required to have only one mapping as the ","type":"text"},{"text":"Key attribute used for comparing","type":"text","marks":[{"type":"em"}]},{"text":". For Item Occurrence configurations, it is recommended that the dRofus ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"em"}]},{"text":" is used as the ","type":"text"},{"text":"Key attribute used for comparing","type":"text","marks":[{"type":"em"}]},{"text":" as it is guaranteed to be unique (at least within dRofus) so it will be easy to spot deviations in Item Occurrences if changes happen in either ArchiCAD or dRofus. When linking ","type":"text"},{"text":"Object Instances","type":"text","marks":[{"type":"em"}]},{"text":" to ","type":"text"},{"text":"Item Occurrences","type":"text","marks":[{"type":"em"}]},{"text":", the key value is read from dRofus and then written in to ArchiCAD (unless the ArchiCAD parameter is read-only or the dRofus parameter is empty - in which case the key value is read from ArchiCAD and then written in to dRofus). The following is an example of an ","type":"text"},{"text":"Object <-> Item Occurrence Configuration","type":"text","marks":[{"type":"em"}]},{"text":" where the","type":"text"},{"text":" ID","type":"text","marks":[{"type":"em"}]},{"text":" is used as the key, and the values against the ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"em"}]},{"text":" attribute in dRofus gets injected in to a parameter called ","type":"text"},{"text":"A","type":"text","marks":[{"type":"em"}]},{"text":" under ","type":"text"},{"text":"Object","type":"text","marks":[{"type":"em"}]},{"text":" in ArchiCAD, after which the link between the dRofus ","type":"text"},{"text":"Item Occurrences","type":"text","marks":[{"type":"em"}]},{"text":" and ArchiCAD ","type":"text"},{"text":"Object Instances","type":"text","marks":[{"type":"em"}]},{"text":" will then be maintained:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":935,"id":"b23fde0c-0262-47a0-acaa-bf2e47c2de37","collection":"contentId-1346374848","type":"file","height":672}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Write data to Model:","type":"text","marks":[{"type":"strong"}]},{"text":" Select a dRofus attribute, then select an ArchiCAD parameter and then click on \"Link -->\". Next time the configuration is used for linking or synchronizing, the data flow direction will be from dRofus to ArchiCAD - i.e., values from the ","type":"text"},{"text":"Item Occurrences","type":"text","marks":[{"type":"em"}]},{"text":"' selected dRofus attribute will be written in to the ","type":"text"},{"text":"Object Instances","type":"text","marks":[{"type":"em"}]},{"text":"' selected ArchiCAD parameter.","type":"text"}]},{"type":"paragraph","content":[{"text":"Write data to dRofus:","type":"text","marks":[{"type":"strong"}]},{"text":" Select a dRofus Attribute, then select an ArchiCAD parameter and then click on \"Link <--\". Next time the configuration is used for linking or synchronizing, the data flow direction will be from ArchiCAD to dRofus - i.e., values from the ","type":"text"},{"text":"Object Instances","type":"text","marks":[{"type":"em"}]},{"text":"' selected ArchiCAD parameter will be written in to the ","type":"text"},{"text":"Item Occurrences","type":"text","marks":[{"type":"em"}]},{"text":"' selected dRofus attribute. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Unlink: ","type":"text","marks":[{"type":"strong"}]},{"text":"Select an existing mapping within the list of linked attributes / parameters and then click on \"Unlink\".","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported