typo in changelog

Feature/fix lang

.github/workflows/artifact-csharp-mvc.yml

@@ -0,0 +1,33 @@
+name: Artifact Csharp MVC
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/csharp-mvc/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/csharp-mvc/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/csharp-mvc
+          mkdir -p ./deploy/'DotNet (Csharp MVN) Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'DotNet (Csharp MVC) Example'
+          cd ./deploy/'DotNet (Csharp MVC) Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: DotNet.Csharp.MVC.Example
+          path: ${{ github.workspace }}/web/documentserver-example/csharp-mvc/deploy

.github/workflows/artifact-csharp.yml

@@ -0,0 +1,33 @@
+name: Artifact Csharp
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/csharp/**']
+  pull_request:
+    branches: [master, main, develop]
+    paths: ['web/documentserver-example/csharp/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/csharp
+          mkdir -p ./deploy/'DotNet (Csharp) Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'DotNet (Csharp) Example'
+          cd ./deploy/'DotNet (Csharp) Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: DotNet.Csharp.Example
+          path: ${{ github.workspace }}/web/documentserver-example/csharp/deploy

.github/workflows/artifact-java.yml

@@ -0,0 +1,33 @@
+name: Artifact Java
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/java
+          mkdir -p ./deploy/'Java Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'Java Example'
+          cd ./deploy/'Java Example'/src/main/resources/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: Java.Example
+          path: ${{ github.workspace }}/web/documentserver-example/java/deploy

.github/workflows/artifact-node.yml

@@ -0,0 +1,33 @@
+name: Artifact Nodejs
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/nodejs/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/nodejs/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/nodejs
+          mkdir -p ./deploy/'Node.js Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'Node.js Example'
+          cd ./deploy/'Node.js Example'/public/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: Node.js.Example
+          path: ${{ github.workspace }}/web/documentserver-example/nodejs/deploy

.github/workflows/artifact-php.yml

@@ -0,0 +1,33 @@
+name: Artifact PHP
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/php/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/php/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/php
+          mkdir -p ./deploy/'PHP Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'PHP Example'
+          cd ./deploy/'PHP Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: PHP.Example
+          path: ${{ github.workspace }}/web/documentserver-example/php/deploy

.github/workflows/artifact-python.yml

@@ -0,0 +1,33 @@
+name: Artifact Python
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/python/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/python/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/python
+          mkdir -p ./deploy/'Python Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'Python Example'
+          cd ./deploy/'Python Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: Python.Example
+          path: ${{ github.workspace }}/web/documentserver-example/python/deploy

.github/workflows/artifact-ruby.yml

@@ -0,0 +1,33 @@
+name: Artifact Ruby
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/ruby/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/ruby/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/ruby
+          mkdir -p ./deploy/'Ruby Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'Ruby Example'
+          cd ./deploy/'Ruby Example'/public/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: Ruby.Example
+          path: ${{ github.workspace }}/web/documentserver-example/ruby/deploy

.github/workflows/artifact-spring.yml

@@ -0,0 +1,33 @@
+name: Artifact Java Spring
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java-spring/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java-spring/**']
+
+jobs:
+  artifact:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Build Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/java-spring
+          mkdir -p ./deploy/'Java Spring Example'
+          rsync -av --exclude='deploy' ./ ./deploy/'Java Spring Example'
+          cd ./deploy/'Java Spring Example'/src/main/resources/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: Java.Spring.Example
+          path: ${{ github.workspace }}/web/documentserver-example/java-spring/deploy

.github/workflows/lint-php.yml

@@ -22,8 +22,10 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.2'
           tools: cs2pr, phpcs
           
       - name: Run phpcs
-        run: phpcs -q --extensions=php,module,inc,install,test,profile,theme,css,info,txt,md,yml --ignore=node_modules,bower_components,vendor ./
+        run: |
+          phpcs --version
+          phpcs -q --extensions=php,module,inc,install,test,profile,theme,info --ignore=node_modules,bower_components,vendor,css,js,lib --standard=./ruleset.xml ./

.github/workflows/release.yml

@@ -0,0 +1,146 @@
+name: Release
+
+on:
+  push:
+    branches: [master,main]
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - name: Install Zip
+        run: sudo apt-get install zip
+      - name: Get Info
+        run: |
+          echo "version=$(grep -Eo '[0-9]+(\.[0-9]+)+' CHANGELOG.md | head -n 1)" >> $GITHUB_OUTPUT
+        id: info
+      - name: Generate Changelog
+        run: |
+          awk '/## [0-9]/{p++} p; /## [0-9]/{if (p > 1) exit}' CHANGELOG.md | awk 'NR>2 {print last} {last=$0}' > RELEASE.md
+      - name: Build Csharp MVC Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/csharp-mvc
+          mkdir -p ./'DotNet (Csharp MVC) Example'
+          rsync -av --exclude='DotNet (Csharp MVC) Example' ./ ./'DotNet (Csharp MVC) Example'
+          cd ./'DotNet (Csharp MVC) Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Build Csharp Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/csharp
+          mkdir -p ./'DotNet (Csharp) Example'
+          rsync -av --exclude='DotNet (Csharp) Example' ./ ./'DotNet (Csharp) Example'
+          cd ./'DotNet (Csharp) Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Build Java Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/java
+          mkdir -p ./'Java Example'
+          rsync -av --exclude='Java Example' ./ ./'Java Example'
+          cd ./'Java Example'/src/main/resources/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Build Nodejs Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/nodejs
+          mkdir -p ./'Node.js Example'
+          rsync -av --exclude='Node.js Example' ./ ./'Node.js Example'
+          cd ./'Node.js Example'/public/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Build PHP Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/php
+          mkdir -p ./'PHP Example'
+          rsync -av --exclude='PHP Example' ./ ./'PHP Example'
+          cd ./'PHP Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Build Python Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/python
+          mkdir -p ./'Python Example'
+          rsync -av --exclude='Python Example' ./ ./'Python Example'
+          cd ./'Python Example'/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Build Ruby Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/ruby
+          mkdir -p ./'Ruby Example'
+          rsync -av --exclude='Ruby Example' ./ ./'Ruby Example'
+          cd ./'Ruby Example'/public/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Build Spring Artifact
+        run: |
+          cd ${{ github.workspace }}
+          cwd=$(pwd)
+          git submodule update --init --recursive
+          cd ./web/documentserver-example/java-spring
+          mkdir -p ./'Java Spring Example'
+          rsync -av --exclude='Java Spring Example' ./ ./'Java Spring Example'
+          cd ./'Java Spring Example'/src/main/resources/assets
+          rm -rf ./.git/
+          rm .git
+      - name: Pack Artifacts
+        run: |
+          cd ${{ github.workspace }}/web/documentserver-example/csharp-mvc
+          zip -r DotNet.Csharp.MVC.Example.zip ./'DotNet (Csharp MVC) Example'
+          cd ${{ github.workspace }}/web/documentserver-example/csharp
+          zip -r DotNet.Csharp.Example.zip ./'DotNet (Csharp) Example'
+          cd ${{ github.workspace }}/web/documentserver-example/java
+          zip -r Java.Example.zip ./'Java Example'
+          cd ${{ github.workspace }}/web/documentserver-example/nodejs
+          zip -r Node.js.Example.zip ./'Node.js Example'
+          cd ${{ github.workspace }}/web/documentserver-example/php
+          zip -r PHP.Example.zip ./'PHP Example'
+          cd ${{ github.workspace }}/web/documentserver-example/python
+          zip -r Python.Example.zip ./'Python Example'
+          cd ${{ github.workspace }}/web/documentserver-example/ruby
+          zip -r Ruby.Example.zip ./'Ruby Example'
+          cd ${{ github.workspace }}/web/documentserver-example/java-spring
+          zip -r Java.Spring.Example.zip ./'Java Spring Example'
+      - name: Create Release
+        uses: ncipollo/release-action@v1
+        id: create_release
+        with:
+          bodyFile: RELEASE.md
+          artifacts: "
+            ${{ github.workspace }}/web/documentserver-example/csharp-mvc/DotNet.Csharp.MVC.Example.zip,
+            ${{ github.workspace }}/web/documentserver-example/csharp/DotNet.Csharp.Example.zip,
+            ${{ github.workspace }}/web/documentserver-example/java/Java.Example.zip,
+            ${{ github.workspace }}/web/documentserver-example/nodejs/Node.js.Example.zip,
+            ${{ github.workspace }}/web/documentserver-example/php/PHP.Example.zip,
+            ${{ github.workspace }}/web/documentserver-example/python/Python.Example.zip,
+            ${{ github.workspace }}/web/documentserver-example/ruby/Ruby.Example.zip,
+            ${{ github.workspace }}/web/documentserver-example/java-spring/Java.Spring.Example.zip
+          "
+          tag: v${{ steps.info.outputs.version }}

.gitignore

@@ -11,6 +11,19 @@
 **/.vscode/
 **/.vs/
 **/.idea
+.classpath
+.project
+.settings/
+*.iml
+*.iws
+.DS_Store
 /web/documentserver-example/java/target/
+/web/documentserver-example/java-spring/target/
 /web/documentserver-example/csharp/packages
 /web/documentserver-example/csharp-mvc/packages
+/web/documentserver-example/java-spring/documents/
+/web/documentserver-example/ruby/.bundle
+/web/documentserver-example/ruby/db/*.sqlite3
+/web/documentserver-example/ruby/db/*.sqlite3-journal
+/web/documentserver-example/ruby/log/*
+/web/documentserver-example/ruby/tmp

3rd-Party.license

@@ -19,6 +19,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license
@@ -46,6 +50,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license
@@ -81,6 +89,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license
@@ -108,6 +120,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license
@@ -199,6 +215,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license
@@ -246,10 +266,108 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license
 
+JWT           - JSON Web Token implementation (https://github.com/firebase/php-jwt/blob/master/LICENSE)
+License:        BSD-3-Clause
+License File:   jwt.license
+
+PHP_CodeSniffer - PHP_CodeSniffer is a set of two PHP scripts; the main phpcs script that tokenizes PHP, JavaScript and CSS files to detect violations of a defined coding standard, and a second phpcbf script to automatically correct coding standard violations. PHP_CodeSniffer is an essential development tool that ensures your code remains clean and consistent. (https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt)
+License:        BSD-3-Clause
+License File:   PHP_CodeSniffer.license
+
+
+web/documentserver-example/python
+
+Django        - Django is a high-level Python web framework that encourages rapid development and clean, pragmatic design. Thanks for checking it out. (https://github.com/django/django/blob/main/LICENSE)
+License:        BSD-3-Clause
+License File:   Django.license
+
+jQuery        - jQuery is a new kind of JavaScript Library.        jQuery is a fast and concise JavaScript Library that simplifies HTML document traversing, event handling, animating, and Ajax interactions for rapid web development. jQuery is designed to change the way that you write JavaScript.        NOTE: This package is maintained on behalf of the library owners by the NuGet Community Packages project at https://nugetpackages.codeplex.com/ (https://jquery.org/license/)
+License:        MIT
+License File:   jQuery.license
+
+jQuery.BlockUI - The jQuery BlockUI Plugin lets you simulate synchronous behavior when using AJAX, without locking the browser. (https://github.com/malsup/blockui/)
+License:        MIT, GPL
+License File:   jQuery.BlockUI.license
+
+jQuery.FileUpload - File Upload widget with multiple file selection, drag&drop support, progress bar, validation and preview images, audio and video for jQuery. Supports cross-domain, chunked and resumable file uploads. Works with any server-side platform (Google App Engine, PHP, Python, Ruby on Rails, Java, etc.) that supports standard HTML form file uploads. (https://github.com/blueimp/jQuery-File-Upload/blob/master/LICENSE.txt)
+License:        MIT
+License File:   jQuery.FileUpload.license
+
+jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https://github.com/blueimp/jQuery-File-Upload/blob/master/LICENSE.txt)
+License:        MIT
+License File:   jQuery.iframe-transport.license
+
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
+jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
+License:        MIT
+License File:   jQuery.UI.license
+
+PyJWT         - A Python implementation of RFC 7519. (https://github.com/jpadilla/pyjwt/blob/master/LICENSE)
+License:        MIT
+License File:   PyJWT.license
+
+python-magic  - python-magic is a Python interface to the libmagic file type identification library. (https://github.com/ahupp/python-magic/blob/master/LICENSE)
+License:        MIT
+License File:   python-magic.license
+
+requests      - Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your PUT & POST data — but nowadays, just use the json method! (https://github.com/psf/requests/blob/main/LICENSE)
+License:        Apache 2.0
+License File:   requests.license
+
+
+web/documentserver-example/python
+
+Django        - Django is a high-level Python web framework that encourages rapid development and clean, pragmatic design. Thanks for checking it out. (https://github.com/django/django/blob/main/LICENSE)
+License:        BSD-3-Clause
+License File:   Django.license
+
+jQuery        - jQuery is a new kind of JavaScript Library.        jQuery is a fast and concise JavaScript Library that simplifies HTML document traversing, event handling, animating, and Ajax interactions for rapid web development. jQuery is designed to change the way that you write JavaScript.        NOTE: This package is maintained on behalf of the library owners by the NuGet Community Packages project at https://nugetpackages.codeplex.com/ (https://jquery.org/license/)
+License:        MIT
+License File:   jQuery.license
+
+jQuery.BlockUI - The jQuery BlockUI Plugin lets you simulate synchronous behavior when using AJAX, without locking the browser. (https://github.com/malsup/blockui/)
+License:        MIT, GPL
+License File:   jQuery.BlockUI.license
+
+jQuery.FileUpload - File Upload widget with multiple file selection, drag&drop support, progress bar, validation and preview images, audio and video for jQuery. Supports cross-domain, chunked and resumable file uploads. Works with any server-side platform (Google App Engine, PHP, Python, Ruby on Rails, Java, etc.) that supports standard HTML form file uploads. (https://github.com/blueimp/jQuery-File-Upload/blob/master/LICENSE.txt)
+License:        MIT
+License File:   jQuery.FileUpload.license
+
+jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https://github.com/blueimp/jQuery-File-Upload/blob/master/LICENSE.txt)
+License:        MIT
+License File:   jQuery.iframe-transport.license
+
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
+jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
+License:        MIT
+License File:   jQuery.UI.license
+
+PyJWT         - A Python implementation of RFC 7519. (https://github.com/jpadilla/pyjwt/blob/master/LICENSE)
+License:        MIT
+License File:   PyJWT.license
+
+python-magic  - python-magic is a Python interface to the libmagic file type identification library. (https://github.com/ahupp/python-magic/blob/master/LICENSE)
+License:        MIT
+License File:   python-magic.license
+
+requests      - Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your PUT & POST data — but nowadays, just use the json method! (https://github.com/psf/requests/blob/main/LICENSE)
+License:        Apache 2.0
+License File:   requests.license
+
 
 web/documentserver-example/ruby
 
@@ -281,6 +399,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license

CHANGELOG.md

@@ -1,5 +1,28 @@
 # Change Log
 
+- si skin languages
+- fix "no" skin languages
+- anonymous can't change viewer to edit
+- referenceData
+- anonymous can't protect file
+- separate setting for checking the token in requests
+- php: linter refactoring
+- horizontal scroll fix for Internet Explorer
+- save file with extension from response after conversation
+- conversation to ooxml
+
+## 1.5.1
+- update jquery
+
+## 1.5.0
+- nodejs: added wopi putRelativeFile action
+- nodejs: wopi editnew action for exisiting file
+- nodejs: fix wopi actions after restart
+- setting an unavailable language
+- description in the tooltip on the main page
+- nodejs: referenceData
+- option to send directUrl
+
 ## 1.4.0
 - nodejs: option to send directUrl
 - opening file on client by directUrl
@@ -34,6 +57,5 @@
 - creating docxf
 - opening docxf, oform
 
-
 ## 1.0.0
 - added java spring

build/msbuild/zip.proj

@@ -26,13 +26,13 @@
     <RemoveDir Directories="$(To)" ContinueOnError="true" />
 
     <ItemGroup>
-      <ZipFilesCSharp Include="$(DirCSharp)**" Exclude="$(DirCSharp)obj\**;$(DirCSharp)**\.git" />
+      <ZipFilesCSharp Include="$(DirCSharp)**" Exclude="$(DirCSharp).vs\**;$(DirCSharp)bin\*.pdb;$(DirCSharp)bin\*.xml;$(DirCSharp)obj\**;$(DirCSharp)packages\**;$(DirCSharp)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesCSharp)" DestinationFiles="@(ZipFilesCSharp->'$(NameCSharp)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameCSharp)" WorkingDirectory="$(To)" ZipFileName="$(NameCSharp).zip" />
 
     <ItemGroup>
-      <ZipFilesMVC Include="$(DirMvc)**" Exclude="$(DirMvc)obj\**;$(DirMvc)**\.git" />
+      <ZipFilesMVC Include="$(DirMvc)**" Exclude="$(DirMvc).vs\**;$(DirMvc)bin\*.pdb;$(DirMvc)bin\*.xml;$(DirMvc)obj\**;$(DirMvc)packages\**;$(DirMvc)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesMVC)" DestinationFiles="@(ZipFilesMVC->'$(NameMvc)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameMvc)" WorkingDirectory="$(To)" ZipFileName="$(NameMvc).zip" />

web/documentserver-example/csharp-mvc/3rd-Party.license

@@ -20,6 +20,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license

web/documentserver-example/csharp-mvc/App_Start/BundleConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -28,6 +28,7 @@ namespace OnlineEditorsExampleMVC
             // create a jquery script bundle
             bundles.Add(new ScriptBundle("~/bundles/jquery").Include(
                 "~/Scripts/jquery-{version}.js",
+                "~/Scripts/jquery-migrate-{version}.js",
                 "~/Scripts/jquery-ui.js",
                 "~/Scripts/jquery.blockUI.js",
                 "~/Scripts/jquery.iframe-transport.js",

web/documentserver-example/csharp-mvc/App_Start/FilterConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/App_Start/RouteConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/App_Start/WebApiConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Content/editor.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Content/media.css

@@ -1,4 +1,22 @@
-@media (min-width: 1280px)  and (max-width: 1380px) {
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+ @media (min-width: 1280px)  and (max-width: 1380px) {
     .copy {
         margin-right: 6.5%;
     }
@@ -664,3 +682,8 @@
         max-width:15%;
     }
 }
+@media all and (-ms-high-contrast: none), (-ms-high-contrast: active) {
+    .tableRow td:first-child{
+        max-width: none;
+    }
+}

web/documentserver-example/csharp-mvc/Content/stylesheet.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -167,7 +167,7 @@ label .checkbox {
     background-image: url("images/file_docxf.svg");
 }
 
-.create-sample {
+.side-option {
     color: #666666;
     line-height: 24px;
 }
@@ -740,3 +740,28 @@ html {
 .user-descr > b {
     margin-left: 25px;
 }
+
+.tooltip {
+    background: #FFFFFF;
+    border-radius: 5px;
+    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
+    color: #666666;
+    line-height: 160%;
+    max-width: 455px;
+    padding: 14px;
+    position: absolute;
+}
+
+.tooltip ul {
+    margin: 0;
+}
+
+.arrow {
+    border-top: 8px solid transparent;
+    border-bottom: 8px solid transparent;
+    border-right: 8px solid #FFFFFF;
+    left: -4px;
+    position: absolute;
+    top: 50%;
+    transform: translate(-50%, -50%);
+}

web/documentserver-example/csharp-mvc/Controllers/HomeController.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@
  *
  */
 
+using System;
 using System.IO;
 using System.Web.Mvc;
 using OnlineEditorsExampleMVC.Helpers;
@@ -31,13 +32,14 @@ namespace OnlineEditorsExampleMVC.Controllers
         }
 
         // viewing file in the editor
-        public ActionResult Editor(string fileName, string editorsMode, string editorsType)
+        public ActionResult Editor(string fileName, string editorsMode, string editorsType, string directUrl)
         {
             var file = new FileModel
             {
                 Mode = editorsMode,  // editor mode: edit or view
                 Type = editorsType,  // editor type: desktop, mobile, embedded
-                FileName = Path.GetFileName(fileName)  // file name
+                FileName = Path.GetFileName(fileName),  // file name
+                IsEnabledDirectUrl = directUrl != null ? Convert.ToBoolean(directUrl) : false
             };
 
             return View("Editor", file);

web/documentserver-example/csharp-mvc/Global.asax.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Helpers/DocManagerHelper.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -442,5 +442,11 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
             return languages;
         }
+
+        public static string GetDirectUrl()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return isEnabledDirectUrl != null ? isEnabledDirectUrl : "false";
+        }
     }
 }

web/documentserver-example/csharp-mvc/Helpers/DocumentConverter.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -68,24 +68,24 @@ namespace OnlineEditorsExampleMVC.Helpers
         /// <param name="toExtension">Extension to which to convert</param>
         /// <param name="documentRevisionId">Key for caching on service</param>
         /// <param name="isAsync">Perform conversions asynchronously</param>
-        /// <param name="convertedDocumentUri">Uri to the converted document</param>
+        /// <param name="convertedDocumentData">Uri and file type of the converted document</param>
         /// <returns>The percentage of conversion completion</returns>
         /// <example>
-        /// string convertedDocumentUri;
-        /// GetConvertedUri("http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", ".pdf", ".docx", "http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", false, out convertedDocumentUri);
+        /// Dictionary<string, string> convertedDocumentData;
+        /// GetConvertedData("http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", ".pdf", ".docx", "http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", false, out convertedDocumentData);
         /// </example>
         /// <exception>
         /// </exception>
-        public static int GetConvertedUri(string documentUri,
+        public static int GetConvertedData(string documentUri,
                                           string fromExtension,
                                           string toExtension,
                                           string documentRevisionId,
                                           bool isAsync,
-                                          out string convertedDocumentUri,
+                                          out Dictionary<string, string> convertedDocumentData,
                                           string filePass = null,
                                           string lang = null)
         {
-            convertedDocumentUri = string.Empty;
+            convertedDocumentData = new Dictionary<string, string>();
 
             // check if the fromExtension parameter is defined; if not, get it from the document url
             fromExtension = string.IsNullOrEmpty(fromExtension) ? Path.GetExtension(documentUri).ToLower() : fromExtension;
@@ -119,7 +119,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                 { "region", lang }
             };
 
-            if (JwtManager.Enabled)
+            if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
             {
                 // create payload object
                 var payload = new Dictionary<string, object>
@@ -130,7 +130,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                 var payloadToken = JwtManager.Encode(payload);  // encode the payload object to the payload token
                 var bodyToken = JwtManager.Encode(body);  // encode the body object to the body token
                 // create header token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);
 
                 body.Add("token", bodyToken);
@@ -157,7 +157,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                 }
             }
 
-            return GetResponseUri(dataResponse, out convertedDocumentUri);
+            return GetResponseData(dataResponse, out convertedDocumentData);
         }
 
         /// <summary>
@@ -181,9 +181,9 @@ namespace OnlineEditorsExampleMVC.Helpers
         /// Processing document received from the editing service
         /// </summary>
         /// <param name="jsonDocumentResponse">The resulting json from editing service</param>
-        /// <param name="responseUri">Uri to the converted document</param>
+        /// <param name="responseData">Uri and file type of the converted document</param>
         /// <returns>The percentage of conversion completion</returns>
