The “Change Input Parameter ID” window allows Quagensia® Function authors to accomplish the rare task of changing the Input Parameter ID of an input parameter of a Quagensia Function.
You can view an input parameter’s Input Parameter ID in the “Input Parameter ID” field located in the “Advanced Fields” section of the input parameter, and if you are allowed to edit a Quagensia Function you can open the “Change Input Parameter ID” window from the “Change Input Parameter ID” button to the right of the “Input Parameter ID” field.
You should rarely need to change the Input Parameter ID of an input parameter of a Quagensia Function. In fact, if you never accidentally delete a Quagensia Function’s input parameter you should never need to use this feature.
You will need to use this feature if you accidentally delete a Quagensia Function’s input parameter after you’ve already used the input parameter in one of two ways:
- You used the input parameter inside of the Quagensia Function, which you probably will have done before accidentally deleting it.
- You or another user used the Quagensia Function in another Quagensia Strategy or Quagensia Function.
If in the process of creating or editing a Quagensia Function, you create an input parameter, then use it in one or more places as described above, then accidentally delete it, then for your own safety, Quagensia will not allow you to generate the code for a Quagensia Strategy or Quagensia Function that uses the Quagensia Function with the deleted input parameter, because the code generation engine won’t be able to locate the deleted input parameter by its Input Parameter ID, since it no longer exists.
If you notice your mistake soon after deleting the input parameter, you can “Undo” the deletion of the input parameter using the “Undo” toolbar button, menu item, or keyboard shortcut (Ctrl-Z).
However, if you notice your mistake too late, and don’t have a backup of the Quagensia Function, you can create another input parameter with the same or similar name as the input parameter you accidentally deleted, then use the “Change Input Parameter ID” window to set the new input parameter’s Input Parameter ID to the same value as the Input Parameter ID of the input parameter that was accidentally deleted.
You can open the “Change Input Parameter ID” window by clicking on the button to the right of the “Input Parameter ID” field, which is displayed when you click the input parameter’s “Advanced Fields” link button.
Note that changing an input parameter’s Input Parameter ID from the “Change Input Parameter ID” window will save the Quagensia Function file’s unsaved changes permanently to disk in the same way that pressing the “Save” toolbar button or clicking on the main menu “Save” menu item does. Note also that the list of undo-able changes will be cleared, so all changes made to this Quagensia Function since the last time the Quagensia Function was loaded from disk won’t be able to be undone by pressing the “Undo” button.
If you have any doubts, create a backup of your Quagensia Function file first, then change the input parameter’s Input Parameter ID to permanently change the Quagensia Function, permanently save the changes to disk, and lose the list of undo-able changes since the last time the Quagensia Function was loaded from disk.
