2,299
edits
Changes
→Deleted System Variables
==Overview= =
The '''System Variables '''setting on the [[Global Settings]] page will allow you to create and edit system-wide variables within your [[instance]]. These variables can then be referred to from anywhere within your [[SmartSimple]] copy by using the following syntax:
: <span style="font-size: medium;">@system.''variable name''@</span>
'''Example:''' If If you have created a System Variable named '''Tax Rate''' you would use:
@system.tax rate@
: <span style="font-size: medium;">@system.library.''variable name''@</span>
'''<br class="Apple-interchange-newline">Example:''' To To return a list of languages from the global library, you would use:
@system.library.language@
You can also include links - for example, you can make a document of guidelines in [[SmartFolders Overview|SmartFolders]] into an Internet-enabled URL, then upload this link to '''System Variables '''in order to place the documents everywhere. If that document then changes, you would only have to modify the content in one place. Other use-cases for '''System Variables '''might include a set scoring protocol if your system uses a reviewer-scoring process.
===Accessing System Variables= ==
1. Click on the 9-square menu icon on the top right of your page.
:: {{Icon-Menu}}
2. Under the heading '''Configuration, '''select '''Global Settings. '''
A [[List View Overview|list]] of available system variables will be displayed.
:: [[File:Sys variables list.png|900px|border]]
You can use the '''Search '''function on the top right at any point to specify the results of the list of system variables.
===Setting a System Variable===
Once you have accessed the list of '''System Variables '''via [[Global Settings]], you can set new system variables.
1. Click on the '''+ '''icon on the top left of the System Variables list page to create a new system variable.
2. The new system variable form will be displayed:
:: [[File:New sys variable.png|400px|border]]
Fill in the fields appropriately: '''Name, Description, '''and '''Value. '''The '''ID '''field will be autopopulated.
'''Note: '''Once you set the '''Name '''of a system variable and save it, it ''cannot be changed. ''
3. Click '''Save '''when you are done filling out the fields.
The page will reload and the page title will be redisplayed as '''Edit '''rather than '''New, '''with the '''Name '''field now greyed out as it is non-editable.
Any changes that you make to the system variable from this page will be impacted system-wide for any reference to this specific system variable.
====Update History====
There will be a '''reload '''icon at the top left of your System Variable page.
:: [[File:Update history icon.png|40px|border]]
This icon, when clicked, will reveal the '''Update History '''related to any revisions made on this specific system variable.
:: [[File:Sys variable update history list.png|800px|border]]
By providing information related to each update - including a date and time stamp, the name of the [[User|user]] who made the modification, the comparative difference in the '''Value '''and '''Description '''fields, etc - you can keep track of any changes made to this system variable.
===Deleted System Variables===
The third tab of the '''System Variables '''page is labelled '''Deleted System Variables '''and will provide a [[List View Overview|list]] of all deleted system variables ''for up to ''one year.
<pre> Deleted system variables can be restored only up to one year; beyond one year, they will be automatically purged from the system. </pre>
Clicking on a deleted system variable will allow you to choose to purge it manually or to restore it back into the system.
:: [[File:Deleted sys variables.png|850px|border]]
==System 2==
And refer to them on the [[Web Page View]] as follows
The system will replace @me.langid@ with either 1 or 2 depending if the current user has their primary language set as English or French (Canada). They will pull the relevant System Variable.
'''Note:''' Do not use '''@system2.''' variables to populate the "options" for fields such as a [[Combo Box]] or [[Check Boxes]] if you wish to be able to search using those fields. The system will not be able to process the variable when searching from the [[List View]]. If using system2 (with @me.langid@) to process different user languages the [[Custom Field Language Settings]] should be used to obtain the language specific option values.
*#* '''Description''' is an optional narrative description.
*#* '''Value''' will be the value returned by the variable.
If the Value is a date, use the ''yyyy-mm-dd'' date format.
==See Also==
[[Category:Global Settings]][[Category:Variables]]
