Files
document-server-integration/web/documentserver-example/ruby/app/models/file_model.rb
2023-11-28 10:05:46 +03:00

389 lines
15 KiB
Ruby
Executable File

#
# (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.
#
require_relative '../configuration/configuration'
class FileModel
attr_accessor :file_name, :mode, :type, :user_ip, :lang, :user, :action_data, :direct_url
attr_reader :config_manager
# set file parameters
def initialize(attributes = {})
@file_name = attributes[:file_name]
@mode = attributes[:mode]
@type = attributes[:type]
@user_ip = attributes[:user_ip]
@lang = attributes[:lang]
@user = attributes[:user]
@action_data = attributes[:action_data]
@direct_url = attributes[:direct_url]
@config_manager = ConfigurationManager.new
end
def type
@type ? @type : "desktop" # the default platform type is desktop
end
# get file extension from its name
def file_ext
File.extname(@file_name).downcase
end
# get file url
def file_uri
DocumentHelper.get_file_uri(@file_name, true)
end
# get file uri for document server
def file_uri_user
@config_manager.storage_path.absolute? ? download_url + "&dmode=emb" : DocumentHelper.get_file_uri(@file_name, false)
end
# get document type from its name (word, cell or slide)
def document_type
FileUtility.get_file_type(@file_name)
end
# generate the document key value
def key
uri = DocumentHelper.cur_user_host_address(nil) + '/' + @file_name # get current user host address
stat = File.mtime(DocumentHelper.storage_path(@file_name, nil)) # get the modification time of the given file
return ServiceConverter.generate_revision_id("#{uri}.#{stat.to_s}")
end
# get callback url
def callback_url
DocumentHelper.get_callback(@file_name)
end
# get url to the created file
def create_url
DocumentHelper.get_create_url(document_type)
end
# get url to download a file
def download_url(is_serverUrl=true)
DocumentHelper.get_download_url(@file_name, is_serverUrl)
end
# get current user host address
def cur_user_host_address
DocumentHelper.cur_user_host_address(nil)
end
# get config parameters
def get_config
editorsmode = @mode ? @mode : "edit" # mode: view/edit/review/comment/fillForms/embedded
canEdit = DocumentHelper.edited_exts.include?(file_ext) # check if the document can be edited
if (!canEdit && editorsmode.eql?("edit") || editorsmode.eql?("fillForms")) && DocumentHelper.fill_forms_exts.include?(file_ext)
editorsmode = "fillForms"
canEdit = true
end
submitForm = editorsmode.eql?("fillForms") && @user.id.eql?("uid-1") # the Submit form button state
mode = canEdit && !editorsmode.eql?("view") ? "edit" : "view"
templatesImageUrl = DocumentHelper.get_template_image_url(document_type) # templates image url in the "From Template" section
templates = [
{
:image => "",
:title => "Blank",
:url => create_url
},
{
:image => templatesImageUrl,
:title => "With sample content",
:url => create_url + "&sample=true"
}
]
config = {
:type => type(),
:documentType => document_type,
:document => {
:title => @file_name,
:url => download_url,
:directUrl => is_enable_direct_url ? download_url(false) : "",
:fileType => file_ext.delete("."),
:key => key,
:info => {
:owner => "Me",
:uploaded => Time.now.to_s,
:favorite => @user.favorite
},
:permissions => { # the permission for the document to be edited and downloaded or not
:comment => !editorsmode.eql?("view") && !editorsmode.eql?("fillForms") && !editorsmode.eql?("embedded") && !editorsmode.eql?("blockcontent"),
:copy => !@user.deniedPermissions.include?("copy"),
:download => !@user.deniedPermissions.include?("download"),
:edit => canEdit && (editorsmode.eql?("edit") || editorsmode.eql?("view") || editorsmode.eql?("filter") || editorsmode.eql?("blockcontent")),
:print => !@user.deniedPermissions.include?("print"),
:fillForms => !editorsmode.eql?("view") && !editorsmode.eql?("comment") && !editorsmode.eql?("embedded") && !editorsmode.eql?("blockcontent"),
:modifyFilter => !editorsmode.eql?("filter"),
:modifyContentControl => !editorsmode.eql?("blockcontent"),
:review => canEdit && (editorsmode.eql?("edit") || editorsmode.eql?("review")),
:chat => !@user.id.eql?("uid-0"),
:reviewGroups => @user.reviewGroups,
:commentGroups => @user.commentGroups,
:userInfoGroups => @user.userInfoGroups,
:protect => !@user.deniedPermissions.include?("protect")
},
:referenceData => {
:instanceId => DocumentHelper.get_server_url(false),
:fileKey => !@user.id.eql?("uid-0") ? {:fileName => @file_name,:userAddress => DocumentHelper.cur_user_host_address(nil)}.to_json : nil
}
},
:editorConfig => {
:actionLink => @action_data ? JSON.parse(@action_data) : nil,
:mode => mode,
:lang => @lang ? @lang : "en",
:callbackUrl => callback_url, # absolute URL to the document storage service
:coEditing => editorsmode.eql?("view") && @user.id.eql?("uid-0") ? {
:mode => "strict",
:change => false
} : nil,
:createUrl => !@user.id.eql?("uid-0") ? create_url : nil,
:templates => @user.templates ? templates : nil,
:user => { # the user currently viewing or editing the document
:id => !@user.id.eql?("uid-0") ? @user.id : nil,
:name => @user.name,
:group => @user.group,
:image => @user.avatar ? "#{DocumentHelper.get_server_url(true)}/assets/#{@user.id}.png" : nil
},
:embedded => { # the parameters for the embedded document type
:saveUrl => download_url(false), # the absolute URL that will allow the document to be saved onto the user personal computer
:embedUrl => download_url(false), # the absolute URL to the document serving as a source file for the document embedded into the web page
:shareUrl => download_url(false), # the absolute URL that will allow other users to share this document
:toolbarDocked => "top" # the place for the embedded viewer toolbar (top or bottom)
},
:customization => { # the parameters for the editor interface
:about => true, # the About section display
:comments => true,
:feedback => true, # the Feedback & Support menu button display
:forcesave => false, # adding the request for the forced file saving to the callback handler
:submitForm => submitForm, # the Submit form button state
:goback => {
:url => DocumentHelper.get_server_url(false)
},
}
}
}
if JwtHelper.is_enabled # check if a secret key to generate token exists or not
config["token"] = JwtHelper.encode(config) # encode a payload object into a token and write it to the config
end
return config
end
# get document history
def get_history
file_name = @file_name
file_ext = File.extname(file_name).downcase
doc_key = key()
doc_uri = file_uri()
hist_dir = DocumentHelper.history_dir(DocumentHelper.storage_path(@file_name, nil)) # get the path to the file history
cur_ver = DocumentHelper.get_file_version(hist_dir) # get the file version
if (cur_ver > 0) # if file was modified
hist = []
histData = {}
for i in 1..cur_ver # run through all the file versions
obj = {}
dataObj = {}
ver_dir = DocumentHelper.version_dir(hist_dir, i) # get the path to the given file version
# get document key
cur_key = doc_key
if (i != cur_ver)
File.open(File.join(ver_dir, "key.txt"), 'r') do |file|
cur_key = file.read()
end
end
obj["key"] = cur_key
obj["version"] = i
if (i == 1) # check if the version number is equal to 1
if File.file?(File.join(hist_dir, "createdInfo.json")) # check if the createdInfo.json file with meta data exists
File.open(File.join(hist_dir, "createdInfo.json"), 'r') do |file| # open it
cr_info = JSON.parse(file.read()) # parse the file content
# write information about changes to the object
obj["created"] = cr_info["created"]
obj["user"] = {
:id => cr_info["uid"],
:name => cr_info["uname"]
}
end
end
end
# get the history data from the previous file version and write key and url information about it
dataObj["fileType"] = file_ext[1..file_ext.length]
dataObj["key"] = cur_key
dataObj["url"] = i == cur_ver ? DocumentHelper.get_download_url(file_name, true) : DocumentHelper.get_historypath_uri(file_name, i, "prev#{file_ext}")
if is_enable_direct_url == true
dataObj["directUrl"] = i == cur_ver ? download_url(false) : DocumentHelper.get_historypath_uri(file_name, i, "prev#{file_ext}", false)
end
dataObj["version"] = i
if (i > 1) # check if the version number is greater than 1
changes = nil
change = nil
File.open(File.join(DocumentHelper.version_dir(hist_dir, i - 1), "changes.json"), 'r') do |file| # get the path to the changes.json file
changes = JSON.parse(file.read()) # and parse its content
end
change = changes["changes"][0]
# write information about changes to the object
obj["changes"] = change ? changes["changes"] : nil
obj["serverVersion"] = changes["serverVersion"]
obj["created"] = change ? change["created"] : nil
obj["user"] = change ? change["user"] : nil
prev = histData[(i - 2).to_s] # get the history data from the previous file version
dataObj["previous"] = is_enable_direct_url == true ? { # write key and url information about previous file version with optional direct url
:fileType => prev["fileType"],
:key => prev["key"],
:url => prev["url"],
:directUrl => prev["directUrl"]
} : {
:fileType => prev["fileType"],
:key => prev["key"],
:url => prev["url"]
}
# write the path to the diff.zip archive with differences in this file version
dataObj["changesUrl"] = DocumentHelper.get_historypath_uri(file_name, i - 1, "diff.zip")
end
if JwtHelper.is_enabled # check if a secret key to generate token exists or not
dataObj["token"] = JwtHelper.encode(dataObj) # encode a payload object into a token and write it to the data object
end
hist.push(obj) # add object dictionary to the hist list
histData[(i - 1).to_s] = dataObj # write data object information to the history data
end
return {
:hist => { # write history information about the current file version to the hist
:currentVersion => cur_ver,
:history => hist
},
:histData => histData
}
end
return nil
end
# get image information
def get_insert_image
insert_image = is_enable_direct_url == true ? {
:fileType => "png", # image file type
:url => DocumentHelper.get_server_url(true) + "/assets/logo.png", # server url to the image
:directUrl => DocumentHelper.get_server_url(false) + "/assets/logo.png" # direct url to the image
} : {
:fileType => "png", # image file type
:url => DocumentHelper.get_server_url(true) + "/assets/logo.png" # server url to the image
}
if JwtHelper.is_enabled # check if a secret key to generate token exists or not
insert_image["token"] = JwtHelper.encode(insert_image) # encode a payload object into a token and write it to the insert_image object
end
return insert_image.to_json.tr("{", "").tr("}","")
end
# get compared file information
def dataDocument
compare_file = is_enable_direct_url == true ? {
:fileType => "docx", # file type
:url => DocumentHelper.get_server_url(true) + "/asset?fileName=sample.docx", # server url to the compared file
:directUrl => DocumentHelper.get_server_url(false) + "/asset?fileName=sample.docx" # direct url to the compared file
} : {
:fileType => "docx", # file type
:url => DocumentHelper.get_server_url(true) + "/asset?fileName=sample.docx" # server url to the compared file
}
if JwtHelper.is_enabled # check if a secret key to generate token exists or not
compare_file["token"] = JwtHelper.encode(compare_file) # encode a payload object into a token and write it to the compare_file object
end
return compare_file
end
# get mail merge recipients information
def dataSpreadsheet
dataSpreadsheet = is_enable_direct_url == true ? {
:fileType => "csv", # file type
:url => DocumentHelper.get_server_url(true) + "/csv", # server url to the mail merge recipients file
:directUrl => DocumentHelper.get_server_url(false) + "/csv" # direct url to the mail merge recipients file
} : {
:fileType => "csv", # file type
:url => DocumentHelper.get_server_url(true) + "/csv" # server url to the mail merge recipients file
}
if JwtHelper.is_enabled # check if a secret key to generate token exists or not
dataSpreadsheet["token"] = JwtHelper.encode(dataSpreadsheet) # encode a payload object into a token and write it to the dataSpreadsheet object
end
return dataSpreadsheet
end
# get users data for mentions
def get_users_mentions
return !@user.id.eql?("uid-0") ? Users.get_users_for_mentions(@user.id) : nil
end
def get_users_info
users_info = []
if !@user.id.eql?("uid-0")
Users.get_all_users().each do |user_info|
u = {
id: user_info.id,
name: user_info.name,
email: user_info.email,
group: user_info.group,
reviewGroups: user_info.reviewGroups,
commentGroups: user_info.commentGroups,
userInfoGroups: user_info.userInfoGroups,
favorite: user_info.favorite,
deniedPermissions: user_info.deniedPermissions,
descriptions: user_info.descriptions,
templates: user_info.templates,
avatar: user_info.avatar
}
u["image"] = user_info.avatar ? "#{DocumentHelper.get_server_url(true)}/assets/#{user_info.id}.png" : nil
users_info.push(u)
end
return users_info
end
end
# get users data for protect
def get_users_protect
return !@user.id.eql?("uid-0") ? Users.get_users_for_protect(@user.id) : nil
end
# get direct url existence flag
def is_enable_direct_url
return @direct_url != nil && @direct_url == "true"
end
end