Plandroid Help Documentation

Plandroid allows you to create your design using the actual parts catalog of your supplier. You choose which catalogs you will use, so that you design has the correct part numbers for ordering, and those parts have the correct pricing. You can select multiple catalogs to use at once, and normally you would select the parts catalog of your parts supplier, plus the units catalog of your A/C unit supplier. You can also select other catalogs to load at the same time, for example the program comes with a selection of generic starter sets to use, plus some catalogs of symbols that you might find useful. Plandroid also allows you to completely customise your product pricing and discount scheme so that you are using the exact prices provided by your own supplier, even when they vary from the standard catalog list prices. You can even switch between multiple different pricing schemes.

Select Parts Catalogs
The Select Parts Catalogs window

Selecting Catalogs

You can select one or more catalog to display in the Parts catalog tab from the menu item Tools -> Select Catalogs. This will show you each available catalog's version name, the manufacturer whose catalog it is, when the catalog was released, when the catalog expires, and if there is a valid digital signature on the catalog which marks it as being valid. Any catalog which has expired or is otherwise invalid is shown greyed-out.

If you have catalogs from more than one region, they are separated into their respective regions by tab. Certain catalogs, such as symbols, may be shown on all region tabs or a subset of relevant tabs.

You can also import new catalogs into the list of available catalogs using the Import Catalog button on this form - or, equivalently, drag and drop a new catalog file onto the form.

Catalogs can be deleted from the catalog list by right-clicking to bring up the context menu and selecting Delete.

It is possible to edit a number of a Part's properties (see the Costing page), however this does not change the original catalog data. You can specify if you wish to use the edited values when you read in a catalog by checking the Apply user-edits when loading catalogs check box. Edits made by one user can be applied to all users on a system, or kept private, depending on your Options settings.

Duplicate Part Codes

Each part must have a unique product code, as this identifies it uniquely to the program. Nevertheless, although it is not recommended, it is still possible to load catalogs with identical part numbers or codes. The program will add a counter suffix e.g. (1) to a product code which is the same as one it has already read, to make the new product code unique. This capability should be used with caution, as which product codes are altered is dependent on the order you load the catalogs. If you have edited any parameters of a part which is changed in this way, your edits may be applied incorrectly!

Importing Catalogs

From time to time catalog files are updated, or new catalogs are released. These catalogs can be downloaded from the Catalogs section of the Plandroid website. The Import Catalog button allows you to import any new parts catalogs, new part icons, or a pre-defined catalog edits file.

Catalogs

You can browse to an XML catalog file that you may have made or downloaded and copy it into Plandroid's application data area where it will be found by the program. Any associated icons that are in the appropriate icon subdirectory (Default_Images, or <Catalog Name>_Images) will also be automatically copied.

Icons

If you use this function to select a .emf or .png icon file instead of an XML catalog file, then the icon file will be copied into the default icons directory instead.

Catalog Edits

Any edits you make to a part's price or price modifier (discount or mark-up) in your catalog is stored in a special price edits file. This same file records any automatically added parts that you may have defined yourself. For example, your preferred parts supplier may give you a catalog edits file specifically tailored to your particular pricing structure, or indeed you may even have different pricing schemes for your own different classes of customers. Or perhaps your colleague has defined sets of parts that should be added together and you want to use the same definitions. If so, you can simply use the menu item Import -> Price Edits File button to browse to and import a price edits file in either XML or comma separated variable (CSV) format. You can swap between these different price edits files using the Tools -> Select Parts Catalogs -> Set Price Edits button. Also in this dialog you can use the context menu to delete unwanted edits files, copy them to a different location (for example to give to a colleague), or merge different price edits files together so you can use them at the same time.

This covers all the information you need to work with catalogs. There is further documentation on the structure of the XML catalog files, however this is intended for advanced users and is only relevant if you intend to edit or create your own catalog files.

The US spelling "catalog" is deliberately used in the application instead of "catalogue", for succinctness.

The next section covers the Tools available in Plandroid.