-        private static int GetResponseUri(string jsonDocumentResponse, out string responseUri)
+        private static int GetResponseData(string jsonDocumentResponse, out Dictionary<string, string> responseData)
         {
             if (string.IsNullOrEmpty(jsonDocumentResponse)) throw new ArgumentException("Invalid param", "jsonDocumentResponse");
 
@@ -197,14 +197,20 @@ namespace OnlineEditorsExampleMVC.Helpers
             var isEndConvert = responseFromService.endConvert;
 
             int resultPercent;
-            responseUri = string.Empty;
+            responseData = new Dictionary<string, string>(); 
+            var responseUri = string.Empty;
+            var responseFileType = string.Empty;
             if (isEndConvert)  // if the conversion is completed
             {
                 responseUri = responseFromService.fileUrl;  // get the file url
+                responseFileType = responseFromService.fileType;  // get the file type
+                responseData.Add("fileUrl", responseUri);
+                responseData.Add("fileType", responseFileType);
                 resultPercent = 100;
             }
             else  // if the conversion isn't completed
             {
+                responseData.Add("fileUrl", "");
                 resultPercent = responseFromService.percent;  // get the percentage value
                 if (resultPercent >= 100) resultPercent = 99;
             }

web/documentserver-example/csharp-mvc/Helpers/JwtManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -29,11 +29,13 @@ namespace OnlineEditorsExampleMVC.Helpers
     {
         private static readonly string Secret;
         public static readonly bool Enabled;
+        public static readonly bool SignatureUseForRequest;
 
         static JwtManager()
         {
             Secret = WebConfigurationManager.AppSettings["files.docservice.secret"] ?? "";  // get token secret from the config parameters
             Enabled = !string.IsNullOrEmpty(Secret);  // check if the token is enabled
+            SignatureUseForRequest = bool.Parse(WebConfigurationManager.AppSettings["files.docservice.token.useforrequest"]);
         }
 
         // encode a payload object into a token using a secret key

web/documentserver-example/csharp-mvc/Helpers/TrackManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -53,9 +53,9 @@ namespace OnlineEditorsExampleMVC.Helpers
             var fileData = jss.Deserialize<Dictionary<string, object>>(body);
 
             // check if the document token is enabled
-            if (JwtManager.Enabled)
+            if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
             {
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                 string token = null;
 
@@ -92,15 +92,13 @@ namespace OnlineEditorsExampleMVC.Helpers
         // file saving process
         public static int processSave(Dictionary<string, object> fileData, string fileName, string userAddress)
         {
-            if (fileData["url"].Equals(null)) {
+            if (string.IsNullOrEmpty((string)fileData["url"])) {
                 throw new Exception("DownloadUrl is null");
             }
             var downloadUri = (string)fileData["url"];
             string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower() ?? ""; // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"]; // get the extension of the downloaded file
 
             var newFileName = fileName;
 
@@ -110,8 +108,9 @@ namespace OnlineEditorsExampleMVC.Helpers
                 try
                 {
                     // convert file and give url to a new file
-                    string newFileUri;
-                    var result = ServiceConverter.GetConvertedUri(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileUri);
+                    Dictionary<string, string> newFileData;
+                    var result = ServiceConverter.GetConvertedData(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileData);
+                    var newFileUri = newFileData["fileUrl"];
                     if (string.IsNullOrEmpty(newFileUri))
                     {
                         // get the correct file name if it already exists
@@ -130,37 +129,48 @@ namespace OnlineEditorsExampleMVC.Helpers
 
             DocManagerHelper.VerifySSL();
 
-            var storagePath = DocManagerHelper.StoragePath(newFileName, userAddress);  // get the file path
-            var histDir = DocManagerHelper.HistoryDir(storagePath);  // get the path to the history directory
-            if (!Directory.Exists(histDir)) Directory.CreateDirectory(histDir);
-
-            var versionDir = DocManagerHelper.VersionDir(histDir, DocManagerHelper.GetFileVersion(histDir));  // get the path to the file version
-            if (!Directory.Exists(versionDir)) Directory.CreateDirectory(versionDir);  // if the path doesn't exist, create it
-
-            // get the path to the previous file version and move it to the storage directory
-            File.Move(DocManagerHelper.StoragePath(fileName, userAddress), Path.Combine(versionDir, "prev" + curExt));
-
-            DownloadToFile(downloadUri, storagePath);  // save file to the storage directory
-            DownloadToFile((string)fileData["changesurl"], Path.Combine(versionDir, "diff.zip"));  // save file changes to the diff.zip archive
-
-            var hist = fileData.ContainsKey("changeshistory") ? (string)fileData["changeshistory"] : null;
-            if (string.IsNullOrEmpty(hist) && fileData.ContainsKey("history"))
+            try
             {
-                var jss = new JavaScriptSerializer();
-                hist = jss.Serialize(fileData["history"]);
-            }
+                var bytesFile = DownloadFile(downloadUri); // download document file
+                var storagePath = DocManagerHelper.StoragePath(newFileName, userAddress);  // get the file path
 
-            if (!string.IsNullOrEmpty(hist))
+                var histDir = DocManagerHelper.HistoryDir(storagePath);  // get the path to the history directory
+                if (!Directory.Exists(histDir)) Directory.CreateDirectory(histDir);
+
+                var versionDir = DocManagerHelper.VersionDir(histDir, DocManagerHelper.GetFileVersion(histDir));  // get the path to the file version
+                if (!Directory.Exists(versionDir)) Directory.CreateDirectory(versionDir);  // if the path doesn't exist, create it
+
+                // get the path to the previous file version and move it to the storage directory
+                File.Move(DocManagerHelper.StoragePath(fileName, userAddress), Path.Combine(versionDir, "prev" + curExt));
+
+                SaveFile(bytesFile, storagePath);// save document file
+
+                byte[] bytesChanges = DownloadFile((string)fileData["changesurl"]); // download changes file
+                SaveFile(bytesChanges, Path.Combine(versionDir, "diff.zip")); // save file changes to the diff.zip archive
+
+                var hist = fileData.ContainsKey("changeshistory") ? (string)fileData["changeshistory"] : null;
+                if (string.IsNullOrEmpty(hist) && fileData.ContainsKey("history"))
+                {
+                    var jss = new JavaScriptSerializer();
+                    hist = jss.Serialize(fileData["history"]);
+                }
+
+                if (!string.IsNullOrEmpty(hist))
+                {
+                    File.WriteAllText(Path.Combine(versionDir, "changes.json"), hist);  // write the history changes to the changes.json file
+                }
+
+                File.WriteAllText(Path.Combine(versionDir, "key.txt"), (string)fileData["key"]);  // write the key value to the key.txt file
+
+                string forcesavePath = DocManagerHelper.ForcesavePath(newFileName, userAddress, false);  // get the path to the forcesaved file version
+                if (!forcesavePath.Equals(""))  // if the forcesaved file version exists
+                {
+                    File.Delete(forcesavePath);  // remove it
+                }
+
+            } catch (Exception)
             {
-                File.WriteAllText(Path.Combine(versionDir, "changes.json"), hist);  // write the history changes to the changes.json file
-            }
-
-            File.WriteAllText(Path.Combine(versionDir, "key.txt"), (string)fileData["key"]);  // write the key value to the key.txt file
-
-            string forcesavePath = DocManagerHelper.ForcesavePath(newFileName, userAddress, false);  // get the path to the forcesaved file version
-            if (!forcesavePath.Equals(""))  // if the forcesaved file version exists
-            {
-                File.Delete(forcesavePath);  // remove it
+                return 1;
             }
 
             return 0;
@@ -169,16 +179,14 @@ namespace OnlineEditorsExampleMVC.Helpers
         // file force saving process
         public static int processForceSave(Dictionary<string, object> fileData, string fileName, string userAddress)
         {
-            if (fileData["url"].Equals(null)) {
+            if ( string.IsNullOrEmpty((string)fileData["url"])) {
                 throw new Exception("DownloadUrl is null");
             }
             var downloadUri = (string)fileData["url"];
 
             string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower(); // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"];  // get the extension of the downloaded file
 
             Boolean newFileName = false;
 
@@ -188,8 +196,9 @@ namespace OnlineEditorsExampleMVC.Helpers
                 try
                 {
                     // convert file and give url to a new file
-                    string newFileUri;
-                    var result = ServiceConverter.GetConvertedUri(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileUri);
+                    Dictionary<string, string> newFileData;
+                    var result = ServiceConverter.GetConvertedData(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileData);
+                    var newFileUri = newFileData["fileUrl"];
                     if (string.IsNullOrEmpty(newFileUri))
                     {
                         newFileName = true;
@@ -206,43 +215,51 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
 
             DocManagerHelper.VerifySSL();
-            
-            string forcesavePath = "";
-            Boolean isSubmitForm = fileData["forcesavetype"].ToString().Equals("3");  // SubmitForm
 
-            if (isSubmitForm)  // if the form is submitted
+            try
             {
-                if (newFileName)
+                var bytesFile = DownloadFile(downloadUri); // download document file
+
+                string forcesavePath = "";
+                Boolean isSubmitForm = fileData["forcesavetype"].ToString().Equals("3");  // SubmitForm
+
+                if (isSubmitForm)  // if the form is submitted
                 {
-                    fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + downloadExt, userAddress);  // get the correct file name if it already exists
+                    if (newFileName)
+                    {
+                        fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + downloadExt, userAddress);  // get the correct file name if it already exists
                 } else
-                {
-                    fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + curExt, userAddress);
+                    {
+                        fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + curExt, userAddress);
+                    }
+                    forcesavePath = DocManagerHelper.StoragePath(fileName, userAddress);
                 }
-                forcesavePath = DocManagerHelper.StoragePath(fileName, userAddress);
-            }
-            else
-            {
-                if (newFileName)
+                else
                 {
-                    fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
+                    if (newFileName)
+                    {
+                        fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
+                    }
+                    forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);
+                if (string.IsNullOrEmpty(forcesavePath))  // create forcesave path if it doesn't exist
+                    {
+                        forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, true);
+                    }
                 }
-                forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);
-                if (forcesavePath.Equals(""))  // create forcesave path if it doesn't exist
-                {
-                    forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, true);
-                }
-            }
 
-            DownloadToFile(downloadUri, forcesavePath);
+                SaveFile(bytesFile, forcesavePath);// save document file
 
-            if (isSubmitForm)
+                if (isSubmitForm)
+                {
+                    var jss = new JavaScriptSerializer();
+                    var actions = jss.Deserialize<List<object>>(jss.Serialize(fileData["actions"]));
+                    var action = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(actions[0]));
+                    var user = action["userid"].ToString();  // get the user id
+                    DocManagerHelper.CreateMeta(fileName, user, "Filling Form", userAddress);  // create meta data for the forcesaved file
+                }
+            } catch (Exception)
             {
-                var jss = new JavaScriptSerializer();
-                var actions = jss.Deserialize<List<object>>(jss.Serialize(fileData["actions"]));
-                var action = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(actions[0]));
-                var user = action["userid"].ToString();  // get the user id
-                DocManagerHelper.CreateMeta(fileName, user, "Filling Form", userAddress);  // create meta data for the forcesaved file
+                return 1;
             }
 
             return 0;
@@ -270,7 +287,7 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
 
             // check if a secret key to generate token exists or not
-            if (JwtManager.Enabled)
+            if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
             {
                 var payload = new Dictionary<string, object>
                     {
@@ -279,7 +296,7 @@ namespace OnlineEditorsExampleMVC.Helpers
 
                 var payloadToken = JwtManager.Encode(payload);  // encode a payload object into a header token
                 var bodyToken = JwtManager.Encode(body);  // encode body into a body token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);  // add a header Authorization with a header token and Authorization prefix in it
 
                 body.Add("token", bodyToken);
@@ -314,26 +331,30 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
         }
 
+        // save file
+        private static void SaveFile(byte[] data, string path)
+        {
+            using (var fs = File.Open(path, FileMode.Create))
+            {
+                fs.Write(data, 0, data.Length);
+            }
+        }
+
         // save file information from the url to the file specified
-        private static void DownloadToFile(string url, string path)
+        private static byte[] DownloadFile(string url)
         {
             if (string.IsNullOrEmpty(url)) throw new ArgumentException("url");  // url isn't specified
-            if (string.IsNullOrEmpty(path)) throw new ArgumentException("path");  // file isn't specified
 
             var req = (HttpWebRequest)WebRequest.Create(url);
+            req.Timeout = 5000;
             using (var stream = req.GetResponse().GetResponseStream())  // get input stream of the file information from the url
             {
                 if (stream == null) throw new Exception("stream is null");
-                const int bufferSize = 4096;
 
-                using (var fs = File.Open(path, FileMode.Create))
+                using (MemoryStream memoryStream = new MemoryStream())
                 {
-                    var buffer = new byte[bufferSize];
-                    int readed;
-                    while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
-                    {
-                        fs.Write(buffer, 0, readed);  // write bytes to the output stream
-                    }
+                    stream.CopyTo(memoryStream);
+                    return memoryStream.ToArray();
                 }
             }
         }

web/documentserver-example/csharp-mvc/Helpers/Users.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -69,6 +69,7 @@ namespace OnlineEditorsExampleMVC.Helpers
             "Can’t see anyone’s information",
             "Can't rename files from the editor",
             "Can't view chat",
+            "Can't protect file",
             "View file without collaboration",
         };
 
@@ -131,7 +132,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                     new Dictionary<string,object>(),
                     new List<string>(),
                     null,
-                    new List<string>(),
+                    new List<string>() { "protect" },
                     descr_user_0,
                     false
                 )

web/documentserver-example/csharp-mvc/Helpers/Utils.cs

@@ -1,4 +1,22 @@
-using System.Web;
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+using System.Web;
 
 namespace OnlineEditorsExampleMVC.Helpers
 {

web/documentserver-example/csharp-mvc/Models/FileModel.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -33,6 +33,7 @@ namespace OnlineEditorsExampleMVC.Models
     {
         public string Mode { get; set; }  // editor mode
         public string Type { get; set; }  // editor type
+        public bool IsEnabledDirectUrl { get; set; }  // is enabled direct url
 
         // get file url for Document Server
         public string FileUri
@@ -126,7 +127,7 @@ namespace OnlineEditorsExampleMVC.Models
                             {
                                 { "title", FileName },
                                 { "url", DownloadUrl },
-                                { "directUrl", directUrl },
+                                { "directUrl", IsEnabledDirectUrl ? directUrl : "" },
                                 { "fileType", ext.Trim('.') },
                                 { "key", Key },
                                 {
@@ -137,6 +138,17 @@ namespace OnlineEditorsExampleMVC.Models
                                             { "favorite", favorite}
                                         }
                                 },
+                                {
+                                    "referenceData", new Dictionary<string, string>()
+                                    {
+                                        { "fileKey", !user.id.Equals("uid-0") ?
+                                            jss.Serialize(new Dictionary<string, object>{
+                                                {"fileName", FileName},
+                                                {"userAddress", HttpUtility.UrlEncode(DocManagerHelper.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress))}
+                                        }) : null },
+                                        {"instanceId", DocManagerHelper.GetServerUrl(false) }
+                                    }
+                                },
                                 {
                                     // the permission for the document to be edited and downloaded or not
                                     "permissions", new Dictionary<string, object>
@@ -153,7 +165,8 @@ namespace OnlineEditorsExampleMVC.Models
                                             { "chat", !user.id.Equals("uid-0") },
                                             { "reviewGroups", user.reviewGroups },
                                             { "commentGroups", user.commentGroups },
-                                            { "userInfoGroups", user.userInfoGroups }
+                                            { "userInfoGroups", user.userInfoGroups },
+                                            { "protect", !user.deniedPermissions.Contains("protect") }
                                         }
                                 }
                             }
@@ -286,7 +299,10 @@ namespace OnlineEditorsExampleMVC.Models
                     }
 
                     dataObj.Add("url", prevFileUrl);
-                    dataObj.Add("directUrl", directPrevFileUrl);
+                    if (IsEnabledDirectUrl)
+                    {
+                        dataObj.Add("directUrl", directPrevFileUrl);
+                    }
                     dataObj.Add("version", i);
                     if (i > 1)  // check if the version number is greater than 1 (the file was modified)
                     {
@@ -304,11 +320,15 @@ namespace OnlineEditorsExampleMVC.Models
                         obj.Add("user", change.Count > 0 ? change["user"] : null);
 
                         var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];  // get the history data from the previous file version
-                        dataObj.Add("previous", new Dictionary<string, object>() {  // write information about previous file version to the data object
+                        dataObj.Add("previous", IsEnabledDirectUrl ? new Dictionary<string, object>() {  // write information about previous file version to the data object with direct url
                             { "fileType", prev["fileType"] },
                             { "key", prev["key"] },  // write key and url information about previous file version
                             { "url", prev["url"] },
                             { "directUrl", prev["directUrl"] },
+                        } : new Dictionary<string, object>() {  // write information about previous file version to the data object without direct url
+                            { "fileType", prev["fileType"] },
+                            { "key", prev["key"] },  // write key and url information about previous file version
+                            { "url", prev["url"] },
                         });
                         // write the path to the diff.zip archive with differences in this file version
                         var changesUrl = DocManagerHelper.GetHistoryDownloadUrl(FileName, (i - 1).ToString(), "diff.zip");
@@ -359,10 +379,14 @@ namespace OnlineEditorsExampleMVC.Models
             var dataCompareFile = new Dictionary<string, object>
             {
                 { "fileType", "docx" },
-                { "url", compareFileUrl.ToString() },
-                { "directUrl", directCompareFileUrl.ToString()}
+                { "url", compareFileUrl.ToString() }
             };
 
+            if (IsEnabledDirectUrl)
+            {
+                dataCompareFile.Add("directUrl", directCompareFileUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var compareFileToken = JwtManager.Encode(dataCompareFile);  // encode the dataCompareFile object into the token
@@ -396,10 +420,14 @@ namespace OnlineEditorsExampleMVC.Models
             var logoConfig = new Dictionary<string, object>
             {
                 { "fileType", "png"},
-                { "url", mailMergeUrl.ToString()},
-                { "directUrl", directMailMergeUrl.ToString()}
+                { "url", mailMergeUrl.ToString()}
             };
 
+            if (IsEnabledDirectUrl)
+            {
+                logoConfig.Add("directUrl", directMailMergeUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var token = JwtManager.Encode(logoConfig);  // encode logoConfig into the token
@@ -437,10 +465,14 @@ namespace OnlineEditorsExampleMVC.Models
             var mailMergeConfig = new Dictionary<string, object>
             {
                 { "fileType", "csv" },
-                { "url", mailMergeUrl.ToString()},
-                { "directUrl", directMailMergeUrl.ToString()}
+                { "url", mailMergeUrl.ToString()}
             };
 
+            if (IsEnabledDirectUrl)
+            {
+                mailMergeConfig.Add("directUrl", directMailMergeUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var mailmergeToken = JwtManager.Encode(mailMergeConfig);  // encode mailMergeConfig into the token

web/documentserver-example/csharp-mvc/Models/FileUtility.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Properties/AssemblyInfo.cs

@@ -7,7 +7,7 @@ using System.Runtime.InteropServices;
 [assembly: AssemblyConfiguration("")]
 [assembly: AssemblyCompany("Ascensio System SIA")]
 [assembly: AssemblyProduct("OnlineEditorsExampleMVC")]
-[assembly: AssemblyCopyright("Ascensio System SIA 2021")]
+[assembly: AssemblyCopyright("Ascensio System SIA 2023")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]
 

web/documentserver-example/csharp-mvc/Scripts/jquery.dropdownToggle.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Scripts/jscript.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,11 +16,24 @@
  *
  */
 
+var directUrl;
+
 if (typeof jQuery != "undefined") {
     jq = jQuery.noConflict();
 
+    directUrl = getUrlVars()["directUrl"] == "true";
+
     mustReload = false;
 
+    if (directUrl)
+        jq("#directUrl").prop("checked", directUrl);
+    else
+        directUrl = jq("#directUrl").prop("checked");
+
+    jq("#directUrl").change(function () {
+        window.location = "?directUrl=" + jq(this).prop("checked");
+    });
+
     jq(function () {
         jq('#fileupload').fileupload({
             dataType: 'json',
@@ -219,7 +232,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEdit:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?fileName=" + fileId;
+        var url = UrlEditor + "?fileName=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -227,7 +240,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginView:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?editorsMode=view&fileName=" + fileId;
+        var url = UrlEditor + "?editorsMode=view&fileName=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -235,7 +248,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEmbedded:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?editorsType=embedded&editorsMode=embedded&fileName=" + fileId;
+        var url = UrlEditor + "?editorsType=embedded&editorsMode=embedded&fileName=" + fileId + "&directUrl=" + directUrl;
 
         jq("#mainProgress").addClass("embedded");
         jq("#beginEmbedded").addClass("disable");
@@ -289,6 +302,17 @@ if (typeof jQuery != "undefined") {
         }
     };
 
+    function getUrlVars() {
+        var vars = [], hash;
+        var hashes = window.location.href.slice(window.location.href.indexOf('?') + 1).split('&');
+        for (var i = 0; i < hashes.length; i++) {
+            hash = hashes[i].split('=');
+            vars.push(hash[0]);
+            vars[hash[0]] = hash[1];
+        }
+        return vars;
+    };
+
     var fileList = jq("tr.tableRow");
 
     var mouseIsOverTooltip = false;
@@ -299,12 +323,12 @@ if (typeof jQuery != "undefined") {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
                 }
-                jq(".info").on("touchend", function () {
+                jq("#info").on("touchend", function () {
                     showUserTooltip(true);
                 });
             }
     } else {
-        jq(".info").mouseover(function (event) {
+        jq("#info").mouseover(function (event) {
             if (fileList.length > 0) {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
@@ -328,4 +352,18 @@ if (typeof jQuery != "undefined") {
             }, 500);
         });
     }
+
+    jq(".info-tooltip").mouseover(function (event) {
+        var target = event.target;
+        var id = target.dataset.id ? target.dataset.id : target.id;
+        var tooltip = target.dataset.tooltip;
+
+        jq("<div class='tooltip'>" + tooltip + "<div class='arrow'></div></div>").appendTo("body");
+
+        var top = jq("#" + id).offset().top + jq("#" + id).outerHeight() / 2 - jq("div.tooltip").outerHeight() / 2;
+        var left = jq("#" + id).offset().left + jq("#" + id).outerWidth() + 20;
+        jq("div.tooltip").css({ "top": top, "left": left });
+    }).mouseout(function () {
+        jq("div.tooltip").remove();
+    });
 }

web/documentserver-example/csharp-mvc/Views/Home/Editor.aspx

@@ -14,7 +14,7 @@
     <meta name="mobile-web-app-capable" content="yes" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -31,7 +31,7 @@
     -->
     <link rel="icon" href="<%= "content/images/" + Model.DocumentType + ".ico" %>" type="image/x-icon" />
     <title><%= Model.FileName + " - ONLYOFFICE" %></title>
-    
+
     <%: Styles.Render("~/Content/editor") %>
 
 </head>
@@ -40,7 +40,7 @@
         <div id="iframeEditor">
         </div>
     </div>
-    
+
     <%: Scripts.Render(new []{ WebConfigurationManager.AppSettings["files.docservice.url.site"] + WebConfigurationManager.AppSettings["files.docservice.url.api"] }) %>
 
     <script type="text/javascript" language="javascript">
@@ -141,7 +141,7 @@
             <% Model.GetMailMergeConfig(out dataMailMergeRecipients); %>
             docEditor.setMailMergeRecipients(<%= dataMailMergeRecipients%>);  // insert recipient data for mail merge into the file
         };
-        
+
          var onRequestSaveAs = function (event) {  //  the user is trying to save file by clicking Save Copy as... button
              var title = event.data.title;
              var url = event.data.url;
@@ -178,6 +178,18 @@
             }
         };
 
+        var onRequestReferenceData = function (event) {  // user refresh external data source
+            event.data.directUrl = !!config.document.directUrl;
+            let xhr = new XMLHttpRequest();
+            xhr.open("POST", "webeditor.ashx?type=reference");
+            xhr.setRequestHeader("Content-Type", "application/json");
+            xhr.send(JSON.stringify(event.data));
+            xhr.onload = function () {
+                console.log(xhr.responseText);
+                docEditor.setReferenceData(JSON.parse(xhr.responseText));
+            }
+        };
+
         config = <%= Model.GetDocConfig(Request, Url) %>;
 
         config.width = "100%";
@@ -186,7 +198,6 @@
         config.events = {
             'onAppReady': onAppReady,
             'onDocumentStateChange': onDocumentStateChange,
-            'onRequestEditRights': onRequestEditRights,
             'onError': onError,
             'onOutdatedVersion': onOutdatedVersion,
             "onMakeActionLink": onMakeActionLink,
@@ -216,7 +227,7 @@
                     docEditor.setHistoryData(histData[ver - 1]);  // send the link to the document for viewing the version history
                 };
                 // the user is trying to go back to the document from viewing the document version history
-                config.events['onRequestHistoryClose '] = function () {
+                config.events['onRequestHistoryClose'] = function () {
                     document.location.reload();
                 };
             <% } %>
@@ -239,6 +250,9 @@
             };
             // prevent file renaming for anonymous users
             config.events['onRequestRename'] = onRequestRename;
+            config.events['onRequestReferenceData'] = onRequestReferenceData;
+            // prevent switch the document from the viewing into the editing mode for anonymous users
+            config.events['onRequestEditRights'] = onRequestEditRights;
         }
 
         if (config.editorConfig.createUrl) {

web/documentserver-example/csharp-mvc/Views/Home/Index.aspx

@@ -15,7 +15,7 @@
     <meta name="viewport" content="width=device-width" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -70,7 +70,7 @@
                                             <a class="try-editor form" data-type="docxf">Form template</a>
                                         </li>
                                     </ul>
-                                    <label class="create-sample">
+                                    <label class="side-option">
                                         <input id="createSample" class="checkbox" type="checkbox" />With sample content
                                     </label>
                                 </div>
@@ -86,7 +86,7 @@
                                     <tr>
                                         <td valign="middle">
                                             <span class="select-user">Username</span>
-                                             <img class="info" src="content/images/info.svg" />
+                                             <img id="info" class="info" src="content/images/info.svg" />
                                              <select class="select-user" id="user">
                                             <% foreach (User user in Users.getAllUsers())
                                                { %>
@@ -97,7 +97,10 @@
                                     </tr>
                                     <tr>
                                         <td valign="middle">
-                                            <span class="select-user">Language editors interface</span>
+                                            <span class="select-user">Language</span>
+                                            <img class="info info-tooltip" data-id="language"
+                                                 data-tooltip="Choose the language for ONLYOFFICE editors interface"
+                                                 src="content/images/info.svg" />
                                             <select class="select-user" id="language">
                                                 <% Dictionary<string, string> languages = DocManagerHelper.GetLanguages(); 
                                                 foreach (var lang in languages)
@@ -107,6 +110,14 @@
                                             </select>
                                         </td>
                                     </tr>
+                                    <tr>
+                                        <td valign="middle">
+                                            <label class="side-option">
+                                                <input id="directUrl" type="checkbox" class="checkbox" />Try opening on client
+                                                <img id="directUrlInfo" class="info info-tooltip" data-id="directUrlInfo" data-tooltip="Some files can be opened in the user's browser without connecting to the document server." src="content/images/info.svg" />
+                                            </label>
+                                        </td>
+                                    </tr>
                                 </tbody>
                             </table>
                         </div>
@@ -156,7 +167,8 @@
                                             <tbody>
                                             <% foreach (var storedFile in storedFiles)
                                                {
-                                                    var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
+                                                            var isEnabledDirectUrl = DocManagerHelper.GetDirectUrl();
+                                                            var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
                                                             var docType = FileUtility.GetFileType(storedFile.Name).ToString().ToLower();
                                                             var ext = Path.GetExtension(storedFile.Name).ToLower();
                                                             var canEdit = DocManagerHelper.EditedExts.Contains(ext);
@@ -165,42 +177,42 @@
 
                                                             <tr class="tableRow" title="<%= storedFile.Name %> [<%= DocManagerHelper.GetFileVersion(storedFile.Name, HttpContext.Current.Request.UserHostAddress.Replace(':', '_')) %>]">
                                                                 <td class="contentCells">
-                                                                    <a class="stored-edit <%= docType %>" href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name }) %>" target="_blank">
+                                                                    <a class="stored-edit <%= docType %>" href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <span><%= storedFile.Name %></span>
                                                                     </a>
                                                                 </td>
                                                                 <% if (canEdit) { %>
                                                                     <td class="contentCells contentCells-icon">
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "edit" }) %>" target="_blank">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "edit", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                             <img src="content/images/desktop.svg" alt="Open in editor for full size screens" title="Open in editor for full size screens"/>
                                                                         </a>
                                                                     </td>
                                                                     <td class="contentCells contentCells-icon">
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "edit" }) %>" target="_blank">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "edit", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                             <img src="content/images/mobile.svg" alt="Open in editor for mobile devices" title="Open in editor for mobile devices"/>
                                                                         </a>
                                                                     </td>
                                                                     <td class="contentCells contentCells-icon">
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "comment" }) %>" target="_blank">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "comment", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                             <img src="content/images/comment.svg" alt="Open in editor for comment" title="Open in editor for comment"/>
                                                                         </a>
                                                                     </td>
                                                                     <% if (docType == "word") { %>
                                                                         <td class="contentCells contentCells-icon">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "review" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "review", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/review.svg" alt="Open in editor for review" title="Open in editor for review"/>
                                                                             </a>
                                                                         </td>
                                                                     <% } else if (docType == "cell") { %>
                                                                         <td class="contentCells contentCells-icon">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "filter" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "filter", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/filter.svg" alt="Open in editor without access to change the filter" title="Open in editor without access to change the filter" />
                                                                             </a>
                                                                          </td>
                                                                     <% } %>
                                                                     <% if (docType == "word") { %>
                                                                         <td class="contentCells contentCells-icon">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "blockcontent" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "blockcontent", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/block-content.svg" alt="Open in editor without content control modification" title="Open in editor without content control modification"/>
                                                                             </a>
                                                                         </td>
@@ -212,7 +224,7 @@
                                                                     <% } %>
                                                                     <% if (isFillFormDoc) { %>
                                                                         <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
                                                                             </a>
                                                                         </td>
@@ -222,7 +234,7 @@
                                                                 <% } else if (isFillFormDoc) { %>
                                                                     <td class="contentCells contentCells-icon "></td>
                                                                     <td class="contentCells contentCells-icon">
-                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "fillForms" }) %>" target="_blank">
+                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                            <img src="content/images/mobile-fill-forms.svg" alt="Open in editor for filling in forms for mobile devices" title="Open in editor for filling in forms for mobile devices"/>
                                                                        </a>
                                                                     </td>
@@ -230,7 +242,7 @@
                                                                     <td class="contentCells contentCells-icon "></td>
                                                                     <td class="contentCells contentCells-icon "></td>
                                                                     <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
-                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms" }) %>" target="_blank">
+                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                            <img src="content/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
                                                                        </a>
                                                                     </td>
@@ -238,17 +250,17 @@
                                                                     <td class="contentCells contentCells-shift contentCells-icon contentCellsEmpty" colspan="6"></td>
                                                                 <% } %>
                                                                 <td class="contentCells contentCells-icon firstContentCellViewers">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "view" }) %>" target="_blank">
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "view", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <img src="content/images/desktop.svg" alt="Open in viewer for full size screens" title="Open in viewer for full size screens"/>
                                                                     </a>
                                                                 </td>
                                                                 <td class="contentCells contentCells-icon">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "view" }) %>" target="_blank">
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "view", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <img src="content/images/mobile.svg" alt="Open in viewer for mobile devices" title="Open in viewer for mobile devices"/>
                                                                     </a>
                                                                 </td>
                                                                 <td class="contentCells contentCells-icon contentCells-shift">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "embedded", editorsMode = "embedded" }) %>" target="_blank">
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "embedded", editorsMode = "embedded", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <img src="content/images/embeded.svg" alt="Open in embedded mode" title="Open in embedded mode"/>
                                                                     </a>
                                                                 </td>

