Interactive Reporting - Is there a way to include user defined js file?

Question

Hi,
My struggle with Hyperion IR 11.1 Studio continues... This time I need to know if it is possible to put my own js file somwhere in Studio and make it visible to all my code inside Studio. I have some function ('classes') defined which I use extensively and every time I must copy all my js file to the System or UserSection sections which is really bad practice.
regards,
Paul

Answer 1

I just put this call in the Document.OnStartup() event of most of my files:
eval( (new JOOLEObject("Scripting.FileSystemObject")).OpenTextFile(-2, 1, "\\\\computername\\sharename\\library.js").ReadAll() );This requires you and your users to have read access to the file share, and may assume you are running on Windows.
I've also found I can use Notepad++ as an external script editor for IR Studio. I include a couple of functions in my library to read and write .js files with the same name as the .bqy file and in the same folder.
//     List all scripts in the active document
     ActiveDocument.OutputScripts = function(strOutputFile, blnDisplay) {
          var strOutput = "";
          var strScript = "";
          if (strOutputFile == undefined) {
               strOutputFile = g_strUserTempPath + "\\scriptoutput.txt";
          if (typeof strOutputFile != "string") {
               strOutputFile = g_strUserTempPath + "\\scriptoutput.txt";
          //     default blnDisplay to false
          if (blnDisplay == undefined) {
               blnDisplay = false;
          if (typeof blnDisplay != "boolean") {
               blnDisplay = false;
          //     Cycle through all of the event scripts in the active document.
          for (var i = 1; i <= ActiveDocument.EventScripts.Count; i++) {
               strScriptName = ActiveDocument.EventScripts.Item(i).Name;
               strScript = "/* new script */\r\n";
               strScript += "//script:     " + strScriptName + "\r\n";
               strScript += "//object:     ActiveDocument.EventScripts[\"" + strScriptName + "\"].Script = \r\n";
               strScript += ActiveDocument.EventScripts.Item(i).Script;
               strScript += "\r\n";
               strOutput += strScript;
          //     Cycle through all of the sections in the ActiveDocument.
          for (var i = 1; i <= ActiveDocument.Sections.Count; i++) {
               //     Is it a dashboard?
               if (ActiveDocument.Sections.Item(i).Type == bqDashboard) {
                    //     Cycle through all of the event scripts in the dashboard.
                    strDashboardName = ActiveDocument.Sections.Item(i).Name;
                    for (var j = 1; j <= ActiveDocument.Sections.Item(i).EventScripts.Count; j++) {
                         strScriptName = ActiveDocument.Sections.Item(i).EventScripts.Item(j).Name;
                         strScript = "/* new script */\r\n";
                         strScript += "//dashboard:  " + strDashboardName + "\r\n";
                         strScript += "//script:     " + strScriptName + "\r\n";
                         strScript += "//object:     ActiveDocument.Sections[\"" + strDashboardName + "\"].EventScripts[\"" + strScriptName + "\"].Script = \r\n";
                         strScript += ActiveDocument.Sections.Item(i).EventScripts.Item(j).Script;
                         strScript += "\r\n";
                         strOutput += strScript;
                    //     Cycle through all of the shapes in the dashboard.
                    for (j = 1; j <= ActiveDocument.Sections.Item(i).Shapes.Count; j++) {
                         //     Cycle through all of the event scripts in the shape.
                         strShapeName = ActiveDocument.Sections.Item(i).Shapes.Item(j).Name;
                         for (var k = 1; k <= ActiveDocument.Sections.Item(i).Shapes.Item(j).EventScripts.Count; k++) {
                              strScriptName = ActiveDocument.Sections.Item(i).Shapes.Item(j).EventScripts.Item(k).Name;
                              strScript = "/* new script */\r\n";
                              strScript += "//dashboard:  " + strDashboardName + "\r\n";
                              strScript += "//shape:      " + strShapeName + "\r\n";
                              strScript += "//script:     " + strScriptName + "\r\n";
                              strScript += "//object:     ActiveDocument.Sections[\"" + strDashboardName + "\"].Shapes[\"" + strShapeName + "\"].EventScripts[\"" + strScriptName + "\"].Script = \r\n";
                              strScript += ActiveDocument.Sections.Item(i).Shapes.Item(j).EventScripts.Item(k).Script;
                              strScript += "\r\n";
                              strOutput += strScript;
          try {
               var oTS = ActiveDocument.g_fsoMain.CreateTextFile(false, true, strOutputFile);
               oTS.WriteLine(strOutput);
               oTS.Close();
               if (blnDisplay) Shell(g_strWinPath + "\\notepad.exe", strOutputFile);
          catch (e) {
               Console.Writeln("Scripts could not be output to " + strOutputFile);
          return strOutput;
     //     load scripts from a text file into the ActiveDocument
     ActiveDocument.InputScripts = function (strInputFile) {
          var strInput = "";
          var strScript = "";
          var strDashboardName = "";
          var strShapeName = "";
          var strScriptName = "";
          var objDashboardName;
          var objShapeName;
          var objScriptName;
          var strObjectName = "";
          //     validate input
          if (strInputFile == undefined) {
               return "Input file name is required";
          if (typeof strInputFile != "string") {
               return "Input file name must be a string";
          if (!ActiveDocument.g_fsoMain.FileExists(strInputFile)) {
               return strInputFile + " doesn't exist."
          var oTS = ActiveDocument.g_fsoMain.OpenTextFile(0, false, 1, strInputFile);
          while (!oTS.AtEndOfStream) {
               strInput = oTS.ReadLine();
               if (strInput == "\/* new script *\/") {
                    if (strScriptName != "") {
                         //     load the previous script
                         try {
                              objScript.Script = strScript.substr(0, strScript.length - 2);
                         catch (e) {
                              Console.Writeln(strObjectName + ".Script could not be set.");
                    //     read the new script
                    strDashboardName = "";
                    objDashboard = new Object();
                    strShapeName = "";
                    objShape = new Object();
                    strScriptName = "";
                    objScript = new Object();
                    strObjectName = "ActiveDocument";
                    while (strInput.indexOf("\/\/object") == -1) {
                         strInput = oTS.ReadLine();
                         if (strInput.substr(0, 14) == "//dashboard:  ") {
                              strDashboardName = strInput.substr(14);
                              strObjectName += ".Sections[\"" + strDashboardName + "\"]";
                              try {
                                   objDashboard = ActiveDocument.Sections[strDashboardName];
                              catch (e) {
                                   Console.Writeln(strObjectName + " does not exist.");
                         if (strInput.substr(0, 14) == "//shape:      ") {
                              strShapeName = strInput.substr(14);
                              strObjectName += ".Shapes[\"" + strShapeName + "\"]";
                              try {
                                   objShape = objDashboard.Shapes[strShapeName];
                              catch (e) {
                                   Console.Writeln(strObjectName + " does not exist.");
                         if (strInput.substr(0, 14) == "//script:     ") {
                              strScriptName = strInput.substr(14);
                              strObjectName += ".EventScripts[\"" + strDashboardName + "\"]";
                              if (strDashboardName == "" && strShapeName == "") {
                                   //     it's an ActiveDocument EventScript
                                   try {
                                        objScript = ActiveDocument.EventScripts[strScriptName];
                                   catch (e) {
                                        Console.Writeln(strObjectName + " does not exist.");
                              else {
                                   if (strDashboardName != "" && strShapeName == "") {
                                        //     it's a dashboard eventscript
                                        try {
                                             objScript = objDashboard.EventScripts[strScriptName];
                                        catch (e) {
                                             Console.Writeln(strObjectName + " does not exist.");
                                   else {
                                        //     it's a shape eventscript
                                        try {
                                             objScript = objShape.EventScripts[strScriptName];
                                        catch (e) {
                                             Console.Writeln(strObjectName + " does not exist.");
                    strScript = "";
               else {
                    strScript += strInput + "\r\n";
          //     load the last script
          try {
               objScript.Script = strScript.substr(0, strScript.length - 2);
          catch (e) {
               Console.Writeln(strObjectName + ".Script could not be set.");
          oTS.Close( );
     };I have set up a custom menu in IR Studio using Tools | Customize and included a Script Output var strTemp = ActiveDocument.Path.reverse();;strTemp = strTemp.substr(strTemp.indexOf(".")).reverse() + "js";;;ActiveDocument.wsdot_GlobalStartup.OutputScripts(strTemp, false);; item and a Script Input var strTemp = ActiveDocument.Path.reverse();;;strTemp = strTemp.substr(strTemp.indexOf(".")).reverse() + "js";;;ActiveDocument.wsdot_GlobalStartup.InputScripts(strTemp);; item. That way I have the ability to import/export scripting from any file, provided that my script library has been loaded. (So I have a menu item that loads the script library, too.)