1040 lines
45 KiB
Python
1040 lines
45 KiB
Python
'''This package contains base classes for wrappers that hide to the Appy
|
|
developer the real classes used by the underlying web framework.'''
|
|
|
|
# ------------------------------------------------------------------------------
|
|
import os, os.path, mimetypes
|
|
import appy.pod
|
|
from appy.gen import Field, Search, Ref, String, WorkflowAnonymous
|
|
from appy.gen.indexer import defaultIndexes
|
|
from appy.gen.utils import createObject
|
|
from appy.px import Px
|
|
from appy.shared.utils import getOsTempFolder, executeCommand, \
|
|
normalizeString, sequenceTypes
|
|
from appy.shared.xml_parser import XmlMarshaller
|
|
from appy.shared.csv_parser import CsvMarshaller
|
|
|
|
# Some error messages ----------------------------------------------------------
|
|
WRONG_FILE_TUPLE = 'This is not the way to set a file. You can specify a ' \
|
|
'2-tuple (fileName, fileContent) or a 3-tuple (fileName, fileContent, ' \
|
|
'mimeType).'
|
|
FREEZE_ERROR = 'Error while trying to freeze a "%s" file in POD field ' \
|
|
'"%s" (%s).'
|
|
FREEZE_FATAL_ERROR = 'A server error occurred. Please contact the system ' \
|
|
'administrator.'
|
|
|
|
# ------------------------------------------------------------------------------
|
|
class AbstractWrapper(object):
|
|
'''Any real Appy-managed Zope object has a companion object that is an
|
|
instance of this class.'''
|
|
|
|
# Buttons for going to next/previous objects if this one is among bunch of
|
|
# referenced or searched objects. currentNumber starts with 1.
|
|
pxNavigateSiblings = Px('''
|
|
<div if="req.get('nav', None)" var2="ni=ztool.getNavigationInfo()">
|
|
<!-- Go to the source URL (search or referred object) -->
|
|
<a if="ni.sourceUrl" href=":ni.sourceUrl"><img
|
|
var="gotoSource=_('goto_source');
|
|
goBack=ni.backText and ('%s - %s' % (ni.backText, gotoSource)) \
|
|
or gotoSource"
|
|
src=":url('gotoSource')" title=":goBack"/></a>
|
|
|
|
<!-- Go to the first page -->
|
|
<a if="ni.firstUrl" href=":ni.firstUrl"><img title=":_('goto_first')"
|
|
src=":url('arrowLeftDouble')"/></a>
|
|
|
|
<!-- Go to the previous page -->
|
|
<a if="ni.previousUrl" href=":ni.previousUrl"><img
|
|
title=":_('goto_previous')" src=":url('arrowLeftSimple')"/></a>
|
|
|
|
<!-- Explain which element is currently shown -->
|
|
<span class="discreet">
|
|
<x>:ni.currentNumber</x> <b>//</b>
|
|
<x>:ni.totalNumber</x>
|
|
</span>
|
|
|
|
<!-- Go to the next page -->
|
|
<a if="ni.nextUrl" href=":ni.nextUrl"><img title=":_('goto_next')"
|
|
src=":url('arrowRightSimple')"/></a>
|
|
|
|
<!-- Go to the last page -->
|
|
<a if="ni.lastUrl" href=":ni.lastUrl"><img title=":_('goto_last')"
|
|
src=":url('arrowRightDouble')"/></a>
|
|
</div>''')
|
|
|
|
pxNavigationStrip = Px('''
|
|
<table width="100%" class="navigate">
|
|
<tr>
|
|
<!-- Breadcrumb -->
|
|
<td var="breadcrumb=zobj.getBreadCrumb()" class="breadcrumb">
|
|
<x for="bc in breadcrumb" var2="nb=loop.bc.nb">
|
|
<img if="nb != 0" src=":url('to')"/>
|
|
<!-- Display only the title of the current object -->
|
|
<span if="nb == len(breadcrumb)-1">:bc.title</span>
|
|
<!-- Display a link for parent objects -->
|
|
<a if="nb != len(breadcrumb)-1" href=":bc.url">:bc.title</a>
|
|
</x>
|
|
</td>
|
|
<!-- Object navigation -->
|
|
<td align=":dright">:obj.pxNavigateSiblings</td>
|
|
</tr>
|
|
</table>''')
|
|
|
|
# The template PX for all pages.
|
|
pxTemplate = Px('''
|
|
<html var="ztool=tool.o; user=tool.user;
|
|
obj=obj or ztool.getHomeObject();
|
|
zobj=obj and obj.o or None;
|
|
isAnon=user.login=='anon'; app=ztool.getApp();
|
|
appFolder=app.data; url = ztool.getIncludeUrl;
|
|
appName=ztool.getAppName(); _=ztool.translate;
|
|
req=ztool.REQUEST; resp=req.RESPONSE;
|
|
lang=ztool.getUserLanguage(); q=ztool.quote;
|
|
layoutType=ztool.getLayoutType();
|
|
showPortlet=ztool.showPortlet(zobj, layoutType);
|
|
dir=ztool.getLanguageDirection(lang);
|
|
discreetLogin=ztool.getProductConfig(True).discreetLogin;
|
|
dleft=(dir == 'ltr') and 'left' or 'right';
|
|
dright=(dir == 'ltr') and 'right' or 'left';
|
|
x=resp.setHeader('Content-type', ztool.xhtmlEncoding);
|
|
x=resp.setHeader('Expires', 'Thu, 11 Dec 1975 12:05:00 GMT+2');
|
|
x=resp.setHeader('Content-Language', lang)"
|
|
dir=":ztool.getLanguageDirection(lang)">
|
|
<head>
|
|
<title>:_('app_name')</title>
|
|
<link rel="icon" type="image/x-icon" href="/favicon.ico"/>
|
|
<x for="name in ztool.getGlobalCssJs()">
|
|
<link if="name.endswith('.css') and \
|
|
not ((dir == 'ltr') and (name == 'appyrtl.css'))"
|
|
rel="stylesheet" type="text/css" href=":url(name)"/>
|
|
<script if="name.endswith('.js')" type="text/javascript"
|
|
src=":url(name)"></script>
|
|
</x>
|
|
</head>
|
|
<body>
|
|
<!-- Google Analytics stuff, if enabled -->
|
|
<script var="gaCode=ztool.getGoogleAnalyticsCode()" if="gaCode"
|
|
type="text/javascript">:gaCode</script>
|
|
|
|
<!-- Grey background shown when popups are shown -->
|
|
<div id="grey" class="grey"></div>
|
|
|
|
<!-- Popup for confirming an action -->
|
|
<div id="confirmActionPopup" class="popup">
|
|
<form id="confirmActionForm" method="post">
|
|
<div align="center">
|
|
<p id="appyConfirmText"></p>
|
|
<input type="hidden" name="actionType"/>
|
|
<input type="hidden" name="action"/>
|
|
<div id="commentArea" align=":dleft"><br/>
|
|
<span class="discreet">:_('workflow_comment')</span>
|
|
<textarea name="comment" cols="30" rows="3"></textarea>
|
|
<br/>
|
|
</div><br/>
|
|
<input type="button" onclick="doConfirm()" value=":_('yes')"/>
|
|
<input type="button" onclick="closePopup('confirmActionPopup')"
|
|
value=":_('no')"/>
|
|
</div>
|
|
</form>
|
|
</div>
|
|
|
|
<!-- Popup for reinitializing the password -->
|
|
<div id="askPasswordReinitPopup" class="popup"
|
|
if="isAnon and ztool.showForgotPassword()">
|
|
<form id="askPasswordReinitForm" method="post"
|
|
action=":ztool.absolute_url() + '/askPasswordReinit'">
|
|
<div align="center">
|
|
<p>:_('app_login')</p>
|
|
<input type="text" size="35" name="login" id="login" value=""/>
|
|
<br/><br/>
|
|
<input type="button" onclick="doAskPasswordReinit()"
|
|
value=":_('ask_password_reinit')"/>
|
|
<input type="button" onclick="closePopup('askPasswordReinitPopup')"
|
|
value=":_('object_cancel')"/>
|
|
</div>
|
|
</form>
|
|
</div>
|
|
|
|
<table class="main" align="center" cellpadding="0">
|
|
<tr class="top">
|
|
<!-- Top banner -->
|
|
<td var="bannerName=(dir == 'ltr') and 'banner' or 'bannerrtl'"
|
|
style=":url('%s.jpg' % bannerName, bg=True)">
|
|
|
|
<!-- Top links -->
|
|
<div style="margin-top: 4px" align=":dright">
|
|
<!-- Icon "home" -->
|
|
<a class="pageLink" href="/" title=": _('app_home')">
|
|
<img src=":url('home.gif')" style="margin-right: 3px"/>
|
|
</a>
|
|
|
|
<!-- Additional links -->
|
|
<x>:tool.pxLinks</x>
|
|
|
|
<!-- Top-level pages -->
|
|
<a for="page in tool.pages" class="pageLink"
|
|
href=":page.url">:page.title</a>
|
|
|
|
<!-- Connect link if discreet login -->
|
|
<a if="isAnon and discreetLogin" id="loginLink" name="loginLink"
|
|
onclick="showLoginForm()"
|
|
class="pageLink clickable">:_('app_connect')</a>
|
|
|
|
<!-- Language selector -->
|
|
<select if="ztool.showLanguageSelector()"
|
|
var2="languages=ztool.getLanguages();
|
|
defaultLanguage=languages[0]"
|
|
class="pageLink" onchange="switchLanguage(this)">
|
|
<option for="lg in languages" value=":lg"
|
|
selected=":lang == lg">:ztool.getLanguageName(lg)</option>
|
|
</select>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
|
|
<!-- The message strip -->
|
|
<tr valign="top">
|
|
<td><div style="position: relative">:tool.pxMessage</div></td>
|
|
</tr>
|
|
|
|
<!-- The user strip -->
|
|
<tr>
|
|
<td>
|
|
<table class="userStrip" width="100%">
|
|
<tr>
|
|
<!-- The user login form for anonymous users -->
|
|
<td align="center"
|
|
if="isAnon and ('/temp_folder/' not in req['ACTUAL_URL'])">
|
|
<form id="loginForm" name="loginForm" method="post" class="login"
|
|
action=":tool.url + '/performLogin'">
|
|
<input type="hidden" name="js_enabled" id="js_enabled" value="0"/>
|
|
<input type="hidden" name="cookies_enabled" id="cookies_enabled"
|
|
value=""/>
|
|
<input type="hidden" name="login_name" id="login_name" value=""/>
|
|
<input type="hidden" name="pwd_empty" id="pwd_empty" value="0"/>
|
|
<!-- Login fields, directly shown or not (depends on
|
|
discreetLogin) -->
|
|
<span id="loginFields" name="loginFields"
|
|
style=":discreetLogin and 'display:none' or 'display:block'">
|
|
<span class="userStripText">:_('app_login')</span>
|
|
<input type="text" name="__ac_name" id="__ac_name" value=""
|
|
style="width: 142px"/>
|
|
<span class="userStripText">:_('app_password')</span>
|
|
<input type="password" name="__ac_password" id="__ac_password"
|
|
style="width: 142px"/>
|
|
<input type="submit" name="submit" onclick="setLoginVars()"
|
|
var="label=_('app_connect')" value=":label" alt=":label"/>
|
|
<!-- Forgot password? -->
|
|
<a if="ztool.showForgotPassword()"
|
|
href="javascript: openPopup('askPasswordReinitPopup')"
|
|
class="lostPassword">:_('forgot_password')</a>
|
|
</span>
|
|
</form>
|
|
</td>
|
|
|
|
<!-- User info and controls for authenticated users -->
|
|
<td if="not isAnon">
|
|
<table class="buttons" width="99%">
|
|
<tr>
|
|
<td>
|
|
<!-- Config -->
|
|
<a if="user.has_role('Manager')" href=":tool.url"
|
|
title=":_('%sTool' % appName)">
|
|
<img src=":url('appyConfig.gif')"/></a>
|
|
<!-- Additional icons -->
|
|
<x>:tool.pxIcons</x>
|
|
<!-- Log out -->
|
|
<a href=":tool.url + '/performLogout'" title=":_('app_logout')">
|
|
<img src=":url('logout.gif')"/></a>
|
|
</td>
|
|
<td class="userStripText" var="userInfo=ztool.getUserLine()"
|
|
align=":dright">
|
|
<span>:userInfo[0]</span>
|
|
<a if="userInfo[1]"
|
|
href=":userInfo[1]"><img src=":url('edit')"/></a>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
|
|
<!-- The navigation strip -->
|
|
<tr if="zobj and showPortlet and (layoutType != 'edit')">
|
|
<td>:obj.pxNavigationStrip</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<table width="100%" cellpadding="0" cellspacing="0">
|
|
<tr valign="top">
|
|
<!-- The portlet -->
|
|
<td if="showPortlet" class="portlet">:tool.pxPortlet</td>
|
|
<!-- Page content -->
|
|
<td class="content">:content</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
<!-- Footer -->
|
|
<tr><td>:tool.pxFooter</td></tr>
|
|
</table>
|
|
</body>
|
|
</html>''', prologue=Px.xhtmlPrologue)
|
|
|
|
# --------------------------------------------------------------------------
|
|
# PXs for rendering graphical elements tied to a given object
|
|
# --------------------------------------------------------------------------
|
|
|
|
# This PX displays an object's history.
|
|
pxHistory = Px('''
|
|
<x var="startNumber=req.get'startNumber', 0);
|
|
startNumber=int(startNumber);
|
|
batchSize=int(req.get('maxPerPage', 5));
|
|
historyInfo=zobj.getHistory(startNumber,batchSize=batchSize)"
|
|
if="historyInfo.events"
|
|
var2="objs=historyInfo.events;
|
|
totalNumber=historyInfo.totalNumber;
|
|
ajaxHookId='appyHistory';
|
|
navBaseCall='askObjectHistory(%s,%s,%d,**v**)' % \
|
|
(q(ajaxHookId), q(zobj.absolute_url()), batchSize)">
|
|
|
|
<!-- Navigate between history pages -->
|
|
<x>:tool.pxNavigate</x>
|
|
<!-- History -->
|
|
<table width="100%" class="history">
|
|
<tr>
|
|
<th align=":dleft">:_('object_action')</th>
|
|
<th align=":dleft">:_('object_author')</th>
|
|
<th align=":dleft">:_('action_date')</th>
|
|
<th align=":dleft">:_('action_comment')</th>
|
|
</tr>
|
|
<tr for="event in objs"
|
|
var2="odd=loop.event.odd;
|
|
rhComments=event.get('comments', None);
|
|
state=event.get('review_state', None);
|
|
action=event['action'];
|
|
isDataChange=action == '_datachange_'"
|
|
class="odd and 'even' or 'odd'" valign="top">
|
|
<td if="isDataChange">
|
|
<x>:_('data_change')</x>
|
|
<img if="user.has_role('Manager')" class="clickable"
|
|
src=":url('delete')"
|
|
onclick=":'onDeleteEvent(%s,%s)' % \
|
|
(q(zobj.UID()), q(event['time']))"/>
|
|
</td>
|
|
<td if="not isDataChange">:_(zobj.getWorkflowLabel(action))</td>
|
|
<td var="actorId=event.get('actor')">
|
|
<x if="not actorId">?</x>
|
|
<x if="actorId">:ztool.getUserName(actorId)</x>
|
|
</td>
|
|
<td>:ztool.formatDate(event['time'], withHour=True)"></td>
|
|
<td if="not isDataChange">
|
|
<x if="rhComments">::zobj.formatText(rhComments)</x>
|
|
<x if="not rhComments">-</x>
|
|
</td>
|
|
<td if="isDataChange">
|
|
<!-- Display the previous values of the fields whose value were
|
|
modified in this change. -->
|
|
<table class="appyChanges" width="100%">
|
|
<tr>
|
|
<th align=":dleft" width="30%">:_('modified_field')</th>
|
|
<th align=":dleft" width="70%">:_('previous_value')</th>
|
|
</tr>
|
|
<tr for="change in event['changes'].items()" valign="top"
|
|
var2="field=zobj.getAppyType(change[0])">
|
|
<td>::_(field.labelId)</td>
|
|
<td>::change[1][0]</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</x>''')
|
|
|
|
# Displays an object's transitions(s).
|
|
pxTransitions = Px('''
|
|
<form var="transitions=targetObj.getAppyTransitions()" if="transitions"
|
|
var2="formId='trigger_%s' % targetObj.UID()" method="post"
|
|
id=":formId" action=":targetObj.absolute_url() + '/do'">
|
|
<input type="hidden" name="action" value="Trigger"/>
|
|
<input type="hidden" name="workflow_action"/>
|
|
<table>
|
|
<tr valign="middle">
|
|
<!-- Input field for storing comment -->
|
|
<textarea id="comment" name="comment" cols="30" rows="3"
|
|
style="display:none"></textarea>
|
|
<!-- Buttons for triggering transitions -->
|
|
<td align=":dright" for="transition in transitions">
|
|
<!-- Real button -->
|
|
<input type="button" class="button" if="transition['may_trigger']"
|
|
style=":url('buttonTransition', bg=True)"
|
|
title=":transition['title']"
|
|
value=":ztool.truncateValue(transition['title'])"
|
|
onclick=":'triggerTransition(%s,%s,%s)' % (q(formId), \
|
|
q(transition['name']), q(transition['confirm']))"/>
|
|
|
|
<!-- Fake button, explaining why the transition can't be triggered -->
|
|
<input type="button" class="button" if="not transition['may_trigger']"
|
|
style=":url('buttonFake', bg=True) + ';cursor: help'"
|
|
value=":ztool.truncateValue(transition['title'])"
|
|
title=":'%s: %s' % (transition['title'], \
|
|
transition['reason'])"/>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</form>''')
|
|
|
|
# Displays header information about an object: title, workflow-related info,
|
|
# history...
|
|
pxHeader = Px('''
|
|
<div if="not zobj.isTemporary()"
|
|
var2="hasHistory=zobj.hasHistory();
|
|
historyMaxPerPage=req.get('maxPerPage', 5);
|
|
historyExpanded=req.get('appyHistory','collapsed') == 'expanded';
|
|
creator=zobj.Creator()">
|
|
<table width="100%" class="summary">
|
|
<tr>
|
|
<td colspan="2" class="by">
|
|
<!-- Plus/minus icon for accessing history -->
|
|
<x if="hasHistory">
|
|
<img class="clickable" onclick="toggleCookie('appyHistory')"
|
|
src="historyExpanded and url('collapse.gif') or url('expand.gif')"
|
|
align=":dleft" id="appyHistory_img"/>
|
|
<x>:_('object_history')</x> ||
|
|
</x>
|
|
|
|
<!-- Creator and last modification date -->
|
|
<x>:_('object_created_by')</x><x>:ztool.getUserName(creator)</x>
|
|
|
|
<!-- Creation and last modification dates -->
|
|
<x>:_('object_created_on')</x>
|
|
<x var="creationDate=zobj.Created();
|
|
modificationDate=zobj.Modified()">
|
|
<x>:ztool.formatDate(creationDate, withHour=True)></x>
|
|
<x if="modificationDate != creationDate">—
|
|
<x>:_('object_modified_on')</x>
|
|
<x>:ztool.formatDate(modificationDate, withHour=True)</x>
|
|
</x>
|
|
</x>
|
|
|
|
<!-- State -->
|
|
<x if="zobj.showState()">—
|
|
<x>:_('workflow_state')</x> : <b>:_(zobj.getWorkflowLabel())</b>
|
|
</x>
|
|
</td>
|
|
</tr>
|
|
|
|
<!-- Object history -->
|
|
<tr if="hasHistory">
|
|
<td colspan="2">
|
|
<span id="appyHistory"
|
|
style=":historyExpanded and 'display:block' or 'display:none')">
|
|
<div var="ajaxHookId=zobj.UID() + '_history'" id=":ajaxHookId">
|
|
<script type="text/javascript">:'askObjectHistory(%s,%s,%d,0)' % \
|
|
(q(ajaxHookId), q(zobj.absolute_url()), \
|
|
historyMaxPerPage)</script>
|
|
</div>
|
|
</span>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>''')
|
|
|
|
# Shows the range of buttons (next, previous, save,...) and the workflow
|
|
# transitions for a given object.
|
|
pxButtons = Px('''
|
|
<table cellpadding="2" cellspacing="0" style="margin-top: 7px"
|
|
var="previousPage=phaseObj.getPreviousPage(page)[0];
|
|
nextPage=phaseObj.getNextPage(page)[0];
|
|
isEdit=layoutType == 'edit';
|
|
pageInfo=phaseObj.pagesInfo[page]">
|
|
<tr>
|
|
<!-- Previous -->
|
|
<td if="previousPage and pageInfo.showPrevious">
|
|
<!-- Button on the edit page -->
|
|
<x if="isEdit">
|
|
<input type="button" class="button" value=":_('page_previous')"
|
|
onClick="submitAppyForm('previous')"
|
|
style=":url('buttonPrevious', bg=True)"/>
|
|
<input type="hidden" name="previousPage" value=":previousPage"/>
|
|
</x>
|
|
<!-- Button on the view page -->
|
|
<input if="not isEdit" type="button" class="button"
|
|
value=":_('page_previous')"
|
|
style=":url('buttonPrevious', bg=True)"
|
|
onclick=":'goto(%s)' % q(zobj.getUrl(page=previousPage))"/>
|
|
</td>
|
|
|
|
<!-- Save -->
|
|
<td if="isEdit and pageInfo.showSave">
|
|
<input type="button" class="button" onClick="submitAppyForm('save')"
|
|
style=":url('buttonSave', bg=True)" value=":_('object_save')"/>
|
|
</td>
|
|
|
|
<!-- Cancel -->
|
|
<td if="isEdit and pageInfo.showCancel">
|
|
<input type="button" class="button" onClick="submitAppyForm('cancel')"
|
|
style=":url('buttonCancel', bg=True)" value=":_('object_cancel')"/>
|
|
</td>
|
|
|
|
<td if="not isEdit"
|
|
var2="locked=zobj.isLocked(user, page);
|
|
editable=pageInfo.showOnEdit and zobj.mayEdit()">
|
|
|
|
<!-- Edit -->
|
|
<input type="button" class="button" if="editable and not locked"
|
|
style=":url('buttonEdit', bg=True)" value=":_('object_edit')"
|
|
onclick=":'goto(%s)' % q(zobj.getUrl(mode='edit', page=page))"/>
|
|
|
|
<!-- Locked -->
|
|
<a if="editable and locked">
|
|
<img style="cursor: help"
|
|
var="lockDate=tool.formatDate(locked[1]);
|
|
lockMap={'user':tool.getUserName(locked[0]),'date':lockDate};
|
|
lockMsg=_('page_locked', mapping=lockMap)"
|
|
src=":url('lockedBig')" title=":lockMsg"/></a>
|
|
</td>
|
|
|
|
<!-- Next -->
|
|
<td if="nextPage and pageInfo.showNext">
|
|
<!-- Button on the edit page -->
|
|
<x if="isEdit">
|
|
<input type="button" class="button" onClick="submitAppyForm('next')"
|
|
style=":url('buttonNext', bg=True)" value=":_('page_next')"/>
|
|
<input type="hidden" name="nextPage" value=":nextPage"/>
|
|
</x>
|
|
<!-- Button on the view page -->
|
|
<input if="not isEdit" type="button" class="button"
|
|
style=":url('buttonNext', bg=True)" value=":_('page_next')"
|
|
onclick=":'goto(%s)' % q(zobj.getUrl(page=nextPage))"/>
|
|
</td>
|
|
|
|
<!-- Workflow transitions -->
|
|
<td var="targetObj=zobj"
|
|
if="targetObj.showTransitions(layoutType)">:obj.pxTransitions</td>
|
|
|
|
<!-- Refresh -->
|
|
<td if="zobj.isDebug()">
|
|
<a href=":zobj.getUrl(mode=layoutType, page=page, refresh='yes')">
|
|
<img title="Refresh" style="vertical-align:top" src=":url('refresh')"/>
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
</table>''')
|
|
|
|
# Displays the fields of a given page for a given object.
|
|
pxFields = Px('''
|
|
<table width=":layout.width">
|
|
<tr for="field in groupedFields">
|
|
<td if="field.type == 'group'">:field.pxView</td>
|
|
<td if="field.type != 'group'">:field.pxRender</td>
|
|
</tr>
|
|
</table>''')
|
|
|
|
pxView = Px('''
|
|
<x var="x=zobj.allows('read', raiseError=True);
|
|
errors=req.get('errors', {});
|
|
layout=zobj.getPageLayout(layoutType);
|
|
phaseObj=zobj.getAppyPhases(currentOnly=True, layoutType='view');
|
|
phase=phaseObj.name;
|
|
cssJs={};
|
|
page=req.get('page',None) or zobj.getDefaultViewPage();
|
|
x=zobj.removeMyLock(user, page);
|
|
groupedFields=zobj.getGroupedFields(layoutType, page,cssJs=cssJs)">
|
|
<x>:tool.pxPagePrologue</x>
|
|
<x var="tagId='pageLayout'; tagName=''; tagCss='';
|
|
layoutTarget=obj">:tool.pxLayoutedObject</x>
|
|
<x>:tool.pxPageBottom</x>
|
|
</x>''', template=pxTemplate, hook='content')
|
|
|
|
pxEdit = Px('''
|
|
<x var="x=zobj.allows('write', raiseError=True);
|
|
errors=req.get('errors', None) or {};
|
|
layout=zobj.getPageLayout(layoutType);
|
|
cssJs={};
|
|
phaseObj=zobj.getAppyPhases(currentOnly=True, \
|
|
layoutType=layoutType);
|
|
phase=phaseObj.name;
|
|
page=req.get('page', None) or zobj.getDefaultEditPage();
|
|
x=zobj.setLock(user, page);
|
|
confirmMsg=req.get('confirmMsg', None);
|
|
groupedFields=zobj.getGroupedFields(layoutType,page, cssJs=cssJs)">
|
|
<x>:tool.pxPagePrologue</x>
|
|
<!-- Warn the user that the form should be left via buttons -->
|
|
<script type="text/javascript"><![CDATA[
|
|
window.onbeforeunload = function(e){
|
|
theForm = document.getElementById('appyForm');
|
|
if (theForm.button.value == "") {
|
|
var e = e || window.event;
|
|
if (e) {e.returnValue = warn_leave_form;}
|
|
return warn_leave_form;
|
|
}
|
|
}]]>
|
|
</script>
|
|
<form id="appyForm" name="appyForm" method="post"
|
|
enctype="multipart/form-data" action=":zobj.absolute_url()+'/do'">
|
|
<input type="hidden" name="action" value="Update"/>
|
|
<input type="hidden" name="button" value=""/>
|
|
<input type="hidden" name="page" value=":page"/>
|
|
<input type="hidden" name="nav" value=":req.get('nav', None)"/>
|
|
<input type="hidden" name="confirmed" value="False"/>
|
|
<x var="tagId='pageLayout'; tagName=''; tagCss='';
|
|
layoutTarget=obj">:tool.pxLayoutedObject</x>
|
|
</form>
|
|
<script type="text/javascript"
|
|
if="confirmMsg">:'askConfirm(%s,%s,%s)' % \
|
|
(q('script'), q('postConfirmedEditForm()'), q(confirmMsg))</script>
|
|
<x>:tool.pxPageBottom</x>
|
|
</x>''', template=pxTemplate, hook='content')
|
|
|
|
# PX called via asynchronous requests from the browser. Keys "Expires" and
|
|
# "CacheControl" are used to prevent IE to cache returned pages (which is
|
|
# the default IE behaviour with Ajax requests).
|
|
pxAjax = Px('''
|
|
<x var="zobj=obj.o; ztool=tool.o; user=tool.user;
|
|
isAnon=user.login == 'anon'; app=ztool.getApp();
|
|
appFolder=app.data; url = ztool.getIncludeUrl;
|
|
appName=ztool.getAppName(); _=ztool.translate;
|
|
req=ztool.REQUEST; resp=req.RESPONSE;
|
|
lang=ztool.getUserLanguage(); q=ztool.quote;
|
|
action=req.get('action', None);
|
|
px=req['px'].split(':');
|
|
field=(len(px) == 2) and zobj.getAppyType(px[0]) or None;
|
|
dir=ztool.getLanguageDirection(lang);
|
|
dleft=(dir == 'ltr') and 'left' or 'right';
|
|
dright=(dir == 'ltr') and 'right' or 'left';
|
|
x=resp.setHeader('Content-type', ztool.xhtmlEncoding);
|
|
x=resp.setHeader('Expires', 'Thu, 11 Dec 1975 12:05:00 GMT+2');
|
|
x=resp.setHeader('Content-Language', lang);
|
|
x=resp.setHeader('CacheControl', 'no-cache')">
|
|
|
|
<!-- If an action is defined, execute it on p_zobj or on p_field. -->
|
|
<x if="action and not field" var2="x=getattr(zobj, action)()"></x>
|
|
<x if="action and field" var2="x=getattr(field, action)(zobj)"></x>
|
|
|
|
<!-- Then, call the PX on p_obj or on p_field. -->
|
|
<x if="not field">:getattr(obj, px[0])</x>
|
|
<x if="field">:getattr(field, px[1])</x>
|
|
</x>''')
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Class methods
|
|
# --------------------------------------------------------------------------
|
|
@classmethod
|
|
def _getParentAttr(klass, attr):
|
|
'''Gets value of p_attr on p_klass base classes (if this attr exists).
|
|
Scan base classes in the reverse order as Python does. Used by
|
|
classmethod m_getWorkflow below. Scanning base classes in reverse
|
|
order allows user-defined elements to override default Appy
|
|
elements.'''
|
|
i = len(klass.__bases__) - 1
|
|
res = None
|
|
while i >= 0:
|
|
res = getattr(klass.__bases__[i], attr, None)
|
|
if res: return res
|
|
i -= 1
|
|
|
|
@classmethod
|
|
def getWorkflow(klass):
|
|
'''Returns the workflow tied to p_klass.'''
|
|
res = klass._getParentAttr('workflow')
|
|
# Return a default workflow if no workflow was found.
|
|
if not res: res = WorkflowAnonymous
|
|
return res
|
|
|
|
@classmethod
|
|
def getIndexes(klass, includeDefaults=True):
|
|
'''Returns a dict whose keys are the names of the indexes that are
|
|
applicable to instances of this class, and whose values are the
|
|
(Zope) types of those indexes.'''
|
|
# Start with the standard indexes applicable for any Appy class.
|
|
if includeDefaults:
|
|
res = defaultIndexes.copy()
|
|
else:
|
|
res = {}
|
|
# Add the indexed fields found on this class
|
|
for field in klass.__fields__:
|
|
if not field.indexed or (field.name == 'title'): continue
|
|
n = field.name
|
|
indexName = 'get%s%s' % (n[0].upper(), n[1:])
|
|
res[indexName] = field.getIndexType()
|
|
return res
|
|
|
|
# --------------------------------------------------------------------------
|
|
# Instance methods
|
|
# --------------------------------------------------------------------------
|
|
def __init__(self, o): self.__dict__['o'] = o
|
|
def appy(self): return self
|
|
|
|
def __setattr__(self, name, value):
|
|
appyType = self.o.getAppyType(name)
|
|
if not appyType:
|
|
raise 'Attribute "%s" does not exist.' % name
|
|
appyType.store(self.o, value)
|
|
|
|
def __getattribute__(self, name):
|
|
'''Gets the attribute named p_name. Lot of cheating here.'''
|
|
if name == 'o': return object.__getattribute__(self, name)
|
|
elif name == 'tool': return self.o.getTool().appy()
|
|
elif name == 'request':
|
|
# The request may not be present, ie if we are at Zope startup.
|
|
res = getattr(self.o, 'REQUEST', None)
|
|
if res != None: return res
|
|
return self.o.getProductConfig().fakeRequest
|
|
elif name == 'session': return self.o.REQUEST.SESSION
|
|
elif name == 'typeName': return self.__class__.__bases__[-1].__name__
|
|
elif name == 'id': return self.o.id
|
|
elif name == 'uid': return self.o.UID()
|
|
elif name == 'klass': return self.__class__.__bases__[-1]
|
|
elif name == 'created': return self.o.created
|
|
elif name == 'modified': return self.o.modified
|
|
elif name == 'url': return self.o.absolute_url()
|
|
elif name == 'state': return self.o.State()
|
|
elif name == 'stateLabel':
|
|
return self.o.translate(self.o.getWorkflowLabel())
|
|
elif name == 'history':
|
|
o = self.o
|
|
key = o.workflow_history.keys()[0]
|
|
return o.workflow_history[key]
|
|
elif name == 'user': return self.o.getTool().getUser()
|
|
elif name == 'fields': return self.o.getAllAppyTypes()
|
|
elif name == 'siteUrl': return self.o.getTool().getSiteUrl()
|
|
# Now, let's try to return a real attribute.
|
|
res = object.__getattribute__(self, name)
|
|
# If we got an Appy type, return the value of this type for this object
|
|
if isinstance(res, Field):
|
|
o = self.o
|
|
if isinstance(res, Ref):
|
|
return res.getValue(o, noListIfSingleObj=True)
|
|
else:
|
|
return res.getValue(o)
|
|
return res
|
|
|
|
def __repr__(self):
|
|
return '<%s appyobj at %s>' % (self.klass.__name__, id(self))
|
|
|
|
def __cmp__(self, other):
|
|
if other: return cmp(self.o, other.o)
|
|
return 1
|
|
|
|
def _getCustomMethod(self, methodName):
|
|
'''See docstring of _callCustom below.'''
|
|
if len(self.__class__.__bases__) > 1:
|
|
# There is a custom user class
|
|
custom = self.__class__.__bases__[-1]
|
|
if custom.__dict__.has_key(methodName):
|
|
return custom.__dict__[methodName]
|
|
|
|
def _callCustom(self, methodName, *args, **kwargs):
|
|
'''This wrapper implements some methods like "validate" and "onEdit".
|
|
If the user has defined its own wrapper, its methods will not be
|
|
called. So this method allows, from the methods here, to call the
|
|
user versions.'''
|
|
custom = self._getCustomMethod(methodName)
|
|
if custom: return custom(self, *args, **kwargs)
|
|
|
|
def getField(self, name): return self.o.getAppyType(name)
|
|
def isEmpty(self, name):
|
|
'''Returns True if value of field p_name is considered as being
|
|
empty.'''
|
|
obj = self.o
|
|
if hasattr(obj.aq_base, name):
|
|
field = obj.getAppyType(name)
|
|
return field.isEmptyValue(getattr(obj, name))
|
|
return True
|
|
|
|
def link(self, fieldName, obj):
|
|
'''This method links p_obj (which can be a list of objects) to this one
|
|
through reference field p_fieldName.'''
|
|
return self.getField(fieldName).linkObject(self.o, obj)
|
|
|
|
def unlink(self, fieldName, obj):
|
|
'''This method unlinks p_obj (which can be a list of objects) from this
|
|
one through reference field p_fieldName.'''
|
|
return self.getField(fieldName).unlinkObject(self.o, obj)
|
|
|
|
def sort(self, fieldName, sortKey='title', reverse=False):
|
|
'''Sorts referred elements linked to p_self via p_fieldName according
|
|
to a given p_sortKey which must be an attribute set on referred
|
|
objects ("title", by default).'''
|
|
refs = getattr(self.o, fieldName, None)
|
|
if not refs: return
|
|
tool = self.tool
|
|
# refs is a PersistentList: param "key" is not available. So perform the
|
|
# sort on the real list and then indicate that the persistent list has
|
|
# changed (the ZODB way).
|
|
refs.data.sort(key=lambda x: getattr(tool.getObject(x), sortKey),
|
|
reverse=reverse)
|
|
refs._p_changed = 1
|
|
|
|
def create(self, fieldNameOrClass, noSecurity=False, **kwargs):
|
|
'''If p_fieldNameOrClass is the name of a field, this method allows to
|
|
create an object and link it to the current one (self) through
|
|
reference field named p_fieldName.
|
|
If p_fieldNameOrClass is a class from the gen-application, it must
|
|
correspond to a root class and this method allows to create a
|
|
root object in the application folder.'''
|
|
isField = isinstance(fieldNameOrClass, basestring)
|
|
tool = self.tool.o
|
|
# Determine the class of the object to create
|
|
if isField:
|
|
fieldName = fieldNameOrClass
|
|
appyType = self.o.getAppyType(fieldName)
|
|
portalType = tool.getPortalType(appyType.klass)
|
|
else:
|
|
klass = fieldNameOrClass
|
|
portalType = tool.getPortalType(klass)
|
|
# Determine object id
|
|
if kwargs.has_key('id'):
|
|
objId = kwargs['id']
|
|
del kwargs['id']
|
|
else:
|
|
objId = tool.generateUid(portalType)
|
|
# Determine if object must be created from external data
|
|
externalData = None
|
|
if kwargs.has_key('_data'):
|
|
externalData = kwargs['_data']
|
|
del kwargs['_data']
|
|
# Where must I create the object?
|
|
if not isField:
|
|
folder = tool.getPath('/data')
|
|
else:
|
|
folder = self.o.getCreateFolder()
|
|
if not noSecurity:
|
|
# Check that the user can edit this field.
|
|
appyType.checkAdd(self.o)
|
|
# Create the object
|
|
zopeObj = createObject(folder, objId, portalType, tool.getAppName(),
|
|
noSecurity=noSecurity)
|
|
appyObj = zopeObj.appy()
|
|
# Set object attributes
|
|
for attrName, attrValue in kwargs.iteritems():
|
|
setattr(appyObj, attrName, attrValue)
|
|
if isField:
|
|
# Link the object to this one
|
|
appyType.linkObject(self.o, zopeObj)
|
|
# Call custom initialization
|
|
if externalData: param = externalData
|
|
else: param = True
|
|
if hasattr(appyObj, 'onEdit'): appyObj.onEdit(param)
|
|
zopeObj.reindex()
|
|
return appyObj
|
|
|
|
def freeze(self, fieldName, doAction=False):
|
|
'''This method freezes a POD document. TODO: allow to freeze Computed
|
|
fields.'''
|
|
rq = self.request
|
|
field = self.o.getAppyType(fieldName)
|
|
if field.type != 'Pod': raise 'Cannot freeze non-Pod field.'
|
|
# Perform the related action if required.
|
|
if doAction: self.request.set('askAction', True)
|
|
# Set the freeze format
|
|
rq.set('podFormat', field.freezeFormat)
|
|
# Generate the document.
|
|
doc = field.getValue(self.o)
|
|
if isinstance(doc, basestring):
|
|
self.log(FREEZE_ERROR % (field.freezeFormat, field.name, doc),
|
|
type='error')
|
|
if field.freezeFormat == 'odt': raise FREEZE_FATAL_ERROR
|
|
self.log('Trying to freeze the ODT version...')
|
|
# Try to freeze the ODT version of the document, which does not
|
|
# require to call OpenOffice/LibreOffice, so the risk of error is
|
|
# smaller.
|
|
self.request.set('podFormat', 'odt')
|
|
doc = field.getValue(self.o)
|
|
if isinstance(doc, basestring):
|
|
self.log(FREEZE_ERROR % ('odt', field.name, doc), type='error')
|
|
raise FREEZE_FATAL_ERROR
|
|
field.store(self.o, doc)
|
|
|
|
def unFreeze(self, fieldName):
|
|
'''This method un freezes a POD document. TODO: allow to unfreeze
|
|
Computed fields.'''
|
|
rq = self.request
|
|
field = self.o.getAppyType(fieldName)
|
|
if field.type != 'Pod': raise 'Cannot unFreeze non-Pod field.'
|
|
field.store(self.o, None)
|
|
|
|
def delete(self):
|
|
'''Deletes myself.'''
|
|
self.o.delete()
|
|
|
|
def translate(self, label, mapping={}, domain=None, language=None,
|
|
format='html'):
|
|
'''Check documentation of self.o.translate.'''
|
|
return self.o.translate(label, mapping, domain, language=language,
|
|
format=format)
|
|
|
|
def do(self, transition, comment='', doAction=True, doNotify=True,
|
|
doHistory=True, noSecurity=False):
|
|
'''This method allows to trigger on p_self a workflow p_transition
|
|
programmatically. See doc in self.o.do.'''
|
|
return self.o.trigger(transition, comment, doAction=doAction,
|
|
doNotify=doNotify, doHistory=doHistory,
|
|
doSay=False, noSecurity=noSecurity)
|
|
|
|
def log(self, message, type='info'): return self.o.log(message, type)
|
|
def say(self, message, type='info'): return self.o.say(message, type)
|
|
|
|
def normalize(self, s, usage='fileName'):
|
|
'''Returns a version of string p_s whose special chars have been
|
|
replaced with normal chars.'''
|
|
return normalizeString(s, usage)
|
|
|
|
def search(self, klass, sortBy='', maxResults=None, noSecurity=False,
|
|
**fields):
|
|
'''Searches objects of p_klass. p_sortBy must be the name of an indexed
|
|
field (declared with indexed=True); every param in p_fields must
|
|
take the name of an indexed field and take a possible value of this
|
|
field. You can optionally specify a maximum number of results in
|
|
p_maxResults. If p_noSecurity is specified, you get all objects,
|
|
even if the logged user does not have the permission to view it.'''
|
|
# Find the content type corresponding to p_klass
|
|
tool = self.tool.o
|
|
contentType = tool.getPortalType(klass)
|
|
# Create the Search object
|
|
search = Search('customSearch', sortBy=sortBy, **fields)
|
|
if not maxResults:
|
|
maxResults = 'NO_LIMIT'
|
|
# If I let maxResults=None, only a subset of the results will be
|
|
# returned by method executeResult.
|
|
res = tool.executeQuery(contentType, search=search,
|
|
maxResults=maxResults, noSecurity=noSecurity)
|
|
return [o.appy() for o in res.objects]
|
|
|
|
def search1(self, *args, **kwargs):
|
|
'''Identical to m_search above, but returns a single result (if any).'''
|
|
res = self.search(*args, **kwargs)
|
|
if res: return res[0]
|
|
|
|
def count(self, klass, noSecurity=False, **fields):
|
|
'''Identical to m_search above, but returns the number of objects that
|
|
match the search instead of returning the objects themselves. Use
|
|
this method instead of writing len(self.search(...)).'''
|
|
tool = self.tool.o
|
|
contentType = tool.getPortalType(klass)
|
|
search = Search('customSearch', **fields)
|
|
res = tool.executeQuery(contentType, search=search, brainsOnly=True,
|
|
noSecurity=noSecurity)
|
|
if res: return res._len # It is a LazyMap instance
|
|
else: return 0
|
|
|
|
def countRefs(self, fieldName):
|
|
'''Counts the number of objects linked to this one via Ref field
|
|
p_fieldName.'''
|
|
uids = getattr(self.o.aq_base, fieldName, None)
|
|
if not uids: return 0
|
|
return len(uids)
|
|
|
|
def compute(self, klass, sortBy='', maxResults=None, context=None,
|
|
expression=None, noSecurity=False, **fields):
|
|
'''This method, like m_search and m_count above, performs a query on
|
|
objects of p_klass. But in this case, instead of returning a list of
|
|
matching objects (like m_search) or counting elements (like p_count),
|
|
it evaluates, on every matching object, a Python p_expression (which
|
|
may be an expression or a statement), and returns, if needed, a
|
|
result. The result may be initialized through parameter p_context.
|
|
p_expression is evaluated with 2 variables in its context: "obj"
|
|
which is the currently walked object, instance of p_klass, and "ctx",
|
|
which is the context as initialized (or not) by p_context. p_context
|
|
may be used as
|
|
(1) a variable or instance that is updated on every call to
|
|
produce a result;
|
|
(2) an input variable or instance;
|
|
(3) both.
|
|
|
|
The method returns p_context, modified or not by evaluation of
|
|
p_expression on every matching object.
|
|
|
|
When you need to perform an action or computation on a lot of
|
|
objects, use this method instead of doing things like
|
|
|
|
"for obj in self.search(MyClass,...)"
|
|
'''
|
|
tool = self.tool.o
|
|
contentType = tool.getPortalType(klass)
|
|
search = Search('customSearch', sortBy=sortBy, **fields)
|
|
# Initialize the context variable "ctx"
|
|
ctx = context
|
|
for brain in tool.executeQuery(contentType, search=search, \
|
|
brainsOnly=True, maxResults=maxResults, noSecurity=noSecurity):
|
|
# Get the Appy object from the brain
|
|
if noSecurity: method = '_unrestrictedGetObject'
|
|
else: method = 'getObject'
|
|
exec 'obj = brain.%s().appy()' % method
|
|
exec expression
|
|
return ctx
|
|
|
|
def reindex(self, fields=None, unindex=False):
|
|
'''Asks a direct object reindexing. In most cases you don't have to
|
|
reindex objects "manually" with this method. When an object is
|
|
modified after some user action has been performed, Appy reindexes
|
|
this object automatically. But if your code modifies other objects,
|
|
Appy may not know that they must be reindexed, too. So use this
|
|
method in those cases.
|
|
'''
|
|
if fields:
|
|
# Get names of indexes from field names.
|
|
indexes = [Search.getIndexName(name) for name in fields]
|
|
else:
|
|
indexes = None
|
|
self.o.reindex(indexes=indexes, unindex=unindex)
|
|
|
|
def export(self, at='string', format='xml', include=None, exclude=None):
|
|
'''Creates an "exportable" version of this object. p_format is "xml" by
|
|
default, but can also be "csv". If p_format is:
|
|
* "xml", if p_at is "string", this method returns the XML version,
|
|
without the XML prologue. Else, (a) if not p_at, the XML
|
|
will be exported on disk, in the OS temp folder, with an
|
|
ugly name; (b) else, it will be exported at path p_at.
|
|
* "csv", if p_at is "string", this method returns the CSV data as a
|
|
string. If p_at is an opened file handler, the CSV line will
|
|
be appended in it.
|
|
If p_include is given, only fields whose names are in it will be
|
|
included. p_exclude, if given, contains names of fields that will
|
|
not be included in the result.
|
|
'''
|
|
if format == 'xml':
|
|
# Todo: take p_include and p_exclude into account.
|
|
# Determine where to put the result
|
|
toDisk = (at != 'string')
|
|
if toDisk and not at:
|
|
at = getOsTempFolder() + '/' + self.o.UID() + '.xml'
|
|
# Create the XML version of the object
|
|
marshaller = XmlMarshaller(cdata=True, dumpUnicode=True,
|
|
dumpXmlPrologue=toDisk,
|
|
rootTag=self.klass.__name__)
|
|
xml = marshaller.marshall(self.o, objectType='appy')
|
|
# Produce the desired result
|
|
if toDisk:
|
|
f = file(at, 'w')
|
|
f.write(xml.encode('utf-8'))
|
|
f.close()
|
|
return at
|
|
else:
|
|
return xml
|
|
elif format == 'csv':
|
|
if isinstance(at, basestring):
|
|
marshaller = CsvMarshaller(include=include, exclude=exclude)
|
|
return marshaller.marshall(self)
|
|
else:
|
|
marshaller = CsvMarshaller(at, include=include, exclude=exclude)
|
|
marshaller.marshall(self)
|
|
|
|
def historize(self, data):
|
|
'''This method allows to add "manually" a "data-change" event into the
|
|
object's history. Indeed, data changes are "automatically" recorded
|
|
only when an object is edited through the edit form, not when a
|
|
setter is called from the code.
|
|
|
|
p_data must be a dictionary whose keys are field names (strings) and
|
|
whose values are the previous field values.'''
|
|
self.o.addDataChange(data)
|
|
|
|
def formatText(self, text, format='html'):
|
|
'''Produces a representation of p_text into the desired p_format, which
|
|
is 'html' by default.'''
|
|
return self.o.formatText(text, format)
|
|
# ------------------------------------------------------------------------------
|