web/documentserver-example/csharp-mvc/Views/Shared/Error.aspx

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/WebEditor.ashx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -74,6 +74,9 @@ namespace OnlineEditorsExampleMVC
                 case "rename":
                     Rename(context);
                     break;
+                case "reference":
+                    Reference(context);
+                    break;
             }
         }
 
@@ -227,11 +230,10 @@ namespace OnlineEditorsExampleMVC
                 var fileUri = DocManagerHelper.GetDownloadUrl(fileName);
 
                 var extension = (Path.GetExtension(fileName).ToLower() ?? "").Trim('.');
-                var internalExtension = DocManagerHelper.GetInternalExtension(FileUtility.GetFileType(fileName)).Trim('.');
+                var internalExtension = "ooxml";
 
                 // check if the file with such an extension can be converted
-                if (DocManagerHelper.ConvertExts.Contains("." + extension)
-                    && !string.IsNullOrEmpty(internalExtension))
+                if (DocManagerHelper.ConvertExts.Contains("." + extension))
                 {
                     // generate document key
                     var key = ServiceConverter.GenerateRevisionId(fileUri);
@@ -244,9 +246,11 @@ namespace OnlineEditorsExampleMVC
                         Query = "type=download&fileName=" + HttpUtility.UrlEncode(fileName)
                     };
 
-                    // get the url to the converted file
-                    string newFileUri;
-                    var result = ServiceConverter.GetConvertedUri(downloadUri.ToString(), extension, internalExtension, key, true, out newFileUri, filePass, lang);
+                    // get the url and file type of the converted file
+                    Dictionary<string, string> newFileData;
+                    var result = ServiceConverter.GetConvertedData(downloadUri.ToString(), extension, internalExtension, key, true, out newFileData, filePass, lang);
+                    var newFileUri = newFileData["fileUrl"];
+                    var newFileType = "." + newFileData["fileType"];
                     if (result != 100)
                     {
                         context.Response.Write("{ \"step\" : \"" + result + "\", \"filename\" : \"" + fileName + "\"}");
@@ -254,7 +258,7 @@ namespace OnlineEditorsExampleMVC
                     }
 
                     // get a file name of an internal file extension with an index if the file with such a name already exists
-                    var correctName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "." + internalExtension);
+                    var correctName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + newFileType);
 
                     var req = (HttpWebRequest)WebRequest.Create(newFileUri);
 
@@ -461,25 +465,26 @@ namespace OnlineEditorsExampleMVC
                 var userAddress = context.Request["userAddress"];
                 var isEmbedded = context.Request["dmode"];
 
-                if (JwtManager.Enabled && isEmbedded == null)
+                if (JwtManager.Enabled && isEmbedded == null && userAddress != null && JwtManager.SignatureUseForRequest)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
+                    string token = "";
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
-                        string token = JwtManager.Decode(headerToken);
-                        if (token == null || token.Equals(""))
-                        {
-                            context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
-                            context.Response.Write("JWT validation failed");
-                            return;
-                        }
+                        token = JwtManager.Decode(headerToken);
+                    }
+                    if (string.IsNullOrEmpty(token))
+                    {
+                        context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
+                        context.Response.Write("JWT validation failed");
+                        return;
                     }
                 }
 
                 var filePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);  // get the path to the force saved document version
-                if (filePath.Equals(""))
+                if (string.IsNullOrEmpty(filePath))
                 {
                     filePath = DocManagerHelper.StoragePath(fileName, userAddress);  // or to the original document
                 }
@@ -518,16 +523,16 @@ namespace OnlineEditorsExampleMVC
                 var version = System.Convert.ToInt32(context.Request["ver"]);
                 var file = Path.GetFileName(context.Request["file"]);
 
-                if (JwtManager.Enabled)
+                if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
                         string token = JwtManager.Decode(headerToken);
 
-                        if (token == null || token.Equals(""))
+                        if (string.IsNullOrEmpty(token))
                         {
                             context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
                             context.Response.Write("JWT validation failed");
@@ -590,5 +595,96 @@ namespace OnlineEditorsExampleMVC
             TrackManager.commandRequest("meta", docKey, meta);
             context.Response.Write("{ \"result\": \"OK\"}");
         }
+
+        private static void Reference(HttpContext context)
+        {
+            string fileData;
+            try
+            {
+                using (var receiveStream = context.Request.InputStream)
+                using (var readStream = new StreamReader(receiveStream))
+                {
+                    fileData = readStream.ReadToEnd();
+                    if (string.IsNullOrEmpty(fileData)) return;
+                }
+            }
+            catch (Exception e)
+            {
+                throw new HttpException((int)HttpStatusCode.BadRequest, e.Message);
+            }
+
+            var jss = new JavaScriptSerializer();
+            var body = jss.Deserialize<Dictionary<string, object>>(fileData);
+            Dictionary<string, object> referenceData = null;
+            var fileName = "";
+            var userAddress = "";
+
+            if (body.ContainsKey("referenceData"))
+            {
+                referenceData = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(body["referenceData"]));
+                var instanceId = (string)referenceData["instanceId"];
+                var fileKey = (string)referenceData["fileKey"];
+                if (instanceId == DocManagerHelper.GetServerUrl(false))
+                {
+                    var fileKeyObj = jss.Deserialize<Dictionary<string, object>>(fileKey);
+                    userAddress = (string)fileKeyObj["userAddress"];
+                    if (userAddress == HttpUtility.UrlEncode(DocManagerHelper.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress)))
+                    {
+                        fileName = (string)fileKeyObj["fileName"];
+                    }
+                }
+            }
+
+            if (fileName == "")
+            {
+                try
+                {
+                    var path = (string)body["path"];
+                    path = Path.GetFileName(path);
+                    if (File.Exists(DocManagerHelper.StoragePath(path, null)))
+                    {
+                        fileName = path;
+                    }
+                }
+                catch
+                {
+                    context.Response.Write("{ \"error\": \"Path not found!\"}");
+                    return;
+                }
+            }
+
+            if (fileName == "")
+            {
+                context.Response.Write("{ \"error\": \"File not found!\"}");
+                return;
+            }
+
+            var data = new Dictionary<string, object>() {
+            { "fileType", (Path.GetExtension(fileName) ?? "").ToLower() },
+            { "url",  DocManagerHelper.GetDownloadUrl(fileName)},
+            { "directUrl",  DocManagerHelper.GetDownloadUrl(fileName) },
+            { "referenceData", new Dictionary<string, string>()
+                {
+                    { "fileKey", jss.Serialize(new Dictionary<string, object>{
+                            {"fileName", fileName},
+                            {"userAddress", HttpUtility.UrlEncode(DocManagerHelper.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress))}
+                    })
+                    },
+                    {"instanceId", DocManagerHelper.GetServerUrl(false) }
+                }
+            },
+            { "path", fileName }
+            };
+
+            if (JwtManager.Enabled)
+            {
+                var token = JwtManager.Encode(data);
+                data.Add("token", token);
+            }
+
+            context.Response.Write(jss.Serialize(data));
+        }
+
     }
+ 
 }

web/documentserver-example/csharp-mvc/licenses/3rd-Party.license

@@ -20,6 +20,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license

web/documentserver-example/csharp-mvc/licenses/jQuery.Migrate.license

@@ -0,0 +1,36 @@
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/jquery-migrate
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.

web/documentserver-example/csharp-mvc/licenses/jquery.license

@@ -1,4 +1,4 @@
-Copyright (c) 2009 John Resig, http://jquery.com/
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

web/documentserver-example/csharp-mvc/web.appsettings.config

@@ -1,22 +1,24 @@
 <?xml version="1.0"?>
 <appSettings>
   <clear />
-  <add key="version" value="1.4.0"/>
+  <add key="version" value="1.5.1"/>
 
   <add key="filesize-max" value="52428800"/>
   <add key="storage-path" value=""/>
   
-  <add key="files.docservice.fillform-docs" value=".oform|.docx"/>
-  <add key="files.docservice.viewed-docs" value=".pdf|.djvu|.xps|.oxps"/>
-  <add key="files.docservice.edited-docs" value=".docx|.xlsx|.csv|.pptx|.txt|.docxf"/>
-  <add key="files.docservice.convert-docs" value=".docm|.dotx|.dotm|.dot|.doc|.odt|.fodt|.ott|.xlsm|.xlsb|.xltx|.xltm|.xlt|.xls|.ods|.fods|.ots|.pptm|.ppt|.ppsx|.ppsm|.pps|.potx|.potm|.pot|.odp|.fodp|.otp|.rtf|.mht|.html|.htm|.xml|.epub|.fb2"/>
+  <add key="files.docservice.fillform-docs" value=".docx|.oform"/>
+  <add key="files.docservice.viewed-docs" value=".djvu|.oxps|.pdf|.xps"/>
+  <add key="files.docservice.edited-docs" value=".csv|.docm|.docx|.docxf|.dotm|.dotx|.epub|.fb2|.html|.odp|.ods|.odt|.otp|.ots|.ott|.potm|.potx|.ppsm|.ppsx|.pptm|.pptx|.rtf|.txt|.xlsm|.xlsx|.xltm|.xltx"/>
+  <add key="files.docservice.convert-docs" value=".doc|.dot|.dps|.dpt|.epub|.et|.ett|.fb2|.fodp|.fods|.fodt|.htm|.html|.mht|.mhtml|.odp|.ods|.odt|.otp|.ots|.ott|.pot|.pps|.ppt|.rtf|.stw|.sxc|.sxi|.sxw|.wps|.wpt|.xls|.xlsb|.xlt|.xml"/>
   <add key="files.docservice.timeout" value="120000" />
   <add key="files.docservice.secret" value="" />
   <add key="files.docservice.header" value="Authorization" />
 
+  <add key="files.docservice.token.useforrequest" value="true" />
+
   <add key="files.docservice.verify-peer-off" value="true"/>
 
-  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese (People's Republic of China)|zh-TW:Chinese (Traditional, Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lv:Latvian|lo:Lao|ms:Malay (Malaysia)|nb:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese"/>
+  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese|zh-TW:Chinese (Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lo:Lao|lv:Latvian|ms:Malay (Malaysia)|no:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|si:Sinhala (Sri Lanka)|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese|aa-AA: Test Language"/>
 
   <add key="files.docservice.url.site" value="http://documentserver/"/>
 

web/documentserver-example/csharp/3rd-Party.license

@@ -16,6 +16,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license

web/documentserver-example/csharp/App_Themes/media.css

@@ -1,4 +1,22 @@
-@media (min-width: 1280px)  and (max-width: 1380px) {
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+ @media (min-width: 1280px)  and (max-width: 1380px) {
     .copy {
         margin-right: 6.5%;
     }
@@ -664,3 +682,8 @@
         max-width:15%;
     }
 }
+@media all and (-ms-high-contrast: none), (-ms-high-contrast: active) {
+    .tableRow td:first-child{
+        max-width: none;
+    }
+}

web/documentserver-example/csharp/App_Themes/stylesheet.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -167,7 +167,7 @@ label .checkbox {
     background-image: url("images/file_docxf.svg");
 }
 
-.create-sample {
+.side-option {
     color: #666666;
     line-height: 24px;
 }
@@ -744,3 +744,28 @@ html {
 .user-descr > b {
     margin-left: 25px;
 }
+
+.tooltip {
+    background: #FFFFFF;
+    border-radius: 5px;
+    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
+    color: #666666;
+    line-height: 160%;
+    max-width: 455px;
+    padding: 14px;
+    position: absolute;
+}
+
+    .tooltip ul {
+        margin: 0;
+    }
+
+.arrow {
+    border-top: 8px solid transparent;
+    border-bottom: 8px solid transparent;
+    border-right: 8px solid #FFFFFF;
+    left: -4px;
+    position: absolute;
+    top: 50%;
+    transform: translate(-50%, -50%);
+}

web/documentserver-example/csharp/Default.aspx

@@ -16,7 +16,7 @@
     <title>ONLYOFFICE</title>
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -73,7 +73,7 @@
                                                 <a class="try-editor form" data-type="docxf">Form template</a>
                                             </li>
                                         </ul>
-                                        <label class="create-sample">
+                                        <label class="side-option">
                                             <input id="createSample" class="checkbox" type="checkbox" />With sample content
                                         </label>
                                     </div>
@@ -88,7 +88,7 @@
                                         <tr>
                                             <td valign="middle">
                                                 <span class="select-user">Username</span>
-                                                <img class="info" src="app_themes/images/info.svg" />
+                                                <img id="info" class="info" src="app_themes/images/info.svg" />
                                                 <select class="select-user" id="user">
                                                     <% foreach (User user in Users.getAllUsers())
                                                        { %>
@@ -99,7 +99,10 @@
                                         </tr>
                                         <tr>
                                             <td valign="middle">
-                                                <span class="select-user">Language editors interface</span>
+                                                <span class="select-user">Language</span>
+                                            <img class="info info-tooltip" data-id="language"
+                                                 data-tooltip="Choose the language for ONLYOFFICE editors interface"
+                                                 src="app_themes/images/info.svg" />
                                                 <select class="select-user" id="language">
                                                     <% Dictionary<string, string> languages = GetLanguages(); 
                                                     foreach (var lang in languages)
@@ -109,6 +112,14 @@
                                                 </select>
                                             </td>
                                         </tr>
+                                        <tr>
+                                        <td valign="middle">
+                                            <label class="side-option">
+                                                <input id="directUrl" type="checkbox" class="checkbox" />Try opening on client
+                                                <img id="directUrlInfo" class="info info-tooltip" data-id="directUrlInfo" data-tooltip="Some files can be opened in the user's browser without connecting to the document server." src="app_themes/images/info.svg" />
+                                            </label>
+                                        </td>
+                                    </tr>
                                     </tbody>
                                 </table>
                             </div>
@@ -158,7 +169,8 @@
                                                 <tbody>
                                                 <%  foreach (var storedFile in storedFiles)
                                                     {
-                                                        var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
+                                                        var directUrlParam = GetDirectUrlParam();
+                                                        var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name) + directUrlParam;
                                                         var ext = Path.GetExtension(storedFile.Name).ToLower();
                                                         var docType = DocumentType(storedFile.Name);
                                                         var canEdit = EditedExts.Contains(ext);
@@ -344,7 +356,8 @@
         </footer>
     </form>
 
-    <script language="javascript" type="text/javascript" src="script/jquery-1.9.0.min.js"></script>
+    <script language="javascript" type="text/javascript" src="script/jquery-3.6.4.min.js"></script>
+    <script language="javascript" type="text/javascript" src="script/jquery-migrate-3.4.1.min.js"></script>
     <script language="javascript" type="text/javascript" src="script/jquery-ui.min.js"></script>
     <script language="javascript" type="text/javascript" src="script/jquery.blockUI.js"></script>
     <script language="javascript" type="text/javascript" src="script/jquery.iframe-transport.js"></script>

web/documentserver-example/csharp/Default.aspx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -471,11 +471,10 @@ namespace OnlineEditorsExample
             var lang = context.Request.Cookies.GetOrDefault("ulang", null);
 
             var extension = (Path.GetExtension(_fileName).ToLower() ?? "").Trim('.');
-            var internalExtension = FileType.GetInternalExtension(_fileName).Trim('.');
+            var internalExtension = "ooxml";
 
             // check if the file with such an extension can be converted
-            if (ConvertExts.Contains("." + extension)
-                && !string.IsNullOrEmpty(internalExtension))
+            if (ConvertExts.Contains("." + extension))
             {
                 // generate document key
                 var key = ServiceConverter.GenerateRevisionId(FileUri(_fileName, true));
@@ -487,16 +486,18 @@ namespace OnlineEditorsExample
                 fileUrl.Query = "type=download&fileName=" + HttpUtility.UrlEncode(_fileName)
                 + "&userAddress=" + HttpUtility.UrlEncode(CurUserHostAddress(HttpContext.Current.Request.UserHostAddress));
 
-                // get the url to the converted file
-                string newFileUri;
-                var result = ServiceConverter.GetConvertedUri(fileUrl.ToString() , extension, internalExtension, key, true, out newFileUri, filePass, lang);
+                // get the url and file type of the converted file
+                Dictionary<string, string> newFileData;
+                var result = ServiceConverter.GetConvertedData(fileUrl.ToString() , extension, internalExtension, key, true, out newFileData, filePass, lang);
+                var newFileUri = newFileData["fileUrl"];
+                var newFileType = "." + newFileData["fileType"];
                 if (result != 100)
                 {
                     return "{ \"step\" : \"" + result + "\", \"filename\" : \"" + _fileName + "\"}";
                 }
 
                 // get a file name of an internal file extension with an index if the file with such a name already exists
-                var fileName = GetCorrectName(Path.GetFileNameWithoutExtension(_fileName) + "." + internalExtension);
+                var fileName = GetCorrectName(Path.GetFileNameWithoutExtension(_fileName) + newFileType);
 
                 var req = (HttpWebRequest)WebRequest.Create(newFileUri);
 
@@ -626,5 +627,11 @@ namespace OnlineEditorsExample
             }
             return languages;
         }
+
+        public static string GetDirectUrlParam()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return "&directUrl=" + (isEnabledDirectUrl != null ? isEnabledDirectUrl : "false");
+        }
     }
 }

web/documentserver-example/csharp/DocEditor.aspx

@@ -15,7 +15,7 @@
     <title>ONLYOFFICE</title>
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -153,7 +153,7 @@
         var onRequestMailMergeRecipients = function (event) {
             docEditor.setMailMergeRecipients(<%= DataMailMergeRecipients %>);  // insert recipient data for mail merge into the file
         };
-        
+
         var onRequestSaveAs = function (event) {  //  the user is trying to save file by clicking Save Copy as... button
             var title = event.data.title;
             var url = event.data.url;
@@ -190,6 +190,19 @@
             }
         };
 
+        var onRequestReferenceData = function (event) {  // user refresh external data source
+
+            event.data.directUrl = !!config.document.directUrl;
+            let xhr = new XMLHttpRequest();
+            xhr.open("POST", "webeditor.ashx?type=reference");
+            xhr.setRequestHeader("Content-Type", "application/json");
+            xhr.send(JSON.stringify(event.data));
+            xhr.onload = function () {
+                console.log(xhr.responseText);
+                docEditor.setReferenceData(JSON.parse(xhr.responseText));
+            }
+        };
+
         config = <%= DocConfig %>;
 
         config.width = "100%";
@@ -198,7 +211,6 @@
         config.events = {
             'onAppReady': onAppReady,
             'onDocumentStateChange': onDocumentStateChange,
-            'onRequestEditRights': onRequestEditRights,
             'onError': onError,
             'onOutdatedVersion': onOutdatedVersion,
             'onMakeActionLink': onMakeActionLink,
@@ -219,7 +231,7 @@
                     var histData = <%= HistoryData %>;
                     docEditor.setHistoryData(histData[ver - 1]);  // send the link to the document for viewing the version history
                 };
-                config.events['onRequestHistoryClose '] = function () {  // the user is trying to go back to the document from viewing the document version history
+                config.events['onRequestHistoryClose'] = function () {  // the user is trying to go back to the document from viewing the document version history
                     document.location.reload();
                 };
             <% } %>
@@ -242,6 +254,9 @@
             };
             // prevent file renaming for anonymous users
             config.events['onRequestRename'] = onRequestRename;
+            config.events['onRequestReferenceData'] = onRequestReferenceData;
+            // prevent switch the document from the viewing into the editing mode for anonymous users
+            config.events['onRequestEditRights'] = onRequestEditRights;
         }
 
         if (config.editorConfig.createUrl) {

web/documentserver-example/csharp/DocEditor.aspx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -195,7 +195,7 @@ namespace OnlineEditorsExample
                             {
                                 { "title", FileName },
                                 { "url", getDownloadUrl(FileName) },
-                                { "directUrl", directUrl },
+                                { "directUrl", IsEnabledDirectUrl() ? directUrl : "" },
                                 { "fileType", ext.Trim('.') },
                                 { "key", Key },
                                 {
@@ -206,6 +206,17 @@ namespace OnlineEditorsExample
                                             { "favorite", favorite }
                                         }
                                 },
+                                {
+                                    "referenceData", new Dictionary<string, string>()
+                                    {
+                                        { "fileKey", !user.id.Equals("uid-0") ?
+                                            jss.Serialize(new Dictionary<string, object>{
+                                                {"fileName", FileName},
+                                                {"userAddress", HttpUtility.UrlEncode(_Default.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress))}
+                                        }) : null },
+                                        {"instanceId", _Default.GetServerUrl(false) }
+                                    }
+                                },
                                 {
                                     // the permission for the document to be edited and downloaded or not
                                     "permissions", new Dictionary<string, object>
@@ -222,7 +233,8 @@ namespace OnlineEditorsExample
                                             { "chat", !user.id.Equals("uid-0") },
                                             { "reviewGroups", user.reviewGroups },
                                             { "commentGroups", user.commentGroups },
-                                            { "userInfoGroups", user.userInfoGroups }
+                                            { "userInfoGroups", user.userInfoGroups },
+                                            { "protect", !user.deniedPermissions.Contains("protect") }
                                         }
                                 }
                             }
@@ -377,7 +389,12 @@ namespace OnlineEditorsExample
                     }
 
                     dataObj.Add("url", prevFileUrl);  // write file url to the data object
