[{"data":1,"prerenderedAt":542},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Ftools\u002Fbom-revisions":239,"\u002Fdocs\u002Ftools\u002Fbom-revisions-surround":537},[4],{"title":5,"path":6,"stem":7,"children":8},"Docs","\u002Fdocs","docs",[9,12,16,20,73,98,131,152,173,198],{"title":10,"path":6,"stem":11},"Gerbtrace Documentation","docs\u002Findex",{"title":13,"path":14,"stem":15},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",{"title":17,"path":18,"stem":19},"Licensing","\u002Fdocs\u002Flicensing","docs\u002F2.licensing",{"title":21,"path":22,"stem":23,"children":24,"page":72},"Viewer","\u002Fdocs\u002Fviewer","docs\u002F3.viewer",[25,29,33,37,41,45,49,53,57,60,64,68],{"title":26,"path":27,"stem":28},"Files","\u002Fdocs\u002Fviewer\u002Ffiles","docs\u002F3.viewer\u002F01.files",{"title":30,"path":31,"stem":32},"PCB","\u002Fdocs\u002Fviewer\u002Fpcb","docs\u002F3.viewer\u002F02.pcb",{"title":34,"path":35,"stem":36},"Panel","\u002Fdocs\u002Fviewer\u002Fpanel","docs\u002F3.viewer\u002F03.panel",{"title":38,"path":39,"stem":40},"Assembly","\u002Fdocs\u002Fviewer\u002Fassembly","docs\u002F3.viewer\u002F04.assembly",{"title":42,"path":43,"stem":44},"Jetprint","\u002Fdocs\u002Fviewer\u002Fjetprint","docs\u002F3.viewer\u002F05.jetprint",{"title":46,"path":47,"stem":48},"SMD","\u002Fdocs\u002Fviewer\u002Fsmd","docs\u002F3.viewer\u002F06.smd",{"title":50,"path":51,"stem":52},"THT","\u002Fdocs\u002Fviewer\u002Ftht","docs\u002F3.viewer\u002F07.tht",{"title":54,"path":55,"stem":56},"BOM","\u002Fdocs\u002Fviewer\u002Fbom","docs\u002F3.viewer\u002F08.bom",{"title":5,"path":58,"stem":59},"\u002Fdocs\u002Fviewer\u002Fdocs","docs\u002F3.viewer\u002F09.docs",{"title":61,"path":62,"stem":63},"Conversation","\u002Fdocs\u002Fviewer\u002Fconversation","docs\u002F3.viewer\u002F10.conversation",{"title":65,"path":66,"stem":67},"Summary","\u002Fdocs\u002Fviewer\u002Fsummary","docs\u002F3.viewer\u002F11.summary",{"title":69,"path":70,"stem":71},"Pricing","\u002Fdocs\u002Fviewer\u002Fpricing","docs\u002F3.viewer\u002F12.pricing",false,{"title":74,"path":75,"stem":76,"children":77,"page":72},"Tools","\u002Fdocs\u002Ftools","docs\u002F4.tools",[78,82,86,90,94],{"title":79,"path":80,"stem":81},"Exports","\u002Fdocs\u002Ftools\u002Fexports","docs\u002F4.tools\u002F1.exports",{"title":83,"path":84,"stem":85},"Compare","\u002Fdocs\u002Ftools\u002Fcompare","docs\u002F4.tools\u002F2.compare",{"title":87,"path":88,"stem":89},"Package Manager","\u002Fdocs\u002Ftools\u002Fpackage-manager","docs\u002F4.tools\u002F3.package-manager",{"title":91,"path":92,"stem":93},"Draw Tool","\u002Fdocs\u002Ftools\u002Fdraw-tool","docs\u002F4.tools\u002F4.draw-tool",{"title":95,"path":96,"stem":97},"BOM Revisions","\u002Fdocs\u002Ftools\u002Fbom-revisions","docs\u002F4.tools\u002F5.bom-revisions",{"title":99,"path":100,"stem":101,"children":102,"page":72},"Collaboration","\u002Fdocs\u002Fcollaboration","docs\u002F5.collaboration",[103,107,111,115,119,123,127],{"title":104,"path":105,"stem":106},"Team Settings","\u002Fdocs\u002Fcollaboration\u002Fteam-settings","docs\u002F5.collaboration\u002F1.team-settings",{"title":108,"path":109,"stem":110},"Team Members","\u002Fdocs\u002Fcollaboration\u002Fteam-members","docs\u002F5.collaboration\u002F2.team-members",{"title":112,"path":113,"stem":114},"User Profile","\u002Fdocs\u002Fcollaboration\u002Fuser-profile","docs\u002F5.collaboration\u002F3.user-profile",{"title":116,"path":117,"stem":118},"Spaces","\u002Fdocs\u002Fcollaboration\u002Fspaces","docs\u002F5.collaboration\u002F4.spaces",{"title":120,"path":121,"stem":122},"Notifications","\u002Fdocs\u002Fcollaboration\u002Fnotifications","docs\u002F5.collaboration\u002F6.notifications",{"title":124,"path":125,"stem":126},"Plans & Billing","\u002Fdocs\u002Fcollaboration\u002Fplans-and-billing","docs\u002F5.collaboration\u002F7.plans-and-billing",{"title":128,"path":129,"stem":130},"MCP server","\u002Fdocs\u002Fcollaboration\u002Fconnected-apps","docs\u002F5.collaboration\u002F8.connected-apps",{"title":132,"path":133,"stem":134,"children":135,"page":72},"App","\u002Fdocs\u002Fapp","docs\u002F6.app",[136,140,144,148],{"title":137,"path":138,"stem":139},"Desktop App","\u002Fdocs\u002Fapp\u002Fdesktop","docs\u002F6.app\u002F1.desktop",{"title":141,"path":142,"stem":143},"Light & Dark Mode","\u002Fdocs\u002Fapp\u002Flight-dark-mode","docs\u002F6.app\u002F2.light-dark-mode",{"title":145,"path":146,"stem":147},"Performance Monitor","\u002Fdocs\u002Fapp\u002Fperformance-monitor","docs\u002F6.app\u002F3.performance-monitor",{"title":149,"path":150,"stem":151},"Report a Bug","\u002Fdocs\u002Fapp\u002Freport-a-bug","docs\u002F6.app\u002F4.report-a-bug",{"title":153,"path":154,"stem":155,"children":156,"page":72},"Guides","\u002Fdocs\u002Fguides","docs\u002F7.guides",[157,161,165,169],{"title":158,"path":159,"stem":160},"Importing Files","\u002Fdocs\u002Fguides\u002Fimporting-files","docs\u002F7.guides\u002F1.importing-files",{"title":162,"path":163,"stem":164},"Supported Formats","\u002Fdocs\u002Fguides\u002Fsupported-formats","docs\u002F7.guides\u002F2.supported-formats",{"title":166,"path":167,"stem":168},"Package Library","\u002Fdocs\u002Fguides\u002Fpackage-library","docs\u002F7.guides\u002F3.package-library",{"title":170,"path":171,"stem":172},"Panel Checks","\u002Fdocs\u002Fguides\u002Fpanel-checks","docs\u002F7.guides\u002F4.panel-checks",{"title":174,"path":175,"stem":176,"children":177,"page":72},"Reference","\u002Fdocs\u002Freference","docs\u002F8.reference",[178,182,186,190,194],{"title":179,"path":180,"stem":181},"BOM File Format","\u002Fdocs\u002Freference\u002Fbom-format","docs\u002F8.reference\u002F1.bom-format",{"title":183,"path":184,"stem":185},"Package Definitions","\u002Fdocs\u002Freference\u002Fpackage-definitions","docs\u002F8.reference\u002F2.package-definitions",{"title":187,"path":188,"stem":189},"Package Naming","\u002Fdocs\u002Freference\u002Fpackage-naming","docs\u002F8.reference\u002F3.package-naming",{"title":191,"path":192,"stem":193},"TPSys Format","\u002Fdocs\u002Freference\u002Ftpsys-format","docs\u002F8.reference\u002F4.tpsys-format",{"title":195,"path":196,"stem":197},"Jet Printing","\u002Fdocs\u002Freference\u002Fjet-printing","docs\u002F8.reference\u002F5.jet-printing",{"title":199,"path":200,"stem":201,"children":202,"page":72},"Development","\u002Fdocs\u002Fdevelopment","docs\u002F9.development",[203,207,211,215,219,223,227,231,235],{"title":204,"path":205,"stem":206},"Development Setup","\u002Fdocs\u002Fdevelopment\u002Fsetup","docs\u002F9.development\u002F1.setup",{"title":208,"path":209,"stem":210},"Architecture","\u002Fdocs\u002Fdevelopment\u002Farchitecture","docs\u002F9.development\u002F2.architecture",{"title":212,"path":213,"stem":214},"CAD Libraries","\u002Fdocs\u002Fdevelopment\u002Fcad-libraries","docs\u002F9.development\u002F3.cad-libraries",{"title":216,"path":217,"stem":218},"Release Process","\u002Fdocs\u002Fdevelopment\u002Frelease-process","docs\u002F9.development\u002F4.release-process",{"title":220,"path":221,"stem":222},"Error Monitoring","\u002Fdocs\u002Fdevelopment\u002Ferror-monitoring","docs\u002F9.development\u002F5.error-monitoring",{"title":224,"path":225,"stem":226},"Contributing","\u002Fdocs\u002Fdevelopment\u002Fcontributing","docs\u002F9.development\u002F6.contributing",{"title":228,"path":229,"stem":230},"Commit Conventions","\u002Fdocs\u002Fdevelopment\u002Fcommit-conventions","docs\u002F9.development\u002F7.commit-conventions",{"title":232,"path":233,"stem":234},"Sidebar Design","\u002Fdocs\u002Fdevelopment\u002Fsidebar-design","docs\u002F9.development\u002F8.sidebar-design",{"title":236,"path":237,"stem":238},"Operational Runbooks","\u002Fdocs\u002Fdevelopment\u002Frunbooks","docs\u002F9.development\u002F9.runbooks",{"id":240,"title":95,"body":241,"description":530,"extension":531,"links":532,"meta":533,"navigation":534,"path":96,"seo":535,"stem":97,"__hash__":536},"docs\u002Fdocs\u002F4.tools\u002F5.bom-revisions.md",{"type":242,"value":243,"toc":519},"minimark",[244,248,261,266,320,324,331,350,354,357,392,395,399,431,448,455,459,465,481,491,494,501],[245,246,95],"h1",{"id":247},"bom-revisions",[249,250,251,252,256,257,260],"p",{},"When a customer sends a new BOM revision, Gerbtrace shows what changed against the previous one: quantities, designators, MPNs, values and DNP flags. Both files go through the same import as the BOM tab, so column mapping, designator ranges (",[253,254,255],"code",{},"C1-C4","), units such as ",[253,258,259],{},"1 Stk"," and MPN spelling are handled the same way.",[262,263,265],"h2",{"id":264},"where-to-compare","Where to compare",[267,268,269,287],"ul",{},[270,271,272,276,277,280,281,286],"li",{},[273,274,275],"strong",{},"BOM tab"," – click ",[273,278,279],{},"Compare revisions"," in the toolbar. Pick the old revision (a BOM file of the project or an upload) and the new one (usually an upload). Editors can then replace the project BOM with the new file (see ",[282,283,285],"a",{"href":284},"#replacing-the-project-bom","Replacing the project BOM",").",[270,288,289,292,293,296,297,300,301,304,305,307,308,311,312,315,316,319],{},[273,290,291],{},"Compare mode"," – create a ",[282,294,295],{"href":84},"compare project"," with the old BOM in ",[273,298,299],{},"Packet 1"," and the new BOM in ",[273,302,303],{},"Packet 2",". The file names must look like a BOM (for example contain ",[253,306,54],{},", ",[253,309,310],{},"Bill of Materials"," or ",[253,313,314],{},"Stückliste",") so the import classifies them. Select the matched BOM pair in the sidebar and the BOM diff replaces the canvas; ",[273,317,318],{},"Text Diff"," still shows the raw file text.",[262,321,323],{"id":322},"column-mapping","Column mapping",[249,325,326,327,330],{},"Each side is parsed with the header row and column mapping Gerbtrace detects, or with the project's stored mapping for a project file. If the new revision renames or reorders its columns, the mapping of the old revision is carried over by header name, and the summary says how many columns were mapped like the old revision. Use ",[273,328,329],{},"Columns"," to correct a mapping; a column can only be mapped to one field.",[249,332,333,334,307,337,307,340,307,343,307,346,349],{},"Columns that only number the rows (",[253,335,336],{},"#",[253,338,339],{},"Pos",[253,341,342],{},"Item",[253,344,345],{},"Line",[253,347,348],{},"Nr.",") are ignored, so a reordered BOM does not show every line as changed. Other unmapped columns are compared when both revisions have them.",[262,351,353],{"id":352},"how-lines-are-matched","How lines are matched",[249,355,356],{},"Gerbtrace pairs old and new lines with the strongest key first:",[358,359,360,374,380,386],"ol",{},[270,361,362,365,366,369,370,373],{},[273,363,364],{},"Same designator set"," – ",[253,367,368],{},"C1, C2, C3"," and ",[253,371,372],{},"C1-C3"," are the same set.",[270,375,376,379],{},[273,377,378],{},"Overlapping designators"," – a line that was split, merged or regrouped.",[270,381,382,385],{},[273,383,384],{},"Same MPN"," – for lines without designators, such as screws or labels.",[270,387,388,391],{},[273,389,390],{},"Value and package"," – for lines without an MPN.",[249,393,394],{},"Lines left over are added or removed. Designator comparison ignores case and whitespace.",[262,396,398],{"id":397},"reading-the-result","Reading the result",[249,400,401,402,307,405,307,408,307,411,307,414,307,417,307,420,307,423,426,427,430],{},"The summary counts added, removed, changed and unchanged lines. Filter by change type (",[273,403,404],{},"Added",[273,406,407],{},"Removed",[273,409,410],{},"Quantity",[273,412,413],{},"Designators",[273,415,416],{},"MPN",[273,418,419],{},"Value \u002F package",[273,421,422],{},"DNP",[273,424,425],{},"Description & other","), search, or turn on ",[273,428,429],{},"Show unchanged",".",[267,432,433,443],{},[270,434,435,438,439,442],{},[273,436,437],{},"Lines"," – one row per matched line with the old and new values. The line column shows its position in each file after parsing (",[253,440,441],{},"#3 → #4","). Split, merged and regrouped lines are labelled.",[270,444,445,447],{},[273,446,413],{}," – one row per designator: added, removed, or changed MPN, value or line.",[249,449,450,451,454],{},"The value comes from a ",[253,452,453],{},"Value"," column when the BOM has one; otherwise the description is compared as the value. Designators listed on more than one line in the same file are flagged above the table.",[262,456,458],{"id":457},"export","Export",[249,460,461,462,464],{},"Use ",[273,463,458],{}," to download:",[267,466,467,473],{},[270,468,469,472],{},[273,470,471],{},"Excel workbook (.xlsx)"," – sheets for the summary, the lines and the designators.",[270,474,475,369,478,430],{},[273,476,477],{},"Changed lines (.csv)",[273,479,480],{},"Changed designators (.csv)",[249,482,483,484,487,488,430],{},"File names follow the ",[282,485,486],{"href":80},"export naming scheme",", for example ",[253,489,490],{},"Board_BOM-Revision-Diff.xlsx",[262,492,285],{"id":493},"replacing-the-project-bom",[249,495,496,497,500],{},"In the BOM tab, an editor can click ",[273,498,499],{},"Replace BOM with this revision"," when the old side is a project BOM file and the new side is an upload. This needs the BOM and Files tabs unlocked. After you confirm:",[267,502,503,506,509],{},[270,504,505],{},"The old file is removed from the project and the new file is added with the column mapping used in the compare.",[270,507,508],{},"The BOM tab re-imports it like any changed BOM file. Lines whose designators are unchanged keep your edits (groups, notes, pricing). A changed MPN is added next to the old manufacturer, so remove the old part where it no longer applies. Lines with new designators come in fresh, and removed lines are dropped.",[270,510,511,512,369,515,518],{},"The old file is not kept. The confirmation offers ",[273,513,514],{},"Download old revision",[273,516,517],{},"Export diff (.xlsx)"," so you can keep both, and use the diff as a checklist of lines to review.",{"title":520,"searchDepth":521,"depth":522,"links":523},"",3,2,[524,525,526,527,528,529],{"id":264,"depth":522,"text":265},{"id":322,"depth":522,"text":323},{"id":352,"depth":522,"text":353},{"id":397,"depth":522,"text":398},{"id":457,"depth":522,"text":458},{"id":493,"depth":522,"text":285},"Compare two revisions of a customer BOM line by line and designator by designator, export the changes, and replace the project BOM.","md",null,{},true,{"title":95,"description":530},"G9bT_SwfMlxZS4r6uSwCLah-_gTobqDoPYfGY2SLM1M",[538,540],{"title":91,"path":92,"stem":93,"description":539,"children":-1},"Draw shapes, place fiducials, and add drill holes directly on Gerber and Excellon layers.",{"title":104,"path":105,"stem":106,"description":541,"children":-1},"Configure team name, defaults, integrations (Elexess pricing, Spark AI), and panel defaults.",1792858553124]