Working with the Asset Model

Asset models can be created using convenience methods to simplify the process. There are helper methods for commonly used parameters. Additional asset attributes which are supported by the base model, but do not have any helper methods, can be created directly using base.go.

The following methods are available for converting asset model structures:

1. Convert asset structure to a semantic identifier
2. Convert asset structure to JSON

Example: Creating an Asset Structure and Converting to JSON

device, err := NewDevice("Asset", "DummyDevice")
if err != nil{
    // handle error
}

err = device.AddNameplate("Dummy Manufacturer", "http://example.com/idlink", "12345",
    "Dummy Product", "v1.0", "SN123456")
if err != nil{
    // handle error
}
nicID, err := device.AddNic("eth0", "00:1A:2B:3C:4D:5E")
if err != nil{
    // handle error
}
_, err := device.AddIPv4(nicID, "192.168.1.100", "255.255.255.0", "192.168.1.1")
if err != nil{
    // handle error
}
err = device.AddSoftwareArtifactComponent("DummySoftware", "1.0.0", true)
if err != nil{
    // handle error
}
err = device.AddCapabilities("firmware_update", true)
if err != nil{
    // handle error
}

Asset Relations

Use AddAssetRelation() to establish relationships between assets (e.g., module hierarchies, connectivity).

// Add a module relation
err := device.AddAssetRelation(
    "is_module_of",
    model.RelatedAsset{
        AssetIdentifiers: []interface{}{
            model.MacIdentifier{
                AssetIdentifierType: model.MacIdentifierAssetIdentifierTypeMacIdentifier,
                MacAddress:          "AA:BB:CC:DD:EE:FF",
            },
        },
    },
    model.RelationalRoleOfRelatedAssetValuesObject,
    false, // isBidirectional
)
if err != nil {
    // handle error
}

For asset relations, refer to the base schema for validation constraints on predicates and identifier types.