Transform
What is a transform event?
A Transform event describes an activity that irreversibly changes a product, transforming it into a new, traceable output product with a new Primary ID (i.e. a new serial number or lot number). It could be that raw materials are combined, cut or melted to make a new product, or that a product is packaged for consumption. No matter the type of transformation, Wholechain makes sure you'll have visibility into the inputs and outputs that comprise each of these real-world events in the traceability journey.
How it works:
- A Wholechain user selects the input item(s) they want to transform from their current inventory, and is prompted to specify details about the output product.
- The user can enter the output product details manually or via CSV upload for multiple items.
- The new product appears in the Current Inventory of that product page.
- Users can also use the "+ product" tab in the event drawer to transform multiple inputs into multiple output products.
Examples:
- At a seafood processor, an input lot of whole sockeye salmon is processed into three distinct production lots of packaged sockeye salmon fillets.
- Traceable harvests from multiple fishing vessels are irreversibly combined into one container of whole sockeye salmon upon landing.
- At a pasta factory, workers mix flour, egg and water input products to create 4 differently-shaped pasta output products.
Notes:
- Each transform event consists of input product(s) and output product(s)
- Transform events allow for the use of templates. You can use a template that a Network Partner has shared with you, or create a custom template in the Templates page.
Transform into a single item manually
One way to log a transform event is to change one or more items into a single output item, in which case it may be simpler to enter the output details manually. The single output item could be a lot with multiple units, but it only represents one line item in your inventory.
- 1
- Navigate to the Products page from Wholechain's left-side menu, and click on the product you'd like to transform.
- 2
- Using the checkboxes to the left of the Current Inventory lines, select the product item(s) you'd like to transform, and click Actions > Transform.
- 3
-
If you wish to transform only part of an inventory item (for example, if you have one item representing an entire lot of 1000 lbs and you only pick 100 lbs of it for this processing event), edit the quantity of input product you'd like to transform. Next, select the output product as well as a Template, either that you've created previously or received from a Company in your Network. The Template will dictate what additional custom data will be collected and written to the blockchain for this event.
-
- 4
- Select the Manual option under Data Entry Method, and manually fill in the fields with the information surrounding the given transformation.
- 5
- Click Log Event. If you've transformed the input into a different product, it will automatically disappear from the input product's Current Inventory and instead appear in the Current Inventory page of the output product. If you've transformed it into the same product with a new traceability unit, you'll see it appear in the same list it started in, with its new attributes.
Note: You can use the same output product as you input into this event if you wish to represent the comingling or shrinkage/quantity change of the same product.
Transform using a CSV upload
Another way to log a Transform event is to upload your output product items using a CSV file. This makes transforming into multiple items much more accurate and efficient. It also makes it simpler to include an unlimited amount of custom data depending on the the Template you select at the point of logging.
- 1
- Navigate to the Products page from Wholechain's left-side menu, and click on the product whose items you wish to transform.
- 2
-
Using the checkboxes to the left of the Current Inventory lines, select the product item(s) you'd like to transform, and click Actions > Transform.
- 3
- If you wish to transform only part of an inventory item (for example, if you have one item representing an entire lot of 1000 lbs and you only pick 100 lbs of it for this processing event), edit the quantity of input product you'd like to transform. Next, select the output product as well as a Template, either that you've created previously or received from a Company in your Network. The Template will dictate what additional custom data will be collected and written to the blockchain for this event.
-
- 4
- Select the CSV Upload option and then click Download CSV Template. A CSV file will automatically download containing column headers such as Primary ID, quantity date and optional identifiers, as well as additional columns that correspond to the fields from the Template you've selected.
- 5
- Fill in the CSV template with all of the requested data, and save the file to your computer.
-
- 6
- Upload the CSV by either dropping the file in the upload field, or clicking Drop Here to Upload. Note that the table is editable, so when the data uploads you can make any changes within the drawer.
-
- 7
- Click Log Event. If you've transformed the input into a different product, it will automatically disappear from the input product's Current Inventory and instead appear in the Current Inventory page of the output product. If you've transformed it into the same product with a new traceability unit, you'll see it appear in the same list it started in, with its new attributes