source: trunk/workflow/inc/class.so_external_applications.inc.php @ 7712

Revision 7712, 11.4 KB checked in by douglasz, 12 years ago (diff)

Ticket #3236 - Revisao das Melhorias de performance no codigo do Expresso.
  • Property svn:executable set to *
Line 
1<?php
2
3        /**************************************************************************\
4        * eGroupWare                                                               *
5        * http://www.egroupware.org                                                *
6        * --------------------------------------------                             *
7        *  This program is free software; you can redistribute it and/or modify it *
8        *  under the terms of the GNU General Public License as published by the   *
9        *  Free Software Foundation; either version 2 of the License, or (at your  *
10        *  option) any later version.                                              *
11        \**************************************************************************/
12
13/**
14 * Camada Model das Aplicações Externas
15 * @package Workflow
16 * @author Sidnei Augusto Drovetto Jr. - drovetto@gmail.com
17 * @license http://www.gnu.org/copyleft/gpl.html GPL
18 */
19class so_external_applications
20{
21        /**
22         * @var bool True se o usuário for administrador do expresso
23         * @access private
24         */
25        private $isAdmin;
26
27        /**
28         * @var object Link para a ACL do Workflow
29         * @access private
30         */
31        private $acl;
32
33        /**
34         * @var object Link para o Banco de Dados do Expresso
35         * @access private
36         */
37        private $db;
38
39        /**
40         * @var object Link para o Banco de Dados do Expresso
41         * @access private
42         */
43        private $EXTERNAL_APPLICATION_PATH;
44
45        /**
46         * Checa se o usuário possui acesso à administração das Aplicações Externas
47         * @return void
48         * @access private
49         */
50        private function _checkAccess()
51        {
52                /* the user is an administrator */
53                if ($this->isAdmin)
54                        return true;
55                else
56                        die(serialize("Você não tem permissão para executar este procedimento!"));
57        }
58
59        /**
60         * Verifica se houve erro em alguma query do Banco de Dados
61         * @param object $result O resultado de alguma query
62         * @return void
63         * @access private
64         */
65        private function _checkError($result)
66        {
67                if ($result === false)
68                        die(serialize("Ocorreu um erro ao se tentar executar a operação solicitada."));
69        }
70
71        /**
72         * Grava a imagem no diretório de aplicações externas
73         * @param string $filename O nome da imagem
74         * @param string $contents O conteúdo (binário) da imagem
75         * @return bool Informa se a imagem foi gravada com sucesso ou não
76         * @access private
77         */
78        private function _saveImage($filename, $contents)
79        {
80                /* avoid writes outside the external_applications directory */
81                if (strpos($filename, '/') !== false)
82                        return false;
83
84                /* create the directories if they don't exist */
85                @mkdir($this->EXTERNAL_APPLICATION_PATH, 0770, true);
86
87                /* perform the write operations */
88                $handler = fopen($this->EXTERNAL_APPLICATION_PATH . '/' . $filename, 'w');
89                if ($handler)
90                {
91                        fwrite($handler, $contents);
92                        fclose($handler);
93                        return true;
94                }
95                else
96                        return false;
97        }
98
99        /**
100         * Verifica a presença de valores inválidos em alguns campos da aplicação externa
101         * @param string $name O nome da aplicação externa
102         * @param string $address O endereço da aplicação externa
103         * @return array Uma array contendo os erros encontrados
104         * @access private
105         */
106        private function checkExternalApplicationData($name, $address)
107        {
108                $output = array();
109                $name = trim($name);
110                $address = trim($address);
111
112                if (empty($name))
113                        $output[] = 'O nome da aplicação externa não pode ser vazio.';
114
115                if (empty($address))
116                        $output[] = 'O endereço da aplicação externa não pode ser vazio.';
117
118                if (preg_match('/^[a-z]+:\/\//i', $address) == 0)
119                        $output[] = 'Aparentemente a URL informada não está formatada corretamente.';
120
121                return $output;
122        }
123
124        /**
125         * Construtor da classe so_external_applications
126         * @return object
127         */
128        function so_external_applications()
129        {
130                $this->isAdmin = $_SESSION['phpgw_info']['workflow']['user_is_admin'];
131                $this->acl = &$GLOBALS['ajax']->acl;
132                $this->db =& Factory::getInstance('WorkflowObjects')->getDBGalaxia()->Link_ID;
133                $this->EXTERNAL_APPLICATION_PATH = $_SESSION['phpgw_info']['workflow']['server']['files_dir'] . '/workflow//workflow/external_applications';
134        }
135
136        /**
137         * Lista todas as aplicações externas
138         * @return array Lista de aplicações externas
139         * @access public
140         */
141        function getExternalApplications()
142        {
143                $this->_checkAccess();
144                $query = "SELECT external_application_id, name FROM egw_wf_external_application ORDER BY name";
145
146                $result = $this->db->query($query);
147                $this->_checkError($result);
148
149                $output = $result->GetArray(-1);
150
151                for ($i = 0; $i < count($output); ++$i)
152                        for ($j = 0; $j < $result->_numOfFields; ++$j)
153                                unset($output[$i][$j]);
154
155                return $output;
156        }
157
158        /**
159         * Retornar informações sobre uma aplicação externa
160         * @param int $externalApplicationID O ID da aplicação externa
161         * @return array Array contento informações sobre a aplicação externa
162         * @access public
163         */
164        function getExternalApplication($externalApplicationID)
165        {
166                $this->_checkAccess();
167                $query = "SELECT external_application_id, name, description, image, address, authentication, post, intranet_only FROM egw_wf_external_application WHERE (external_application_id = ?)";
168
169                $result = $this->db->query($query, array($externalApplicationID));
170                $this->_checkError($result);
171
172                $output = $result->GetArray(-1);
173
174                for ($i = 0; $i < count($output); ++$i)
175                        for ($j = 0; $j < $result->_numOfFields; ++$j)
176                                unset($output[$i][$j]);
177
178                return isset($output[0]) ? $output[0] : false;
179        }
180
181        /**
182         * Adiciona uma aplicação externa
183         * @param string $name O nome da aplicação externa
184         * @param string $description A descrição da aplicação externa
185         * @param string $address O endereço da aplicação externa
186         * @param string $image O nome da imagem da aplicação externa
187         * @param int $authentication Indica se a aplicação externa autentica (1) ou não (0)
188         * @param string $post Os dados que são postados para a aplicação externa (caso necessite de autenticação)
189         * @param int $intranetOnly Indica se a aplicação externa só será visível na Intranet (1 somente Intranet e 2 para cliente de qualquer origem)
190         * @return bool TRUE se a ação foi concluída com êxito e FALSE caso contrário
191         * @access public
192         */
193        function addExternalApplication($name, $description, $address, $image, $authentication, $post, $intranetOnly)
194        {
195                $this->_checkAccess();
196
197                if (count($errors = $this->checkExternalApplicationData($name, $address)) > 0)
198                        return array('error' => implode("\n", $errors));
199
200                /* decode the supplied image */
201                if ($image != '')
202                {
203                        $image = str_replace(' ', '+', $image);
204                        $imageData = base64_decode($image);
205                        if ($imageData !== false)
206                                $imageData = unserialize($imageData);
207                        if ($imageData !== false)
208                        {
209                                $image = strtolower(end(explode('.', $imageData['name'])));
210                                if (($image != 'png') && ($image != 'jpg') && ($image != 'gif'))
211                                        return array('error' => 'A imagem enviada não é do tipo JPG, PNG ou GIF');
212                        }
213                        else
214                                $image = '';
215                }
216
217                if (strlen($image) > 0)
218                        $query = "INSERT INTO egw_wf_external_application(name, description, address, image, authentication, post, intranet_only) VALUES(?, ?, ?, currVAL('seq_egw_wf_external_application') || '.$image', ?, ?, ?)";
219                else
220                        $query = "INSERT INTO egw_wf_external_application(name, description, address, authentication, post, intranet_only) VALUES(?, ?, ?, ?, ?, ?)";
221
222                $this->db->StartTrans();
223                $result = $this->db->query($query, array($name, $description, $address, $authentication, $post, $intranetOnly));
224
225                if ((strlen($image) > 0) && ($result !== false))
226                {
227                        $currentID = $this->db->getOne("SELECT currVAL('seq_egw_wf_external_application')");
228                        $this->_saveImage($currentID . '.' . $image, $imageData['contents']);
229                }
230
231                if ($result === false)
232                        $this->db->FailTrans();
233                else
234                        $this->db->CompleteTrans();
235
236                $this->_checkError($result);
237                return (($result === false) ? false : true);
238        }
239
240        /**
241         * Atualiza uma aplicação externa
242         * @param int $externalApplicationID O ID da aplicação externa
243         * @param string $name O nome da aplicação externa
244         * @param string $description A descrição da aplicação externa
245         * @param string $address O endereço da aplicação externa
246         * @param string $image O nome da imagem da aplicação externa
247         * @param int $authentication Indica se a aplicação externa autentica (1) ou não (0)
248         * @param string $post Os dados que são postados para a aplicação externa (caso necessite de autenticação)
249         * @param int $removeCurrentImage Indica se a imagem atual da aplicação externa será removida (1 para remover e 0 para não remover)
250         * @param int $intranetOnly Indica se a aplicação externa só será visível na Intranet (1 somente Intranet e 2 para cliente de qualquer origem)
251         * @return bool TRUE se a ação foi concluída com êxito e FALSE caso contrário
252         * @access public
253         */
254        function updateExternalApplication($externalApplicationID, $name, $description, $address, $image, $authentication, $post, $removeCurrentImage, $intranetOnly)
255        {
256                $this->_checkAccess();
257
258                if (count($errors = $this->checkExternalApplicationData($name, $address)) > 0)
259                        return array('error' => implode("\n", $errors));
260
261                /* if a new image is supplied, decode the data */
262                if ($image != '')
263                {
264                        $image = str_replace(' ', '+', $image);
265                        $imageData = base64_decode($image);
266                        if ($imageData !== false)
267                                $imageData = unserialize($imageData);
268                        if ($imageData !== false)
269                        {
270                                $image = strtolower(end(explode('.', $imageData['name'])));
271                                if (($image != 'png') && ($image != 'jpg') && ($image != 'gif'))
272                                        return array('error' => 'A imagem enviada não é do tipo JPG, PNG ou GIF');
273                                $image = $externalApplicationID . '.' . $image;
274                        }
275                        else
276                                $image = null;
277                }
278                else
279                        $image = null;
280
281                /* get the current image */
282                $currentImage = $this->db->getOne('SELECT image FROM egw_wf_external_application WHERE (external_application_id = ?)', array($externalApplicationID));
283
284                /* if necessary, remove the current image */
285                if ((($removeCurrentImage == '1') || (!is_null($image))) && ($currentImage))
286                        if (file_exists($this->EXTERNAL_APPLICATION_PATH . '/' . $currentImage))
287                                unlink($this->EXTERNAL_APPLICATION_PATH . '/' . $currentImage);
288
289                /* if supplied, save the new image */
290                if (!is_null($image))
291                        $this->_saveImage($image, $imageData['contents']);
292                else
293                        if ($removeCurrentImage == '0')
294                                $image = $currentImage;
295
296                /* update the external application */
297                $query = "UPDATE egw_wf_external_application SET name = ?, description = ?, address = ?, image = ?, authentication = ?, post = ?, intranet_only = ? WHERE (external_application_id = ?)";
298                $result = $this->db->query($query, array($name, $description, $address, $image, $authentication, $post, $intranetOnly, $externalApplicationID));
299                $this->_checkError($result);
300
301                return (($result === false) ? false : true);
302        }
303
304        /**
305         * Remove uma aplicação externa
306         * @param int $externalApplicationID O ID da aplicação externa.
307         * @return bool TRUE se a ação foi concluída com êxito e FALSE caso contrário.
308         * @access public
309         */
310        function removeExternalApplication($externalApplicationID)
311        {
312                $this->_checkAccess();
313
314                /* remove the current image */
315                $currentImage = $this->db->getOne('SELECT image FROM egw_wf_external_application WHERE (external_application_id = ?)', array($externalApplicationID));
316                if ($currentImage)
317                        if (file_exists($this->EXTERNAL_APPLICATION_PATH . '/' . $currentImage))
318                                unlink($this->EXTERNAL_APPLICATION_PATH . '/' . $currentImage);
319
320                /* remove the external application */
321                $result = $this->db->query('DELETE FROM egw_wf_external_application WHERE (external_application_id = ?)', array($externalApplicationID));
322                $this->_checkError($result);
323
324                $this->acl->removeAdminsFromResource('APX', $externalApplicationID);
325
326                return (($result === false) ? false : true);
327        }
328}
329?>
Note: See TracBrowser for help on using the repository browser.