-                    dataObj.Add("directUrl", directPrevFileUrl);  // write direct url to the data object
+
+                    if (IsEnabledDirectUrl())
+                    {
+                        dataObj.Add("directUrl", directPrevFileUrl); // write direct url to the data object
+                    } 
+
                     dataObj.Add("version", i);
                     if (i > 1)  // check if the version number is greater than 1 (the file was modified)
                     {
@@ -395,12 +412,19 @@ namespace OnlineEditorsExample
                         obj.Add("user", change.Count > 0 ? change["user"] : null);
 
                         var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];  // get the history data from the previous file version
-                        dataObj.Add("previous", new Dictionary<string, object>() {  // write information about previous file version to the data object
+
+                        Dictionary<string, object> dataPrev = new Dictionary<string, object>() {  // write information about previous file version to the data object
                             { "fileType", prev["fileType"] },
                             { "key", prev["key"] },  // write key and url information about previous file version
-                            { "url", prev["url"] },
-                            { "directUrl", prev["directUrl"] },
-                        });
+                            { "url", prev["url"] }
+                        };
+
+                        if (IsEnabledDirectUrl())
+                        {
+                            dataPrev.Add("directUrl", prev["directUrl"]);
+                        }
+
+                        dataObj.Add("previous", dataPrev);
                         // write the path to the diff.zip archive with differences in this file version
                         var changesUrl = MakePublicHistoryUrl(FileName, (i - 1).ToString(), "diff.zip");
                         dataObj.Add("changesUrl", changesUrl);
@@ -442,10 +466,14 @@ namespace OnlineEditorsExample
             Dictionary<string, object> logoConfig = new Dictionary<string, object>
                 {
                     { "fileType", "png"},
-                    { "url", InsertImageUrl.ToString()},
-                    { "directUrl", DirectImageUrl.ToString()}
+                    { "url", InsertImageUrl.ToString()}
                 };
 
+            if (IsEnabledDirectUrl())
+            {
+                logoConfig.Add("directUrl", DirectImageUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var insImageToken = JwtManager.Encode(logoConfig);  // encode logoConfig into the token
@@ -475,10 +503,14 @@ namespace OnlineEditorsExample
             Dictionary<string, object> dataCompareFile = new Dictionary<string, object>
                 {
                     { "fileType", "docx" },
-                    { "url", compareFileUrl.ToString() },
-                    { "directUrl", DirectFileUrl.ToString() }
+                    { "url", compareFileUrl.ToString() }
                 };
 
+            if (IsEnabledDirectUrl())
+            {
+                dataCompareFile.Add("directUrl", DirectFileUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var compareFileToken = JwtManager.Encode(dataCompareFile);  // encode the dataCompareFile object into the token
@@ -510,10 +542,14 @@ namespace OnlineEditorsExample
             Dictionary<string, object> mailMergeConfig = new Dictionary<string, object>
                 {
                     { "fileType", "csv" },
-                    { "url", mailmergeUrl.ToString() },
-                    { "directUrl", DirectMailMergeUrl.ToString() }
+                    { "url", mailmergeUrl.ToString() }
                 };
 
+            if (IsEnabledDirectUrl())
+            {
+                mailMergeConfig.Add("directUrl", DirectMailMergeUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var mailmergeToken = JwtManager.Encode(mailMergeConfig);  // encode mailMergeConfig into the token
@@ -615,5 +651,12 @@ namespace OnlineEditorsExample
                 { "name", uname }
             }));
         }
+
+        // get direct url flag
+        private static bool IsEnabledDirectUrl()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return isEnabledDirectUrl != null ? Convert.ToBoolean(isEnabledDirectUrl) : false;
+        }
     }
 }

web/documentserver-example/csharp/DocumentConverter.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -70,24 +70,24 @@ namespace ASC.Api.DocumentConverter
         /// <param name="toExtension">Extension to which to convert</param>
         /// <param name="documentRevisionId">Key for caching on service</param>
         /// <param name="isAsync">Perform conversions asynchronously</param>
-        /// <param name="convertedDocumentUri">Uri to the converted document</param>
+        /// <param name="convertedDocumentData">Uri and file type of the converted document</param>
         /// <returns>The percentage of conversion completion</returns>
         /// <example>
-        /// string convertedDocumentUri;
-        /// GetConvertedUri("http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", ".pdf", ".docx", "http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", false, out convertedDocumentUri);
+        /// Dictionary<string, string> convertedDocumentData;
+        /// GetConvertedData("http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", ".pdf", ".docx", "http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", false, out convertedDocumentData);
         /// </example>
         /// <exception>
         /// </exception>
-        public static int GetConvertedUri(string documentUri,
+        public static int GetConvertedData(string documentUri,
                                           string fromExtension,
                                           string toExtension,
                                           string documentRevisionId,
                                           bool isAsync,
-                                          out string convertedDocumentUri,
+                                          out Dictionary<string, string> convertedDocumentData,
                                           string filePass = null,
                                           string lang = null)
         {
-            convertedDocumentUri = string.Empty;
+            convertedDocumentData = new Dictionary<string, string>();
 
             // check if the fromExtension parameter is defined; if not, get it from the document url
             fromExtension = string.IsNullOrEmpty(fromExtension) ? Path.GetExtension(documentUri).ToLower() : fromExtension;
@@ -121,7 +121,7 @@ namespace ASC.Api.DocumentConverter
                 { "region", lang }
             };
 
-            if (JwtManager.Enabled)
+            if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
             {
                 // create payload object
                 var payload = new Dictionary<string, object>
@@ -132,7 +132,7 @@ namespace ASC.Api.DocumentConverter
                 var payloadToken =  JwtManager.Encode(payload);  // encode the payload object to the payload token
                 var bodyToken = JwtManager.Encode(body);  // encode the body object to the body token
                 // create header token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);  // and add it to the request headers with the Bearer prefix
 
                 body.Add("token", bodyToken);
@@ -159,7 +159,7 @@ namespace ASC.Api.DocumentConverter
                 }
             }
 
-            return GetResponseUri(dataResponse, out convertedDocumentUri);
+            return GetResponseData(dataResponse, out convertedDocumentData);
         }
 
         /// <summary>
@@ -183,9 +183,9 @@ namespace ASC.Api.DocumentConverter
         /// Processing document received from the editing service
         /// </summary>
         /// <param name="jsonDocumentResponse">The resulting json from editing service</param>
-        /// <param name="responseUri">Uri to the converted document</param>
+        /// <param name="responseData">Uri and file type of the converted document</param>
         /// <returns>The percentage of conversion completion</returns>
-        private static int GetResponseUri(string jsonDocumentResponse, out string responseUri)
+        private static int GetResponseData(string jsonDocumentResponse, out Dictionary<string, string> responseData)
         {
             if (string.IsNullOrEmpty(jsonDocumentResponse)) throw new ArgumentException("Invalid param", "jsonDocumentResponse");
 
@@ -199,14 +199,20 @@ namespace ASC.Api.DocumentConverter
             var isEndConvert = responseFromService.endConvert;
 
             int resultPercent;
-            responseUri = string.Empty;
+            responseData = new Dictionary<string, string>(); 
+            var responseUri = string.Empty;
+            var responseFileType = string.Empty;
             if (isEndConvert)  // if the conversion is completed
             {
                 responseUri = responseFromService.fileUrl;  // get the file url
+                responseFileType = responseFromService.fileType;  // get the file type
+                responseData.Add("fileUrl", responseUri);
+                responseData.Add("fileType", responseFileType);
                 resultPercent = 100;
             }
             else  // if the conversion isn't completed
             {
+                responseData.Add("fileUrl", "");
                 resultPercent = responseFromService.percent;  // get the percentage value
                 if (resultPercent >= 100) resultPercent = 99;
             }

web/documentserver-example/csharp/JwtManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -29,11 +29,13 @@ namespace OnlineEditorsExample
     {
         private static readonly string Secret;
         public static readonly bool Enabled;
+        public static readonly bool SignatureUseForRequest;
 
         static JwtManager()
         {
             Secret = WebConfigurationManager.AppSettings["files.docservice.secret"] ?? "";  // get token secret from the config parameters
             Enabled = !string.IsNullOrEmpty(Secret);  // check if the token is enabled
+            SignatureUseForRequest = bool.Parse(WebConfigurationManager.AppSettings["files.docservice.token.useforrequest"]);
         }
 
         // encode a payload object into a token using a secret key

web/documentserver-example/csharp/Properties/AssemblyInfo.cs

@@ -7,7 +7,7 @@ using System.Runtime.InteropServices;
 [assembly: AssemblyConfiguration("")]
 [assembly: AssemblyCompany("Ascensio System SIA")]
 [assembly: AssemblyProduct("OnlineEditorsExample")]
-[assembly: AssemblyCopyright("Ascensio System SIA 2021")]
+[assembly: AssemblyCopyright("Ascensio System SIA 2023")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]
 

web/documentserver-example/csharp/TrackManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -55,9 +55,9 @@ namespace OnlineEditorsExample
             var fileData = jss.Deserialize<Dictionary<string, object>>(body);
 
             // check if the document token is enabled
-            if (JwtManager.Enabled)
+            if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
             {
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                 string token = null;
 
@@ -76,7 +76,7 @@ namespace OnlineEditorsExample
                     context.Response.Write("{\"error\":1,\"message\":\"JWT expected\"}");
                 }
 
-                if (token != null && !token.Equals(""))  // invalid signature error
+                if (!string.IsNullOrEmpty(token))  // invalid signature error
                 {
                     fileData = jss.Deserialize<Dictionary<string, object>>(token);
                     if (fileData.ContainsKey("payload"))
@@ -100,9 +100,7 @@ namespace OnlineEditorsExample
             var downloadUri = (string)fileData["url"];
             var curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower() ?? ""; // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"];  // get the extension of the downloaded file
 
             var newFileName = fileName;
 
@@ -112,8 +110,9 @@ namespace OnlineEditorsExample
                 try
                 {
                     // convert file and give url to a new file
-                    string newFileUri;
-                    ServiceConverter.GetConvertedUri(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileUri);
+                    Dictionary<string, string> newFileData;
+                    ServiceConverter.GetConvertedData(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileData);
+                    var newFileUri = newFileData["fileUrl"];
                     if (string.IsNullOrEmpty(newFileUri))
                     {
                         // get the correct file name if it already exists
@@ -132,37 +131,48 @@ namespace OnlineEditorsExample
 
             _Default.VerifySSL();
 
-            var storagePath = _Default.StoragePath(newFileName, userAddress);  // get the file path
-            var histDir = _Default.HistoryDir(storagePath);  // get the path to the history directory
-            if (!Directory.Exists(histDir)) Directory.CreateDirectory(histDir);
-
-            var versionDir = _Default.VersionDir(histDir, _Default.GetFileVersion(histDir));  // get the path to the file version
-            if (!Directory.Exists(versionDir)) Directory.CreateDirectory(versionDir);  // if the path doesn't exist, create it
-
-            // get the path to the previous file version and rename the storage path with it
-            File.Copy(_Default.StoragePath(fileName, userAddress), Path.Combine(versionDir, "prev" + curExt));
-
-            DownloadToFile(downloadUri, storagePath);  // save file to the storage directory
-            DownloadToFile((string)fileData["changesurl"], Path.Combine(versionDir, "diff.zip"));  // save file changes to the diff.zip archive
-
-            var hist = fileData.ContainsKey("changeshistory") ? (string)fileData["changeshistory"] : null;
-            if (string.IsNullOrEmpty(hist) && fileData.ContainsKey("history"))
+            try
             {
-                var jss = new JavaScriptSerializer();
-                hist = jss.Serialize(fileData["history"]);
+                var bytesFile = DownloadFile(downloadUri); // download document file
+                var storagePath = _Default.StoragePath(newFileName, userAddress);  // get the file path
+
+                var histDir = _Default.HistoryDir(storagePath);  // get the path to the history directory
+                if (!Directory.Exists(histDir)) Directory.CreateDirectory(histDir);
+
+                var versionDir = _Default.VersionDir(histDir, _Default.GetFileVersion(histDir));  // get the path to the file version
+                if (!Directory.Exists(versionDir)) Directory.CreateDirectory(versionDir);  // if the path doesn't exist, create it
+
+                // get the path to the previous file version and rename the storage path with it
+                File.Copy(_Default.StoragePath(fileName, userAddress), Path.Combine(versionDir, "prev" + curExt));
+
+                SaveFile(bytesFile, storagePath);// save document file
+
+                var bytesChanges = DownloadFile((string)fileData["changesurl"]); // download changes file
+                SaveFile(bytesChanges, Path.Combine(versionDir, "diff.zip")); // save file changes to the diff.zip archive
+
+                var hist = fileData.ContainsKey("changeshistory") ? (string)fileData["changeshistory"] : null;
+                if (string.IsNullOrEmpty(hist) && fileData.ContainsKey("history"))
+                {
+                    var jss = new JavaScriptSerializer();
+                    hist = jss.Serialize(fileData["history"]);
+                }
+
+                if (!string.IsNullOrEmpty(hist))
+                {
+                    File.WriteAllText(Path.Combine(versionDir, "changes.json"), hist);  // write the history changes to the changes.json file
+                }
+
+                File.WriteAllText(Path.Combine(versionDir, "key.txt"), (string)fileData["key"]);  // write the key value to the key.txt file
+
+                string forcesavePath = _Default.ForcesavePath(newFileName, userAddress, false);  // get the path to the forcesaved file version
+            if (!string.IsNullOrEmpty(forcesavePath))  // if the forcesaved file version exists
+                {
+                    File.Delete(forcesavePath);  // remove it
+                }
             }
-
-            if (!string.IsNullOrEmpty(hist))
+            catch (Exception)
             {
-                File.WriteAllText(Path.Combine(versionDir, "changes.json"), hist);  // write the history changes to the changes.json file
-            }
-
-            File.WriteAllText(Path.Combine(versionDir, "key.txt"), (string)fileData["key"]);  // write the key value to the key.txt file
-
-            string forcesavePath = _Default.ForcesavePath(newFileName, userAddress, false);  // get the path to the forcesaved file version
-            if (!forcesavePath.Equals(""))  // if the forcesaved file version exists
-            {
-                File.Delete(forcesavePath);  // remove it
+                return 1;
             }
 
             return 0;
@@ -178,9 +188,7 @@ namespace OnlineEditorsExample
 
             string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower(); // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"];  // get the extension of the downloaded file
 
             Boolean newFileName = false;
 
@@ -190,8 +198,9 @@ namespace OnlineEditorsExample
                 try
                 {
                     // convert file and give url to a new file
-                    string newFileUri;
-                    var result = ServiceConverter.GetConvertedUri(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileUri);
+                    Dictionary<string, string> newFileData;
+                    var result = ServiceConverter.GetConvertedData(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileData);
+                    var newFileUri = newFileData["fileUrl"];
                     if (string.IsNullOrEmpty(newFileUri))
                     {
                         newFileName = true;
@@ -209,43 +218,51 @@ namespace OnlineEditorsExample
 
             _Default.VerifySSL();
 
-            string forcesavePath = "";
-            Boolean isSubmitForm = fileData["forcesavetype"].ToString().Equals("3");  // SubmitForm
-
-            if (isSubmitForm)  // if the form is submitted
+            try
             {
-                if (newFileName)
+                var bytesFile = DownloadFile(downloadUri); // download document file
+                string forcesavePath = "";
+                Boolean isSubmitForm = fileData["forcesavetype"].ToString().Equals("3");  // SubmitForm
+
+                if (isSubmitForm)  // if the form is submitted
                 {
-                    fileName = _Default.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + downloadExt, userAddress);  // get the correct file name if it already exists
+                    if (newFileName)
+                    {
+                        fileName = _Default.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + downloadExt, userAddress);  // get the correct file name if it already exists
                 } else
-                {
-                    fileName = _Default.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + curExt, userAddress);
+                    {
+                        fileName = _Default.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + curExt, userAddress);
+                    }
+                    forcesavePath = _Default.StoragePath(fileName, userAddress);
                 }
-                forcesavePath = _Default.StoragePath(fileName, userAddress);
-            }
-            else
-            {
-                if (newFileName)
+                else
                 {
-                    fileName = _Default.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
+                    if (newFileName)
+                    {
+                        fileName = _Default.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
+                    }
+
+                    forcesavePath = _Default.ForcesavePath(fileName, userAddress, false);
+                if (string.IsNullOrEmpty(forcesavePath))  // create forcesave path if it doesn't exist
+                    {
+                        forcesavePath = _Default.ForcesavePath(fileName, userAddress, true);
+                    }
                 }
 
-                forcesavePath = _Default.ForcesavePath(fileName, userAddress, false);
-                if (forcesavePath.Equals(""))  // create forcesave path if it doesn't exist
+                SaveFile(bytesFile, forcesavePath);// save document file
+
+                if (isSubmitForm)
                 {
-                    forcesavePath = _Default.ForcesavePath(fileName, userAddress, true);
+                    var jss = new JavaScriptSerializer();
+                    var actions = jss.Deserialize<List<object>>(jss.Serialize(fileData["actions"]));
+                    var action = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(actions[0]));
+                    var user = action["userid"].ToString();  // get the user id
+                    DocEditor.CreateMeta(fileName, user, "Filling Form", userAddress);  // create meta data for the forcesaved file
                 }
             }
-
-            DownloadToFile(downloadUri, forcesavePath);
-
-            if (isSubmitForm)
+            catch (Exception)
             {
-                var jss = new JavaScriptSerializer();
-                var actions = jss.Deserialize<List<object>>(jss.Serialize(fileData["actions"]));
-                var action = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(actions[0]));
-                var user = action["userid"].ToString();  // get the user id
-                DocEditor.CreateMeta(fileName, user, "Filling Form", userAddress);  // create meta data for the forcesaved file
+                return 1;
             }
 
             return 0;
@@ -273,7 +290,7 @@ namespace OnlineEditorsExample
             }
 
             // check if a secret key to generate token exists or not
-            if (JwtManager.Enabled)
+            if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
             {
                 var payload = new Dictionary<string, object>
                 {
@@ -282,7 +299,7 @@ namespace OnlineEditorsExample
 
                 var payloadToken = JwtManager.Encode(payload);  // encode a payload object into a header token
                 var bodyToken = JwtManager.Encode(body);  // encode body into a body token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);  // add a header Authorization with a header token and Authorization prefix in it
 
                 body.Add("token", bodyToken);
@@ -317,26 +334,29 @@ namespace OnlineEditorsExample
             }
         }
 
+        private static void SaveFile(byte[] data, string path)
+        {
+            using (var fs = File.Open(path, FileMode.Create))
+            {
+                fs.Write(data, 0, data.Length);
+            }
+        }
+
         // save file information from the url to the file specified
-        private static void DownloadToFile(string url, string path)
+        private static byte[] DownloadFile(string url)
         {
             if (string.IsNullOrEmpty(url)) throw new ArgumentException("url");  // url isn't specified
-            if (string.IsNullOrEmpty(path)) throw new ArgumentException("path");  // file isn't specified
 
             var req = (HttpWebRequest)WebRequest.Create(url);
+            req.Timeout = 5000;
             using (var stream = req.GetResponse().GetResponseStream())  // get input stream of the file information from the url
             {
                 if (stream == null) throw new Exception("stream is null");
-                const int bufferSize = 4096;
 
-                using (var fs = File.Open(path, FileMode.Create))
+                using (MemoryStream memoryStream = new MemoryStream())
                 {
-                    var buffer = new byte[bufferSize];
-                    int readed;
-                    while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
-                    {
-                        fs.Write(buffer, 0, readed);  // write bytes to the output stream
-                    }
+                    stream.CopyTo(memoryStream);
+                    return memoryStream.ToArray();
                 }
             }
         }

web/documentserver-example/csharp/Users.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -68,6 +68,7 @@ namespace OnlineEditorsExample
             "Can’t see anyone’s information",
             "Can't rename files from the editor",
             "Can't view chat",
+            "Can't protect file",
             "View file without collaboration",
         };
 
@@ -130,7 +131,7 @@ namespace OnlineEditorsExample
                     new Dictionary<string, object>(),
                     new List<string>(),
                     null,
-                    new List<string>(),
+                    new List<string>() { "protect" },
                     descr_user_0,
                     false
                 )

web/documentserver-example/csharp/Utils.cs

@@ -1,4 +1,22 @@
-using System.Web;
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+using System.Web;
 
 namespace OnlineEditorsExample
 {

web/documentserver-example/csharp/WebEditor.ashx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,6 +26,7 @@ using System.Diagnostics;
 using System.Web.Configuration;
 using System.Linq;
 using System.Net;
+using System.Net.Sockets;
 
 namespace OnlineEditorsExample
 {
@@ -71,6 +72,9 @@ namespace OnlineEditorsExample
                 case "rename":
                     Rename(context);
                     break;
+                case "reference":
+                    Reference(context);
+                    break;
             }
         }
 
@@ -281,26 +285,26 @@ namespace OnlineEditorsExample
                 var userAddress = Path.GetFileName(context.Request["userAddress"]);
                 var isEmbedded = context.Request["dmode"];
 
-                if (JwtManager.Enabled && isEmbedded == null)
+                if (JwtManager.Enabled && isEmbedded == null && userAddress != null && JwtManager.SignatureUseForRequest)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
+                    string token = "";
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
-                        string token = JwtManager.Decode(headerToken);
-
-                        if (token == null || token.Equals(""))
-                        {
-                            context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
-                            context.Response.Write("JWT validation failed");
-                            return;
-                        }
+                        token = JwtManager.Decode(headerToken);
+                    }
+                    if (string.IsNullOrEmpty(token))
+                    {
+                        context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
+                        context.Response.Write("JWT validation failed");
+                        return;
                     }
                 }
 
                 var filePath = _Default.ForcesavePath(fileName, userAddress, false);  // get the path to the force saved document version
-                if (filePath.Equals(""))
+                if (string.IsNullOrEmpty(filePath))
                 {
                     filePath = _Default.StoragePath(fileName, userAddress);  // or to the original document
                 }
@@ -338,16 +342,16 @@ namespace OnlineEditorsExample
                 var version = Path.GetFileName(context.Request["ver"]);
                 var file = Path.GetFileName(context.Request["file"]);
 
-                if (JwtManager.Enabled)
+                if (JwtManager.Enabled && JwtManager.SignatureUseForRequest)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
                         string token = JwtManager.Decode(headerToken);
 
-                        if (token == null || token.Equals(""))
+                        if (string.IsNullOrEmpty(token))
                         {
                             context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
                             context.Response.Write("JWT validation failed");
@@ -409,5 +413,94 @@ namespace OnlineEditorsExample
             TrackManager.commandRequest("meta", docKey, meta);
             context.Response.Write("{ \"result\": \"OK\"}");
         }
+
+        private static void Reference(HttpContext context)
+        {
+            string fileData;
+            try
+            {
+                using (var receiveStream = context.Request.InputStream)
+                using (var readStream = new StreamReader(receiveStream))
+                {
+                    fileData = readStream.ReadToEnd();
+                    if (string.IsNullOrEmpty(fileData)) return;
+                }
+            }
+            catch (Exception e)
+            {
+                throw new HttpException((int)HttpStatusCode.BadRequest, e.Message);
+            }
+
+            var jss = new JavaScriptSerializer();
+            var body = jss.Deserialize<Dictionary<string, object>>(fileData);
+            Dictionary<string, object> referenceData = null;
+            var fileName = "";
+            var userAddress = "";
+
+            if (body.ContainsKey("referenceData"))
+            {
+                referenceData = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(body["referenceData"]));
+                var instanceId = (string)referenceData["instanceId"];
+                var fileKey = (string)referenceData["fileKey"];
+                if (instanceId == _Default.GetServerUrl(false))
+                {
+                    var fileKeyObj = jss.Deserialize<Dictionary<string, object>>(fileKey);
+                    userAddress = (string)fileKeyObj["userAddress"];
+                    if (userAddress == HttpUtility.UrlEncode(_Default.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress)))
+                    {
+                        fileName = (string)fileKeyObj["fileName"];
+                    }
+                }
+            }
+
+            if (fileName == "")
+            {
+                try
+                {
+                    var path = (string)body["path"];
+                    path = Path.GetFileName(path);
+                    if (File.Exists(_Default.StoragePath(path, null)))
+                    {
+                        fileName = path;
+                    }
+                }
+                catch
+                {
+                    context.Response.Write("{ \"error\": \"Path not found!\"}");
+                    return;
+                }
+            }
+
+            if (fileName == "")
+            {
+                context.Response.Write("{ \"error\": \"File not found!\"}");
+                return;
+            }
+
+            var data = new Dictionary<string, object>() {
+            { "fileType", (Path.GetExtension(fileName) ?? "").ToLower() },
+            { "url",  DocEditor.getDownloadUrl(fileName)},
+            { "directUrl",  DocEditor.getDownloadUrl(fileName) },
+            { "referenceData", new Dictionary<string, string>()
+                {
+                    { "fileKey", jss.Serialize(new Dictionary<string, object>{
+                            {"fileName", fileName},
+                            {"userAddress", HttpUtility.UrlEncode(_Default.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress))}
+                    })
+                    },
+                    {"instanceId", _Default.GetServerUrl(false) }
+                }
+            },
+            { "path", fileName }
+            };
+
+            if (JwtManager.Enabled)
+            {
+                var token = JwtManager.Encode(data);
+                data.Add("token", token);
+            }
+
+            context.Response.Write(jss.Serialize(data));
+        }
     }
 }

web/documentserver-example/csharp/licenses/3rd-Party.license

@@ -16,6 +16,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license

web/documentserver-example/csharp/licenses/jQuery.Migrate.license

