Using XioScript 12 - XiozZe/XioScript GitHub Wiki
XS12 main purpose is to take over daily tasks. To be able to do so, you as user decides which tasks XS12 has to execute on which subdivisions. XS12 will remember all the things you tell him to do, so you only have to say: "GO!" and XS12 does all you have told him to do. Every day.
This may sound magical to you, but it is really as simple as that. The main idea behind this userscript: XioScript 12, is to get rid of all your laundry by pressing that "XioMaintenance"-button floating above your unit list.
Basic Usage
So how can I use it? Above a lot of pages of a lot of subdivisions, you will see drop-down menu's where you can choose what XS12 has to do on that page. For example, if you browse to the sale page of a production building, you will find a drop-down list with price functions. One of these functions is called "prime cost". If this function is selected, and you fire the "XioMaintenance"-button, the prices of that single subdivision will be set to prime cost. For further explanation of what each option does, check the XS12 Functions Explained page.
Using this "trick", you can bundle all your daily tasks with a single click on a button, and the best thing is: your browser will remember the options when you close your browser! This means that if you have no time to love your growing cash-tree today, you let your new handcrafted script take care of it!
From XS 12.0.16 and onward, you can find FIRE!-buttons next to the options, executing only the options on that page. After the XioMaintenance function is finished, be sure to reload to see the results!
More technical: the instance you select an option of a drop-down menu, it is saved. You don't have to manually save or reload the page. Also, if you want to cancel the XioMaintenance function, you can just reload the page without harm. Be careful with changing values while the function is running. Although the chance something is going wrong is low, the values you just set may be used or overwritten, and that's why I would advice against it.
Note that no matter which subdivisions are present on the unit list, the XioMaintenance works on all subdivisions in your company which have an option set.
XioOverview
If you have a company with hundreds of subdivisions, it isn't always an easy task to know which subdivision is set on which function. This is where XioOverview comes in: pressing the button on the unit list will direct you to the same page, but with a slash attached to the url. On this page most information in the unit list is removed and replaced with the options you have chosen for that subdivision. Here you can change the options for your subdivision as well. Don't forget: you will not see changes before the XioMaintenance has run!
You can change options easy and fast by using the click and drag mechanics. Click on a row and drag to lighten up several subdivisions. Now you set all the options of these subdivisions at the same time by setting the options of a single subdivision. You don't have to worry about the different types of subdivisions: it effects the options the subdivisions have in common. For example, if I change the option of supply for a medical center (supply, salary, holiday, training and equipment), while I have also selected a laboratory (salary, holiday, training, equipment and research), none of the laboratory options will change.
You may note that some drop-down boxes are missing for a certain subdivision, even though it should be there (for example, a salary drop-down box is missing on a store subdivision). In that case, visit the page of the subdivision where the drop-down box belongs (i.e. the main page of the store). Just visiting is enough: if you reload the XioOverview page, the drop-down box should appear.
You can also find two types of buttons on the XioOverview page: Generate buttons and execution buttons. The execution button are the buttons with or the subdivision id, or the group name of functions (such as "price", "supply", etc.) on them. They both do the same thing as the XioMaintenance button, but now only fire the functions relating to that subdivision (the ids; on the row) or group (on the column). This way if you have just bought a new subdivision, you can change the options of that subdivision and let the XioMaintenance only do his function on that subdivision. Also, if you want to execute only the supply functions of the subdivision, you can press the FIRE!-button next to the supply header.
Every subdivision also has a Generate button. If you just built a new subdivision and quickly let the options for the subdivision appear without having to browse to all the pages, you can use the Generate-button to retrieve the options related to that subdivision. If you are running XS12 for the first time, in general or on a new computer, you can use the Generate All-button to use the generate function on all subdivisions shown on the page.
Import and Export
If you want to change browsers, you might want to take the options set with you. If you press the Export-button, a textbox with compressed data will appear. Copy that data and save it somewhere. If you now want to import that data, press the Import-button and paste the data in the textbox. Save and if the data is not false, the page will reload and all your options will be set.