items:adding_a_new_item

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
items:adding_a_new_item [2023/05/09 14:37] – [Cross reference item tab] Gary Willettsitems:adding_a_new_item [2024/11/08 13:27] (current) – [Normal items] Gary Willetts
Line 24: Line 24:
 These 3 fields are available to be filled in for every type of item. These 3 fields are available to be filled in for every type of item.
  
-You should decide on a clear scheme for item names and codes. This can be a tricky process but is worth persevering with. You can change your mind later but changing the codes of all the items and names in your datafile could be a time-consuming business.+**Universal code:** This read-only field shows the item's universal code as supplied by The mSupply Foundation's unversal code server at [[https://universalcodes.msupply.org.nz/]]. Use the button next to the field to search for this item's universal code. See the [[items:item_basics:tab_general#universal_code|4.01.01. Items - General tab]] page for more details. The universal code is useful for identifying the item across multiple systems. 
 + 
 +You should decide on a clear scheme for item names and codes. This can be a tricky process but is worth persevering with. You can change your mind later but changing the codes of all the items and names in your datafile could be a time-consuming business - but note you can speed this up hugely by exporting all the items then reimporting them with their new codes. See the [[import_and_export:importing_items|]] page for details.
  
 We would recommend that the item code is systematic and can be worked out from the item's details e.g. first 3 letters of the item's name, 3 figures for the strength, a letter for the formulation then a letter or number for disambiguation if necessary. We would recommend that the item code is systematic and can be worked out from the item's details e.g. first 3 letters of the item's name, 3 figures for the strength, a letter for the formulation then a letter or number for disambiguation if necessary.
Line 118: Line 120:
 That's it, all done. After clicking the **OK** or **OK & Next** buttons, every time a user chooses the item you entered in the **Item name** / **Item code** fields it will be replaced with the item you entered in the **When this item is chosen in a list, use** field. That's it, all done. After clicking the **OK** or **OK & Next** buttons, every time a user chooses the item you entered in the **Item name** / **Item code** fields it will be replaced with the item you entered in the **When this item is chosen in a list, use** field.
  
-Note: Item custom field 5 is also settable, as shown in the screenshot. This is the user_field_5 for the cross reference item (brand/familiar name), not the . +**Note:** Item custom field 5 is also settable, as shown in the screenshot. It is a number field. This is the user_field_5 for the **cross reference item** (brand/familiar name), not the normal item. The //user_field_5// label shown in the screenshot will be replaced with the name assigned to the field in the preferences (see the [[preferences:general#misc_tab|16.01. General preferences]] page for details) if it has been set. Making this field settable here might seem strange but it is used in some customisations!
-==== Stores tab ==== +
-You select the stores the cross reference item will be visible in on this tab. It operates exactly the same as the Stores tab described [[items:adding_a_new_item#stores_tab|above]] for normal items.+
  
-Note: cross reference items cannot be added to master lists so there is no Master lists tab. Their visibility cannot therefore be controlled by master lists but only by directly selecting the stores they are visible in on this stores tab.+The visibility of cross reference items in different stores matches the visibility of the normal item it is linked to. So there is no functionality for manually setting the visibility of cross reference items.
  
 ===== Service items ===== ===== Service items =====
  • Last modified: 2023/05/09 14:37
  • by Gary Willetts