[{"data":1,"prerenderedAt":378},["ShallowReactive",2],{"docs:\u002Fdocs\u002Froster\u002Fimporting-locomotives":3,"docs:nav":265},{"id":4,"title":5,"body":6,"description":254,"draft":255,"extension":256,"meta":257,"navTitle":258,"navigation":259,"order":260,"path":261,"seo":262,"stem":263,"__hash__":264},"docs\u002Fdocs\u002Froster\u002Fimporting-locomotives.md","Importing locomotives",{"type":7,"value":8,"toc":246},"minimark",[9,13,17,22,60,76,103,136,142,149,153,164,185,202,217,222,226,231,235],[10,11,5],"h1",{"id":12},"importing-locomotives",[14,15,16],"p",{},"If you already track your locomotives in a spreadsheet, importing is faster than\nadding them one at a time. Locomotives import separately from cars since they\ncapture different fields: road number and model instead of a car type and home\nlocation.",[18,19,21],"h2",{"id":20},"prepare-your-csv","Prepare your CSV",[23,24,25,46,53],"ol",{},[26,27,28,29,33,34,37,38,41,42,45],"li",{},"Go to ",[30,31,32],"strong",{},"Locomotives",", open the ",[30,35,36],{},"⋮"," menu next to ",[30,39,40],{},"New Locomotive",", and\nselect ",[30,43,44],{},"Import",".",[26,47,48,49,52],{},"Select ",[30,50,51],{},"Download sample CSV"," to get a template with the right column\nheaders.",[26,54,55,56,45],{},"Fill in one row per locomotive, then save it as ",[57,58,59],"code",{},".csv",[14,61,62,65,66,69,70,69,73],{},[30,63,64],{},"Required columns:"," ",[57,67,68],{},"RoadName",", ",[57,71,72],{},"RoadNumber",[57,74,75],{},"Model",[14,77,78,65,81,69,84,69,87,69,90,93,94,69,97,69,100],{},[30,79,80],{},"Optional columns:",[57,82,83],{},"HorsePower",[57,85,86],{},"Length",[57,88,89],{},"Weight",[57,91,92],{},"Manufacturer",",\n",[57,95,96],{},"AcquiredOn",[57,98,99],{},"PurchasePrice",[57,101,102],{},"Notes",[14,104,105,107,108,69,111,69,114,117,118,121,122,69,125,69,128,131,132,135],{},[57,106,68],{}," is the railroad's reporting mark (",[57,109,110],{},"BNSF",[57,112,113],{},"UP",[57,115,116],{},"CSXT","), up to 10\ncharacters. Write dates as ",[57,119,120],{},"YYYY-MM-DD",". Column order doesn't matter, and\ncommon alternate headers work too: ",[57,123,124],{},"Road",[57,126,127],{},"Number",[57,129,130],{},"HP",", and ",[57,133,134],{},"Comments"," all\nmap to the right field.",[14,137,138,139,45],{},"Any railroad or locomotive model your CSV references that doesn't already exist\nin Rail Ops gets created automatically, so you don't need to set those up first.\nNew railroads use the reporting mark as their name, and new models start with\njust a name; fill in the rest under ",[30,140,141],{},"Settings → Locomotive Models",[14,143,144],{},[145,146],"img",{"alt":147,"src":148},"Import Locomotives from CSV","\u002Fimages\u002Fdocs\u002Froster\u002Flocomotives-import-modal.png",[18,150,152],{"id":151},"choose-what-happens-to-existing-rows","Choose what happens to existing rows",[14,154,155,156,159,160,163],{},"Rail Ops matches CSV rows to existing locomotives by ",[30,157,158],{},"road name + road\nnumber",". Under ",[30,161,162],{},"When a row already exists",", pick how it should handle a\nmatch:",[165,166,167,173,179],"ul",{},[26,168,169,172],{},[30,170,171],{},"Skip existing rows",": leaves them untouched. Only new locomotives are\nadded.",[26,174,175,178],{},[30,176,177],{},"Update existing rows",": this is the default. The existing locomotive is\nupdated with the values from the CSV.",[26,180,181,184],{},[30,182,183],{},"Replace existing rows",": the existing locomotive is deleted and\nrecreated from the CSV.",[14,186,187,188,191,192,195,196,201],{},"With either ",[30,189,190],{},"Update"," or ",[30,193,194],{},"Replace",", a blank cell clears that field on the\nexisting locomotive. If you only want to change a few columns, start from an\n",[197,198,200],"a",{"href":199},"\u002Fdocs\u002Froster\u002Fexporting-your-roster","export"," of your locomotives rather than a\nfresh sample file. That way every other column is already filled in.",[203,204,205],"blockquote",{},[14,206,207,208,210,211,191,213,216],{},"Tip: Decoders and photos aren't part of the CSV. ",[30,209,183],{},"\nrecreates the locomotive, so use ",[30,212,190],{},[30,214,215],{},"Skip"," if you've already\nadded those by hand.",[14,218,48,219,221],{},[30,220,44],{}," once your file is ready.",[18,223,225],{"id":224},"if-some-rows-dont-import","If some rows don't import",[14,227,228,229,45],{},"Rows are checked one at a time. A row that's missing a required column or has\na bad value gets skipped, and the rest of the file still imports. If a\nlocomotive you expected is missing afterward, check that row, fix it, and\nimport the file again with ",[30,230,177],{},[18,232,234],{"id":233},"next","Next",[14,236,237,238,242,243,45],{},"Locomotives without a decoder, photo, or acquisition details import fine. Add\nthose later from each locomotive's own page. See\n",[197,239,241],{"href":240},"\u002Fdocs\u002Froster\u002Fmanaging-your-locomotives","Managing your locomotives"," for adding\none by hand and filling in the rest. To get your fleet back out as a\nspreadsheet (or into JMRI), see\n",[197,244,245],{"href":199},"Exporting your roster",{"title":247,"searchDepth":248,"depth":248,"links":249},"",2,[250,251,252,253],{"id":20,"depth":248,"text":21},{"id":151,"depth":248,"text":152},{"id":224,"depth":248,"text":225},{"id":233,"depth":248,"text":234},"Bring your locomotive fleet into Rail Ops from a CSV file.",false,"md",{},null,true,20,"\u002Fdocs\u002Froster\u002Fimporting-locomotives",{"title":5,"description":254},"docs\u002Froster\u002Fimporting-locomotives","pPRSqdQZdtPXfAAx_YZqOUeK9oH_J0F6vP0Fr_F-pWM",[266],{"title":267,"path":268,"stem":269,"children":270},"Docs","\u002Fdocs","docs",[271,276,310,319,340,349],{"title":272,"path":268,"stem":273,"navTitle":274,"order":275,"draft":255},"Documentation","docs\u002Findex","Overview",0,{"title":277,"navTitle":258,"order":278,"draft":255,"path":279,"stem":280,"children":281,"page":255},"Document Templates",30,"\u002Fdocs\u002Fdocument-templates","docs\u002Fdocument-templates",[282,287,292,296,301,306],{"title":283,"path":284,"stem":285,"navTitle":258,"order":286,"draft":255},"Car cards","\u002Fdocs\u002Fdocument-templates\u002Fcar-cards","docs\u002Fdocument-templates\u002Fcar-cards",40,{"title":288,"path":289,"stem":290,"navTitle":258,"order":291,"draft":255},"Loco cards","\u002Fdocs\u002Fdocument-templates\u002Floco-cards","docs\u002Fdocument-templates\u002Floco-cards",50,{"title":293,"path":294,"stem":295,"navTitle":258,"order":260,"draft":255},"Setting up a template","\u002Fdocs\u002Fdocument-templates\u002Fsetting-up-a-template","docs\u002Fdocument-templates\u002Fsetting-up-a-template",{"title":297,"path":298,"stem":299,"navTitle":258,"order":300,"draft":255},"Station signs","\u002Fdocs\u002Fdocument-templates\u002Fstation-signs","docs\u002Fdocument-templates\u002Fstation-signs",60,{"title":302,"path":303,"stem":304,"navTitle":258,"order":305,"draft":255},"Document templates overview","\u002Fdocs\u002Fdocument-templates\u002Ftemplates-overview","docs\u002Fdocument-templates\u002Ftemplates-overview",10,{"title":307,"path":308,"stem":309,"navTitle":258,"order":278,"draft":255},"Using templates","\u002Fdocs\u002Fdocument-templates\u002Fusing-templates","docs\u002Fdocument-templates\u002Fusing-templates",{"title":311,"navTitle":258,"order":305,"draft":255,"path":312,"stem":313,"children":314,"page":255},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002Fgetting-started",[315],{"title":316,"path":317,"stem":318,"navTitle":258,"order":305,"draft":255},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002Fgetting-started\u002Fintroduction",{"title":320,"navTitle":258,"order":321,"draft":255,"path":322,"stem":323,"children":324,"page":255},"Operations",25,"\u002Fdocs\u002Foperations","docs\u002Foperations",[325,329,333,336],{"title":326,"path":327,"stem":328,"navTitle":258,"order":278,"draft":255},"Creating waybills","\u002Fdocs\u002Foperations\u002Fcreating-waybills","docs\u002Foperations\u002Fcreating-waybills",{"title":330,"path":331,"stem":332,"navTitle":258,"order":286,"draft":255},"Generating waybill cards","\u002Fdocs\u002Foperations\u002Fgenerating-waybills","docs\u002Foperations\u002Fgenerating-waybills",{"title":320,"path":334,"stem":335,"navTitle":258,"order":305,"draft":255},"\u002Fdocs\u002Foperations\u002Foperations-overview","docs\u002Foperations\u002Foperations-overview",{"title":337,"path":338,"stem":339,"navTitle":258,"order":260,"draft":255},"Setting up for operations","\u002Fdocs\u002Foperations\u002Fsetting-up-operations","docs\u002Foperations\u002Fsetting-up-operations",{"title":341,"navTitle":258,"order":286,"draft":255,"path":342,"stem":343,"children":344,"page":255},"Reference","\u002Fdocs\u002Freference","docs\u002Freference",[345],{"title":346,"path":347,"stem":348,"navTitle":258,"order":305,"draft":255},"Keyboard shortcuts","\u002Fdocs\u002Freference\u002Fkeyboard-shortcuts","docs\u002Freference\u002Fkeyboard-shortcuts",{"title":350,"navTitle":258,"order":260,"draft":255,"path":351,"stem":352,"children":353,"page":255},"Roster & Importing","\u002Fdocs\u002Froster","docs\u002Froster",[354,357,361,362,366,371,374],{"title":245,"path":199,"stem":355,"navTitle":258,"order":356,"draft":255},"docs\u002Froster\u002Fexporting-your-roster",45,{"title":358,"path":359,"stem":360,"navTitle":258,"order":278,"draft":255},"Importing cars","\u002Fdocs\u002Froster\u002Fimporting-cars","docs\u002Froster\u002Fimporting-cars",{"title":5,"path":261,"stem":263,"navTitle":258,"order":260,"draft":255},{"title":363,"path":364,"stem":365,"navTitle":258,"order":305,"draft":255},"Importing your roster","\u002Fdocs\u002Froster\u002Fimporting-overview","docs\u002Froster\u002Fimporting-overview",{"title":367,"path":368,"stem":369,"navTitle":258,"order":370,"draft":255},"Managing your cars","\u002Fdocs\u002Froster\u002Fmanaging-your-cars","docs\u002Froster\u002Fmanaging-your-cars",37,{"title":241,"path":240,"stem":372,"navTitle":258,"order":373,"draft":255},"docs\u002Froster\u002Fmanaging-your-locomotives",35,{"title":375,"path":376,"stem":377,"navTitle":258,"order":286,"draft":255},"Managing your roster","\u002Fdocs\u002Froster\u002Fmanaging-your-roster","docs\u002Froster\u002Fmanaging-your-roster",1791699585351]