* @author Nathan Gray * @package timesheet * @copyright (c) 2007-16 by Ralf Becker * @copyright 2011 Nathan Gray * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License * @version $Id$ */ use EGroupware\Api; use EGroupware\Api\Link; /** * Timesheet - document merge object */ class timesheet_merge extends Api\Storage\Merge { /** * Functions that can be called via menuaction * * @var array */ var $public_functions = array( 'download_by_request' => true, 'show_replacements' => true, 'timesheet_replacements' => true, ); /** * Fields that are numeric, for special numeric handling */ protected $numeric_fields = array( '$$ts_duration$$', '$$ts_quantity$$', '$$ts_unitprice$$' ); /** * Business object to pull records from */ protected $bo = null; /** * Constructor * */ function __construct() { parent::__construct(); // switch of handling of Api\Html formated content, if Api\Html is not used $this->parse_html_styles = Api\Storage\Customfields::use_html('timesheet'); $this->bo = new timesheet_bo(); $this->date_fields += array( 'ts_start', 'ts_modified', ); } /** * Get replacements * * @param int $id id of entry * @param string &$content=null content to create some replacements only if they are use * @return array|boolean */ protected function get_replacements($id,&$content=null) { if (!($replacements = $this->timesheet_replacements($id, '', $content))) { return false; } if (!(strpos($content,'$$ts_project/') === false)) { // Check to see if it's actually a project, then load if($replacements['$$pm_id$$']) { if(!$this->pm) { $this->pm = new projectmanager_merge(); } $this->pm->projectmanager_bo = new projectmanager_bo($replacements['$$pm_id$$']); $replacements += $this->pm->projectmanager_replacements($replacements['$$pm_id$$'],'ts_project'); } } return $replacements; } /** * Get timesheet replacements * * @param int $id id of entry * @param string $prefix='' prefix like eg. 'erole' * @return array|boolean */ public function timesheet_replacements($id,$prefix='', &$content = null) { $record = new timesheet_egw_record($id); $info = array(); // Get project manager ID $links = Link\Storage::get_links('timesheet',$id,'projectmanager'); if($links) { $record->pm_id = current($links); } // Convert to human friendly values $types = timesheet_egw_record::$types; $_selects = array('status' => $this->bo->status_labels); foreach($_selects['status'] as &$status) { $status = str_replace(' ', '', $status); } foreach($_selects as $name => $value) { $selects['ts_'.$name] = $value; } if($content && strpos($content, '#') !== 0) { $this->cf_link_to_expand($record->get_record_array(), $content, $info); } importexport_export_csv::convert($record, $types, 'timesheet', $selects); $array = $record->get_record_array(); $array['ts_total'] = $array['ts_quantity'] * $array['ts_unitprice']; foreach(array('ts_duration','ts_quantity','ts_unitprice','ts_total') as $key) { $array[$key] = self::number_format($array[$key],2,$this->mimetype); } // Set any missing custom fields, or the marker will stay foreach(array_keys($this->bo->customfields) as $name) { if(!$array['#'.$name]) $array['#'.$name] = ''; } // Links $array += $this->get_all_links('timesheet', $id, $prefix, $content); // Add markers foreach($array as $key => &$value) { if(!$value) $value = ''; $info['$$'.($prefix ? $prefix.'/':'').$key.'$$'] = $value; } return $info; } /** * Generate table with replacements for the Api\Preferences * */ public function show_replacements() { $GLOBALS['egw_info']['flags']['app_header'] = lang('timesheet').' - '.lang('Replacements for inserting entries into documents'); $GLOBALS['egw_info']['flags']['nonavbar'] = false; $GLOBALS['egw']->framework->header(); echo "\n"; echo '"; $n = 0; $fields = array('ts_id' => lang('Timesheet ID')) + $this->bo->field2label + array('ts_total' => lang('total')); foreach($fields as $name => $label) { if (in_array($name,array('pl_id','customfields'))) continue; // dont show them if (in_array($name,array('ts_title', 'ts_description')) && $n&1) // main values, which should be in the first column { echo "\n"; $n++; } if (!($n&1)) echo ''; echo ''; if ($n&1) echo "\n"; $n++; } echo '"; foreach($this->bo->customfields as $name => $field) { echo '\n"; } echo ''; $pm_merge = new projectmanager_merge(); $i = 0; foreach($pm_merge->projectmanager_fields as $name => $label) { if (!($i&1)) echo ''; echo ''; if ($i&1) echo "\n"; $i++; } echo '"; foreach(array( 'link' => lang('HTML link to the current record'), 'links' => lang('Titles of any entries linked to the current record, excluding attached files'), 'attachments' => lang('List of files linked to the current record'), 'links_attachments' => lang('Links and attached files'), 'links/[appname]' => lang('Links to specified application. Example: {{links/infolog}}'), 'date' => lang('Date'), 'user/n_fn' => lang('Name of current user, all other contact fields are valid too'), 'user/account_lid' => lang('Username'), 'pagerepeat' => lang('For serial letter use this tag. Put the content, you want to repeat between two Tags.'), 'label' => lang('Use this tag for addresslabels. Put the content, you want to repeat, between two tags.'), 'labelplacement' => lang('Tag to mark positions for address labels'), 'IF fieldname' => lang('Example {{IF n_prefix~Mr~Hello Mr.~Hello Ms.}} - search the field "n_prefix", for "Mr", if found, write Hello Mr., else write Hello Ms.'), 'NELF' => lang('Example {{NELF role}} - if field role is not empty, you will get a new line with the value of field role'), 'NENVLF' => lang('Example {{NELFNV role}} - if field role is not empty, set a LF without any value of the field'), 'LETTERPREFIX' => lang('Example {{LETTERPREFIX}} - Gives a letter prefix without double spaces, if the title is empty for example'), 'LETTERPREFIXCUSTOM' => lang('Example {{LETTERPREFIXCUSTOM n_prefix title n_family}} - Example: Mr Dr. James Miller'), ) as $name => $label) { echo '\n"; } echo "

'.lang('Timesheet fields:')."

{{'.$name.'}}'.lang($label).'

'.lang('Custom fields').":

{{#'.$name.'}}'.$field['label']."

'.lang('Project fields').':

{{ts_project/'.$name.'}}'.$label.'

'.lang('General fields:')."

{{'.$name.'}}'.$label."
\n"; $GLOBALS['egw']->framework->footer(); } }