278 lines
10 KiB
Python
278 lines
10 KiB
Python
# w.c.s. - web application for online forms
|
|
# Copyright (C) 2005-2013 Entr'ouvert
|
|
#
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, see <http://www.gnu.org/licenses/>.
|
|
|
|
import xml.etree.ElementTree as ET
|
|
|
|
from quixote import get_publisher
|
|
from quixote.html import TemplateIO, htmltext
|
|
|
|
from wcs.admin.fields import FieldDefPage, FieldsDirectory
|
|
from wcs.formdata import get_dict_with_varnames
|
|
from wcs.formdef import FormDef, lax_int
|
|
from wcs.forms.common import FileDirectory
|
|
from wcs.forms.root import FormPage
|
|
from wcs.workflows import RedisplayFormException, WorkflowStatusItem, register_item_class
|
|
|
|
from ..qommon import _
|
|
from ..qommon.form import SingleSelectWidget, VarnameWidget, WidgetList
|
|
|
|
|
|
def lookup_wf_form_file(self, filename):
|
|
# supports for URLs such as /$formdata/$id/files/form-$formvar-$fieldvar/test.txt
|
|
try:
|
|
literal, formvar, fieldvar = self.reference.split('-')
|
|
except ValueError:
|
|
return
|
|
if literal != 'form':
|
|
return
|
|
try:
|
|
return self.formdata.workflow_data['%s_var_%s_raw' % (formvar, fieldvar)]
|
|
except KeyError:
|
|
return
|
|
|
|
|
|
class WorkflowFormFieldsFormDef(FormDef):
|
|
lightweight = False
|
|
|
|
def __init__(self, item):
|
|
self.item = item
|
|
self.fields = []
|
|
self.id = None
|
|
|
|
@property
|
|
def name(self):
|
|
return _('Form action in workflow "%s"') % self.item.parent.parent.name
|
|
|
|
def get_admin_url(self):
|
|
base_url = get_publisher().get_backoffice_url()
|
|
return '%s/workflows/%s/status/%s/items/%s/fields/' % (
|
|
base_url,
|
|
self.item.parent.parent.id,
|
|
self.item.parent.id,
|
|
self.item.id,
|
|
)
|
|
|
|
def store(self, comment=None):
|
|
self.item.parent.parent.store(comment=comment)
|
|
|
|
|
|
class WorkflowFormFieldDefPage(FieldDefPage):
|
|
section = 'workflows'
|
|
blacklisted_attributes = ['display_locations']
|
|
|
|
def get_deletion_extra_warning(self):
|
|
return None
|
|
|
|
|
|
class WorkflowFormFieldsDirectory(FieldsDirectory):
|
|
section = 'workflows'
|
|
support_import = False
|
|
blacklisted_types = ['page', 'computed']
|
|
field_def_page_class = WorkflowFormFieldDefPage
|
|
|
|
|
|
class FormWorkflowStatusItem(WorkflowStatusItem):
|
|
description = _('Form')
|
|
key = 'form'
|
|
category = 'interaction'
|
|
ok_in_global_action = False
|
|
endpoint = False
|
|
waitpoint = True
|
|
redirect_after_submit_url = 'fields/'
|
|
submit_button_label = _('Submit and go to fields edition')
|
|
|
|
by = []
|
|
formdef = None
|
|
varname = None
|
|
|
|
@classmethod
|
|
def init(cls):
|
|
if 'lookup_wf_form_file' not in FileDirectory._lookup_methods:
|
|
FileDirectory._lookup_methods.append('lookup_wf_form_file')
|
|
FileDirectory.lookup_wf_form_file = lookup_wf_form_file
|
|
|
|
def add_parameters_widgets(self, form, parameters, prefix='', formdef=None, **kwargs):
|
|
super().add_parameters_widgets(form, parameters, prefix=prefix, formdef=formdef, **kwargs)
|
|
if 'by' in parameters:
|
|
form.add(
|
|
WidgetList,
|
|
'%sby' % prefix,
|
|
title=_('To'),
|
|
element_type=SingleSelectWidget,
|
|
value=self.by,
|
|
add_element_label=self.get_add_role_label(),
|
|
element_kwargs={
|
|
'render_br': False,
|
|
'options': [(None, '---', None)] + self.get_list_of_roles(include_logged_in_users=False),
|
|
},
|
|
)
|
|
if 'varname' in parameters:
|
|
form.add(
|
|
VarnameWidget,
|
|
'%svarname' % prefix,
|
|
required=True,
|
|
title=_('Identifier'),
|
|
value=self.varname,
|
|
hint=_('This is used as prefix for form fields variable names.'),
|
|
)
|
|
|
|
def get_parameters(self):
|
|
return ('by', 'varname', 'condition')
|
|
|
|
def clean_varname(self, form):
|
|
widget = form.get_widget('varname')
|
|
new_value = widget.parse()
|
|
|
|
if new_value == 'form' or new_value.startswith('form_'):
|
|
widget.set_error(_('Wrong identifier detected: "form" prefix is forbidden.'))
|
|
return True
|
|
|
|
return False
|
|
|
|
def migrate(self):
|
|
changed = False
|
|
if self.formdef and self.formdef.fields:
|
|
for field in self.formdef.fields:
|
|
changed |= field.migrate()
|
|
return changed
|
|
|
|
def export_to_xml(self, charset, include_id=False):
|
|
item = WorkflowStatusItem.export_to_xml(self, charset, include_id=include_id)
|
|
if not hasattr(self, 'formdef') or not self.formdef or not self.formdef.fields:
|
|
return item
|
|
formdef = ET.SubElement(item, 'formdef')
|
|
|
|
# we give a name to the formdef because it is required in the formdef
|
|
# xml import.
|
|
ET.SubElement(formdef, 'name').text = '-'
|
|
|
|
fields = ET.SubElement(formdef, 'fields')
|
|
for field in self.formdef.fields:
|
|
fields.append(field.export_to_xml(charset=charset, include_id=include_id))
|
|
return item
|
|
|
|
def init_with_xml(self, elem, charset, include_id=False, snapshot=False, check_datasources=True):
|
|
super().init_with_xml(
|
|
elem, charset, include_id=include_id, snapshot=snapshot, check_datasources=check_datasources
|
|
)
|
|
el = elem.find('formdef')
|
|
if el is None:
|
|
return
|
|
# we can always include id in the formdef export as it lives in
|
|
# a different space, isolated from other formdefs.
|
|
imported_formdef = FormDef.import_from_xml_tree(
|
|
el, include_id=True, snapshot=snapshot, check_datasources=check_datasources
|
|
)
|
|
self.formdef = WorkflowFormFieldsFormDef(item=self)
|
|
self.formdef.fields = imported_formdef.fields
|
|
if self.formdef.max_field_id is None and self.formdef.fields:
|
|
self.formdef.max_field_id = max([lax_int(x.id) for x in self.formdef.fields])
|
|
|
|
def q_admin_lookup(self, workflow, status, component, html_top):
|
|
if component == 'fields':
|
|
if not self.formdef:
|
|
self.formdef = WorkflowFormFieldsFormDef(item=self)
|
|
if workflow.is_readonly():
|
|
self.formdef.readonly = True
|
|
fields_directory = WorkflowFormFieldsDirectory(self.formdef)
|
|
if self.varname:
|
|
fields_directory.field_var_prefix = '%s_var_' % self.varname
|
|
fields_directory.html_top = html_top
|
|
return fields_directory
|
|
return None
|
|
|
|
def prefix_form_fields(self):
|
|
for field in self.formdef.fields:
|
|
try:
|
|
field.id = '%s_%s' % (self.varname, int(field.id))
|
|
except ValueError:
|
|
# already prefixed
|
|
pass
|
|
|
|
def fill_form(self, form, formdata, user, displayed_fields=None, **kwargs):
|
|
if not self.formdef:
|
|
return
|
|
self.prefix_form_fields()
|
|
self.formdef.var_prefix = self.varname
|
|
self.formdef.add_fields_to_form(form, displayed_fields=displayed_fields)
|
|
if 'submit' not in form._names:
|
|
form.add_submit('submit', _('Submit'))
|
|
|
|
# put varname in a form attribute so it can be used in templates to
|
|
# identify the form.
|
|
form.varname = self.varname
|
|
|
|
formdata.feed_session()
|
|
|
|
self.formdef.set_live_condition_sources(form, self.formdef.fields)
|
|
|
|
if form.is_submitted():
|
|
# skip prefilling part when form is being submitted
|
|
return
|
|
|
|
fields = self.formdef.fields
|
|
if displayed_fields is not None:
|
|
fields = displayed_fields
|
|
|
|
FormPage.apply_field_prefills({}, form, fields)
|
|
|
|
def evaluate_live_form(self, form, formdata, user):
|
|
if not self.formdef:
|
|
return
|
|
workflow_data = {}
|
|
self.prefix_form_fields()
|
|
for k, v in get_dict_with_varnames(
|
|
self.formdef.fields, self.formdef.get_data(form), varnames_only=True
|
|
).items():
|
|
workflow_data['%s_%s' % (self.varname, k)] = v
|
|
formdata.update_workflow_data(workflow_data)
|
|
|
|
def submit_form(self, form, formdata, user, evo):
|
|
if not self.formdef:
|
|
return
|
|
if form.get_submit() is True:
|
|
# non-submit button, maybe a "add block" button, look for them.
|
|
for widget in form.widgets:
|
|
if isinstance(widget, WidgetList): # BlockWidget
|
|
add_element_widget = widget.get_widget('add_element')
|
|
if add_element_widget and add_element_widget.parse():
|
|
raise RedisplayFormException()
|
|
if form.get_submit() == 'submit' and not form.has_errors():
|
|
self.evaluate_live_form(form, formdata, user)
|
|
formdata.store()
|
|
get_publisher().substitutions.unfeed(lambda x: x.__class__.__name__ == 'ConditionVars')
|
|
|
|
def get_parameters_view(self):
|
|
r = TemplateIO(html=True)
|
|
r += super().get_parameters_view()
|
|
if self.formdef and self.formdef.fields:
|
|
r += htmltext('<p>%s</p>') % _('Form:')
|
|
r += htmltext('<ul>')
|
|
for field in self.formdef.fields:
|
|
r += htmltext('<li>')
|
|
r += field.label
|
|
if getattr(field, 'required', False):
|
|
r += htmltext(' (%s)') % _('required')
|
|
r += htmltext(' (%s)') % field.get_type_label()
|
|
if field.varname:
|
|
r += htmltext(' (<tt>%s</tt>)') % field.varname
|
|
r += htmltext('</li>')
|
|
r += htmltext('</ul>')
|
|
return r.getvalue()
|
|
|
|
|
|
register_item_class(FormWorkflowStatusItem)
|