提交文件

阅读并理解如何文件在继续之前处理。

提交文件用于在编辑工作流程中跟踪文件的进展。例如，一个文件可能在提交过程中由作者上传，由编辑推进到审查阶段，由作者再次修改，并由copyyeditor下载。

每一个SubmissionFile表示这些文件阶段中的一个文件。例如，当编辑器将一个文件从Submission阶段提升到Review阶段时，有两个阶段SubmissionFile引用同一文件的对象。

submission_file_id	文件标识	文件存储阶段
1	82	SUBMISSION_FILE_SUBMISSION
2	82	SUBMISSION_FILE_REVIEW_FILE

提交文件可以修改。例如，处于审阅阶段的文件可能需要匿名，然后才能发送供审阅。当编辑器将修改后的副本作为修订上载时文件标识是换了新的吗SubmissionFile没有创建。

submission_file_id	文件标识	文件存储阶段
1	82	SUBMISSION_FILE_SUBMISSION
2	83	SUBMISSION_FILE_REVIEW_FILE

编辑和助手可以访问提交文件的活动日志中的文件的所有修订。

文件阶段＃

所有提交文件分配到一个文件阶段。文件阶段与提交工作流阶段重叠，但每个工作流阶段可以有多个文件阶段。例如，评审工作流阶段有一个文件阶段用于发送给评审人员的文件，另一个文件阶段用于作者上传的修订。

大多数文件阶段对应于提交工作流中的文件列表，如Review files、copyededited files或Production Ready files。其他文件阶段用于识别附属于讨论、审查作业和galleys或出版物格式的提交文件。

文件阶段	描述
`SUBMISSION_FILE_SUBMISSION`	提交期间上载的文件。
`SUBMISSION_FILE_REVIEW_FILE`	发送供同行审查的文件。
`SUBMISSION_FILE_REVIEW_ATTACHMENT`	由审阅者上载的文件。
`SUBMISSION_FILE_ATTACHMENT`	编辑在要求修改的电子邮件中所附的文件。这些文件不会显示在作者指示板中。
`提交\文件\审查\修订`	作者经同行评审后上传的修订版本。
`SUBMISSION_FILE_INTERNAL_REVIEW_FILE`	提交内部审核的文件。仅用于OMP。
`提交\文件\内部\审核\修订`	作者经同行评审后上传的修订版本。仅用于OMP。
`SUBMISSION_FILE_FINAL`	要复制和编辑的文件。
`SUBMISSION_FILE_COPYEDIT`	已复制编辑的文件。
`SUBMISSION_FILE_PRODUCTION_READY`	准备排字的文件。例如，准备转换为PDF的文件。
`SUBMISSION_FILE_PROOF`	附在厨房(OJS/OPS)或出版格式(OMP)的文件。
`SUBMISSION_FILE_DEPENDENT`	永远不会直接下载，而是附加到另一个文件的文件。例如，将CSS文件作为依赖文件上传至HTML文件。当检测到HTML或XML文件时，相关文件将被单独上传。
`SUBMISSION_FILE_QUERY`	文件上传到讨论。
`SUBMISSION_FILE_NOTE`	不使用此文件阶段。

分配给审阅文件或修订阶段的文件必须与审阅轮次关联。

       $submissionFile->setData（“fileStage”，SUBMISSION_FILE_REVIEW_FILE）;$submissionFile->setData（“assocType”，助理类型审查轮）;$submissionFile->setData（“assocId”，reviewRoundId美元）;
      

分配给SUBMISSION_FILE_QUERY文件阶段必须与查询记录相关联。

       $submissionFile->setData（“fileStage”，SUBMISSION_FILE_QUERY）;$submissionFile->setData（“assocType”，助理类型注释）;$submissionFile->setData（“assocId”，$noteId）;
      

提交文件服务＃

使用提交文件服务添加、编辑和删除提交文件。这个helper类确保保存事件日志以跟踪修订、标识文件的上传者和更新挂起的任务。

使用文件服务创建一个文件。然后分配文件ID到SubmissionFile．

       文件标识美元＝服务：：得到（“文件”）->添加（$source，美元的目的地）;$submissionFile＝服务：：得到（“submissionFile”）->编辑（$submissionFile，［“文件标识”=>文件标识美元，“uploaderUserId”=>应用程序：：得到（）->getRequest（）->getUser（）->getId（），］）;
      

如果没有必需的属性，则无法创建提交文件。

       $submissionFile＝DAORegistry：：格道（“SubmissionFileDAO”）->newDataObject（）;$submissionFile->setAllData（[“fileStage”=>SUBMISSION_FILE_REVIEW_FILE，“文件标识”=>文件标识美元，“姓名”=>［primaryLocale美元=>“my-filename.txt”，]，“submissionId”=>$submissionId，“uploaderUserId”=>$userId，]）;
      