@@ -0,0 +1,36 @@
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/jquery-migrate
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.

web/documentserver-example/csharp/licenses/jquery.license

@@ -1,4 +1,4 @@
-Copyright (c) 2009 John Resig, http://jquery.com/
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

web/documentserver-example/csharp/script/jquery.dropdownToggle.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp/script/jscript.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,11 +16,24 @@
  *
  */
 
+var directUrl;
+
 if (typeof jQuery != "undefined") {
     jq = jQuery.noConflict();
 
+    directUrl = getUrlVars()["directUrl"] == "true";
+
     mustReload = false;
 
+    if (directUrl)
+        jq("#directUrl").prop("checked", directUrl);
+    else
+        directUrl = jq("#directUrl").prop("checked");
+
+    jq("#directUrl").change(function () {
+        window.location = "?directUrl=" + jq(this).prop("checked");
+    });
+
     jq(function () {
         jq('#fileupload').fileupload({
             dataType: 'json',
@@ -219,7 +232,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEdit:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = "doceditor.aspx?fileID=" + fileId;
+        var url = "doceditor.aspx?fileID=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -227,7 +240,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginView:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = "doceditor.aspx?editorsMode=view&fileID=" + fileId;
+        var url = "doceditor.aspx?editorsMode=view&fileID=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -235,7 +248,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEmbedded:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = "doceditor.aspx?editorsType=embedded&editorsMode=embedded&fileID=" + fileId;
+        var url = "doceditor.aspx?editorsType=embedded&editorsMode=embedded&fileID=" + fileId + "&directUrl=" + directUrl;
 
         jq("#mainProgress").addClass("embedded");
         jq("#beginEmbedded").addClass("disable");
@@ -288,6 +301,17 @@ if (typeof jQuery != "undefined") {
         }
     };
 
+    function getUrlVars() {
+        var vars = [], hash;
+        var hashes = window.location.href.slice(window.location.href.indexOf('?') + 1).split('&');
+        for (var i = 0; i < hashes.length; i++) {
+            hash = hashes[i].split('=');
+            vars.push(hash[0]);
+            vars[hash[0]] = hash[1];
+        }
+        return vars;
+    };
+
     var fileList = jq("tr.tableRow");
 
     var mouseIsOverTooltip = false;
@@ -298,12 +322,12 @@ if (typeof jQuery != "undefined") {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
                 }
-                jq(".info").on("touchend", function () {
+                jq("#info").on("touchend", function () {
                     showUserTooltip(true);
                 });
             }
     } else {
-        jq(".info").mouseover(function (event) {
+        jq("#info").mouseover(function (event) {
             if (fileList.length > 0) {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
@@ -327,4 +351,18 @@ if (typeof jQuery != "undefined") {
             }, 500);
         });
     }
+
+    jq(".info-tooltip").mouseover(function (event) {
+        var target = event.target;
+        var id = target.dataset.id ? target.dataset.id : target.id;
+        var tooltip = target.dataset.tooltip;
+
+        jq("<div class='tooltip'>" + tooltip + "<div class='arrow'></div></div>").appendTo("body");
+
+        var top = jq("#" + id).offset().top + jq("#" + id).outerHeight() / 2 - jq("div.tooltip").outerHeight() / 2;
+        var left = jq("#" + id).offset().left + jq("#" + id).outerWidth() + 20;
+        jq("div.tooltip").css({ "top": top, "left": left });
+    }).mouseout(function () {
+        jq("div.tooltip").remove();
+    });
 }

web/documentserver-example/csharp/settings.config

@@ -1,21 +1,23 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <appSettings>
   <clear />
-  <add key="version" value="1.4.0"/>
+  <add key="version" value="1.5.1"/>
 
   <add key="filesize-max" value="52428800"/>
   <add key="storage-path" value=""/>
 
-  <add key="files.docservice.fillform-docs" value=".oform|.docx"/>
-  <add key="files.docservice.viewed-docs" value=".pdf|.djvu|.xps|.oxps"/>
-  <add key="files.docservice.edited-docs" value=".docx|.xlsx|.csv|.pptx|.txt|.docxf"/>
-  <add key="files.docservice.convert-docs" value=".docm|.dotx|.dotm|.dot|.doc|.odt|.fodt|.ott|.xlsm|.xlsb|.xltx|.xltm|.xlt|.xls|.ods|.fods|.ots|.pptm|.ppt|.ppsx|.ppsm|.pps|.potx|.potm|.pot|.odp|.fodp|.otp|.rtf|.mht|.html|.htm|.xml|.epub|.fb2"/>
+  <add key="files.docservice.fillform-docs" value=".docx|.oform"/>
+  <add key="files.docservice.viewed-docs" value=".djvu|.oxps|.pdf|.xps"/>
+  <add key="files.docservice.edited-docs" value=".csv|.docm|.docx|.docxf|.dotm|.dotx|.epub|.fb2|.html|.odp|.ods|.odt|.otp|.ots|.ott|.potm|.potx|.ppsm|.ppsx|.pptm|.pptx|.rtf|.txt|.xlsm|.xlsx|.xltm|.xltx"/>
+  <add key="files.docservice.convert-docs" value=".doc|.dot|.dps|.dpt|.epub|.et|.ett|.fb2|.fodp|.fods|.fodt|.htm|.html|.mht|.mhtml|.odp|.ods|.odt|.otp|.ots|.ott|.pot|.pps|.ppt|.rtf|.stw|.sxc|.sxi|.sxw|.wps|.wpt|.xls|.xlsb|.xlt|.xml"/>
   <add key="files.docservice.timeout" value="120000" />
   <add key="files.docservice.secret" value="" />
   <add key="files.docservice.header" value="Authorization" />
   <add key="files.docservice.verify-peer-off" value="true"/>
 
-  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese (People's Republic of China)|zh-TW:Chinese (Traditional, Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lv:Latvian|lo:Lao|ms:Malay (Malaysia)|nb:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese"/>
+  <add key="files.docservice.token.useforrequest" value="true" />
+
+  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese|zh-TW:Chinese (Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lo:Lao|lv:Latvian|ms:Malay (Malaysia)|no:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|si:Sinhala (Sri Lanka)|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese|aa-AA: Test Language"/>
 
   <add key="files.docservice.url.site" value="http://documentserver/"/>
 

web/documentserver-example/java-spring/.gitignore

@@ -1,19 +0,0 @@
-# Eclipse
-.classpath
-.project
-.settings/
-
-# Intellij
-.idea/
-*.iml
-*.iws
-
-# Mac
-.DS_Store
-
-# Maven
-log/
-target/
-
-#project
-documents

web/documentserver-example/java-spring/3rd-Party.license

@@ -16,6 +16,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license

web/documentserver-example/java-spring/README.md

@@ -139,11 +139,11 @@ See the detailed guide to learn how to install Document Server [for Linux](https
     a) archive with Java-Spring:
 
     ```
-    wget https://api.onlyoffice.com/app_data/editor/Java-Spring%20Example.zip
+    wget https://api.onlyoffice.com/app_data/editor/Java%20Spring%20Example.zip
     ```
     
     ```
-    unzip Java-Spring\ Example.zip
+    unzip Java\ Spring\ Example.zip
     ```
     b) git repository:
     ```
@@ -156,7 +156,7 @@ See the detailed guide to learn how to install Document Server [for Linux](https
     a) from archive
 
     ```
-   cd Java-Spring\ Example/
+   cd Java\ Spring\ Example/
    ```
    b) from git repository 
     ```

web/documentserver-example/java-spring/checkstyle-suppressions.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0"?>
+<!DOCTYPE suppressions PUBLIC
+        "-//Checkstyle//DTD SuppressionFilter Configuration 1.0//EN"
+        "https://checkstyle.org/dtds/suppressions_1_0.dtd">
+
+<suppressions>
+    <suppress checks="HideUtilityClassConstructor" files="IntegrationApplication.java"/>
+    <suppress checks="DesignForExtension" files="."/>
+    <suppress checks="ParameterNumber" files="."/>
+    <suppress checks="JavadocPackage" files="."/>
+    <suppress checks="JavadocVariable" files="."/>
+    <suppress checks="MissingJavadocMethod" files="."/>
+</suppressions>

web/documentserver-example/java-spring/checkstyle.xml

@@ -0,0 +1,199 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<!--
+
+  Checkstyle configuration that checks the sun coding conventions from:
+
+    - the Java Language Specification at
+      https://docs.oracle.com/javase/specs/jls/se11/html/index.html
+
+    - the Sun Code Conventions at https://www.oracle.com/java/technologies/javase/codeconventions-contents.html
+
+    - the Javadoc guidelines at
+      https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html
+
+    - the JDK Api documentation https://docs.oracle.com/en/java/javase/11/
+
+    - some best practices
+
+  Checkstyle is very configurable. Be sure to read the documentation at
+  https://checkstyle.org (or in your downloaded distribution).
+
+  Most Checks are configurable, be sure to consult the documentation.
+
+  To completely disable a check, just comment it out or delete it from the file.
+  To suppress certain violations please review suppression filters.
+
+  Finally, it is worth reading the documentation.
+
+-->
+
+<module name="Checker">
+    <!--
+        If you set the basedir property below, then all reported file
+        names will be relative to the specified directory. See
+        https://checkstyle.org/config.html#Checker
+
+        <property name="basedir" value="${basedir}"/>
+    -->
+    <property name="severity" value="error"/>
+
+    <property name="fileExtensions" value="java, properties, xml"/>
+
+    <!-- Excludes all 'module-info.java' files              -->
+    <!-- See https://checkstyle.org/config_filefilters.html -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$"/>
+    </module>
+
+    <!-- https://checkstyle.org/config_filters.html#SuppressionFilter -->
+    <module name="SuppressionFilter">
+        <property name="file" value="${org.checkstyle.sun.suppressionfilter.config}"
+                  default="checkstyle-suppressions.xml" />
+        <property name="optional" value="true"/>
+    </module>
+
+    <!-- Checks that a package-info.java file exists for each package.     -->
+    <!-- See https://checkstyle.org/config_javadoc.html#JavadocPackage -->
+    <module name="JavadocPackage"/>
+
+    <!-- Checks whether files end with a new line.                        -->
+    <!-- See https://checkstyle.org/config_misc.html#NewlineAtEndOfFile -->
+    <module name="NewlineAtEndOfFile"/>
+
+    <!-- Checks that property files contain the same keys.         -->
+    <!-- See https://checkstyle.org/config_misc.html#Translation -->
+    <module name="Translation"/>
+
+    <!-- Checks for Size Violations.                    -->
+    <!-- See https://checkstyle.org/config_sizes.html -->
+    <module name="FileLength"/>
+    <module name="LineLength">
+        <property name="fileExtensions" value="java"/>
+        <property name="max" value="120"/>
+    </module>
+
+    <!-- Checks for whitespace                               -->
+    <!-- See https://checkstyle.org/config_whitespace.html -->
+    <module name="FileTabCharacter"/>
+
+    <!-- Miscellaneous other checks.                   -->
+    <!-- See https://checkstyle.org/config_misc.html -->
+    <module name="RegexpSingleline">
+        <property name="format" value="\s+$"/>
+        <property name="minimum" value="0"/>
+        <property name="maximum" value="0"/>
+        <property name="message" value="Line has trailing spaces."/>
+    </module>
+
+    <!-- Checks for Headers                                -->
+    <!-- See https://checkstyle.org/config_header.html   -->
+     <module name="Header">
+       <property name="headerFile" value="onlyoffice.header"/>
+       <property name="fileExtensions" value="java"/>
+     </module>
+
+    <module name="TreeWalker">
+
+        <!-- Checks for Javadoc comments.                     -->
+        <!-- See https://checkstyle.org/config_javadoc.html -->
+        <module name="InvalidJavadocPosition"/>
+        <module name="JavadocMethod"/>
+        <module name="JavadocType"/>
+        <module name="JavadocVariable"/>
+        <module name="JavadocStyle"/>
+        <module name="MissingJavadocMethod"/>
+
+        <!-- Checks for Naming Conventions.                  -->
+        <!-- See https://checkstyle.org/config_naming.html -->
+        <module name="ConstantName"/>
+        <module name="LocalFinalVariableName"/>
+        <module name="LocalVariableName"/>
+        <module name="MemberName"/>
+        <module name="MethodName"/>
+        <module name="PackageName"/>
+        <module name="ParameterName"/>
+        <module name="StaticVariableName"/>
+        <module name="TypeName"/>
+
+        <!-- Checks for imports                              -->
+        <!-- See https://checkstyle.org/config_imports.html -->
+        <module name="AvoidStarImport"/>
+        <module name="IllegalImport"/> <!-- defaults to sun.* packages -->
+        <module name="RedundantImport"/>
+        <module name="UnusedImports">
+            <property name="processJavadoc" value="false"/>
+        </module>
+
+        <!-- Checks for Size Violations.                    -->
+        <!-- See https://checkstyle.org/config_sizes.html -->
+        <module name="MethodLength"/>
+        <module name="ParameterNumber"/>
+
+        <!-- Checks for whitespace                               -->
+        <!-- See https://checkstyle.org/config_whitespace.html -->
+        <module name="EmptyForIteratorPad"/>
+        <module name="GenericWhitespace"/>
+        <module name="MethodParamPad"/>
+        <module name="NoWhitespaceAfter"/>
+        <module name="NoWhitespaceBefore"/>
+        <module name="OperatorWrap"/>
+        <module name="ParenPad"/>
+        <module name="TypecastParenPad"/>
+        <module name="WhitespaceAfter"/>
+        <module name="WhitespaceAround"/>
+
+        <!-- Modifier Checks                                    -->
+        <!-- See https://checkstyle.org/config_modifier.html -->
+        <module name="ModifierOrder"/>
+        <module name="RedundantModifier"/>
+
+        <!-- Checks for blocks. You know, those {}'s         -->
+        <!-- See https://checkstyle.org/config_blocks.html -->
+        <module name="AvoidNestedBlocks"/>
+        <module name="EmptyBlock"/>
+        <module name="LeftCurly"/>
+        <module name="NeedBraces"/>
+        <module name="RightCurly"/>
+
+        <!-- Checks for common coding problems               -->
+        <!-- See https://checkstyle.org/config_coding.html -->
+        <module name="EmptyStatement"/>
+        <module name="EqualsHashCode"/>
+        <module name="HiddenField"/>
+        <module name="IllegalInstantiation"/>
+        <module name="InnerAssignment"/>
+        <module name="MagicNumber"/>
+        <module name="MissingSwitchDefault"/>
+        <module name="MultipleVariableDeclarations"/>
+        <module name="SimplifyBooleanExpression"/>
+        <module name="SimplifyBooleanReturn"/>
+
+        <!-- Checks for class design                         -->
+        <!-- See https://checkstyle.org/config_design.html -->
+        <module name="DesignForExtension"/>
+        <module name="FinalClass"/>
+        <module name="HideUtilityClassConstructor"/>
+        <module name="InterfaceIsType"/>
+        <module name="VisibilityModifier"/>
+
+        <!-- Miscellaneous other checks.                   -->
+        <!-- See https://checkstyle.org/config_misc.html -->
+        <module name="ArrayTypeStyle"/>
+        <module name="FinalParameters"/>
+        <module name="TodoComment"/>
+        <module name="UpperEll"/>
+
+        <!-- https://checkstyle.org/config_filters.html#SuppressionXpathFilter -->
+        <module name="SuppressionXpathFilter">
+            <property name="file" value="${org.checkstyle.sun.suppressionxpathfilter.config}"
+                      default="checkstyle-xpath-suppressions.xml" />
+            <property name="optional" value="true"/>
+        </module>
+
+    </module>
+
+</module>

web/documentserver-example/java-spring/licenses/3rd-Party.license

@@ -16,6 +16,10 @@ jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https:
 License:        MIT
 License File:   jQuery.iframe-transport.license
 
+jQuery.Migrate - Upgrading libraries such as jQuery can be a lot of work, when breaking changes have been introduced. jQuery Migrate makes this easier, by restoring the APIs that were removed, and additionally shows warnings in the browser console (development version of jQuery Migrate only) when removed and/or deprecated APIs are used. (https://github.com/jquery/jquery-migrate/blob/main/LICENSE.txt)
+License:         OpenJS
+License File:    jQuery.Migrate.license
+
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license

web/documentserver-example/java-spring/licenses/jQuery.Migrate.license

@@ -0,0 +1,36 @@
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/jquery/jquery-migrate
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+All files located in the node_modules and external directories are
+externally maintained libraries used by this software which have their
+own licenses; we recommend you read them, as their terms may differ from
+the terms above.

web/documentserver-example/java-spring/licenses/jQuery.license

@@ -1,4 +1,4 @@
-Copyright (c) 2009 John Resig, http://jquery.com/
+Copyright OpenJS Foundation and other contributors, https://openjsf.org/
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

web/documentserver-example/java-spring/onlyoffice.header

@@ -0,0 +1,17 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */

web/documentserver-example/java-spring/pom.xml

@@ -86,14 +86,13 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-checkstyle-plugin</artifactId>
-				<version>2.17</version>
+				<version>3.2.0</version>
 				<executions>
 					<execution>
 						<id>validate</id>
 						<phase>validate</phase>
 						<configuration>
-							<configLocation>google_checks.xml</configLocation>
-							<encoding>UTF-8</encoding>
+							<configLocation>checkstyle.xml</configLocation>
 							<failsOnError>true</failsOnError>
 							<failOnViolation>true</failOnViolation>
 							<logViolationsToConsole>true</logViolationsToConsole>

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/ExampleData.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -32,8 +32,9 @@ public class ExampleData {
     @Autowired
     private UserServices userService;
     @PostConstruct
-    public void init(){
-        List<String> description_user_0=List.of(  // the description for user 0
+    public void init() {
+        // the description for user 0
+        List<String> descriptionUserZero = List.of(
                 "The name is requested when the editor is opened",
                 "Doesn’t belong to any group",
                 "Can review all the changes",
@@ -44,9 +45,12 @@ public class ExampleData {
                 "Can’t see anyone’s information",
                 "Can't rename files from the editor",
                 "Can't view chat",
+                "Can't protect file",
                 "View file without collaboration"
         );
-        List<String> description_user_1 = List.of(  // the description for user 1
+
+        // the description for user 1
+        List<String> descriptionUserFirst = List.of(
                 "File author by default",
                 "He doesn’t belong to any of the groups",
                 "He can review all the changes",
@@ -56,19 +60,26 @@ public class ExampleData {
                 "Can see the information about all users",
                 "Can view chat"
         );
-        List<String> description_user_2 = List.of(  // the description for user 2
+
+        // the description for user 2
+        List<String> descriptionUserSecond = List.of(
                 "He belongs to Group2",
-                "He can review only his own changes or the changes made by the users who don’t belong to any of the groups",
-                "He can view every comment, edit his comments and the comments left by the users who don't belong to any of the groups and remove only his comments",
+                "He can review only his own changes or the changes made by the users who don’t belong"
+                        + " to any of the groups",
+                "He can view every comment, edit his comments and the comments left by the users "
+                        + "who don't belong to any of the groups and remove only his comments",
                 "This file is favorite",
                 "Can create a file from an editor",
                 "Can see the information about users from Group2 and users who don’t belong to any group",
                 "Can view chat"
         );
-        List<String> description_user_3 = List.of(  // the description for user 3
+
+        // the description for user 3
+        List<String> descriptionUserThird = List.of(
                 "He belongs to Group3",
                 "He can review only the changes made by the users from Group2",
-                "He can view the comments left by the users from Group2 and Group3 and edit the comments left by the users from Group2",
+                "He can view the comments left by the users from Group2 and Group3 and edit the comments left by "
+                        + "the users from Group2",
                 "This file isn’t favorite",
                 "He can’t copy data from the file into the clipboard",
                 "He can’t download the file",
@@ -77,24 +88,28 @@ public class ExampleData {
                 "Can see the information about Group2 users",
                 "Can view chat"
         );
-        userService.createUser("John Smith", "smith@example.com",  // create user 1 with the specified parameters
-                description_user_1, "", List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                null, true);
-        userService.createUser("Mark Pottato", "pottato@example.com",  // create user 2 with the specified parameters
-                description_user_2, "group-2", List.of("","group-2"), List.of(FilterState.NULL.toString()),
-                List.of("group-2", ""), List.of("group-2"), List.of("group-2", ""), true,
+
+        // create user 1 with the specified parameters
+        userService.createUser("John Smith", "smith@example.com", descriptionUserFirst,
+                "", List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                List.of(FilterState.NULL.toString()), null, true, true);
+
+        // create user 2 with the specified parameters
+        userService.createUser("Mark Pottato", "pottato@example.com", descriptionUserSecond,
+                "group-2", List.of("", "group-2"), List.of(FilterState.NULL.toString()),
+                List.of("group-2", ""), List.of("group-2"), List.of("group-2", ""), true, true,
                 true);
-        userService.createUser("Hamish Mitchell", "mitchell@example.com",  // create user 3 with the specified parameters
-                description_user_3, "group-3", List.of("group-2"), List.of("group-2", "group-3"),
-                List.of("group-2"), new ArrayList<>(), List.of("group-2"), false,
-                true);
-        userService.createUser("Anonymous",null,  // create user 0 with the specified parameters
-                description_user_0,"", List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()), new ArrayList<>(),null,
-                false);
+
+        // create user 3 with the specified parameters
+        userService.createUser("Hamish Mitchell", "mitchell@example.com", descriptionUserThird,
+                "group-3", List.of("group-2"), List.of("group-2", "group-3"), List.of("group-2"),
+                new ArrayList<>(), List.of("group-2"), false, true, true);
+
+        // create user 0 with the specified parameters
+        userService.createUser("Anonymous", null, descriptionUserZero, "",
+                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                new ArrayList<>(), null, false, false);
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/IntegrationApplication.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,9 +24,9 @@ import org.springframework.boot.autoconfigure.SpringBootApplication;
 @SpringBootApplication
 public class IntegrationApplication {
 
-	// run the SpringApplication from the IntagrationApplication with the specified parameters
-	public static void main(String[] args) {
-		SpringApplication.run(IntegrationApplication.class, args);
-	}
+    // run the SpringApplication from the IntagrationApplication with the specified parameters
+    public static void main(final String[] args) {
+        SpringApplication.run(IntegrationApplication.class, args);
+    }
 
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/IntegrationConfiguration.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -48,39 +48,40 @@ public class IntegrationConfiguration {
     private SSLUtils ssl;
 
     @Bean
-    public ModelMapper mapper(){  // create the model mapper
+    public ModelMapper mapper() {  // create the model mapper
         ModelMapper mapper = new ModelMapper();
         mapper.getConfiguration()  // get the mapper configuration and set new parameters to it
                 .setMatchingStrategy(MatchingStrategies.STRICT)  // specify the STRICT matching strategy
                 .setFieldMatchingEnabled(true)  // define if the field matching is enabled or not
                 .setSkipNullEnabled(true)  // define if null value will be skipped or not
-                .setFieldAccessLevel(org.modelmapper.config.Configuration.AccessLevel.PRIVATE);  // specify the PRIVATE field access level
+                .setFieldAccessLevel(org.modelmapper.config.Configuration.AccessLevel.PRIVATE);  /* specify
+                 the PRIVATE field access level */
         return mapper;
     }
 
     @Bean
-    public JSONParser jsonParser(){  // create JSON parser
+    public JSONParser jsonParser() {  // create JSON parser
         return new JSONParser();
     }
 
     @PostConstruct
-    public void init(){  // initialize the storage path builder
+    public void init() {  // initialize the storage path builder
         storagePathBuilder.configure(storageAddress.isBlank() ? null : storageAddress);
-        if(!verifyPerrOff.isEmpty()) {
-            try{
-                if(verifyPerrOff.equals("true")) {
+        if (!verifyPerrOff.isEmpty()) {
+            try {
+                if (verifyPerrOff.equals("true")) {
                     ssl.turnOffSslChecking(); //the certificate will be ignored
                 } else {
                     ssl.turnOnSslChecking(); //the certificate will be verified
                 }
-            } catch(Exception e) {
+            } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
 
     @Bean
-    public ObjectMapper objectMapper(){  // create the object mapper
+    public ObjectMapper objectMapper() {  // create the object mapper
         return new ObjectMapper();
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/controllers/EditorController.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -40,7 +40,16 @@ import org.springframework.web.bind.annotation.CookieValue;
 import org.springframework.web.bind.annotation.CrossOrigin;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
-import java.util.*;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Optional;
+
+import static com.onlyoffice.integration.documentserver.util.Constants.ANONYMOUS_USER_ID;
 
 @CrossOrigin("*")
 @Controller
@@ -75,19 +84,25 @@ public class EditorController {
 
     @GetMapping(path = "${url.editor}")
     // process request to open the editor page
-    public String index(@RequestParam("fileName") String fileName,
-                        @RequestParam(value = "action", required = false) String actionParam,
-                        @RequestParam(value = "type", required = false) String typeParam,
-                        @RequestParam(value = "actionLink", required = false) String actionLink,
-                        @CookieValue(value = "uid") String uid,
-                        @CookieValue(value = "ulang") String lang,
-                        Model model) throws JsonProcessingException {
+    public String index(@RequestParam("fileName") final String fileName,
+                        @RequestParam(value = "action", required = false) final String actionParam,
+                        @RequestParam(value = "type", required = false) final String typeParam,
+                        @RequestParam(value = "actionLink", required = false) final String actionLink,
+                        @RequestParam(value = "directUrl", required = false,
+                                defaultValue = "false") final Boolean directUrl,
+                        @CookieValue(value = "uid") final String uid,
+                        @CookieValue(value = "ulang") final String lang,
+                        final Model model) throws JsonProcessingException {
         Action action = Action.edit;
         Type type = Type.desktop;
         Locale locale = new Locale("en");
 
-        if(actionParam != null) action = Action.valueOf(actionParam);
-        if(typeParam != null) type = Type.valueOf(typeParam);
+        if (actionParam != null) {
+            action = Action.valueOf(actionParam);
+        }
+        if (typeParam != null) {
+            type = Type.valueOf(typeParam);
+        }
 
         List<String> langsAndKeys = Arrays.asList(langs.split("\\|"));
         for (String langAndKey : langsAndKeys) {
@@ -101,7 +116,9 @@ public class EditorController {
         Optional<User> optionalUser = userService.findUserById(Integer.parseInt(uid));
 
         // if the user is not present, return the ONLYOFFICE start page
-        if(!optionalUser.isPresent()) return "index.html";
+        if (!optionalUser.isPresent()) {
+            return "index.html";
+        }
 
         User user = optionalUser.get();
 
@@ -115,27 +132,43 @@ public class EditorController {
                         .action(action)
                         .user(user)
                         .actionData(actionLink)
+                        .isEnableDirectUrl(directUrl)
                         .build()
         );
 
         // add attributes to the specified model
-        model.addAttribute("model", fileModel);  // add file model with the default parameters to the original model
-        model.addAttribute("fileHistory", historyManager.getHistory(fileModel.getDocument()));  // get file history and add it to the model
-        model.addAttribute("docserviceApiUrl",docserviceSite + docserviceApiUrl);  // create the document service api URL and add it to the model
-        model.addAttribute("dataInsertImage",  getInsertImage());  // get an image and add it to the model
-        model.addAttribute("dataCompareFile",  getCompareFile());  // get a document for comparison and add it to the model
-        model.addAttribute("dataMailMergeRecipients", getMailMerge());  // get recipients data for mail merging and add it to the model
-        model.addAttribute("usersForMentions", getUserMentions(uid));  // get user data for mentions and add it to the model
+        // add file model with the default parameters to the original model
+        model.addAttribute("model", fileModel);
+
+        // get file history and add it to the model
+        model.addAttribute("fileHistory", historyManager.getHistory(fileModel.getDocument()));
+
+        // create the document service api URL and add it to the model
+        model.addAttribute("docserviceApiUrl", docserviceSite + docserviceApiUrl);
+
+        // get an image and add it to the model
+        model.addAttribute("dataInsertImage",  getInsertImage(directUrl));
+
+        // get a document for comparison and add it to the model
+        model.addAttribute("dataCompareFile",  getCompareFile(directUrl));
+
+        // get recipients data for mail merging and add it to the model
+        model.addAttribute("dataMailMergeRecipients", getMailMerge(directUrl));
+
+        // get user data for mentions and add it to the model
+        model.addAttribute("usersForMentions", getUserMentions(uid));
         return "editor.html";
     }
 
-    private List<Mentions> getUserMentions(String uid){  // get user data for mentions
-        List<Mentions> usersForMentions=new ArrayList<>();
-        if(uid!=null && !uid.equals("4")) {
+    private List<Mentions> getUserMentions(final String uid) {  // get user data for mentions
+        List<Mentions> usersForMentions = new ArrayList<>();
+        if (uid != null && !uid.equals("4")) {
             List<User> list = userService.findAll();
             for (User u : list) {
-                if (u.getId()!=Integer.parseInt(uid) && u.getId()!=4) {
-                    usersForMentions.add(new Mentions(u.getName(),u.getEmail()));  // user data includes user names and emails
+                if (u.getId() != Integer.parseInt(uid) && u.getId() != ANONYMOUS_USER_ID) {
+
+                    // user data includes user names and emails
+                    usersForMentions.add(new Mentions(u.getName(), u.getEmail()));
                 }
             }
         }
@@ -144,45 +177,61 @@ public class EditorController {
     }
 
     @SneakyThrows
-    private String getInsertImage() {  // get an image that will be inserted into the document
+    private String getInsertImage(final Boolean directUrl) {  // get an image that will be inserted into the document
         Map<String, Object> dataInsertImage = new HashMap<>();
         dataInsertImage.put("fileType", "png");
         dataInsertImage.put("url", storagePathBuilder.getServerUrl(true) + "/css/img/logo.png");
-        dataInsertImage.put("directUrl", storagePathBuilder.getServerUrl(false) + "/css/img/logo.png");
-
-        // check if the document token is enabled
-        if(jwtManager.tokenEnabled()){
-            dataInsertImage.put("token", jwtManager.createToken(dataInsertImage));  // create token from the dataInsertImage object
+        if (directUrl) {
+            dataInsertImage.put("directUrl", storagePathBuilder
+                    .getServerUrl(false) + "/css/img/logo.png");
         }
 
-        return objectMapper.writeValueAsString(dataInsertImage).substring(1, objectMapper.writeValueAsString(dataInsertImage).length()-1);
+        // check if the document token is enabled
+        if (jwtManager.tokenEnabled()) {
+
+            // create token from the dataInsertImage object
+            dataInsertImage.put("token", jwtManager.createToken(dataInsertImage));
+        }
+
+        return objectMapper.writeValueAsString(dataInsertImage)
+                .substring(1, objectMapper.writeValueAsString(dataInsertImage).length() - 1);
     }
 
+    // get a document that will be compared with the current document
     @SneakyThrows
-    private String getCompareFile(){  // get a document that will be compared with the current document
+    private String getCompareFile(final Boolean directUrl) {
         Map<String, Object> dataCompareFile = new HashMap<>();
         dataCompareFile.put("fileType", "docx");
         dataCompareFile.put("url", storagePathBuilder.getServerUrl(true) + "/assets?name=sample.docx");
-        dataCompareFile.put("directUrl", storagePathBuilder.getServerUrl(false) + "/assets?name=sample.docx");
+        if (directUrl) {
+            dataCompareFile.put("directUrl", storagePathBuilder
+                    .getServerUrl(false) + "/assets?name=sample.docx");
+        }
 
         // check if the document token is enabled
-        if(jwtManager.tokenEnabled()){
-            dataCompareFile.put("token", jwtManager.createToken(dataCompareFile));  // create token from the dataCompareFile object
+        if (jwtManager.tokenEnabled()) {
+
+            // create token from the dataCompareFile object
+            dataCompareFile.put("token", jwtManager.createToken(dataCompareFile));
         }
 
         return objectMapper.writeValueAsString(dataCompareFile);
     }
 
     @SneakyThrows
-    private String getMailMerge(){
+    private String getMailMerge(final Boolean directUrl) {
         Map<String, Object> dataMailMergeRecipients = new HashMap<>();  // get recipients data for mail merging
         dataMailMergeRecipients.put("fileType", "csv");
         dataMailMergeRecipients.put("url", storagePathBuilder.getServerUrl(true) + "/csv");
-        dataMailMergeRecipients.put("directUrl", storagePathBuilder.getServerUrl(false) + "/csv");
+        if (directUrl) {
+            dataMailMergeRecipients.put("directUrl", storagePathBuilder.getServerUrl(false) + "/csv");
+        }
 
         // check if the document token is enabled
-        if(jwtManager.tokenEnabled()){
-            dataMailMergeRecipients.put("token", jwtManager.createToken(dataMailMergeRecipients));  // create token from the dataMailMergeRecipients object
+        if (jwtManager.tokenEnabled()) {
+
+            // create token from the dataMailMergeRecipients object
+            dataMailMergeRecipients.put("token", jwtManager.createToken(dataMailMergeRecipients));
         }
 
         return objectMapper.writeValueAsString(dataMailMergeRecipients);

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/controllers/FileController.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,11 +19,14 @@
 package com.onlyoffice.integration.controllers;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
 import com.onlyoffice.integration.documentserver.callbacks.CallbackHandler;
 import com.onlyoffice.integration.documentserver.managers.jwt.JwtManager;
 import com.onlyoffice.integration.documentserver.storage.FileStorageMutator;
 import com.onlyoffice.integration.documentserver.storage.FileStoragePathBuilder;
 import com.onlyoffice.integration.dto.Converter;
+import com.onlyoffice.integration.dto.ConvertedData;
 import com.onlyoffice.integration.dto.Track;
 import com.onlyoffice.integration.entities.User;
 import com.onlyoffice.integration.documentserver.models.enums.DocumentType;
@@ -41,16 +44,28 @@ import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
 import org.springframework.stereotype.Controller;
 import org.springframework.ui.Model;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.CookieValue;
+import org.springframework.web.bind.annotation.CrossOrigin;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseBody;
 import org.springframework.web.multipart.MultipartFile;
 
 import javax.servlet.http.HttpServletRequest;
-import java.io.*;
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.InetAddress;
 import java.net.URL;
 import java.net.URLEncoder;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Path;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
 
 @CrossOrigin("*")
 @Controller
@@ -90,10 +105,10 @@ public class FileController {
     private CallbackManager callbackManager;
 
     // create user metadata
-    private String createUserMetadata(String uid, String fullFileName) {
+    private String createUserMetadata(final String uid, final String fullFileName) {
         Optional<User> optionalUser = userService.findUserById(Integer.parseInt(uid));  // find a user by their ID
         String documentType = fileUtility.getDocumentType(fullFileName).toString().toLowerCase();  // get document type
-        if(optionalUser.isPresent()){
+        if (optionalUser.isPresent()) {
             User user = optionalUser.get();
             storageMutator.createMeta(fullFileName,  // create meta information with the user ID and name specified
                     String.valueOf(user.getId()), user.getName());
@@ -102,33 +117,39 @@ public class FileController {
     }
 
     // download data from the specified file
-    private ResponseEntity<Resource> downloadFile(String fileName){
+    private ResponseEntity<Resource> downloadFile(final String fileName) {
         Resource resource = storageMutator.loadFileAsResource(fileName);  // load the specified file as a resource
         String contentType = "application/octet-stream";
 
         // create a response with the content type, header and body with the file data
         return ResponseEntity.ok()
                 .contentType(MediaType.parseMediaType(contentType))
-                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")
+                .header(HttpHeaders.CONTENT_DISPOSITION,
+                        "attachment; filename=\"" + resource.getFilename() + "\"")
                 .body(resource);
     }
 
     // download data from the specified history file
-    private ResponseEntity<Resource> downloadFileHistory(String fileName, String version, String file){
-        Resource resource = storageMutator.loadFileAsResourceHistory(fileName,version,file);  // load the specified file as a resource
+    private ResponseEntity<Resource> downloadFileHistory(final String fileName,
+                                                         final String version,
+                                                         final String file) {
+
+        // load the specified file as a resource
+        Resource resource = storageMutator.loadFileAsResourceHistory(fileName, version, file);
         String contentType = "application/octet-stream";
 
         // create a response with the content type, header and body with the file data
         return ResponseEntity.ok()
                 .contentType(MediaType.parseMediaType(contentType))
-                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")
+                .header(HttpHeaders.CONTENT_DISPOSITION,
+                        "attachment; filename=\"" + resource.getFilename() + "\"")
                 .body(resource);
     }
 
     @PostMapping("/upload")
     @ResponseBody
-    public String upload(@RequestParam("file") MultipartFile file,  // upload a file
-                             @CookieValue("uid") String uid){
+    public String upload(@RequestParam("file") final MultipartFile file,  // upload a file
+                             @CookieValue("uid") final String uid) {
         try {
             String fullFileName = file.getOriginalFilename();  // get file name
             String fileExtension = fileUtility.getFileExtension(fullFileName);  // get file extension
@@ -136,17 +157,19 @@ public class FileController {
             byte[] bytes = file.getBytes();  // get file in bytes
 
             // check if the file size exceeds the maximum file size or is less than 0
-            if(fileUtility.getMaxFileSize() < fileSize || fileSize <= 0){
+            if (fileUtility.getMaxFileSize() < fileSize || fileSize <= 0) {
                 return "{ \"error\": \"File size is incorrect\"}";  // if so, write an error message to the response
             }
 
             // check if file extension is supported by the editor
-            if(!fileUtility.getFileExts().contains(fileExtension)){
-                return "{ \"error\": \"File type is not supported\"}";  // if not, write an error message to the response
+            if (!fileUtility.getFileExts().contains(fileExtension)) {
+
+                // if not, write an error message to the response
+                return "{ \"error\": \"File type is not supported\"}";
             }
 
             String fileNamePath = storageMutator.updateFile(fullFileName, bytes);  // update a file
-            if (fileNamePath.isBlank()){
+            if (fileNamePath.isBlank()) {
                 throw new IOException("Could not update a file");  // if the file cannot be updated, an error occurs
             }
 
@@ -156,39 +179,57 @@ public class FileController {
         } catch (Exception e) {
             e.printStackTrace();
         }
-        return "{ \"error\": \"Something went wrong when uploading the file.\"}";  // if the operation of file uploading is unsuccessful, an error occurs
+
+        // if the operation of file uploading is unsuccessful, an error occurs
+        return "{ \"error\": \"Something went wrong when uploading the file.\"}";
     }
 
     @PostMapping(path = "${url.converter}")
     @ResponseBody
-    public String convert(@RequestBody Converter body,  // convert a file
-                          @CookieValue("uid") String uid, @CookieValue("ulang") String lang){
-        String fileName = body.getFileName();  // get file name
-        String fileUri = documentManager.getDownloadUrl(fileName, true);  // get URL for downloading a file with the specified name
-        String filePass = body.getFilePass() != null ? body.getFilePass() : null;  // get file password if it exists
-        String fileExt = fileUtility.getFileExtension(fileName);  // get file extension
-        DocumentType type = fileUtility.getDocumentType(fileName);  // get document type (word, cell or slide)
-        String internalFileExt = fileUtility.getInternalExtension(type);  // get an editor internal extension (".docx", ".xlsx" or ".pptx")
+    public String convert(@RequestBody final Converter body,  // convert a file
+                          @CookieValue("uid") final String uid, @CookieValue("ulang") final String lang) {
+        // get file name
+        String fileName = body.getFileName();
 
-        try{
-            if(fileUtility.getConvertExts().contains(fileExt)){  // check if the file with such an extension can be converted
+        // get URL for downloading a file with the specified name
+        String fileUri = documentManager.getDownloadUrl(fileName, true);
+
+        // get file password if it exists
+        String filePass = body.getFilePass() != null ? body.getFilePass() : null;
+
+        // get file extension
+        String fileExt = fileUtility.getFileExtension(fileName);
+
+        // get document type (word, cell or slide)
+        DocumentType type = fileUtility.getDocumentType(fileName);
+
+        // convert to .ooxml
+        String internalFileExt = "ooxml";
+
+        try {
+            // check if the file with such an extension can be converted
+            if (fileUtility.getConvertExts().contains(fileExt)) {
                 String key = serviceConverter.generateRevisionId(fileUri);  // generate document key
-                String newFileUri = serviceConverter  // get the URL to the converted file
-                        .getConvertedUri(fileUri, fileExt, internalFileExt, key, filePass, true, lang);
+                ConvertedData response = serviceConverter  // get the URL to the converted file
+                        .getConvertedData(fileUri, fileExt, internalFileExt, key, filePass, true, lang);
 
-                if(newFileUri.isEmpty()){
+                String newFileUri = response.getUri();
+                String newFileType = "." + response.getFileType();
+
+                if (newFileUri.isEmpty()) {
                     return "{ \"step\" : \"0\", \"filename\" : \"" + fileName + "\"}";
                 }
 
-                // get a file name of an internal file extension with an index if the file with such a name already exists
-                String nameWithInternalExt = fileUtility.getFileNameWithoutExtension(fileName) + internalFileExt;
+                /* get a file name of an internal file extension with an index if the file
+                 with such a name already exists */
+                String nameWithInternalExt = fileUtility.getFileNameWithoutExtension(fileName) + newFileType;
                 String correctedName = documentManager.getCorrectName(nameWithInternalExt);
 
                 URL url = new URL(newFileUri);
                 java.net.HttpURLConnection connection = (java.net.HttpURLConnection) url.openConnection();
                 InputStream stream = connection.getInputStream();  // get input stream of the converted file
 
-                if (stream == null){
+                if (stream == null) {
                     connection.disconnect();
                     throw new RuntimeException("Input stream is null");
                 }
@@ -200,87 +241,105 @@ public class FileController {
 
             // create meta information about the converted file with the user ID and name specified
             return createUserMetadata(uid, fileName);
-        }catch (Exception e) {
+        } catch (Exception e) {
             e.printStackTrace();
         }
-        return "{ \"error\": \"" + "The file can't be converted.\"}";  // if the operation of file converting is unsuccessful, an error occurs
+        // if the operation of file converting is unsuccessful, an error occurs
+        return "{ \"error\": \"" + "The file can't be converted.\"}";
     }
 
     @PostMapping("/delete")
     @ResponseBody
-    public String delete(@RequestBody Converter body){  // delete a file
-        try
-        {
+    public String delete(@RequestBody final Converter body) {  // delete a file
+        try {
             String fullFileName = fileUtility.getFileName(body.getFileName());  // get full file name
-            boolean fileSuccess = storageMutator.deleteFile(fullFileName);  // delete a file from the storage and return the status of this operation (true or false)
-            boolean historySuccess = storageMutator.deleteFileHistory(fullFileName);  // delete file history and return the status of this operation (true or false)
 
-            return "{ \"success\": \""+ (fileSuccess && historySuccess) +"\"}";
-        }
-        catch (Exception e)
-        {
-            return "{ \"error\": \"" + e.getMessage() + "\"}";  // if the operation of file deleting is unsuccessful, an error occurs
+            // delete a file from the storage and return the status of this operation (true or false)
+            boolean fileSuccess = storageMutator.deleteFile(fullFileName);
+
+            // delete file history and return the status of this operation (true or false)
+            boolean historySuccess = storageMutator.deleteFileHistory(fullFileName);
+
+            return "{ \"success\": \"" + (fileSuccess && historySuccess) + "\"}";
+        } catch (Exception e) {
+            // if the operation of file deleting is unsuccessful, an error occurs
+            return "{ \"error\": \"" + e.getMessage() + "\"}";
         }
     }
 
     @GetMapping("/downloadhistory")
-    public ResponseEntity<Resource> downloadHistory(HttpServletRequest request,// download a file
-                                             @RequestParam("fileName") String fileName,
-                                             @RequestParam("ver") String version,
-                                             @RequestParam("file") String file){ // history file
-        try{
+    public ResponseEntity<Resource> downloadHistory(final HttpServletRequest request, // download a file
+                                             @RequestParam("fileName") final String fileName,
+                                             @RequestParam("ver") final String version,
+                                             @RequestParam("file") final String file) { // history file
+        try {
             // check if a token is enabled or not
-            if(jwtManager.tokenEnabled()){
+            if (jwtManager.tokenEnabled() && jwtManager.tokenUseForRequest()) {
                 String header = request.getHeader(documentJwtHeader == null  // get the document JWT header
                         || documentJwtHeader.isEmpty() ? "Authorization" : documentJwtHeader);
-                if(header != null && !header.isEmpty()){
-                    String token = header.replace("Bearer ", "");  // token is the header without the Bearer prefix
+                if (header != null && !header.isEmpty()) {
+                    String token = header
+                            .replace("Bearer ", "");  // token is the header without the Bearer prefix
                     jwtManager.readToken(token);  // read the token
-                }else {
+                } else {
                     return null;
                 }
             }
-            return downloadFileHistory(fileName,version,file);  // download data from the specified file
-        } catch(Exception e){
+            return downloadFileHistory(fileName, version, file);  // download data from the specified file
+        } catch (Exception e) {
             return null;
         }
     }
 
     @GetMapping(path = "${url.download}")
-    public ResponseEntity<Resource> download(HttpServletRequest request,  // download a file
-                                             @RequestParam("fileName") String fileName){
-        try{
+    public ResponseEntity<Resource> download(final HttpServletRequest request,  // download a file
+                                             @RequestParam("fileName") final String fileName,
+                                             @RequestParam(value = "userAddress", required = false)
+                                                 final String userAddress) {
+        try {
             // check if a token is enabled or not
-            if(jwtManager.tokenEnabled()){
-                String header = request.getHeader(documentJwtHeader == null  // get the document JWT header
+            if (jwtManager.tokenEnabled() && userAddress != null && jwtManager.tokenUseForRequest()) {
+                String header = request.getHeader(documentJwtHeader == null // get the document JWT header
                         || documentJwtHeader.isEmpty() ? "Authorization" : documentJwtHeader);
-                if(header != null && !header.isEmpty()){
-                    String token = header.replace("Bearer ", "");  // token is the header without the Bearer prefix
+                if (header != null && !header.isEmpty()) {
+                    String token = header
+                            .replace("Bearer ", "");  // token is the header without the Bearer prefix
                     jwtManager.readToken(token);  // read the token
+                } else {
+                    return null;
                 }
             }
             return downloadFile(fileName);  // download data from the specified file
-        } catch(Exception e){
+        } catch (Exception e) {
             return null;
         }
     }
 
     @GetMapping("/create")
-    public String create(@RequestParam("fileExt") String fileExt,  // create a sample file of the specified extension
-                         @RequestParam(value = "sample", required = false) Optional<Boolean> isSample,
-                         @CookieValue(value = "uid", required = false) String uid,
-                         Model model){
-        Boolean sampleData = (isSample.isPresent() && !isSample.isEmpty()) && isSample.get();  // specify if the sample data exists or not
-        if(fileExt != null){
-            try{
+    public String create(@RequestParam("fileExt")
+                             final String fileExt, // create a sample file of the specified extension
+                         @RequestParam(value = "sample", required = false) final Optional<Boolean> isSample,
+                         @CookieValue(value = "uid", required = false) final String uid,
+                         final Model model) {
+        // specify if the sample data exists or not
+        Boolean sampleData = (isSample.isPresent() && !isSample.isEmpty()) && isSample.get();
+        if (fileExt != null) {
+            try {
                 Optional<User> user = userService.findUserById(Integer.parseInt(uid));  // find a user by their ID
-                if (!user.isPresent()) throw new RuntimeException("Could not fine any user with id = "+uid);  // if the user with the specified ID doesn't exist, an error occurs
-                String fileName = documentManager.createDemo(fileExt, sampleData, uid, user.get().getName());  // create a demo document with the sample data
+                if (!user.isPresent()) {
+                    // if the user with the specified ID doesn't exist, an error occurs
+                    throw new RuntimeException("Could not fine any user with id = " + uid);
+                }
+                String fileName = documentManager.createDemo(fileExt,
+                        sampleData,
+                        uid,
+                        user.get().getName());  // create a demo document with the sample data
                 if (fileName.isBlank() || fileName == null) {
                     throw new RuntimeException("You must have forgotten to add asset files");
                 }
-                return "redirect:editor?fileName=" + URLEncoder.encode(fileName, StandardCharsets.UTF_8);  // redirect the request
-            }catch (Exception ex){
+                return "redirect:editor?fileName=" + URLEncoder
+                        .encode(fileName, StandardCharsets.UTF_8);  // redirect the request
+            } catch (Exception ex) {
                 model.addAttribute("error", ex.getMessage());
                 return "error.html";
             }
@@ -289,33 +348,35 @@ public class FileController {
     }
 
     @GetMapping("/assets")
-    public ResponseEntity<Resource> assets(@RequestParam("name") String name)  // get sample files from the assests
-    {
+    public ResponseEntity<Resource> assets(@RequestParam("name")
+                                               final String name) {  // get sample files from the assests
         String fileName = Path.of("assets", "sample", fileUtility.getFileName(name)).toString();
         return downloadFile(fileName);
     }
 
     @GetMapping("/csv")
-    public ResponseEntity<Resource> csv()  // download a csv file
-    {
+    public ResponseEntity<Resource> csv() {  // download a csv file
         String fileName = Path.of("assets", "sample", "csv.csv").toString();
         return downloadFile(fileName);
     }
 
     @GetMapping("/files")
     @ResponseBody
-    public ArrayList<Map<String, Object>> files(@RequestParam(value = "fileId", required = false) String fileId){  // get files information
+    public ArrayList<Map<String, Object>> files(@RequestParam(value = "fileId", required = false)
+                                                    final String fileId) {  // get files information
         return fileId == null ? documentManager.getFilesInfo() : documentManager.getFilesInfo(fileId);
     }
 
     @PostMapping(path = "${url.track}")
     @ResponseBody
-    public String track(HttpServletRequest request,  // track file changes
-                        @RequestParam("fileName") String fileName,
-                        @RequestParam("userAddress") String userAddress,
-                        @RequestBody Track body){
+    public String track(final HttpServletRequest request,  // track file changes
+                        @RequestParam("fileName") final String fileName,
+                        @RequestParam("userAddress") final String userAddress,
+                        @RequestBody final Track body) {
+        Track track;
         try {
-            String bodyString = objectMapper.writeValueAsString(body);  // write the request body to the object mapper as a string
+            String bodyString = objectMapper
+                    .writeValueAsString(body);  // write the request body to the object mapper as a string
             String header = request.getHeader(documentJwtHeader == null  // get the request header
                     || documentJwtHeader.isEmpty() ? "Authorization" : documentJwtHeader);
 
@@ -324,20 +385,20 @@ public class FileController {
             }
 
             JSONObject bodyCheck = jwtManager.parseBody(bodyString, header);  // parse the request body
-            body = objectMapper.readValue(bodyCheck.toJSONString(), Track.class);  // read the request body
+            track = objectMapper.readValue(bodyCheck.toJSONString(), Track.class);  // read the request body
         } catch (Exception e) {
             e.printStackTrace();
             return e.getMessage();
         }
 
-        int error = callbackHandler.handle(body, fileName);
+        int error = callbackHandler.handle(track, fileName);
 
-        return"{\"error\":" + error + "}";
+        return "{\"error\":" + error + "}";
     }
 
     @PostMapping("/saveas")
     @ResponseBody
-    public String saveAs(@RequestBody JSONObject body, @CookieValue("uid") String uid) {
+    public String saveAs(@RequestBody final JSONObject body, @CookieValue("uid") final String uid) {
         String title = (String) body.get("title");
         String saveAsFileUrl = (String) body.get("url");
 
@@ -368,17 +429,17 @@ public class FileController {
 
     @PostMapping("/rename")
     @ResponseBody
-    public String rename(@RequestBody JSONObject body) {
+    public String rename(@RequestBody final JSONObject body) {
         String newfilename = (String) body.get("newfilename");
         String dockey = (String) body.get("dockey");
         String origExt = "." + (String) body.get("ext");
         String curExt = newfilename;
 
-        if(newfilename.indexOf(".") != -1) {
+        if (newfilename.indexOf(".") != -1) {
             curExt = (String) fileUtility.getFileExtension(newfilename);
         }
 
-        if(origExt.compareTo(curExt) != 0) {
+        if (origExt.compareTo(curExt) != 0) {
             newfilename += origExt;
         }
 
@@ -393,4 +454,71 @@ public class FileController {
             return e.getMessage();
         }
     }
+
+    @PostMapping("/reference")
+    @ResponseBody
+    public String reference(@RequestBody final JSONObject body) {
+        try {
+
+            Gson gson = new GsonBuilder().disableHtmlEscaping().create();
+
+            String userAddress = "";
+            String fileName = "";
+
+            if (body.containsKey("referenceData")) {
+                JSONObject referenceDataObj = (JSONObject) body.get("referenceData");
+                String instanceId = (String) referenceDataObj.get("instanceId");
+
+                if (instanceId.equals(storagePathBuilder.getServerUrl(false))) {
+                    JSONObject fileKey = (JSONObject) referenceDataObj.get("fileKey");
+                    userAddress = (String) fileKey.get("userAddress");
+                    if (userAddress.equals(InetAddress.getLocalHost().getHostAddress())) {
+                        fileName = (String) fileKey.get("fileName");
+                    }
+                }
+            }
+
+
+            if (fileName.equals("")) {
+                try {
+                    String path = (String) body.get("path");
+                    path = fileUtility.getFileName(path);
+                    File f = new File(storagePathBuilder.getFileLocation(path));
+                    if (f.exists()) {
+                        fileName = path;
+                    }
+                } catch (Exception e) {
+                    return "{ \"error\" : 1, \"message\" : \"" + e.getMessage() + "\"}";
+                }
+            }
+
+            if (fileName.equals("")) {
+                return "{ \"error\": \"File not found\"}";
+            }
+
+            HashMap<String, Object> fileKey = new HashMap<>();
+            fileKey.put("fileName", fileName);
+            fileKey.put("userAddress", InetAddress.getLocalHost().getHostAddress());
+
+            HashMap<String, Object> referenceData = new HashMap<>();
+            referenceData.put("instanceId", storagePathBuilder.getServerUrl(true));
+            referenceData.put("fileKey", fileKey);
+
+            HashMap<String, Object> data = new HashMap<>();
+            data.put("fileType", fileUtility.getFileExtension(fileName));
+            data.put("url", documentManager.getDownloadUrl(fileName, true));
+            data.put("directUrl", documentManager.getDownloadUrl(fileName, true));
+            data.put("referenceData", referenceData);
+            data.put("path", fileName);
+
+            if (jwtManager.tokenEnabled()) {
+                String token = jwtManager.createToken(data);
+                data.put("token", token);
+            }
+            return gson.toJson(data);
+        } catch (Exception e) {
+            e.printStackTrace();
+            return "{ \"error\" : 1, \"message\" : \"" + e.getMessage() + "\"}";
+        }
+    }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/controllers/IndexController.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,16 +21,25 @@ package com.onlyoffice.integration.controllers;
 import com.onlyoffice.integration.documentserver.storage.FileStorageMutator;
 import com.onlyoffice.integration.documentserver.storage.FileStoragePathBuilder;
 import com.onlyoffice.integration.documentserver.util.Misc;
-import com.onlyoffice.integration.entities.*;
-import com.onlyoffice.integration.services.UserServices;
 import com.onlyoffice.integration.documentserver.util.file.FileUtility;
+import com.onlyoffice.integration.entities.User;
+import com.onlyoffice.integration.services.UserServices;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Controller;
 import org.springframework.ui.Model;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.CrossOrigin;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseBody;
 
-import java.util.*;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
 import java.util.stream.Collectors;
 
 @CrossOrigin("*")
@@ -68,7 +77,8 @@ public class IndexController {
     private String langs;
 
     @GetMapping("${url.index}")
-    public String index(Model model){
+    public String index(@RequestParam(value = "directUrl", required = false) final Boolean directUrl,
+                        final Model model) {
         java.io.File[] files = storageMutator.getStoredFiles();  // get all the stored files from the storage
         List<String> docTypes = new ArrayList<>();
         List<Boolean> filesEditable = new ArrayList<>();
@@ -86,39 +96,49 @@ public class IndexController {
         List<User> users = userService.findAll();  // get a list of all the users
 
         String tooltip = users.stream()  // get the tooltip with the user descriptions
-                .map(user -> mistUtility.convertUserDescriptions(user.getName(), user.getDescriptions()))  // convert user descriptions to the specified format
+                .map(user -> mistUtility.convertUserDescriptions(user.getName(),
+                        user.getDescriptions()))  // convert user descriptions to the specified format
                 .collect(Collectors.joining());
 
-        for(java.io.File file:files){  // run through all the files
+        for (java.io.File file:files) {  // run through all the files
             String fileName = file.getName();  // get file name
-            docTypes.add(fileUtility.getDocumentType(fileName).toString().toLowerCase());  // add a document type of each file to the list
-            filesEditable.add(fileUtility.getEditedExts().contains(fileUtility.getFileExtension(fileName)));  // specify if a file is editable or not
-            versions.add(" ["+storagePathBuilder.getFileVersion(fileName, true)+"]");  // add a file version to the list
+            docTypes.add(fileUtility
+                    .getDocumentType(fileName)
+                    .toString()
+                    .toLowerCase());  // add a document type of each file to the list
+            filesEditable.add(fileUtility.getEditedExts()
+                    .contains(fileUtility.getFileExtension(fileName)));  // specify if a file is editable or not
+            versions.add(" [" + storagePathBuilder.
+                    getFileVersion(fileName, true) + "]");  // add a file version to the list
             isFillFormDoc.add(fileUtility.getFillExts().contains(fileUtility.getFileExtension(fileName)));
         }
 
         // add all the parameters to the model
         model.addAttribute("isFillFormDoc", isFillFormDoc);
-        model.addAttribute("versions",versions);
+        model.addAttribute("versions", versions);
         model.addAttribute("files", files);
         model.addAttribute("docTypes", docTypes);
         model.addAttribute("filesEditable", filesEditable);
-        model.addAttribute("datadocs", docserviceSite+docservicePreloader);
+        model.addAttribute("datadocs", docserviceSite + docservicePreloader);
         model.addAttribute("tooltip", tooltip);
         model.addAttribute("users", users);
         model.addAttribute("languages", languages);
+        model.addAttribute("directUrl", directUrl);
 
         return "index.html";
     }
 
     @PostMapping("/config")
     @ResponseBody
-    public HashMap<String, String> configParameters(){  // get configuration parameters
+    public HashMap<String, String> configParameters() {  // get configuration parameters
         HashMap<String, String> configuration = new HashMap<>();
 
-        configuration.put("FillExtList", String.join(",", fileUtility.getFillExts()));  // put a list of the extensions that can be filled to config
-        configuration.put("ConverExtList", String.join(",", fileUtility.getConvertExts()));  // put a list of the extensions that can be converted to config
-        configuration.put("EditedExtList", String.join(",", fileUtility.getEditedExts()));  // put a list of the extensions that can be edited to config
+        configuration.put("FillExtList", String.join(",", fileUtility
+                .getFillExts()));  // put a list of the extensions that can be filled to config
+        configuration.put("ConverExtList", String.join(",", fileUtility
+                .getConvertExts()));  // put a list of the extensions that can be converted to config
+        configuration.put("EditedExtList", String.join(",", fileUtility
+                .getEditedExts()));  // put a list of the extensions that can be edited to config
         configuration.put("UrlConverter", urlConverter);
         configuration.put("UrlEditor", urlEditor);
 

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/Callback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,7 +26,7 @@ public interface Callback {
     int handle(Track body, String fileName);  // handle the callback
     int getStatus();  // get document status
     @Autowired
-    default void selfRegistration(CallbackHandler callbackHandler){  // register a callback handler
+    default void selfRegistration(CallbackHandler callbackHandler) {  // register a callback handler
         callbackHandler.register(getStatus(), this);
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/CallbackHandler.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -33,14 +33,14 @@ public class CallbackHandler {
 
     private Map<Integer, Callback> callbackHandlers = new HashMap<>();
 
-    public void register(int code, Callback callback){  // register a callback handler
+    public void register(final int code, final Callback callback) {  // register a callback handler
         callbackHandlers.put(code, callback);
     }
 
-    public int handle(Track body, String fileName){  // handle a callback
+    public int handle(final Track body, final String fileName) {  // handle a callback
         Callback callback = callbackHandlers.get(body.getStatus());
-        if (callback == null){
-            logger.warn("Callback status "+body.getStatus()+" is not supported yet");
+        if (callback == null) {
+            logger.warn("Callback status " + body.getStatus() + " is not supported yet");
            return 0;
         }
 

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/Status.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,10 +26,10 @@ public enum Status {
     MUST_FORCE_SAVE(6),  // 6 - document is being edited, but the current document state is saved
     CORRUPTED_FORCE_SAVE(7);  // 7 - error has occurred while force saving the document
     private int code;
-    Status(int code){
-        this.code = code;
+    Status(final int codeParam) {
+        this.code = codeParam;
     }
-    public int getCode(){  // get document status
+    public int getCode() {  // get document status
         return this.code;
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/implementations/EditCallback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,15 +31,18 @@ public class EditCallback implements Callback {
     @Autowired
     private CallbackManager callbackManager;
     @Override
-    public int handle(Track body, String fileName) {  // handle the callback when the document is being edited
+    public int handle(final Track body,
+                      final String fileName) {  // handle the callback when the document is being edited
         int result = 0;
         Action action =  body.getActions().get(0);  // get the user ID who is editing the document
-        if (action.getType().equals(com.onlyoffice.integration.documentserver.models.enums.Action.edit)) {  // if this value is not equal to the user ID
+        if (action.getType().equals(com.onlyoffice.integration.documentserver.models.enums
+                .Action.edit)) {  // if this value is not equal to the user ID
             String user =  action.getUserid();  // get user ID
             if (!body.getUsers().contains(user)) {  // if this user is not specified in the body
                 String key = body.getKey();  // get document key
                 try {
-                    callbackManager.commandRequest("forcesave", key, null);  // create a command request to forcibly save the document being edited without closing it
+                    // create a command request to forcibly save the document being edited without closing it
+                    callbackManager.commandRequest("forcesave", key, null);
                 } catch (Exception e) {
                     e.printStackTrace();
                     result = 1;

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/implementations/ForcesaveCallback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,7 +30,8 @@ public class ForcesaveCallback implements Callback {
     @Autowired
     private CallbackManager callbackManager;
     @Override
-    public int handle(Track body, String fileName) {  // handle the callback when the force saving request is performed
+    public int handle(final Track body,
+                      final String fileName) {  // handle the callback when the force saving request is performed
         int result = 0;
         try {
             callbackManager.processForceSave(body, fileName);  // file force saving process
@@ -43,6 +44,7 @@ public class ForcesaveCallback implements Callback {
 
     @Override
     public int getStatus() {  // get document status
-        return Status.MUST_FORCE_SAVE.getCode();  // return status 6 - document is being edited, but the current document state is saved
+        // return status 6 - document is being edited, but the current document state is saved
+        return Status.MUST_FORCE_SAVE.getCode();
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/implementations/SaveCallback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,7 +30,8 @@ public class SaveCallback implements Callback {
     @Autowired
     private CallbackManager callbackManager;
     @Override
-    public int handle(Track body, String fileName) {  // handle the callback when the saving request is performed
+    public int handle(final Track body,
+                      final String fileName) {  // handle the callback when the saving request is performed
         int result = 0;
         try {
             callbackManager.processSave(body, fileName);  // file saving process

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/callback/CallbackManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/callback/DefaultCallbackManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -32,17 +32,24 @@ import org.json.simple.JSONObject;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Primary;
+import org.springframework.http.HttpStatus;
 import org.springframework.stereotype.Component;
 
-import java.io.*;
+import java.io.ByteArrayInputStream;
+import java.io.File;
+import java.io.InputStream;
+import java.io.OutputStream;
 import java.net.URL;
 import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
-import java.util.*;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
 
-//TODO: Refactoring
+import static com.onlyoffice.integration.documentserver.util.Constants.FILE_SAVE_TIMEOUT;
+
+// todo: Refactoring
 @Component
 @Primary
 public class DefaultCallbackManager implements CallbackManager {
@@ -69,25 +76,44 @@ public class DefaultCallbackManager implements CallbackManager {
     @Autowired
     private ServiceConverter serviceConverter;
 
-    // save file information from the URL to the file specified
-    private void downloadToFile(String url, Path path) throws Exception {
-        if (url == null || url.isEmpty()) throw new RuntimeException("Url argument is not specified");  // URL isn't specified
-        if (path == null) throw new RuntimeException("Path argument is not specified");  // file isn't specified
+    // download file from url
+    @SneakyThrows
+    private byte[] getDownloadFile(final String url) {
+        if (url == null || url.isEmpty()) {
+            throw new RuntimeException("Url argument is not specified");  // URL isn't specified
+        }
 
         URL uri = new URL(url);
         java.net.HttpURLConnection connection = (java.net.HttpURLConnection) uri.openConnection();
+        connection.setConnectTimeout(FILE_SAVE_TIMEOUT);
         InputStream stream = connection.getInputStream();  // get input stream of the file information from the URL
 
+        int statusCode = connection.getResponseCode();
+        if (statusCode != HttpStatus.OK.value()) {  // checking status code
+            connection.disconnect();
+            throw new RuntimeException("Document editing service returned status: " + statusCode);
+        }
+
         if (stream == null) {
             connection.disconnect();
             throw new RuntimeException("Input stream is null");
         }
 
-        storageMutator.createOrUpdateFile(path, stream);  // update a file or create a new one
+        return stream.readAllBytes();
+    }
+
+    // file saving
+    @SneakyThrows
+    private void saveFile(final byte[] byteArray, final Path path) {
+        if (path == null) {
+            throw new RuntimeException("Path argument is not specified");  // file isn't specified
+        }
+        // update a file or create a new one
+        storageMutator.createOrUpdateFile(path, new ByteArrayInputStream(byteArray));
     }
 
     @SneakyThrows
-    public void processSave(Track body, String fileName) {  // file saving process
+    public void processSave(final Track body, final String fileName) {  // file saving process
         String downloadUri = body.getUrl();
         String changesUri = body.getChangesurl();
         String key = body.getKey();
@@ -96,46 +122,57 @@ public class DefaultCallbackManager implements CallbackManager {
         String curExt = fileUtility.getFileExtension(fileName);  // get current file extension
         String downloadExt = "." + body.getFiletype(); // get an extension of the downloaded file
 
-        // Todo [Delete in version 7.0 or higher]
-        if (downloadExt != "." + null) downloadExt = fileUtility.getFileExtension(downloadUri); // Support for versions below 7.0
-
-        //TODO: Refactoring
-        if (!curExt.equals(downloadExt)) {  // convert downloaded file to the file with the current extension if these extensions aren't equal
+        // todo: Refactoring
+        // convert downloaded file to the file with the current extension if these extensions aren't equal
+        if (!curExt.equals(downloadExt)) {
             try {
-                String newFileUri = serviceConverter.getConvertedUri(downloadUri, downloadExt, curExt, serviceConverter.generateRevisionId(downloadUri), null, false, null);  // convert a file and get URL to a new file
+                String newFileUri = serviceConverter
+                        .getConvertedData(downloadUri, downloadExt, curExt,
+                                serviceConverter.generateRevisionId(downloadUri), null, false,
+                                null).getUri();  // convert a file and get URL to a new file
                 if (newFileUri.isEmpty()) {
                     newFileName = documentManager
-                            .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);  // get the correct file name if it already exists
+                            .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName)
+                                    + downloadExt);  // get the correct file name if it already exists
                 } else {
                     downloadUri = newFileUri;
                 }
-            } catch (Exception e){
-                newFileName = documentManager.getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
+            } catch (Exception e) {
+                newFileName = documentManager
+                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
             }
         }
 
+        byte[] byteArrayFile = getDownloadFile(downloadUri);  // download document file
+
         String storagePath = storagePathBuilder.getFileLocation(newFileName);  // get the path to a new file
-        Path lastVersion = Paths.get(storagePathBuilder.getFileLocation(fileName));  // get the path to the last file version
+        Path lastVersion = Paths.get(storagePathBuilder
+                .getFileLocation(fileName));  // get the path to the last file version
 
         if (lastVersion.toFile().exists()) {  // if the last file version exists
             Path histDir = Paths.get(storagePathBuilder.getHistoryDir(storagePath));  // get the history directory
             storageMutator.createDirectory(histDir);  // and create it
 
-            String versionDir = documentManager.versionDir(histDir.toAbsolutePath().toString(),  // get the file version directory
-                    storagePathBuilder.getFileVersion(histDir.toAbsolutePath().toString(), false), true);
+            String versionDir = documentManager
+                    .versionDir(histDir.toAbsolutePath().toString(),  // get the file version directory
+                    storagePathBuilder
+                            .getFileVersion(histDir.toAbsolutePath().toString(), false), true);
 
             Path ver = Paths.get(versionDir);
             Path toSave = Paths.get(storagePath);
 
             storageMutator.createDirectory(ver);  // create the file version directory
-            storageMutator.moveFile(lastVersion, Paths.get(versionDir + File.separator + "prev" + curExt));  // move the last file version to the file version directory with the "prev" postfix
 
-            downloadToFile(downloadUri, toSave);  // save file to the storage path
-            downloadToFile(changesUri, Path.of(versionDir + File.separator + "diff.zip"));  // save file changes to the diff.zip archive
+            saveFile(byteArrayFile, toSave); // save document file
+
+            byte[] byteArrayChanges = getDownloadFile(changesUri); // download file changes
+            saveFile(byteArrayChanges, Path
+                    .of(versionDir + File.separator + "diff.zip")); // save file changes to the diff.zip archive
 
             JSONObject jsonChanges = new JSONObject();  // create a json object for document changes
             jsonChanges.put("changes", body.getHistory().getChanges());  // put the changes to the json object
-            jsonChanges.put("serverVersion", body.getHistory().getServerVersion());  // put the server version to the json object
+            jsonChanges.put("serverVersion", body.getHistory()
+                    .getServerVersion());  // put the server version to the json object
             String history = objectMapper.writeValueAsString(jsonChanges);
 
             if (history == null && body.getHistory() != null) {
@@ -143,20 +180,26 @@ public class DefaultCallbackManager implements CallbackManager {
             }
 
             if (history != null && !history.isEmpty()) {
-                storageMutator.writeToFile(versionDir + File.separator + "changes.json", history);  // write the history changes to the changes.json file
+                // write the history changes to the changes.json file
+                storageMutator.writeToFile(versionDir + File.separator + "changes.json", history);
             }
 
-            storageMutator.writeToFile(versionDir + File.separator + "key.txt", key);  // write the key value to the key.txt file
-            storageMutator.deleteFile(storagePathBuilder.getForcesavePath(newFileName, false));  // get the path to the forcesaved file version and remove it
+            // write the key value to the key.txt file
+            storageMutator.writeToFile(versionDir + File.separator + "key.txt", key);
+
+            // get the path to the forcesaved file version and remove it
+            storageMutator.deleteFile(storagePathBuilder.getForcesavePath(newFileName, false));
         }
     }
 
-    //TODO: Replace (String method) with (Enum method)
+    // todo: Replace (String method) with (Enum method)
     @SneakyThrows
-    public void commandRequest(String method, String key, HashMap meta) {  // create a command request
-        String DocumentCommandUrl = docserviceUrlSite + docserviceUrlCommand;
+    public void commandRequest(final String method,
+                               final String key,
+                               final HashMap meta) {  // create a command request
+        String documentCommandUrl = docserviceUrlSite + docserviceUrlCommand;
 
-        URL url = new URL(DocumentCommandUrl);
+        URL url = new URL(documentCommandUrl);
         java.net.HttpURLConnection connection = (java.net.HttpURLConnection) url.openConnection();
 
         HashMap<String, Object> params = new HashMap<String, Object>();
@@ -168,12 +211,15 @@ public class DefaultCallbackManager implements CallbackManager {
         }
 
         String headerToken;
-        if (jwtManager.tokenEnabled())  // check if a secret key to generate token exists or not
-        {
+        // check if a secret key to generate token exists or not
+        if (jwtManager.tokenEnabled() && jwtManager.tokenUseForRequest()) {
             Map<String, Object> payloadMap = new HashMap<>();
             payloadMap.put("payload", params);
             headerToken = jwtManager.createToken(payloadMap);  // encode a payload object into a header token
-            connection.setRequestProperty(documentJwtHeader.equals("") ? "Authorization" : documentJwtHeader, "Bearer " + headerToken);  // add a header Authorization with a header token and Authorization prefix in it
+
+            // add a header Authorization with a header token and Authorization prefix in it
+            connection.setRequestProperty(documentJwtHeader.equals("")
+                    ? "Authorization" : documentJwtHeader, "Bearer " + headerToken);
 
             String token = jwtManager.createToken(params);  // encode a payload object into a body token
             params.put("token", token);
@@ -184,7 +230,8 @@ public class DefaultCallbackManager implements CallbackManager {
         byte[] bodyByte = bodyString.getBytes(StandardCharsets.UTF_8);
 
         connection.setRequestMethod("POST");  // set the request method
-        connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");  // set the Content-Type header
+        connection
+                .setRequestProperty("Content-Type", "application/json; charset=UTF-8");  // set the Content-Type header
         connection.setDoOutput(true);  // set the doOutput field to true
         connection.connect();
 
@@ -194,76 +241,82 @@ public class DefaultCallbackManager implements CallbackManager {
 
         InputStream stream = connection.getInputStream();  // get input stream
 
-        if (stream == null) throw new RuntimeException("Could not get an answer");
+        if (stream == null) {
+            throw new RuntimeException("Could not get an answer");
+        }
 
         String jsonString = serviceConverter.convertStreamToString(stream);  // convert stream to json string
         connection.disconnect();
 
         JSONObject response = serviceConverter.convertStringToJSON(jsonString);  // convert json string to json object
-        //TODO: Add errors ENUM
+        // todo: Add errors ENUM
         String responseCode = response.get("error").toString();
-        switch(responseCode) {
+        switch (responseCode) {
             case "0":
-            case "4": {
+            case "4":
                 break;
-            }
-            default: {
+            default:
                 throw new RuntimeException(response.toJSONString());
             }
         }
-    }
 
     @SneakyThrows
-    public void processForceSave(Track body, String fileName) {  // file force saving process
+    public void processForceSave(final Track body, final String fileNameParam) {  // file force saving process
 
         String downloadUri = body.getUrl();
+        String fileName = fileNameParam;
 
         String curExt = fileUtility.getFileExtension(fileName);  // get current file extension
-        String downloadExt = "."+body.getFiletype();  // get an extension of the downloaded file
+        String downloadExt = "." + body.getFiletype();  // get an extension of the downloaded file
 
-        // Todo [Delete in version 7.0 or higher]
-        if (downloadExt != "."+null) downloadExt = fileUtility.getFileExtension(downloadUri);    // Support for versions below 7.0
-        
         Boolean newFileName = false;
 
         // convert downloaded file to the file with the current extension if these extensions aren't equal
-        //TODO: Extract function
+        // todo: Extract function
         if (!curExt.equals(downloadExt)) {
             try {
-                String newFileUri = serviceConverter.getConvertedUri(downloadUri, downloadExt,
-                        curExt, serviceConverter.generateRevisionId(downloadUri), null, false, null);  // convert file and get URL to a new file
+                // convert file and get URL to a new file
+                String newFileUri = serviceConverter
+                        .getConvertedData(downloadUri, downloadExt, curExt, serviceConverter
+                                .generateRevisionId(downloadUri), null, false, null).getUri();
                 if (newFileUri.isEmpty()) {
                     newFileName = true;
                 } else {
                     downloadUri = newFileUri;
                 }
-            } catch (Exception e){
+            } catch (Exception e) {
                 newFileName = true;
             }
         }
 
+        byte[] byteArrayFile = getDownloadFile(downloadUri);  // download document file
         String forcesavePath = "";
 
-        //TODO: Use ENUMS
-        //TODO: Pointless toString conversion
+        // todo: Use ENUMS
+        // todo: Pointless toString conversion
         boolean isSubmitForm = body.getForcesavetype().toString().equals("3");
 
-        //TODO: Extract function
+        // todo: Extract function
         if (isSubmitForm) {  // if the form is submitted
-            if (newFileName){
+            if (newFileName) {
+                // get the correct file name if it already exists
                 fileName = documentManager
-                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + "-form" + downloadExt);  // get the correct file name if it already exists
+                        .getCorrectName(fileUtility
+                                .getFileNameWithoutExtension(fileName) + "-form" + downloadExt);
             } else {
-                fileName = documentManager.getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + "-form" + curExt);
+                fileName = documentManager
+                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + "-form" + curExt);
             }
             forcesavePath = storagePathBuilder.getFileLocation(fileName);  // create forcesave path if it doesn't exist
             List<Action> actions =  body.getActions();
             Action action = actions.get(0);
             String user = action.getUserid();  // get the user ID
-            storageMutator.createMeta(fileName, user, "Filling Form");  // create meta data for the forcesaved file
+            // create meta data for the forcesaved file
+            storageMutator.createMeta(fileName, user, "Filling Form");
         } else {
-            if (newFileName){
-                fileName = documentManager.getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
+            if (newFileName) {
+                fileName = documentManager
+                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
             }
 
             forcesavePath = storagePathBuilder.getForcesavePath(fileName, false);
@@ -272,6 +325,6 @@ public class DefaultCallbackManager implements CallbackManager {
             }
         }
 
-        downloadToFile(downloadUri, Path.of(forcesavePath));
+        saveFile(byteArrayFile, Path.of(forcesavePath));
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/document/DefaultDocumentManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,8 +27,9 @@ import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Primary;
 import org.springframework.stereotype.Component;
 
-import java.io.*;
 import java.io.File;
+import java.io.InputStream;
+import java.io.UnsupportedEncodingException;
 import java.math.BigDecimal;
 import java.math.RoundingMode;
 import java.net.InetAddress;
@@ -37,7 +38,12 @@ import java.net.UnknownHostException;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.Date;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import static com.onlyoffice.integration.documentserver.util.Constants.KILOBYTE_SIZE;
 
 @Component
 @Primary
@@ -62,23 +68,23 @@ public class DefaultDocumentManager implements DocumentManager {
     private ServiceConverter serviceConverter;
 
     // get URL to the created file
-    public String getCreateUrl(String fileName, Boolean sample){
-        String fileExt = fileName.substring(fileName.length() - 4);
-        String url = storagePathBuilder.getServerUrl(true) + "/create?fileExt=" + fileExt + "&sample=" + sample;
+    public String getCreateUrl(final String fileName, final Boolean sample) {
+        String fileExt = fileUtility.getFileExtension(fileName).replace(".", "");
+        String url = storagePathBuilder.getServerUrl(true)
+                + "/create?fileExt=" + fileExt + "&sample=" + sample;
         return url;
     }
 
     // get a file name with an index if the file with such a name already exists
-    public String getCorrectName(String fileName)
-    {
+    public String getCorrectName(final String fileName) {
         String baseName = fileUtility.getFileNameWithoutExtension(fileName);  // get file name without extension
         String ext = fileUtility.getFileExtension(fileName);  // get file extension
         String name = baseName + ext;  // create a full file name
 
         Path path = Paths.get(storagePathBuilder.getFileLocation(name));
 
-        for (int i = 1; Files.exists(path); i++)  // run through all the files with such a name in the storage directory
-        {
+        // run through all the files with such a name in the storage directory
+        for (int i = 1; Files.exists(path); i++) {
             name = baseName + " (" + i + ")" + ext;  // and add an index to the base name
             path = Paths.get(storagePathBuilder.getFileLocation(name));
         }
@@ -87,101 +93,94 @@ public class DefaultDocumentManager implements DocumentManager {
     }
 
     // get file URL
-    public String getFileUri(String fileName, Boolean forDocumentServer)
-    {
-        try
-        {
+    public String getFileUri(final String fileName, final Boolean forDocumentServer) {
+        try {
             String serverPath = storagePathBuilder.getServerUrl(forDocumentServer);  // get server URL
             String hostAddress = storagePathBuilder.getStorageLocation();  // get the storage directory
             String filePathDownload = !fileName.contains(InetAddress.getLocalHost().getHostAddress()) ? fileName
-                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost().getHostAddress()) + InetAddress.getLocalHost().getHostAddress().length() + 1);
+                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost()
+                    .getHostAddress()) + InetAddress.getLocalHost().getHostAddress().length() + 1);
             if (!filesStorage.isEmpty() && filePathDownload.contains(filesStorage)) {
                 filePathDownload = filePathDownload.substring(filesStorage.length() + 1);
             }
 
-            String filePath = serverPath + "/download?fileName=" + URLEncoder.encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString())
-                    + "&userAddress" + URLEncoder.encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
+            String filePath = serverPath + "/download?fileName=" + URLEncoder
+                    .encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString()) + "&userAddress"
+                    + URLEncoder.encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
             return filePath;
-        }
-        catch (UnsupportedEncodingException | UnknownHostException e)
-        {
+        } catch (UnsupportedEncodingException | UnknownHostException e) {
             return "";
         }
     }
 
     // get file URL
-    public String getHistoryFileUrl(String fileName, Integer version, String file, Boolean forDocumentServer)
-    {
-        try
-        {
+    public String getHistoryFileUrl(final String fileName, final Integer version, final String file,
+                                    final Boolean forDocumentServer) {
+        try {
             String serverPath = storagePathBuilder.getServerUrl(forDocumentServer);  // get server URL
             String hostAddress = storagePathBuilder.getStorageLocation();  // get the storage directory
             String filePathDownload = !fileName.contains(InetAddress.getLocalHost().getHostAddress()) ? fileName
-                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost().getHostAddress()) + InetAddress.getLocalHost().getHostAddress().length() + 1);
-            String userAddress = forDocumentServer ? "&userAddress" + URLEncoder.encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
-            String filePath = serverPath + "/downloadhistory?fileName=" + URLEncoder.encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString())
-                + "&ver=" + version + "&file="+file
+                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost().getHostAddress())
+                    + InetAddress.getLocalHost().getHostAddress().length() + 1);
+            String userAddress = forDocumentServer ? "&userAddress" + URLEncoder
+                    .encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
+            String filePath = serverPath + "/downloadhistory?fileName=" + URLEncoder
+                    .encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString())
+                + "&ver=" + version + "&file=" + file
                 + userAddress;
             return filePath;
-        }
-        catch (UnsupportedEncodingException | UnknownHostException e)
-        {
+        } catch (UnsupportedEncodingException | UnknownHostException e) {
             return "";
         }
     }
 
     // get the callback URL
-    public String getCallback(String fileName)
-    {
+    public String getCallback(final String fileName) {
         String serverPath = storagePathBuilder.getServerUrl(true);
         String storageAddress = storagePathBuilder.getStorageLocation();
-        try
-        {
-            String query = trackUrl+"?fileName="+
-                    URLEncoder.encode(fileName, java.nio.charset.StandardCharsets.UTF_8.toString())
-                    + "&userAddress=" + URLEncoder.encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
+        try {
+            String query = trackUrl + "?fileName="
+                    + URLEncoder.encode(fileName, java.nio.charset.StandardCharsets.UTF_8.toString())
+                    + "&userAddress=" + URLEncoder
+                    .encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
             return serverPath + query;
-        }
-        catch (UnsupportedEncodingException e)
-        {
+        } catch (UnsupportedEncodingException e) {
             return "";
         }
     }
 
     // get URL to download a file
-    public String getDownloadUrl(String fileName, Boolean isServer) {
+    public String getDownloadUrl(final String fileName, final Boolean isServer) {
         String serverPath = storagePathBuilder.getServerUrl(isServer);
         String storageAddress = storagePathBuilder.getStorageLocation();
-        try
-        {
-            String userAddress = isServer ? "&userAddress=" + URLEncoder.encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
-            String query = downloadUrl+"?fileName="
+        try {
+            String userAddress = isServer ? "&userAddress=" + URLEncoder
+                    .encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
+            String query = downloadUrl + "?fileName="
                     + URLEncoder.encode(fileName, java.nio.charset.StandardCharsets.UTF_8.toString())
                     + userAddress;
 
             return serverPath + query;
-        }
-        catch (UnsupportedEncodingException e)
-        {
+        } catch (UnsupportedEncodingException e) {
             return "";
         }
     }
 
     // get file information
-    public ArrayList<Map<String, Object>> getFilesInfo(){
+    public ArrayList<Map<String, Object>> getFilesInfo() {
         ArrayList<Map<String, Object>> files = new ArrayList<>();
 
         // run through all the stored files
-        for(File file : storageMutator.getStoredFiles()){
+        for (File file : storageMutator.getStoredFiles()) {
             Map<String, Object> map = new LinkedHashMap<>();  // write all the parameters to the map
             map.put("version", storagePathBuilder.getFileVersion(file.getName(), false));
             map.put("id", serviceConverter
-                    .generateRevisionId(storagePathBuilder.getStorageLocation() +
-                            "/" + file.getName() + "/"
+                    .generateRevisionId(storagePathBuilder.getStorageLocation()
+                            + "/" + file.getName() + "/"
                             + Paths.get(storagePathBuilder.getFileLocation(file.getName()))
                             .toFile()
                             .lastModified()));
-            map.put("contentLength", new BigDecimal(String.valueOf((file.length()/1024.0)))
+            map.put("contentLength", new BigDecimal(String.valueOf((file.length() / Double.valueOf(KILOBYTE_SIZE))))
                     .setScale(2, RoundingMode.HALF_UP) + " KB");
             map.put("pureContentLength", file.length());
             map.put("title", file.getName());
@@ -193,11 +192,11 @@ public class DefaultDocumentManager implements DocumentManager {
     }
 
     // get file information by its ID
-    public ArrayList<Map<String, Object>> getFilesInfo(String fileId){
+    public ArrayList<Map<String, Object>> getFilesInfo(final String fileId) {
         ArrayList<Map<String, Object>> file = new ArrayList<>();
 
-        for (Map<String, Object> map : getFilesInfo()){
-            if (map.get("id").equals(fileId)){
+        for (Map<String, Object> map : getFilesInfo()) {
+            if (map.get("id").equals(fileId)) {
                 file.add(map);
                 break;
             }
@@ -207,26 +206,33 @@ public class DefaultDocumentManager implements DocumentManager {
     }
 
     // get the path to the file version by the history path and file version
-    public String versionDir(String path, Integer version, boolean historyPath) {
-        if (!historyPath){
+    public String versionDir(final String path, final Integer version, final boolean historyPath) {
+        if (!historyPath) {
             return storagePathBuilder.getHistoryDir(storagePathBuilder.getFileLocation(path)) + version;
         }
         return path + File.separator + version;
     }
 
     // create demo document
-    public String createDemo(String fileExt,Boolean sample,String uid,String uname) {
-        String demoName = (sample ? "sample." : "new.") + fileExt;  // create sample or new template file with the necessary extension
-        String demoPath = "assets" + File.separator  + (sample ? "sample" : "new") + File.separator + demoName;  // get the path to the sample document
-        String fileName = getCorrectName(demoName);  // get a file name with an index if the file with such a name already exists
+    public String createDemo(final String fileExt, final Boolean sample, final String uid, final String uname) {
+        String demoName = (sample ? "sample." : "new.")
+                + fileExt;  // create sample or new template file with the necessary extension
+        String demoPath = "assets" + File.separator  + (sample ? "sample" : "new")
+                + File.separator + demoName;  // get the path to the sample document
+
+        // get a file name with an index if the file with such a name already exists
+        String fileName = getCorrectName(demoName);
 
         InputStream stream = Thread.currentThread()
                                     .getContextClassLoader()
                                     .getResourceAsStream(demoPath);  // get the input file stream
 
-        if (stream == null) return null;
+        if (stream == null) {
+            return null;
+        }
 
-        storageMutator.createFile(Path.of(storagePathBuilder.getFileLocation(fileName)), stream);  // create a file in the specified directory
+        storageMutator.createFile(Path.of(storagePathBuilder
+                .getFileLocation(fileName)), stream);  // create a file in the specified directory
         storageMutator.createMeta(fileName, uid, uname);  // create meta information of the demo file
 
         return fileName;

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/document/DocumentManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,14 +23,20 @@ import java.util.Map;
 
 // specify the document manager functions
 public interface DocumentManager {
-    String getCorrectName(String fileName);  // get a file name with an index if the file with such a name already exists
+
+    // get a file name with an index if the file with such a name already exists
+    String getCorrectName(String fileName);
     String getFileUri(String fileName, Boolean forDocumentServer);  // get file URL
     String getHistoryFileUrl(String fileName, Integer version, String file, Boolean forDocumentServer);  // get file URL
     String getCallback(String fileName);  // get the callback URL
     String getDownloadUrl(String fileName, Boolean forDocumentServer);  // get URL to download a file
     ArrayList<Map<String, Object>> getFilesInfo();  // get file information
     ArrayList<Map<String, Object>> getFilesInfo(String fileId);  // get file information by its ID
-    String versionDir(String path, Integer version, boolean historyPath);  // get the path to the file version by the history path and file version
-    String createDemo(String fileExt,Boolean sample,String uid,String uname) throws Exception;  // create demo document
+
+    //  get the path to the file version by the history path and file version
+    String versionDir(String path, Integer version, boolean historyPath);
+
+    // create demo document
+    String createDemo(String fileExt, Boolean sample, String uid, String uname) throws Exception;
     String getCreateUrl(String fileName, Boolean sample);  // get URL to the created file
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/history/DefaultHistoryManager.java

@@ -1,17 +1,19 @@
 /**
- * (c) Copyright Ascensio System SIA 2021
+ *
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- * http://www.apache.org/licenses/LICENSE-2.0
+ *     http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
+ *
  */
 
 package com.onlyoffice.integration.documentserver.managers.history;
@@ -32,9 +34,13 @@ import org.springframework.stereotype.Component;
 
 import java.io.File;
 import java.io.FileInputStream;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Scanner;
 
-//TODO: Rebuild completely
+// todo: Rebuild completely
 @Component
 public class DefaultHistoryManager implements HistoryManager {
 
@@ -56,10 +62,12 @@ public class DefaultHistoryManager implements HistoryManager {
     @Autowired
     private ObjectMapper objectMapper;
 
-    //TODO: Refactoring
+    // todo: Refactoring
     @SneakyThrows
-    public String[] getHistory(Document document) {  // get document history
-        String histDir = storagePathBuilder.getHistoryDir(storagePathBuilder.getFileLocation(document.getTitle()));  // get history directory
+    public String[] getHistory(final Document document) {  // get document history
+
+        // get history directory
+        String histDir = storagePathBuilder.getHistoryDir(storagePathBuilder.getFileLocation(document.getTitle()));
         Integer curVer = storagePathBuilder.getFileVersion(histDir, false);  // get current file version
 
         if (curVer > 0) {  // check if the current file version is greater than 0
@@ -69,14 +77,17 @@ public class DefaultHistoryManager implements HistoryManager {
             for (Integer i = 1; i <= curVer; i++) {  // run through all the file versions
                 Map<String, Object> obj = new HashMap<String, Object>();
                 Map<String, Object> dataObj = new HashMap<String, Object>();
-                String verDir = documentManager.versionDir(histDir, i, true);  // get the path to the given file version
+                String verDir = documentManager
+                        .versionDir(histDir, i, true);  // get the path to the given file version
 
-                String key = i == curVer ? document.getKey() : readFileToEnd(new File(verDir + File.separator + "key.txt"));  // get document key
+                String key = i == curVer ? document.getKey() : readFileToEnd(new File(verDir
+                        + File.separator + "key.txt"));  // get document key
                 obj.put("key", key);
                 obj.put("version", i);
 
                 if (i == 1) {  // check if the version number is equal to 1
-                    String createdInfo = readFileToEnd(new File(histDir + File.separator + "createdInfo.json"));  // get file with meta data
+                    String createdInfo = readFileToEnd(new File(histDir
+                            + File.separator + "createdInfo.json"));  // get file with meta data
                     JSONObject json = (JSONObject) parser.parse(createdInfo);  // and turn it into json object
 
                     // write meta information to the object (user information and creation date)
@@ -87,17 +98,23 @@ public class DefaultHistoryManager implements HistoryManager {
                     obj.put("user", user);
                 }
 
-                dataObj.put("fileType", fileUtility.getFileExtension(document.getTitle()).replace(".", ""));
+                dataObj.put("fileType", fileUtility
+                        .getFileExtension(document.getTitle()).replace(".", ""));
                 dataObj.put("key", key);
-                dataObj.put("url", i == curVer ? document.getUrl() :
-                        documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility.getFileExtension(document.getTitle()), true));
-                dataObj.put("directUrl", i == curVer ? document.getDirectUrl() :
-                        documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility.getFileExtension(document.getTitle()), false));
+                dataObj.put("url", i == curVer ? document.getUrl()
+                        : documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility
+                        .getFileExtension(document.getTitle()), true));
+                if (!document.getDirectUrl().equals("")) {
+                    dataObj.put("directUrl", i == curVer ? document.getDirectUrl()
+                            : documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility
+                            .getFileExtension(document.getTitle()), false));
+                }
                 dataObj.put("version", i);
 
                 if (i > 1) {  //check if the version number is greater than 1
                     // if so, get the path to the changes.json file
-                    JSONObject changes = (JSONObject) parser.parse(readFileToEnd(new File(documentManager.versionDir(histDir, i - 1, true) + File.separator + "changes.json")));
+                    JSONObject changes = (JSONObject) parser.parse(readFileToEnd(new File(documentManager
+                            .versionDir(histDir, i - 1, true) + File.separator + "changes.json")));
                     JSONObject change = (JSONObject) ((JSONArray) changes.get("changes")).get(0);
 
                     // write information about changes to the object
@@ -106,19 +123,27 @@ public class DefaultHistoryManager implements HistoryManager {
                     obj.put("created", change.get("created"));
                     obj.put("user", change.get("user"));
 
-                    Map<String, Object> prev = (Map<String, Object>) histData.get(Integer.toString(i - 2));  // get the history data from the previous file version
+                    // get the history data from the previous file version
+                    Map<String, Object> prev = (Map<String, Object>) histData.get(Integer.toString(i - 2));
                     Map<String, Object> prevInfo = new HashMap<String, Object>();
                     prevInfo.put("fileType", prev.get("fileType"));
                     prevInfo.put("key", prev.get("key"));  // write key and URL information about previous file version
                     prevInfo.put("url", prev.get("url"));
-                    prevInfo.put("directUrl", prev.get("directUrl"));
-                    dataObj.put("previous", prevInfo);  // write information about previous file version to the data object
+                    if (!document.getDirectUrl().equals("")) {
+                        prevInfo.put("directUrl", prev.get("directUrl"));
+                    }
+
+                    // write information about previous file version to the data object
+                    dataObj.put("previous", prevInfo);
                     // write the path to the diff.zip archive with differences in this file version
                     Integer verdiff = i - 1;
-                    dataObj.put("changesUrl", documentManager.getHistoryFileUrl(document.getTitle(), verdiff, "diff.zip", true));
+                    dataObj.put("changesUrl", documentManager
+                            .getHistoryFileUrl(document.getTitle(), verdiff, "diff.zip", true));
                 }
 
-                if (jwtManager.tokenEnabled()) dataObj.put("token", jwtManager.createToken(dataObj));
+                if (jwtManager.tokenEnabled()) {
+                    dataObj.put("token", jwtManager.createToken(dataObj));
+                }
 
                 hist.add(obj);
                 histData.put(Integer.toString(i - 1), dataObj);
@@ -130,7 +155,8 @@ public class DefaultHistoryManager implements HistoryManager {
             histObj.put("history", hist);
 
             try {
-                return new String[]{objectMapper.writeValueAsString(histObj), objectMapper.writeValueAsString(histData)};
+                return new String[]{objectMapper.writeValueAsString(histObj),
+                        objectMapper.writeValueAsString(histData)};
             } catch (JsonProcessingException e) {
                 e.printStackTrace();
             }
@@ -139,7 +165,7 @@ public class DefaultHistoryManager implements HistoryManager {
     }
 
     // read a file
-    private String readFileToEnd(File file) {
+    private String readFileToEnd(final File file) {
         String output = "";
         try {
             try (FileInputStream is = new FileInputStream(file)) {

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/history/HistoryManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/jwt/DefaultJwtManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -37,13 +37,15 @@ import java.util.Map;
 public class DefaultJwtManager implements JwtManager {
     @Value("${files.docservice.secret}")
     private String tokenSecret;
+    @Value("${files.docservice.token-use-for-request}")
+    private String tokenUseForRequest;
     @Autowired
     private ObjectMapper objectMapper;
     @Autowired
     private JSONParser parser;
 
     // create document token
-    public String createToken(Map<String, Object> payloadClaims) {
+    public String createToken(final Map<String, Object> payloadClaims) {
         try {
             // build a HMAC signer using a SHA-256 hash
             Signer signer = HMACSigner.newSHA256Signer(tokenSecret);
@@ -62,19 +64,25 @@ public class DefaultJwtManager implements JwtManager {
         return tokenSecret != null && !tokenSecret.isEmpty();
     }
 
+    public boolean tokenUseForRequest() {
+        return Boolean.parseBoolean(tokenUseForRequest) && !tokenUseForRequest.isEmpty();
+    }
+
     // read document token
-    public JWT readToken(String token) {
+    public JWT readToken(final String token) {
         try {
             // build a HMAC verifier using the token secret
             Verifier verifier = HMACVerifier.newVerifier(tokenSecret);
-            return JWT.getDecoder().decode(token, verifier);  // verify and decode the encoded string JWT to a rich object
+
+            // verify and decode the encoded string JWT to a rich object
+            return JWT.getDecoder().decode(token, verifier);
         } catch (Exception exception) {
             return null;
         }
     }
 
     // parse the body
-    public JSONObject parseBody(String payload, String header) {
+    public JSONObject parseBody(final String payload, final String header) {
         JSONObject body;
         try {
             Object obj = parser.parse(payload);  // get body parameters by parsing the payload
@@ -82,11 +90,13 @@ public class DefaultJwtManager implements JwtManager {
         } catch (Exception ex) {
             throw new RuntimeException("{\"error\":1,\"message\":\"JSON Parsing error\"}");
         }
-        if (tokenEnabled()) {  // check if the token is enabled
+        if (tokenEnabled() && tokenUseForRequest()) {  // check if the token is enabled
             String token = (String) body.get("token");  // get token from the body
             if (token == null) {  // if token is empty
                 if (header != null && !header.isBlank()) {  // and the header is defined
-                    token = header.startsWith("Bearer ") ? header.substring(7) : header;  // get token from the header (it is placed after the Bearer prefix if it exists)
+
+                    // get token from the header (it is placed after the Bearer prefix if it exists)
+                    token = header.startsWith("Bearer ") ? header.substring("Bearer ".length()) : header;
                 }
             }
             if (token == null || token.isBlank()) {
@@ -100,7 +110,7 @@ public class DefaultJwtManager implements JwtManager {
             if (jwt.getObject("payload") != null) {  // get payload from the token and check if it is not empty
                 try {
                     @SuppressWarnings("unchecked") LinkedHashMap<String, Object> jwtPayload =
-                            (LinkedHashMap<String, Object>)jwt.getObject("payload");
+                            (LinkedHashMap<String, Object>) jwt.getObject("payload");
 
                     jwt.claims = jwtPayload;
                 } catch (Exception ex) {

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/jwt/JwtManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,6 +26,7 @@ import java.util.Map;
 // specify the jwt manager functions
 public interface JwtManager {
     boolean tokenEnabled();  // check if the token is enabled
+    boolean tokenUseForRequest();  // check if the token is enabled
     String createToken(Map<String, Object> payloadClaims);  // create document token
     JWT readToken(String token);  // read document token
     JSONObject parseBody(String payload, String header);  // parse the body

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/template/SampleTemplateManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -42,24 +42,27 @@ public class SampleTemplateManager implements TemplateManager {
     private FileUtility fileUtility;
 
     // create a template document with the specified name
-    public List<Template> createTemplates(String fileName){
+    public List<Template> createTemplates(final String fileName) {
         List<Template> templates = List.of(
-                new Template("", "Blank", documentManager.getCreateUrl(fileName, false)),  // create a blank template
-                new Template(getTemplateImageUrl(fileName), "With sample content", documentManager.getCreateUrl(fileName, true))  // create a template with sample content using the template image
+                new Template("", "Blank", documentManager
+                        .getCreateUrl(fileName, false)),  // create a blank template
+                new Template(getTemplateImageUrl(fileName), "With sample content", documentManager
+                        .getCreateUrl(fileName,
+                                true))  // create a template with sample content using the template image
         );
 
         return templates;
     }
 
     // get the template image URL for the specified file
-    public String getTemplateImageUrl(String fileName){
+    public String getTemplateImageUrl(final String fileName) {
         DocumentType fileType = fileUtility.getDocumentType(fileName);  // get the file type
         String path = storagePathBuilder.getServerUrl(true);  // get server URL
-        if(fileType.equals(DocumentType.word)){  // get URL to the template image for the word document type
+        if (fileType.equals(DocumentType.word)) {  // get URL to the template image for the word document type
             return path + "/css/img/file_docx.svg";
-        } else if(fileType.equals(DocumentType.slide)){  // get URL to the template image for the slide document type
+        } else if (fileType.equals(DocumentType.slide)) {  // get URL to the template image for the slide document type
             return path + "/css/img/file_pptx.svg";
-        } else if(fileType.equals(DocumentType.cell)){  // get URL to the template image for the cell document type
+        } else if (fileType.equals(DocumentType.cell)) {  // get URL to the template image for the cell document type
             return path + "/css/img/file_xlsx.svg";
         }
         return path + "/css/img/file_docx.svg";  // get URL to the template image for the default document type (word)