Search Results for 'script'
-
Search Results
-
Hello,
I have zero experience with Javascript and I’m struggling to understand the provided documentation regarding scripts. The reason I’m considering scripts is because I really want to be able to search and sort fields that link to other forms, but from what I’ve read in the forums this is unfortunately not possible yet (this is absolutely my number one request for future development).So, I figured an alternative would be to create a script that copies the contents of a field that links to another form, into a regular field. This way, when I sort or create saved searches/filters, I can point to the regular field that would have copied the relevant contents.
So, all I want is a simple automated copy-paste of the text or numeric contents of a field (that links to other forms) into another field of my form. I haven’t been able to find a step by step guide in the documentation or in the forums.
I see that I’d use “get field value” and “set field value” or “set multiple field values”, but I don’t know how to go about it. Do I create the script as a field, or do I simply add it to the Scripts pane? And once I create the script, what would I type there?
Any help would be much appreciated. Thank you.
Topic: Profiler Script
One of the scripts I use a lot is my profiler. I use it to figure out timing data for how long something takes for my scripts. It’s useful for understanding where your bottlenecks are in code and for figuring out what the true slow downs are.
If you look at the very bottom of the script, there is an example/test for the script so you can see how it works. I use this with a
Script Managerform which makes including easy like this:document.getFormNamed('Script Manager').runScriptNamed('Profiler');Due to the way the tests are coded, you want to define a variable called
PARENT_SCRIPTto prevent the test from firing when being included. Generally I do this in the format ofForm Name::Script Name, e.g.:var PARENT_SCRIPT = 'Boxes::Bulk Add To Box';Using it is easy once you’ve included it:
profiler.start('Start time'); ... your code that does stuff! ... profiler.end();Profiler internally uses a stack so end closes the most recent start. If you do a
profiler.dump()you will get back a string with the profiling information formatted with indentation. Here is a copy of the test running as an example:24/2/20, 9:59:19 pm / Script Manager / Profiler Caught expected error from dump: Error: Profiler imbalance: started called 1 more times than end. Uneven profiler.end called (are you missing a start?) Dump called with index 7 and indent 0 0ms Test 1 0ms Test 2 0ms Test 3 0ms Test 4 0ms Function start 0ms Complex logic 0ms MismatchHere’s the full script:
// ========== Profiler Start ========== // // NAME: Profiler // VERSION: 1.0.0 /** * Profiler module stores timing data. */ if (profiler == undefined) var profiler = (function() { let stack = []; let entries = []; let index = 0; let indent = 0; let current = undefined; return { custom: function(start, end, message) { entries[index] = {'start': start, 'end': end, 'message': message, 'index': index, 'indent': indent}; index++; }, /** * Start a timer. * * Takes a <code>message</code> and adds it to the internal <code>logdata</code> variable * and also logs it to the console with a timestamp. */ start: function(message) { let now = new Date(); stack.push({'start': now.getTime(), 'message': message, 'index': index, 'indent': indent}); index++; indent++; }, /** * Log an error * * Takes a <code>message</code> and <code>error</code> object and then formats into an error * via <code>logMessage</code>. */ end: function(endCount = 1) { for (let i = 0; i < endCount; i++) { let now = new Date(); let entry = stack.pop(); if (entry) { entry['end'] = now.getTime(); entries[entry.index]= entry; indent--; } else { console.log('Uneven profiler.end called (are you missing a start?)'); } } }, /** * Get the internal log buffer * * Returns the raw log buffer to output elsewhere. */ dump: function(autoClose = true) { let returnValue = []; returnValue.push(<code>Dump called with index ${index} and indent ${indent}</code>); let dumpIndent = indent; if (indent > 0) { if (!autoClose) { throw Error("Profiler imbalance: started called " + indent + " more times than end."); } else { // Close out any mismatched items. this.end(indent); } } let entry = null; for(entry of entries) { let message = (entry.end - entry.start) + 'ms \t' + entry.message; returnValue.push(message.padStart(message.length + (entry.indent * 4))); } return returnValue.join('\n'); }, /** * Clear the internal state. */ reset: function() { stack = []; entries = []; index = 0; indent = 1; } } })(); // Testing section. Fake guard for testing. if (typeof PARENT_SCRIPT === 'undefined') { profiler.start('Test 1'); profiler.start('Test 2'); profiler.end(); profiler.start('Test 3'); profiler.start('Test 4'); profiler.end(); profiler.end(); profiler.end(); profiler.start('Function start'); profiler.start('Complex logic'); profiler.end(2); profiler.start('Mismatch'); try { profiler.dump(false); } catch (e) { console.log('Caught expected error from dump: ' + e); } // Call end one too many times. profiler.end(2); console.log(profiler.dump()); profiler.reset(); } // ========== Profiler End ========== //Latest version of this script is available on GitHub: https://github.com/pasamio/tftools/blob/master/scripts/js/profiler.js
Topic: Prompter Functions
Credit to @daniel_leu for this originally and I think a variant of them will be coming in the sample scripts. These are the two that I use personally and I figured I’d share them. I added this in my “Script Manager” form as “Prompter Functions”, so if you have that included already then you can add this as a new one.
If you’re going to use these, the calling function needs to be prefixed with
asyncto make it work properly.// ========== Prompter Functions Start ========== // // NAME: Prompter Functions // VERSION: 1.0 /** * Prompter Functions for using the async system to handle some requests. */ // Temporary variable to store callback details. var prompterTempVar = undefined; /** * Prompt a confirmation dialog with a simple message. * * NOTE: This method uses async, please make sure your calling method is declared 'async'. * * @param {string} text - The text to display in the dialog for the confirmation. * @param {string} continueTitle - The text for the continue button. * @param {string} cancelTitle - The text for the cancel button. * * @return {boolean} Boolean result if the user confirmed or declined the dialog. */ function promptConfirm(text, continueTitle = 'Continue', cancelTitle = 'Cancel') { return new Promise(function(resolve, reject) { let prompter = Prompter .new(); prompter.cancelButtonTitle = cancelTitle; prompter.continueButtonTitle = continueTitle; prompter.show(text, ((status) => { if (status == true) { resolve(true); } else { resolve(false); } })); }); } /** * Prompt * * NOTE: This method uses async, please make sure your calling method is declared 'async'. * * @param {string} text - The text to display in the dialog for the confirmation. * @param {string} popupName - The prefix to display for the text box of the prompt. * @param {string} [continueTitle=Continue] - The text for the continue button. * @param {string} [cancelTitle=Cancel] - The text for the cancel button. * * @return {(string|boolean)} The input text or false if cancelled. */ function promptText(text, popupName, continueTitle = 'Continue', cancelTitle = 'Cancel'){ return new Promise(function(resolve, reject) { prompterTempVar = undefined; let prompter = Prompter .new(); prompter.addParameter(popupName, 'prompterTempVar') prompter.cancelButtonTitle = cancelTitle; prompter.continueButtonTitle = continueTitle; prompter.show(text, ((status) => { if (status == true && prompterTempVar) { resolve(prompterTempVar); } else { resolve(false); } })); }); } // ========== Prompter Functions End ========== //You can also get a copy of this file here: https://github.com/pasamio/tftools/blob/master/scripts/js/prompter.js.
