Okapi Components for WorldServer

This repository contains custom WorldServer components developed using the WorldServer SDK (WSSDK), based on filters and other components available as part of the open source Okapi Framework.

Currently, this repository contains:

• Filters, including
  • YAML
  • po/pot (gettext)
  • JSON
• MT Adapters, including
  • Microsoft Translator Hub
• Common code, including
  • Classes for generating table-based config UIs
  • Classes to simplify working with WSAttribute values

The code also includes a common framework for developing WorldServer filters that adhere to the Okapi IFilter interface, making it easy to add additional components. Our intention is that over time, the set of available components will grow to fill gaps in the WorldServer filter and MT Adapter using open source code from Okapi.

Using the Code

Using the WorldServer SDK with Maven

The project builds with maven. However, the code has a compile-time dependency on the wssdk-server.jar which SDL includes as part of its WorldServer SDK distribution. This file is not normally accessible to Maven, so you must install it in a local repository to use it.

The project pom.xml references the dependency via invented artifact and group IDs:

• Artifact ID: com.idiominc.wssdk
• Group ID: wssdk-server
• Version: We use the WS Build version, which for us is currently 10.4.3.195.

To install your copy of wssdk-server.jar to your local maven repository, you can run this command from within your WSSDK distribution:

mvn install:install-file -DgroupId=com.idiominc.wssdk \
             -DartifactId=wssdk-server \
             -Dversion=10.4.3.195 \
             -Dpackaging=jar \
             -Dfile=lib/server/wssdk-server.jar 

You can also use mvn deploy:deploy-file to deploy to a shared repository for convenience.

WSSDK Compatibility and Java Versions

This code was developed and tested against the WSSDK 10.4 SDK, however it should be expected to work on most 10.x versions of WorldServer (and possibly even 9.x), due to the stability of the WSSDK. You will need to update the ws.version property in the root pom.xml to match the version you are compiling against.

All Okapi releases since M24 require Java 7 or later, so these components must be deployed to a WorldServer instance running Java 7 or later.

Building

Run mvn install from the root directory to build all components.

If you are using an IDE, you should still build once from the command line in order to generate the Version.java file that is referenced from various places in the code.

Deploying

Components can be deployed individually or in bundles. All components are deployed as JARs via the Management > Administration > Customization screen in WorldServer. (WSSDK components are usually deployed as zip files, but WorldServer doesn't care about the extension; a JAR file works fine, as long as it contains a desc.xml file, as these do.)

To deploy an individual components, upload any of:

• filters/json/target/okapi-ws-filters-json-1.2-SNAPSHOT.jar
• filters/po/target/okapi-ws-filters-po-1.2-SNAPSHOT.jar
• filters/yaml/target/okapi-ws-filters-yaml-1.2-SNAPSHOT.jar
• mt/mshub/target/okapi-ws-mt-mshub-1.2-SNAPSHOT.jar

To deploy all filters at once, upload:

• filters/bundle/target/okapi-ws-filters-base-1.2-SNAPSHOT.jar

To deploy all components (all filters + MT Adapters), upload:

• bundle/target/okapi-ws-base-1.2-SNAPSHOT.jar

These jars include all dependencies, including the necessary Okapi components.

Configuring

Currently, the filter configurations are hard-coded internally to sensible defaults, with some options exposed through the WorldServer UI. Over time, we would like to improve this to expose the full configurability of the Okapi filters to WorldServer users.

The MT Adapters offer no real configuration beyond the credentials to use. These are exposed through the the normal WorldServer MT Adapter configuration interface.

About

This project is a joint collaboration between Spartan Software, Inc. and Tableau Software.

License

All code is licensed under the MIT License.

Contributing

Contributions from the community are welcome. Issues and pull requests should be opened through GitHub. Discussion can be directed to one of the two Okapi discussion lists:

• okapitools, for user discussions
• okapi-devel, for developer discussions

Additional documentation can be found on the wiki.

Questions or comments can also be sent to [email protected].