Create and update a furniture

Use enrolui to create your furnitures.

But you can use Inventory API calls to do same operation.
Ask Centiloc support for more informations!

Having one or more centiloc CADS.

Having an account with editor rights at least.

1. Go to furniture page

Follow first steps to connect to enrolui and navigate to the furniture page by clicking on the Furniture box.

Once you are on the Furniture page you can click the Create new button.

fur_create_new

2. Create a furniture

To create a furniture, you need to have some notions about yaml.
The creation of a shelf is made through a yaml file containing all the informations.

2.1. Create the YAML file

This is the structure of the .yaml file:

furniture:
    sn: "fursn"
    shelves:
        - sn: "shelsn"
          floor: 1 
          dimensions_mm: [500, 200]                 
          offsets_mm: [0, 0, 0]                 
          rot_angles_degree: [0.0, 0.0, 0.0]    
          boards:
            - sn: "boardsn"
              offsets_mm: [0, 0] 
              z_rot_angle: 0.0
          locations:
            - ref: "locref"
              weight:  1                        
              dimensions_mm: [100, 100]
              origin_coord: [50, 20]

Please have in mind this picture about concepts here.

The fields are described below:

sn the serial number of your furniture. This is how you will identify it. The serial number must be unique.
shelves ist a list of shelves inside the furniture.
- sn the serial number of your shelf. This is how you will identify it. The serial number must be unique.
- floor indicates the floor on which the shelf is inside a furniture. Default value is 1.
- dimensions_mm are the dimensions in mm of your shelf on X axis and Y axis.
- offsets_mm are relevant only if the shelf is in a furniture. The offsets are on three axis (X, Y and Z) and represent offsets from the furniture reference frame. More about offsets in the details.
- rot_angles_degree are relevant only if the shelf is in a furniture. The rotations angles are on three axis (X, Y and Z) and are used if your shelf isn’t on the same surface as your furniture. More about rotation angles in the details.
- boards is a list of boards inside the shelf.
  - sn the serial number of the board in the shelf. You can find the serial number on centui.
  - offsets_mm the offset of the board within the shelf. More about offsets in the details.
  - z_rot_angle the rotation of the board within the shelf. More about rotations in the details.
- locations (optional) is a list of locations present on the shelf.
  - ref the reference of your location. This is how you will identify it. The reference must be unique.
  - weight the layer of the location. If you have few locations, the weight can be set to 1. More about it in the details.
  - dimensions_mm the dimensions of the location on the shelf. More about it in the details.
  - origin_coord the origin coordinates of the location on the shelf. More about it in the details.

If the location does not exists, it will be automatically created.
If the shelf does not exists, it will be automatically created.

If the shelf exists, it will be updated with the new value from your yaml.

2.2. Upload the YAML file to enrolui

Click on the YAML tab.
Click on the Upload icon.
Verify the content of your .yml file.

fur_create

Click on Submit and then close the popup. You can now see the furniture in the table.

3. Update a furniture

To update a furniture, repeat the steps above.
The update process is the exact same as the create process.

Be mindful when updating a furniture, all the fields will be overwritten. Even the shelf will be overwritten!
This is why you should always keep a version of your .yml file to make sure to modify only the fields you need to modify.

Contact Centiloc support to help you with that if you need help.