First there isn’t too much to get this ActiveX controller up in running in the first place. There are great examples here that take you 95% of the way towards getting these up and running. A few little tricks we learned when setting up the javascript portion of the code are as follows:

• To set the page size use the following method (the example sets it to letter):

        csxi.SetTwainLayout(0,8.5,0,11)

• Some scanners do not reset to their defaults after a custom scan. You need to make sure you manually set all default settings before scanning. A few you may want to set:

        csxi.UseTwainInterface=false; //this makes sure that you are not prompted to change settings
        csxi.TwainAutoBright = true;
        csxi.TwainAutoDeskew = true;

• When beginning a multipage scan you must run the following three methods:
  

        csxi.TwainMultiImage = true;
        csxi.UseADF = true;
        csxi.ClearPDF();

One other fun thing we can do with ChestySoft’s TwainX controller is upload the captured data directly to the server. To do this in the javascript you need to do the following:

      Success = csxi.PostImage(url, file_name, param_name, graphics_format);
      if (Success) {
        //what to do when success
      } else {
        //what to do if error - here are recommendations:
        csxi.SaveToFile(path_on_desktop) //write data to desktop if you saved as a graphic; 
        csxi.WritePDF(path_on_desktop) //write data to desktop if you saved as a pdf; 
      }

Some notes about the preceding code. url a fully qualified url (including the ‘http://’). file_name is what will be included as original_filename when you are reading data on the server side. graphics_format is a enumeration that can be found here.

And the best thing is after you click on the button that runs your scan the information uploaded is the same as a standard file upload so you don’t have to do anything strange at all in ruby.