Document Requeue Job

This git repository represents the University of Arizona (the UA)'s Document Requeue Job modification to KFS 3.0, in the form of patch files (generated by svn diff), liquibase scripts, and documentation. This "patch package" is designed to be informative to technical developers in the position to apply patch files to the java source code of KFS. In order to better serve such an endeavor, this README contains several informative sections:

• List of Jiras - This list contains every Jira ticket at the University of Arizona that relates to this modification. It provides reverse documentation back to the developers at the UA in case of questions regarding how this patch package was created.
• List of Liquibase Changesets - This list contains any liquibase changeset files that were associated with this modification.
• List of Patch Files - This is a list of each patch file that needs to be applied to the KFS source code in order to realize the modification. This list does not include patch files for revisions that didn't touch the trunk/ at the UA. Before a modification was merged with trunk/, it may have been tweaked, reworked, refactored, code reviewed, etc, in handfuls of revisions in a feature branch.
• List of Revisions - This list contains every revision associated with this modification. Many of which, as you will see, only touch files in a feature branch. The revisions that actually made it into the actual modification touch files in trunk/. The list of patch files is a better reference of which are these revisions.
• Lists of Files - These lists contain every file that was created, modified, or deleted for this enhancement.
• List of Local Files - This list contains any extra files that were not explicitly included in the enhancement. The enhancement may rely on these files, and they may not be a part of the original release. They may also include functional and technical specifications.
• List of Known Issues - This list contains known issues related to this enhancement.
• List of Post-Modification Changes - This list contains revision numbers that are not included in the patches, or raw patches, but that touched one or more key files involved in this modification.

Disclaimer

The permissions, etc. required to run the Document Requeue Job are included in the Extra Local Files list.

Jiras

This is a list of Jira tickets at the University of Arizona that relate to this modification. The subversion revisions tagged against each such jira are also listed:

• KFSI-6079: (The main jira for this modification)
  revisions: #23400, #25011, #25012, #25013, #25014, #25015, #25016, #25017, #25018, #25019, #25275, #25277, #25278

Liquibase Changesets

There are no liquibase changesets associated with this modification.

Patch Files

This is a list of all of the patches for revisions that affected files in trunk/. The filenames in each has been modified, for easy digestion. UA's subversion server manages many Kuali projects in one Subversion project, so a file path like:

financial-system/kfs/trunk/src/org/kuali/kfs...

has been modified to:

src/org/kuali/kfs...

• patches/23400_KFSI-6079_cleaned.diff is the patch file for #23400.
• patches/25011-25019_KFSI-6079_cleaned.diff is the patch file for #25011 through #25019.
• patches/25275_KFSI-6079_cleaned.diff is the patch file for #25275.
• patches/25277-25278_KFSI-6079_cleaned.diff is the patch file for #25277 through #25278.

Revisions

This is an ordered list of revisions that relate to this modification. There may not be a patch file for every revision listed below for the following reasons:

• A revision might only affect a branch, perhaps one where development primarily took place. Any changes that finally made it into trunk/ will be seen in revisions that specifically touch files in trunk/. Therefore, we do not create patch files for revisions that only affect a branch.
• A revision might only include a liquibase changeset that is executed by some automated process. Since each institution maintains different revision controls on their database, liquibase changesets are not provided as patches. They are instead presented as intact files under the liquibase-changesets/ directory.

Here is a printout of svn log -v for each revision.

• #23400 was committed against KFSI-6079 on 2011-12-19 22:24:58 UTC by [email protected].

  KFSI-6079 KITT-3041 batch job to requeue docs

• #25011 was committed against KFSI-6079 on 2012-03-28 17:19:10 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25012 was committed against KFSI-6079 on 2012-03-28 17:19:26 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25013 was committed against KFSI-6079 on 2012-03-28 17:19:41 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25014 was committed against KFSI-6079 on 2012-03-28 17:20:05 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25015 was committed against KFSI-6079 on 2012-03-28 17:20:55 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25016 was committed against KFSI-6079 on 2012-03-28 17:21:13 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25017 was committed against KFSI-6079 on 2012-03-28 17:21:25 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25018 was committed against KFSI-6079 on 2012-03-28 17:21:46 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25019 was committed against KFSI-6079 on 2012-03-28 17:22:18 UTC by [email protected].

  KFSI-6079 Batch Requeuer in RQ namespace

• #25275 was committed against KFSI-6079 on 2012-04-16 21:10:58 UTC by [email protected].

  KFSI-6079 Batch job to requeue Stuck Documents

• #25277 was committed against KFSI-6079 on 2012-04-16 22:28:59 UTC by [email protected].

  KFSI-6079 Batch job to requeue Stuck Documents

• #25278 was committed against KFSI-6079 on 2012-04-16 22:29:41 UTC by [email protected].

  KFSI-6079 Batch job to requeue Stuck Documents

Files

Files created for this modification (13 files)

/build/external/work/reports/rq
/build/external/work/staging/rq
/work/src/edu/arizona/kfs/rq
/work/src/edu/arizona/kfs/rq/batch
/work/src/edu/arizona/kfs/rq/batch/DocumentRequeueStep.java
/work/src/edu/arizona/kfs/rq/dataaccess
/work/src/edu/arizona/kfs/rq/dataaccess/DocumnetRequeueDao.java
/work/src/edu/arizona/kfs/rq/dataaccess/impl
/work/src/edu/arizona/kfs/rq/dataaccess/impl/DocumentRequeueDaoOjb.java
/work/src/edu/arizona/kfs/rq/spring-rq.xml
/work/src/edu/arizona/kfs/sys/batch/DocumentRequeueStep.java
/work/src/edu/arizona/kfs/sys/dataaccess/DocumnetRequeueDao.java
/work/src/edu/arizona/kfs/sys/dataaccess/impl/DocumentRequeueDaoOjb.java

Files modified for this modification (2 files)

/arizona-build.properties
/work/src/edu/arizona/kfs/sys/spring-sys.xml

Extra Local Files

Extra local files for this modification that have been included for some reason or another. Most likely, these files are not code, but instead might be specifications, or other documentation. (1 files)

• extra_files/permissions-etc.markdown

Known Issues

These are issues, related to this enhancement, that are currently documented and open at the UA. the UA may be contacted for more information regarding each issue (Has it been prioritized? Has work begun? How to recreate? ...). Any institution receiving this enhancement is also welcome to fix any known issue and contribute back to the UA. :) (1 known issues)

• KATTS-506: "Batch requeue report needs column heading changed and a sum total of requeued documents"
  Resolution as of Aug 1, 2012: Unresolved
  Priority as of Aug 1, 2012: Minor

Post Mod Changes

For each file that was changed or added for this modification, I've looked at its history in subversion (svn log <file_name>) to find whether later fixes were committed against this modification that I might have missed. There were some :) They may be fixes to the modification, or further enhancements, or changes completely unrelated. Please contact the UA for more information about a given revision number, or Jira ticket. Here they are:

• #26748 touches /work/src/edu/arizona/kfs/rq/dataaccess/impl/DocumentRequeueDaoOjb.java.

• #26912 touches /work/src/edu/arizona/kfs/sys/spring-sys.xml.

  KATTS-843 Added file-based, remote batch job invoker class as a TimerTask that checks for files of a certain format and invokes the appropriate batch job. Also checks the status of invoked jobs.

(2 revisions)

The following files were ignored here:

.classpath
arizona-ApplicationResources.properties

This means, for example, that .classpath was changed for this modification, but .classpath's history was not used to build this list of revisions.