在添加或编辑提交文件之前验证它。

       $params＝［“fileStage”=>SUBMISSION_FILE_REVIEW_FILE，“文件标识”=>文件标识美元，“姓名”=>［primaryLocale美元=>“my-filename.txt”，]，“submissionId”=>$submissionId，“uploaderUserId”=>$userId，]；$errors＝服务：：得到（“submissionFile”）->验证（VALIDATE_ACTION_ADD，$params，allowedLocales美元，primaryLocale美元）;如果（空（$errors））｛$submissionFile＝DAORegistry：：格道（“SubmissionFileDAO”）->newDataObject（）;submisssionFile美元->setAllData（$params）;$submissionFile＝服务：：得到（“submissionFile”）->添加（$submissionFile，美元的请求）;｝
      

组件类型＃

提交文件应分配一个genreId．这与提交组件类型之一相匹配，如Article Text、Data Set或Book Monograph。

       $submissionFile->setData（“genreId”，1）;
      

文件访问＃

根据用户对提交文件的分配授予对提交文件的访问权限。例如，作者不能访问由审阅者上载的文件。copyeditor只能在CopyEdit阶段访问文件。

使用服务::getAssignedFileStages ()方法来确定管理员、子编辑器、助理或作者可以访问哪些文件阶段。

       $stageAssignments＝这个美元->getAuthorizedContextObject（ASSOC_TYPE_ACCESSIBLE_WORKFLOW_STAGES）;assignedFileStages美元＝服务：：得到（“submissionFile”）->getAssignedFileStages（$stageAssignments，SUBMISSION_FILE_ACCESS_READ）;
      

使用ReviewFilesDAO检查审查者是否可以访问文件。

       $reviewFilesDao＝DAORegistry：：格道（“ReviewFilesDAO”）;/* @var $reviewFilesDao reviewFilesDao */reviewerCanAccess美元＝$reviewFilesDao->检查（$reviewAssignment->getId（），$submissionFile->getId());
      

使用克雷道检查用户是否可以访问讨论文件。

       如果（$submissionFile->getData（“fileStage”）＝＝＝SUBMISSION_FILE_QUERY＆＆$submissionFile->getData（“assocType”）＝＝＝助理类型注释）｛$queryDao＝DAORegistry：：格道（“克利道”）;/* @var $queryDaonoteDao美元＝DAORegistry：：格道（“NoteDAO”）;/* @var $noteDao$user＝应用程序：：得到（）->getRequest（）->getUser（）;美元的注意＝noteDao美元->getById（$submissionFile->getData（“assocId”））;如果（$queryDao->getParticipantIds（美元的注意->getAssocId（），$user->getId()))｛//用户可以访问这个提交文件｝｝
      

下表描述了授予用户对提交文件的访问权限的时间。

文件阶段	经理	子编辑器¹	助理¹	作者	评论家
`SUBMISSION_FILE_SUBMISSION`	✔	✔	✔	✔²
`SUBMISSION_FILE_REVIEW_FILE`	✔	✔	✔	✔^4，8	✔^7、8
`SUBMISSION_FILE_REVIEW_ATTACHMENT`	✔	✔	✔	✔⁴	✔
`SUBMISSION_FILE_ATTACHMENT`	✔	✔	✔	✔
`提交\文件\审查\修订`	✔	✔	✔	✔^3.
`SUBMISSION_FILE_INTERNAL_REVIEW_FILE`⁶	✔	✔	✔	✔^4，8	✔^7、8
`提交\文件\内部\审核\修订`⁶	✔	✔	✔	✔^3.
`SUBMISSION_FILE_FINAL`	✔	✔	✔
`SUBMISSION_FILE_COPYEDIT`	✔	✔	✔	✔⁸
`SUBMISSION_FILE_PRODUCTION_READY`	✔	✔	✔
`SUBMISSION_FILE_PROOF`	✔	✔	✔	✔⁸
`SUBMISSION_FILE_DEPENDENT`⁹	？	？	？	？	？
`SUBMISSION_FILE_QUERY`⁵	？	？	？	？	？

当用户组被分配到相关工作流阶段时，将授予访问权限。
在提交完成之前授予访问权限。
在请求修订后授予访问权限。
在编辑器决策期间，当文件已与作者共享时，将授予访问权限。这个可视中的列submission_filesTable设置为true。
当用户被分配给正确的查询时，就授予访问权限。用户只能删除附加在自己查询注释上的文件。
仅用于OMP。
当文件已与评审分配共享时，将授予访问权限。将一个条目添加到review_files表格
读访问。
如果用户有权访问父文件，则授予对从属文件的访问权限。

提交文件

文件阶段＃

提交文件服务＃

组件类型＃

文件访问＃

总结