--- alias: user-guide-create-container description: "Create a container object, defining its properties and selecting relevant options for management" --- # Create Container :lock: Container.**Create** :lock: Container.**CreateTemplate** :lock: Container.**CreateFromTemplate** ## Overview This operation is used to create a **Container**. A template can also be created using a similar procedure and there is also the possibility of using a template to create the new object as well. This selection can be done in the main entity menu. ## Setup No specific setup is required other than to meet the preconditions of the transaction. ## Preconditions * The name of the **Container** must be unique. * The **Container** cannot be created for a remote **Facility**. * If the **Container** is contained by another **Container**, the type cannot be changed. * If the **Container** is associated with a **Resource** with the Position Unit Type equal to Container, and the Container Type defined, the Container Type cannot be changed. * When changing the properties Position Unit Type or Allow Mixed Types, the Used Positions must be zero, that is, the **Container** must be empty (without **Materials** or **Containers**). ## Step 1: General Data 1. Provide a Name. 2. Optionally, provide a Description. 3. Select the Type. The list of possible values is taken from the lookup table `ContainerType`. 4. The System State defaults to Available. 5. Optionally, select the Data Group. !!! note For more information, see [Data Groups](../../administration/security/data_groups.md). 6. Select the Facility in which the **Container** will be created. 7. Optionally, select the Vendor. The list of possible values is taken from the lookup table `ContainerVendor`. 8. Optionally, enter the Vendor ID. 9. Select the Position Unit Type: * **Material** - the **Container** contains Materials. * **Container** - the **Container** contains Containers. * **Resource** - the **Container** contains Resources. 10. Specify whether the Positions are Auto Generated or not (auto generated positions are managed automatically by the system). 11. Specify the Total Positions or use Unlimited to specify that the **Container** has infinite positions. In this case the **Container** must have the Auto Generated option set to `True`. 12. If the Position Unit Type is **Material**: * Select the Capacity Validation Mode from the three available options: * Form - you will also need to specify the Capacity Form (from the lookup table `MaterialForm`). * Units - you will also need to specify the Capacity Unit (from the lookup table `Units`) and the Capacity per Position. * None. 13. If the Position Unit Type is **Container** or **Resource**: * Specify the Allow Mixed Types option (defaults to `True`) - this allows different entity types to be placed in the same **Container**. 14. Specify the Orientation of the **Container**: * Bottom To Top * Left To Right * None * Right To Left * Top To Bottom 15. Specify Position Sorting: * Ascending * Descending !!! note When associating an entity to a new **Container**, if the positions are automatically managed by the system, the Position Sorting value will determine the position of the entities in the **Container**. 16. Select **Create** to complete the operation. !!! info If a **Name Generator** is defined, it is not necessary to supply a name for the **Container**. ![create_container][create_container] [create_container]: images/create_container.png