This commit is contained in:
2022-03-29 15:49:15 +00:00
parent 3bbf4cddd4
commit 97fe8a4a50

View File

@@ -0,0 +1,166 @@
# Vendor 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
- Notes
- Wiki
- Tags
- Contact
- ContactNotes
- AlertNotes
- WebAddress
- AccountNumber
- Phone1
- Phone2
- Phone3
- Phone4
- Phone5
- EmailAddress
- PostAddress
- PostCity
- PostRegion
- PostCountry
- PostCode
- Address
- City
- Region
- Country
- Latitude
- Longitude
## JSON file format
The .json file must contain an array of one or more Vendor objects.
The first Vendor record here illustrates importing a Vendor with a link to an existing Contract.
```JSON
[
{
"Name": "Abbott Group",
"Active": true,
"Notes": "Reverse-engineered tertiary analyzer",
"Wiki": null,
"Tags": [
"green",
"shipper",
"zone7"
],
"Contact": "Madisyn Swift",
"ContactNotes": "Dylan Little",
"AlertNotes": null,
"WebAddress": "http://example.name",
"AccountNumber": "80939916",
"Phone1": "1-954-587-1815 x68654",
"Phone2": "1-987-686-7749 x88377",
"Phone3": "(404) 852-9105 x0113",
"Phone4": null,
"Phone5": null,
"EmailAddress": "Verna.Toy@example.net",
"PostAddress": null,
"PostCity": null,
"PostRegion": null,
"PostCountry": null,
"PostCode": null,
"Address": "62774 Stracke Canyon",
"City": "Predovicfurt",
"Region": "Wyoming",
"Country": "American Samoa",
"Latitude": 45.031800,
"Longitude": 162.748800
},
{
"Name": "Balistreri, Terry and Wintheiser",
"Active": true,
"Notes": "Reverse-engineered upward-trending help-desk",
"Wiki": null,
"Tags": [
"contractor",
"indigo",
"xanthic",
"zone5"
],
"Contact": "Eugenia Nicolas",
"ContactNotes": "Claudie Schowalter",
"AlertNotes": null,
"WebAddress": "https://example.net",
"AccountNumber": "92034811",
"Phone1": "1-448-854-6536 x01928",
"Phone2": "837.349.5867",
"Phone3": "208.603.8905 x11661",
"Phone4": null,
"Phone5": null,
"EmailAddress": "Kitty40@example.com",
"PostAddress": null,
"PostCity": null,
"PostRegion": null,
"PostCountry": null,
"PostCode": null,
"Address": "9562 Leuschke Curve",
"City": "Lake Elyse",
"Region": "Wisconsin",
"Country": "Honduras",
"Latitude": -37.742000,
"Longitude": 30.400100
},
{
"Name": "Bernhard Group",
"Active": true,
"Notes": "Sharable executive local area network",
"Wiki": null,
"Tags": [
"factory",
"gold"
],
"Contact": "Evalyn Cremin",
"ContactNotes": "Reid Krajcik",
"AlertNotes": null,
"WebAddress": "http://example.com",
"AccountNumber": "71971967",
"Phone1": "260.368.5741",
"Phone2": "1-508-923-4635",
"Phone3": "(756) 896-6012 x731",
"Phone4": null,
"Phone5": null,
"EmailAddress": "Rowena_Wilderman69@example.org",
"PostAddress": null,
"PostCity": null,
"PostRegion": null,
"PostCountry": null,
"PostCode": null,
"Address": "05524 Johns Courts",
"City": "Cruickshankbury",
"Region": "Maine",
"Country": "Cocos (Keeling) Islands",
"Latitude": -28.537600,
"Longitude": -170.722300
}
]
```
## CSV file format
The first row of the .csv file must contain column headers that match the field names listed above.
The first Vendor record here illustrates importing a Vendor with a link to an existing Contract.
```
Name,Active,Notes,Wiki,Tags,WebAddress,AccountNumber,ContractViz,ContractExpires,Phone1,Phone2,Phone3,Phone4,Phone5,EmailAddress,PostAddress,PostCity,PostRegion,PostCountry,PostCode,Address,City,Region,Country,Latitude,Longitude
Goodwin LLC,true,Triple-buffered mission-critical website,,"jade,zone5,zone7",http://example.info,32906249,Bronze,2023-02-01T08:00:00Z,1-629-420-0186,1-807-405-5544 x2470,352-364-6323 x45752,,,Heloise_Farrell61@example.com,865 Tracey Views,New Mathew,Louisiana,Jordan,74354-4982,3400 Tyree Keys,New Mathew,Louisiana,Jordan,-56.0307,169.8444
Bahringer - Stark,true,Enhanced reciprocal matrix,,"green,red,zone8",http://example.name,71115129,,,530.785.2024 x019,418-629-2283 x34011,347.447.3645,,,Alysa.Mertz@example.org,0511 Deckow Stream,Lake Cotyhaven,Nevada,Comoros,41680,2438 Sibyl Neck,Lake Cotyhaven,Nevada,Comoros,-51.7065,-22.0443
"Beer, Armstrong and Wiegand",true,Compatible clear-thinking concept,,"zone3,zone9",https://example.org,95120864,,,986-530-1111,1-695-482-1199 x321,653-466-6627 x117,,,Elisa41@example.org,15461 Deangelo Tunnel,Kuvalisland,Florida,Sri Lanka,15255-8577,4695 Sandra Tunnel,Kuvalisland,Florida,Sri Lanka,-19.4391,-112.5888
```