Families

Families tool is used to integrate Revit Families and types with IBM® Maximo® Real Estate and Facilities Specifications. The tool can either link a Family or Type to an existing Specification, or it can create a new Specification.

The following table explains fields in the form.

Field	Function
Link to Existing	Links a Revit Family or Type to an existing Maximo Real Estate and Facilities Specification. When Family or Type is selected, the target specification can be chosen in the Link to Existing tab. Clicking the Add button completes the link.
Create New	Creates a new Specification. You can select the Family or Type as the source for the new specification and select a Specification Class to which it is linked. Note: Requests to link and create Specifications are displayed in the Families to Integrate table. They are processed when the form is accepted.
Revit Families and Type	This tree shows all the Revit Categories supported by the Connector, and all the Families and Types in the model belonging to those categories. Select either a Family or a Type. Categories cannot be integrated. When types are used, they are removed from this tree. When Families are used, they remain in the tree, but are grayed out and cannot be used again.
Maximo Real Estate and Facilities Specification – Link Existing:	This table lists all the Specifications on the Maximo Real Estate and Facilities server organized by specification type. Only Building Equipment Specifications are preloaded. To load other specification types, either expand the header in this table, or select the specification type on the Create New tab.
Maximo Real Estate and Facilities Specification – Create New:	A new specification requires a specification type and class to be specified: Specification Type: The combo box has a list of all specialization types supported by the Connector. Selecting a specification type filters the Specification Class tree for classifications valid for the selected type. If the list of Specifications of the selected type has not yet been retrieved from the Maximo Real Estate and Facilities server, it triggers the loading of the list. Specification Class: Maximo Real Estate and Facilities Specification Classes valid for the selected specification type.
Add	Moves the selected element from the Revit Families and Types tree and either the selected Specification, or the selected Specification Type/Class combo to the Families to Integrate table. The new entry has an Action of either To Be Linked or New. Types are removed from the tree; Families are grayed out. Specifications are removed from the table.
Families to Integrate	This section shows both existing integrations and integrations that will be created when the form is processed. Name: Name of the Revit Family or Type. Action: Describes either the action that will be performed when the form is accepted or the current state of the link. The following actions are there: New: A new Specification of the indicated type will be created from the indicated category. To Be Linked: An Integration record will be created to link the model and the indicated Family or Type to the indicated specification. Linked: An integration record owned by this model exists that links the indicated Family or Type to the Indicated Specification. To Be Unlinked: An integration record owned by this model exists that links the indicated Family or Type to the Indicated Specification. The integration record will be deleted and the family or type will be marked as not linked. Matched: An integration record owned by some other model exists that links the indicated Family or Type to the Indicated Specification. Not Matched: The Indicated Family or Type is marked as integrated, but no integration record was found on the server. The Family or Type will be marked as not integrated. Not Loaded: The indicated Family or Type is marked as integrated with a specification of the indicated type, but specifications of that type have not yet been loaded so the Family or Type has not been matched to an integration record. When the indicated type of specifications is loaded, the record will become Linked, Matched, or Not Matched. If the form is processed without loading the specifications, then no action is taken on the item. Specification: The name of the Maximo Real Estate and Facilities Specification, New if the row is a request to create a new Specification, or Blank if the list of Specifications for the Specification type associated with the row are not yet loaded. Specification Class: The Maximo Real Estate and Facilities Specification class for the associated Specifications, or if New, that will be used when the Specification is created. Specification Type: The Type of Specification used in the link, for example, Building Equipment. The Specification type is stored with the Family or Type when the integration is created.
Remove	Active if a selected row has the New, or To Be Linked action. Removes the row from the table and cancels the action.
Unlink	Active if a selected row has the Link action. Changes the Link action to the To Be Unlinked action.
Link	Active if a selected row has the To Be Unlinked action. Changes the action to Linked and cancels the request to unlink the specification.

Note:

Unlike other model elements, integrated specifications are not associated with a Maximo Real Estate and Facilities building, and can be shared across many models. This can happen in either of the following ways:

The same family or type exists in two or more models. Because the model file was copied, or because the same Family is loaded into each file. In this case, there is a single triBIMType link record.
Multiple models link to the same Specification. In this case, there are many triBIMType link records all associated with the same Specification.

Validate: When the form is opened, the following validations are performed on the list of Revit Components:

All Types have a value in their IBM.Name parameter.
There are no duplicate values for the IBM.Name parameter in the list of Types.
The value of the IBM.Name parameter for all Types does not exceed 100 characters.