From 8d791a61195f1954cab41bd75b8c1bf07bc3e16a Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Tue, 29 Mar 2022 14:08:41 +0000 Subject: [PATCH] --- docs/8.0/ayanova/docs/adm-import-unit.md | 143 +++++++++++++++++++++++ docs/8.0/ayanova/docs/adm-import.md | 1 + 2 files changed, 144 insertions(+) create mode 100644 docs/8.0/ayanova/docs/adm-import-unit.md diff --git a/docs/8.0/ayanova/docs/adm-import-unit.md b/docs/8.0/ayanova/docs/adm-import-unit.md new file mode 100644 index 00000000..fcc059c0 --- /dev/null +++ b/docs/8.0/ayanova/docs/adm-import-unit.md @@ -0,0 +1,143 @@ +# Part import / update specifications + +Names of fields listed here are the exact case and spelling required to be recognized by AyaNova for [importing / updating](adm-import.md). + +Any field in the import file that is not listed on this page will be removed before sending to the server for import. + +## Required fields + +- Name + +## Key field used to match to existing records + +- Name + +## Fields directly importable / updateable + +- Name (import only) +- Active +- Description +- Notes +- Wiki +- Tags +- ManufacturerNumber +- WholeSalerNumber +- AlternativeWholeSalerNumber +- Cost +- Retail +- UnitOfMeasure +- UPC +- PartSerialsViz (update will overwrite *all* existing serial numbers if this field is included) + +## Linked object fields + +The following linked objects are importable / updateable: + +- Manufacturer via "ManufacturerViz" field which must contain the name of an existing Vendor +- Wholesaler via "WholeSalerViz" field which must contain the name of an existing Vendor +- Alternative wholesaler via "AlternativeWholeSalerViz" field which must contain the name of an existing Vendor + +## JSON file format + +The .json file must contain an array of one or more Part objects. + +The first Part record here illustrates importing a Part with links to existing Manufacturer, Wholesaler and Alternative Wholesaler and also how to include serial numbers. + +```JSON +[ + { + "Name": "048902", + "Active": true, + "Description": "test description", + "Notes": "Alias nihil beatae dolores quam quisquam molestiae repudiandae magni consequatur dolores inventore distinctio.", + "Wiki": "# Headings\n# Heading 1st level\n## Heading 2nd level\n### Heading 3rd level\n#### Heading 4th level\n##### Heading 5th level\n###### Heading 6th level", + "Tags": [ + "orange", + "zebra", + "zone2", + "zone4", + "zone5" + ], + "ManufacturerViz": "Yellow Cedar Consulting", + "ManufacturerNumber": "man-048902", + "WholeSalerViz": "Ruecker - Jakubowski", + "WholeSalerNumber": "ws-048902", + "AlternativeWholeSalerViz": "Considine Group", + "AlternativeWholeSalerNumber": "aws-048902", + "Cost": 15.200000000000000000, + "Retail": 18.240000000000000000, + "UnitOfMeasure": "each", + "UPC": "4058773855392", + "PartSerialsViz": "387992910, 387992911, 387992912" + }, + { + "Name": "097091", + "Active": true, + "Description": null, + "Notes": "Vel sit id quia provident cum et quaerat.", + "Wiki": null, + "Tags": [ + "black", + "purple", + "silver", + "violet", + "zebra" + ], + "ManufacturerViz": "Littel Group", + "ManufacturerNumber": "man-097091", + "WholeSalerViz": "Ruecker - Jakubowski", + "WholeSalerNumber": "ws-097091", + "AlternativeWholeSalerViz": "Jakubowski, Hoeger and Hauck", + "AlternativeWholeSalerNumber": "aws-097091", + "Cost": 18.060000000000000000, + "Retail": 21.670000000000000000, + "UnitOfMeasure": "each", + "UPC": "2820615657752", + "PartSerialsViz": "" + }, + { + "Name": "198660", + "Active": true, + "Description": null, + "Notes": "Fuga quaerat neque quasi ut inventore explicabo velit explicabo delectus.", + "Wiki": null, + "Tags": [ + "jade", + "zone5", + "zone8", + "zone9" + ], + "ManufacturerViz": "Yellow Cedar Consulting", + "ManufacturerNumber": "man-198660", + "WholeSalerViz": "Weimann Group", + "WholeSalerNumber": "ws-198660", + "AlternativeWholeSalerViz": "Considine Group", + "AlternativeWholeSalerNumber": "aws-198660", + "Cost": 13.740000000000000000, + "Retail": 16.490000000000000000, + "UnitOfMeasure": "each", + "UPC": "5708648426804", + "PartSerialsViz": "" + } + +] +``` + +## CSV file format + +The first row of the .csv file must contain column headers that match the field names listed above. + +The first Part record here illustrates importing a Part with links to existing Manufacturer, Wholesaler and Alternative Wholesaler and also how to include serial numbers. + +``` +Name,Active,Description,Notes,Wiki,Tags,ManufacturerViz,ManufacturerNumber,WholeSalerViz,WholeSalerNumber,AlternativeWholeSalerViz,AlternativeWholeSalerNumber,Cost,Retail,UnitOfMeasure,UPC,PartSerialsViz +048902,true,test description,Alias nihil beatae dolores quam quisquam molestiae repudiandae magni consequatur dolores inventore distinctio.,"# Headings +# Heading 1st level +## Heading 2nd level +### Heading 3rd level +#### Heading 4th level +##### Heading 5th level +###### Heading 6th level","orange,zebra,zone2,zone4,zone5",Yellow Cedar Consulting,man-048902,Ruecker - Jakubowski,ws-048902,Considine Group,aws-048902,15.2,18.24,each,4058773855392,"387992910, 387992911, 387992912" +097091,true,,Vel sit id quia provident cum et quaerat.,,"black,purple,silver,violet,zebra",Littel Group,man-097091,Ruecker - Jakubowski,ws-097091,"Jakubowski, Hoeger and Hauck",aws-097091,18.06,21.67,each,2820615657752, +198660,true,,Fuga quaerat neque quasi ut inventore explicabo velit explicabo delectus.,,"jade,zone5,zone8,zone9",Yellow Cedar Consulting,man-198660,Weimann Group,ws-198660,Considine Group,aws-198660,13.74,16.49,each,5708648426804, +``` diff --git a/docs/8.0/ayanova/docs/adm-import.md b/docs/8.0/ayanova/docs/adm-import.md index 2cf089e3..da549382 100644 --- a/docs/8.0/ayanova/docs/adm-import.md +++ b/docs/8.0/ayanova/docs/adm-import.md @@ -177,6 +177,7 @@ Each object type listed below links to a page showing the specific format requir - ##### [Service rates](adm-import-service-rate.md) - ##### [Task group](adm-import-task-group.md) - ##### [Travel rates](adm-import-travel-rate.md) +- ##### [Units](adm-import-unit.md) ## Import form