e007af6b3f
Change "checkin" usage to "check_in".
Update URL parameters to the "_id" form.
Add support to checkout and check in multiple documents.
Optimize queries that used an ID list of documents for
filtering using values_list('pk', flat=True). These
queries now use .values('pk') as a subquery.
Add pre save hooks to block new document version uploads.
Signed-off-by: Roberto Rosario <Roberto.Rosario@mayan-edms.com>
126 lines
3.9 KiB
Python
126 lines
3.9 KiB
Python
from __future__ import unicode_literals
|
|
|
|
import logging
|
|
|
|
from django.conf import settings
|
|
from django.core.exceptions import ValidationError
|
|
from django.db import models, transaction
|
|
from django.urls import reverse
|
|
from django.utils.encoding import python_2_unicode_compatible
|
|
from django.utils.timezone import now
|
|
from django.utils.translation import ugettext_lazy as _
|
|
|
|
from mayan.apps.documents.models import Document
|
|
|
|
from .events import event_document_check_out
|
|
from .exceptions import DocumentAlreadyCheckedOut
|
|
from .managers import DocumentCheckoutManager, NewVersionBlockManager
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
@python_2_unicode_compatible
|
|
class DocumentCheckout(models.Model):
|
|
"""
|
|
Model to store the state and information of a document checkout.
|
|
"""
|
|
document = models.OneToOneField(
|
|
on_delete=models.CASCADE, to=Document, verbose_name=_('Document')
|
|
)
|
|
checkout_datetime = models.DateTimeField(
|
|
auto_now_add=True, verbose_name=_('Check out date and time')
|
|
)
|
|
expiration_datetime = models.DateTimeField(
|
|
help_text=_(
|
|
'Amount of time to hold the document checked out in minutes.'
|
|
),
|
|
verbose_name=_('Check out expiration date and time')
|
|
)
|
|
user = models.ForeignKey(
|
|
on_delete=models.CASCADE, to=settings.AUTH_USER_MODEL,
|
|
verbose_name=_('User')
|
|
)
|
|
block_new_version = models.BooleanField(
|
|
default=True,
|
|
help_text=_(
|
|
'Do not allow new version of this document to be uploaded.'
|
|
),
|
|
verbose_name=_('Block new version upload')
|
|
)
|
|
|
|
objects = DocumentCheckoutManager()
|
|
|
|
class Meta:
|
|
ordering = ('pk',)
|
|
verbose_name = _('Document checkout')
|
|
verbose_name_plural = _('Document checkouts')
|
|
|
|
def __str__(self):
|
|
return '{}: {} - {} by {}'.format(
|
|
self.document, self.checkout_datetime, self.expiration_datetime,
|
|
self.user
|
|
)
|
|
|
|
def clean(self):
|
|
if self.expiration_datetime < now():
|
|
raise ValidationError(
|
|
_('Check out expiration date and time must be in the future.')
|
|
)
|
|
|
|
def delete(self, *args, **kwargs):
|
|
with transaction.atomic():
|
|
NewVersionBlock.objects.unblock(document=self.document)
|
|
super(DocumentCheckout, self).delete(*args, **kwargs)
|
|
|
|
def get_absolute_url(self):
|
|
return reverse(
|
|
viewname='checkout:checkout_info',
|
|
kwargs={'document_id': self.document.pk}
|
|
)
|
|
|
|
def natural_key(self):
|
|
return self.document.natural_key()
|
|
natural_key.dependencies = ['documents.Document']
|
|
|
|
def save(self, *args, **kwargs):
|
|
new_checkout = not self.pk
|
|
if not new_checkout or self.document.is_checked_out():
|
|
raise DocumentAlreadyCheckedOut(
|
|
_('Document already checked out.')
|
|
)
|
|
|
|
with transaction.atomic():
|
|
result = super(DocumentCheckout, self).save(*args, **kwargs)
|
|
if new_checkout:
|
|
event_document_check_out.commit(
|
|
actor=self.user, target=self.document
|
|
)
|
|
if self.block_new_version:
|
|
NewVersionBlock.objects.block(self.document)
|
|
|
|
logger.info(
|
|
'Document "%s" checked out by user "%s"',
|
|
self.document, self.user
|
|
)
|
|
|
|
return result
|
|
|
|
|
|
class NewVersionBlock(models.Model):
|
|
"""
|
|
Model to keep track of which documents have new version upload restricted.
|
|
"""
|
|
document = models.ForeignKey(
|
|
on_delete=models.CASCADE, to=Document, verbose_name=_('Document')
|
|
)
|
|
|
|
objects = NewVersionBlockManager()
|
|
|
|
class Meta:
|
|
verbose_name = _('New version block')
|
|
verbose_name_plural = _('New version blocks')
|
|
|
|
def natural_key(self):
|
|
return self.document.natural_key()
|
|
natural_key.dependencies = ['documents.Document']
|