{"id":43306647,"url":"https://github.com/levigo/webtoolkit-icn-plugin","last_synced_at":"2026-02-01T20:36:56.526Z","repository":{"id":146442272,"uuid":"360075710","full_name":"levigo/webtoolkit-icn-plugin","owner":"levigo","description":"Plugin for IBM Content Navigator™ to use jadice® web toolkit as viewer for documents","archived":false,"fork":false,"pushed_at":"2022-09-06T11:36:33.000Z","size":969,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-05T21:12:43.888Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/levigo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-21T07:41:12.000Z","updated_at":"2022-09-06T07:47:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"f15f9eca-062e-407f-95a3-2f360d7ae6a4","html_url":"https://github.com/levigo/webtoolkit-icn-plugin","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/levigo/webtoolkit-icn-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levigo%2Fwebtoolkit-icn-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levigo%2Fwebtoolkit-icn-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levigo%2Fwebtoolkit-icn-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levigo%2Fwebtoolkit-icn-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/levigo","download_url":"https://codeload.github.com/levigo/webtoolkit-icn-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/levigo%2Fwebtoolkit-icn-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28989392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T20:36:14.625Z","status":"ssl_error","status_checked_at":"2026-02-01T20:36:11.271Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-01T20:36:55.808Z","updated_at":"2026-02-01T20:36:56.520Z","avatar_url":"https://github.com/levigo.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# webtoolkit-icn-plugin: ICN Plugin for jadice web toolkit\n\njadice® web toolkit is a web-based multi-format viewer for several formats like PDF, TIFF, AFP, MO:DCA, PNG, JPEG and more. \nWith this plugin jadice can be configured in IBM Content Navigator as viewer for documents instead of Daeja One Viewer.\n\n## Features\n\nBelow is a small list with features of the jadice web toolkit viewer\n\n| Feature                        | Available          |\n|--------------------------------| ------------------ |\n| P8 Annotations (read)          | :heavy_check_mark: |\n| P8 Annotations (write)         | :heavy_check_mark: |\n| Filenet IS Annotations (read)  | :heavy_check_mark: |\n| Extensibility                  | :star: :star: :star: |\n| configurable render quality    | :heavy_check_mark: |\n| viewer can be used outside ICN | :heavy_check_mark: |\n| OCR layer support              | :heavy_check_mark: |\n| Javascript API for viewer      | :heavy_check_mark: |\n\n### Render Quality\n\n\u003ca href=\"docs/daeja.jpg\"\u003e\u003cimg src=\"docs/daeja.jpg\" style=\"width:400px;height:371px;display:inline-block\"\u003e\u003c/a\u003e\n\u003ca href=\"docs/webtoolkit.jpg\"\u003e\u003cimg src=\"docs/webtoolkit.jpg\" style=\"width:381px;height:371px;display:inline-block\"\u003e\u003c/a\u003e\n\n## Version support\n\nThis plugin requires Content Navigator version 3.0.x and was tested with version 3.0.7 and version 3.0.9\n\n## Installation\n\n### Plugin Installation\n1. Make sure the plugin JAR-file (e.g. webtoolkit-content-navigator-plugin-1.2.0.jar) is accessible from Content Navigator\n2. Install the plugin via the admin-panel\n3. Make sure you correctly define the \"jadice web toolkit URL\" field in the plugin installation process (e.g. http://myicnhost/webtoolkit , see below).\n4. Create a view-mapping for the new plugin in the admin-panel\n5. Make sure the view-mapping is applied for the desired desktop\n\n### jadice web toolkit Installation\n\nThis url of jadice web toolkit configured in the plugin is used by the Content Navigator server to transfer \nthe documents to the jadice web toolkit and in the viewing window of the web-browser (client). \nAs the Content Navigator has a strict same-origin-policy, this URL must use the same base-path as the Content Navigator \nitself. To achieve this, either deploy the jadice web toolkit WAR-file on the same application server as the \nContent Navigator or use a proxy. Chapter 9.8 of the \"*Customizing and Extending\nIBM Content Navigator*\" Redbook provides more information about this setup. Hint: configure `underscores_in_headers on` \nin Nginx if you're using Nginx as reverse-proxy.\n\n#### Sidecar-deployment\n\nIn this setup, jadice web toolkit is installed on the same application server as the Content Navigator.\nWith this scenario you don't have to worry about same-origin problems. Unfortunately, if you need write\nsupport for annotations, this setup won't work as the IBM P8 libraries seem to interfere with the libraries\nthat are loaded by the Content Navigator. The solution is a standalone-deployment of jadice web toolkit.\n\n#### Standalone \u0026 Nginx\n\nYou can deploy jadice web toolkit to any other application server or run it as standalone application with Spring Boot.\nSince the Content Navigator plugin embeds the jadice viewer with an iframe, the same-policy-origin blocks the viewer\nfrom rendering in this setup. A reverse-proxy is needed to the Content Navigator and the jadice viewer do have\nthe same origin.\n\nIf you choose Nginx for this job, make sure you enable the option `underscores_in_headers on` in the server-block.\nAn example configuration could look like this:\n```text\nserver {\n  server_name ecm.levigo.de;\n  listen 8080 default_server;\n  underscores_in_headers on;\n\n  location /navigator/ {\n    proxy_pass http://localhost:9081/navigator/;\n    proxy_set_header X-Real-IP $remote_addr;\n    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n  }\n\n  location /webtoolkit/ {\n    proxy_pass http://localhost:8090/webtoolkit/;\n  }\n}\n```\n\n### Configuring write support for annotations\n\nSince version 1.2.0 of the plugin, it is possible to persist changes made to a document. The annotations are directly\nstored to the P8 repository. All you have to do is configure the plugin in the admin panel accordingly.\n\n## Integration\n\n### jadice web toolkit content navigator standalone viewer\n\nThe standalone viewer is ready-to-use and can directly be used as a viewer for the Content Navigator. It is an optimized version of the **enterprise demo** that is part of the jadice web toolkit artifact.\n\n1. deploy the webtoolkit-content-navigator-integration WAR-file to the same application server as the Content Navigator. This is mandatory as the Content Navigator enforces same-origin-policy\n2. deploy the WAR-file with the context path \"webtoolkit\" so that it is reachable via e.g. http://myicnhost/webtoolkit (where Content Navigator is accessible via http://myicnhost/navigator )\n\n### existing jadice web toolkit integration\n\nIf you already have a running jadice web toolkit installation, you can use the following module to extend the integration, so it can communicate with the webtoolkit-icn-plugin\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.levigo.jadice.webtoolkit\u003c/groupId\u003e\n    \u003cartifactId\u003ewebtoolkit-content-navigator-integration\u003c/artifactId\u003e\n\u003c/dependency\u003e\n```\n\nThe module is part of the jadice web toolkit and bound to the respective version. More information can be found in the README.md of this module.\n\n## Development\n\n- Get a j2ee.jar (e.g. from your Application server) and place it under /lib\n- Get navigatorAPI.jar from Content Navigator and place it under /lib\n- Run maven task e.g. `mvn install`\n\n## License\n\n[Apache License 2.0](https://github.com/levigo/webtoolkit-icn-plugin/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevigo%2Fwebtoolkit-icn-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flevigo%2Fwebtoolkit-icn-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevigo%2Fwebtoolkit-icn-plugin/lists"}