Differences

This shows you the differences between two versions of the page.

--- locodb:locodb-en [2025/10/16 08:56] – rjversluis
+++ locodb:locodb-en [2025/10/16 12:24] (current) – [Description] rjversluis
@@ Line 1: / Line 1: @@
 ======Locomotive Databank======
+[[:english#rocrail|{{  :server.png}}]][[:english|{{  :rocrail-logo-35.png}}]]
+[[:english | Content ]] -> [[:english#rocrail|Rocrail Server]] -> [[:rocrailini-en | Configuration]]
+  * [[:rocrailini-gen-en|General]] | [[:rocrailini-trace-en|Trace]] | [[:rocrailini-service-en|Service]] | [[:rocrailini-automode-en|Automatic]] | [[:rocrailini-controller-en|Controller]] | [[:networking-en|R2Rnet]] | [[:rocrailini-rocweb-en|SVG]] | [[:finder:finder-en|Finder]] | [[:rocrailini-cmdmapping-en|Command Mapping]] | [[:rocrailini-presets-en|Presets]]
+  * **[[:locodb:locodb-en|Locomotive Databank]]**
+ \\
+|< >|
+| Short hand for //"Locomotive Databank"// is **//LocoDB//** |
+ \\
+=====Description=====
+The idea behind the LocoDB is to be able to access all locomotives on all computers with access to the same NAS/Cloud storage.\\
+Even with an offline Rocview it will be able to access the locomotives and check their properties.\\
+====R/W Access====
+Without read and write access of the LocoDB this concept will not work.\\
  \\
 =====Structure=====
+The LocoDB path points to a directory which can be read and write by all users running Rocrail.\\
+Every loco has its own directory named by its ID. Blanks are replaced with underscores; __Blanks in IDs are discouraged and not supported.__\\
+====Example====
+This is an example of a LocoDB on a NAS:\\
 {{:locodb:locodb-en.png?800}}\\
+===Tree===
+<code>
+LocoDB
+├── BR01097
+│   ├── BR01097.png
+│   ├── BR01097.xml
+│   └── DB01.png
+├── BR120119-3
+│   ├── BR120119-3.xml
+│   └── m33535.png
+.
+.
+.
+├── RoT-1
+│   ├── rot1.png
+│   └── RoT-1.xml
+└── V1002215
+    ├── DB100.png
+    ├── m3072.png
+    └── V1002215.xml
+</code>
  \\
-=====Path=====
+=====Rocview=====
-====Rocview====
+====Setup Path====
 {{:locodb:rocview-path-en.png?800}}\\
-====Rocrail====
+====Menu Programming====
+{{:locodb:locodb-menu-en.png?400}}\\
+===Select===
+Select a directory to open just one locomotive.\\
+===All===
+Open all locomotives in the LocoDB.\\
+ \\
+=====Rocrail=====
+====Setup Path====
 {{:locodb:rocrail-gen-en.png?800}}\\
@@ Line 17: / Line 70: @@
  \\
 =====Plan properties=====
+The "Workspace" and "Scale name" is used as selection in the LocoDB in case of automatically loading.\\
 {{:locodb:planprops-en.png?400}}\\
@@ Line 22: / Line 76: @@
  \\
 =====Locomotive=====
+For selecting a locomotive from the LocoDB the "Workspace" and/or "Scale" field should contain a value which match the [[#plan_properties|Plan properties]].\\
 {{:locodb:loco-gen-en.png?800}}\\
+ \\
+=====Export=====
+With the "Locomotive database" option the export of the selected locomotives will be in the LocoDB.\\
+The export will overwrite existing files.\\
+{{:locodb:export-locos-en.png?600}}\\
+ \\
+=====Automatic loading=====
+Locomotives will be automatically loaded from the LocoDB if following is all true:
+  - No local locomotives are defined.
+  - The [[#setup_path1|Locomotives database path]] exists and is accessible.
+  - The [[#plan_properties|Plan properties]] contains a selection by Workspace and/or Scale-Name.
+  - [[#locomotive|Locomotive]]s in the LocoDB matches the [[#plan_properties|Plan properties]] criterium.