JSXGetURL for InDesign Server

What does it do?

JSXGetURL for InDesign Server enhances ExtendScript in InDesign Server to make it easy to access servers using http, https, sftp… – e.g. to download assets from a remote server.

Download link:

https://www.rorohiko.com/downloads/JSXGetURL.1.1.4.zip

Initially, JSXGetURL operates in demo mode, allowing up to 5 consecutive transfers after an instance restart. To continue using the service beyond this limit, activation is required by way of the PluginInstaller (see further).

This version is only for InDesign Server. We also have a version for Creative Cloud desktop applications.

We provide commercial training and developer support around JSXGetURL: if you need help integrating JSXGetURL into your custom solution, contact us at [email protected] to discuss training and support contracts.

Sample Code

JSXGetURL works on Mac and on Windows.

All you need to do is copy the JSXGetURL folder to sit alongside your own ExtendScript script, and then add an //@include line at the top of your script.

Sample code:

//@include "JSXGetURL/JSXGetURLLoader.jsx"
var getURL = JSXGetURL();

getURL.addRequestHeader("Accept: */*");
var s = getURL.get("https://www.rorohiko.com") + "";

alert(s.substr(0,1000));

var headers = getURL.getResponseHeaders();
alert(headers);

// Some random FTP file for testing

var f = new File("~/Desktop/sha512.sum");
var s = getURL.get("ftp://cygwin.com/pub/gcc/sha512.sum", f.fsName);

// Some zip file to test binary file download

var f = new File("~/Desktop/FrameReporter.1.1.8.zip");
getURL.get("https://www.rorohiko.com/downloads/FrameReporter.1.1.8.zip", f.fsName);

JSXGetURL is implemented as an ExtendScript DLL/framework, written in C/C++.

PluginInstaller

The PluginInstaller is provided in the Helpers subfolder.

You may relocate it to a convenient location (e.g., /Applications or C:\Program Files).

After downloading, and each time you move the PluginInstaller application to a different location on your computer, you need to launch the app once, so it can reconfigure itself.

Demo

Run sample.jsx alongside the JSXGetURL folder from an InDesign Server instance.

Installing JSXGetURL

Copy the JSXGetURL subfolder to reside next to your own script (.jsx). Look at the sample.jsx file for example code.

Modify your script and at the top, add a line

//@include "JSXGetURL/JSXGetURLLoader.jsx"

Then model your transfer logic by mimicking the code you see in sample.jsx, to perform the transfers you need.

Installing PluginInstaller

Mac

If desired, move the PluginInstaller application file to its desired location.

Double-click the PluginInstaller application icon to run the app from its current location at least once.

Windows

If desired, move the PluginInstaller folder for your Windows platform (arm64 vs x86_64) to its desired location.

Navigate into the PluginInstaller folder and double-click the PluginInstaller.exe icon to run the app from its new location at least once.

Activating

Standard Account

You need a Standard Account to activate the software.

Start the PluginInstaller.

Create a standard account by clicking the New button, bottom right of the Accounts window.

Enter a descriptive name and a valid email address, and choose an unlock code. You need to enter the same unlock code twice.

Click OK.

After the account has been created, click Register to register the account.

You will receive a confirmation email with a confirmation link.

If the email does not arrive, make sure to check your email spam filter!

Save Unlock Code

On the Accounts window, there is a checkbox Save Unlock Code.

If you’re on a secure personal computer or secure server, you should select your account, then tick the box to save the unlock code.

If you don’t save the unlock code, you will need to re-enter the code each time you start the PluginInstaller, and you will need to keep PluginInstaller active each time you want to access JSXGetURL.

Multiple Accounts

You can create as many accounts as needed.

It is allowed to re-use the same email address and unlock code for multiple accounts.

If you do re-use the same email address for more than one account, they become hard to distinguish. Make sure to use good descriptive names, so you can tell the accounts apart.

For example, you might use one account that you keep for your own personal use, and one or more additional accounts that you could use for ordering embeddable JSXGetURL activations to pass on to your customers or colleagues.

Always make sure your account is unlocked. If you did not save your unlock code, you will need to re-enter the code if the account is locked.

Fetch Product Info

Now we need to add the product information for the software to be activated into the PluginInstaller.

Use the Store window in the PluginInstaller, and browse into the Rorohiko Catalog.

Click the entry for the desktop version of JSXGetURL to open the Order a License window in the PluginInstaller.

Create an Order

Enter the number of seats needed.

Type in some order reference that will have relevance to you.

Finally, if you have multiple accounts available, you will now need to select the correct account from the popup menu.

Then click the Save button.

This creates a License Request file (.lirq file name extension).

Send us your order

Attach this .lirq file to an email to mailto:[email protected].

In your email, make sure to mention any additional details that might be relevant or useful (e.g. let us know if you prefer us to send you a PayPal invoice).

Payment

Payment processing is not yet automated – you need to manually send payment of US$949/server-machine using PayPal, to [email protected].

With your payment, make sure to mention the order reference that you used in the PluginInstaller, so we can match your payment to the order info embedded in the License Request.

    https://www.paypal.com

Activation File

Once we have received your payment, we will email you an activation file for the order, which will have a .capb file name extension. Again, make sure to check your email spam filter!

Start the PluginInstaller and go to the Licenses, Activations and Pending Orders window.

Click Import and import the .capb file.

The PluginInstaller will match this activation file to the outstanding order.

Activate

In the Licenses, Activations and Pending Orders window you can now select the order entry and click the Activate button to activate your workstation.

The 5-transfer limit will now be removed from JSXGetURL.

Sublicensing/auto-activation

You might want to embed JSXGetURL into your own commercial software, or have JSXGetURL auto-activate so the end-user does not have to handle any activations. To achieve this, you can embed activation info into your source code or provide it as a side-car file.

Please consult the README.md document provided with JSXGetURL.

Version History

Version 1.1.4, 25-Apr-2024

  • Can now set various CURL options (e.g. to follow redirects).
  • Upgraded dependencies: curl 8.7.1, OpenSSL 3.3.0, zlib 1.3.1

Version 1.1.3, 31-Mar-2024:

  • No changes to JSXGetURL. Unbundle PluginInstaller to avoid having to update JSXGetURL with each new PluginInstaller version.

Version 1.1.2, 26-Mar-2024:

  • No changes to JSXGetURL itself. Improvements to the bundled PluginInstaller.

Version 1.1.1, 22-Mar-2024:

  • No changes to JSXGetURL itself. License Manager renamed to PluginInstaller.

Version 1.1.0, 16-Mar-2024:

  • License Manager now handles dark mode.
  • Fixed a bug with sublicensing/autoactivation on machines that do not have License Manager installed.

Version 1.0.9, 7-Mar-2024:

  • Fixed bug in sub-licensing feature: sub-licensed workstations did not always activate, even with a valid .actv file or TIGHTENER.... code snippet.
  • The License Manager is the same as with version 1.0.8 – dark mode problems have not been fixed yet.

Version 1.0.8, 26-Feb-2024:

  • Improved License Manager

Version 1.0.7, 21-Feb-2024:

  • Fixed an issue with the License Manager unable to activate selection

Version 1.0.6, 20-Feb-2024:

  • Fixed an of issue with sublicensing using sidecar files

Version 1.0.5, 19-Feb-2024:

  • Fixed a number of issues with sub-licensing and sidecar activation files.