mirror of
https://github.com/inventree/InvenTree.git
synced 2025-12-16 17:28:11 +00:00
Docs updates
This commit is contained in:
BIN
docs/docs/assets/images/concepts/attachments-tab.png
Normal file
BIN
docs/docs/assets/images/concepts/attachments-tab.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 35 KiB |
BIN
docs/docs/assets/images/concepts/parameter-tab.png
Normal file
BIN
docs/docs/assets/images/concepts/parameter-tab.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 49 KiB |
BIN
docs/docs/assets/images/concepts/parameter-template.png
Normal file
BIN
docs/docs/assets/images/concepts/parameter-template.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 23 KiB |
BIN
docs/docs/assets/images/concepts/parametric-parts.png
Normal file
BIN
docs/docs/assets/images/concepts/parametric-parts.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 44 KiB |
18
docs/docs/concepts/attachments.md
Normal file
18
docs/docs/concepts/attachments.md
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
---
|
||||||
|
title: Attachments
|
||||||
|
---
|
||||||
|
|
||||||
|
## Attachments
|
||||||
|
|
||||||
|
An *attachment* is a file which has been uploaded and linked to a specific object within InvenTree. Attachments can be used to store additional documentation, images, or other relevant files associated with various InvenTree models.
|
||||||
|
|
||||||
|
!!! note "Business Logic"
|
||||||
|
Attachments are not used for any core business logic within InvenTree. They are intended to provide additional metadata for objects, which can be useful for documentation, reference, or reporting purposes.
|
||||||
|
|
||||||
|
Parameters can be associated with various InvenTree models.
|
||||||
|
|
||||||
|
### Attachments Tab
|
||||||
|
|
||||||
|
Any model which supports attachments will have an "Attachments" tab on its detail page. This tab displays all attachments associated with that object:
|
||||||
|
|
||||||
|
{{ image("concepts/attachment-tab.png", "Order Attachments Example") }}
|
||||||
@@ -1,17 +1,21 @@
|
|||||||
---
|
---
|
||||||
title: Part Parameters
|
title: Parameters
|
||||||
---
|
---
|
||||||
|
|
||||||
## Part Parameters
|
## Parameters
|
||||||
|
|
||||||
A part *parameter* describes a particular "attribute" or "property" of a specific part.
|
A *parameter* describes a particular "attribute" or "property" of a specific object in InvenTree. Parameters allow for flexible and customizable data to be stored against various InvenTree models.
|
||||||
|
|
||||||
Part parameters are located in the "Parameters" tab, on each part detail page.
|
!!! note "Business Logic"
|
||||||
There is no limit for the number of part parameters and they are fully customizable through the use of [parameter templates](#parameter-templates).
|
Parameters are not used for any core business logic within InvenTree. They are intended to provide additional metadata for objects, which can be useful for documentation, filtering, or reporting purposes.
|
||||||
|
|
||||||
Here is an example of parameters for a capacitor:
|
Parameters can be associated with various InvenTree models.
|
||||||
|
|
||||||
{{ image("part/part_parameters_example.png", "Part Parameters Example") }}
|
### Parameter Tab
|
||||||
|
|
||||||
|
Any model which supports parameters will have a "Parameters" tab on its detail page. This tab displays all parameters associated with that object:
|
||||||
|
|
||||||
|
{{ image("concepts/parameter-tab.png", "Part Parameters Example") }}
|
||||||
|
|
||||||
## Parameter Templates
|
## Parameter Templates
|
||||||
|
|
||||||
@@ -22,13 +26,16 @@ Parameter templates are used to define the different types of parameters which a
|
|||||||
| Name | The name of the parameter template (*must be unique*) |
|
| Name | The name of the parameter template (*must be unique*) |
|
||||||
| Description | Optional description for the template |
|
| Description | Optional description for the template |
|
||||||
| Units | Optional units field (*must be a valid [physical unit](#parameter-units)*) |
|
| Units | Optional units field (*must be a valid [physical unit](#parameter-units)*) |
|
||||||
|
| Model Type | The InvenTree model to which this parameter template applies (e.g. Part, Company, etc). If this is left blank, the template can be used for any model type. |
|
||||||
| Choices | A comma-separated list of valid choices for parameter values linked to this template. |
|
| Choices | A comma-separated list of valid choices for parameter values linked to this template. |
|
||||||
| Checkbox | If set, parameters linked to this template can only be assigned values *true* or *false* |
|
| Checkbox | If set, parameters linked to this template can only be assigned values *true* or *false* |
|
||||||
| Selection List | If set, parameters linked to this template can only be assigned values from the linked [selection list](#selection-lists) |
|
| Selection List | If set, parameters linked to this template can only be assigned values from the linked [selection list](#selection-lists) |
|
||||||
|
|
||||||
|
{{ image("concepts/parameter-template.png", "Parameters Template") }}
|
||||||
|
|
||||||
### Create Template
|
### Create Template
|
||||||
|
|
||||||
Parameter templates are created and edited via the [settings interface](../settings/global.md).
|
Parameter templates are created and edited via the [admin interface](../settings/admin.md).
|
||||||
|
|
||||||
To create a template:
|
To create a template:
|
||||||
|
|
||||||
@@ -54,11 +61,11 @@ Select the parameter `Template` you would like to use for this parameter, fill-o
|
|||||||
|
|
||||||
## Parametric Tables
|
## Parametric Tables
|
||||||
|
|
||||||
Parametric tables gather all parameters from all parts inside a particular [part category](./index.md#part-category) to be sorted and filtered.
|
Parametric tables gather all parameters from all objects of a particular type, to be sorted and filtered.
|
||||||
|
|
||||||
To access a category's parametric table, click on the "Parameters" tab within the category view:
|
Tables views which support parametric filtering and sorting will have a "Parametric View" button above the table:
|
||||||
|
|
||||||
{{ image("part/parametric_table_tab.png", "Parametric Table Tab") }}
|
{{ image("common/parametric-parts.png", "Parametric Parts Table") }}
|
||||||
|
|
||||||
### Sorting by Parameter Value
|
### Sorting by Parameter Value
|
||||||
|
|
||||||
@@ -139,7 +146,7 @@ Parameter sorting takes unit conversion into account, meaning that values provid
|
|||||||
|
|
||||||
### Selection Lists
|
### Selection Lists
|
||||||
|
|
||||||
Selection Lists can be used to add a large number of predefined values to a parameter template. This can be useful for parameters which must be selected from a large predefined list of values (e.g. a list of standardised colo codes). Choices on templates are limited to 5000 characters, selection lists can be used to overcome this limitation.
|
Selection Lists can be used to add a large number of predefined values to a parameter template. This can be useful for parameters which must be selected from a large predefined list of values (e.g. a list of standardized color codes). Choices on templates are limited to 5000 characters, selection lists can be used to overcome this limitation.
|
||||||
|
|
||||||
It is possible that plugins lock selection lists to ensure a known state.
|
It is possible that plugins lock selection lists to ensure a known state.
|
||||||
|
|
||||||
@@ -96,6 +96,8 @@ nav:
|
|||||||
- Custom States: concepts/custom_states.md
|
- Custom States: concepts/custom_states.md
|
||||||
- Pricing: concepts/pricing.md
|
- Pricing: concepts/pricing.md
|
||||||
- Project Codes: concepts/project_codes.md
|
- Project Codes: concepts/project_codes.md
|
||||||
|
- Attachments: concepts/attachments.md
|
||||||
|
- Parameters: concepts/parameters.md
|
||||||
- Barcodes:
|
- Barcodes:
|
||||||
- Barcode Support: barcodes/index.md
|
- Barcode Support: barcodes/index.md
|
||||||
- Internal Barcodes: barcodes/internal.md
|
- Internal Barcodes: barcodes/internal.md
|
||||||
@@ -125,7 +127,6 @@ nav:
|
|||||||
- Virtual Parts: part/virtual.md
|
- Virtual Parts: part/virtual.md
|
||||||
- Part Views: part/views.md
|
- Part Views: part/views.md
|
||||||
- Tracking: part/trackable.md
|
- Tracking: part/trackable.md
|
||||||
- Parameters: part/parameter.md
|
|
||||||
- Revisions: part/revision.md
|
- Revisions: part/revision.md
|
||||||
- Templates: part/template.md
|
- Templates: part/template.md
|
||||||
- Tests: part/test.md
|
- Tests: part/test.md
|
||||||
|
|||||||
Reference in New Issue
Block a user