ionic-otrs-app

a otrs(Open-source Ticket Request System) app base on ionic
基于Ionic开发的Otrs(http://www.otrs.com/?lang=zh-hans IT运维管理/客服系统)手机客户端
主要实现客户新增、查询工单、投诉、加急处理的功能

##0.安装开发环境

安装node.js
安装ionic
npm install -g cordova ionic
以下工具打包ap时要用到，在浏览器中运行用不到 ** 安装 jdk ** 安装 ant ** 安装 git ** 安装 android sdk
代码编辑工具推荐brackets
ionic参考文档主要有 http://codepen.io/ionic/public-list/
http://ionicframework.com/docs/

##1.运行程序 ###下载源码 git clone https://github.com/little51/ionic-otrs-app.git
或download zip ###下载依赖包

在ionic-otrs-app目录下执行：npm install
为了使用gulp，还需要执行：npm install gulp -g
最新版的gulp-connect在windows上由于对盘符大小写判断有误，会出现403错误（ubuntu上正常），具体解决方法如下修改ionic-otrs-app\node_modules\gulp-connect\node_modules\connect\node_modules\serve-static\node_modules\send\lib\send.js
注释掉第413行,return this.error(403)

###启动程序 gulp

###运行App（在浏览器中测试）为了解决跨域访问问题

Linux：chromium-browser --disable-web-security&
Window:chrome浏览器启动项加 --disable-web-security
彻底解决跨域问题的方案通过apache proxy实现cors,浏览器用正常模式启动
修改/etc/httpd/conf/httpd.conf，在最后一行增加：

<LocationMatch "/otrs/Webservice">  #webservice地址变成了http://ip/otrs/Webservice/
  ProxyPass http://localhost/otrs/nph-genericinterface.pl/Webservice/GenericTicketConnector
  Header always set Access-Control-Allow-Origin "*"
  Header always set Access-Control-Allow-Methods "POST,GET,OPTIONS,DELETE,PUT"
  Header always set Access-Control-Max-Age "1000"
  Header always set Access-Control-Allow-Headers "Content-Type,x-requested-with,Access-Control-Allow-Headers"
  RewriteEngine On
  RewriteCond %{REQUEST_METHOD} OPTIONS #跨域时，chrome会先发options请求，但otrs未实现options响应，所以要过滤掉
  RewriteRule ^(.*)$ $1 [R=200,L]
</LocationMatch>

http://localhost:8080
用户名：640001 口令:0000

##2.将ionic-otrs-app用于您的otrs ###导入GenericTicketConnector webservice接口 http://yourhost/otrs/index.pl?Action=AdminGenericInterfaceWebservice
导入 ionic-otrs-app\ws\GenericTicketConnector.yml
###修改app中webservice调用指向修改 ionic-otrs-app\www\js\app.js中的wsUrl变量值

打包App到Android apk，参见 http://ionicframework.com/docs/guide/publishing.html

##3.用到的技术要点

gulp管理包依赖关系
gulp-connect 实现web监听（浏览器环境下）
GenericInterfaceWebservice 实现App调用otrs后台
locationChangeStart event拦截实现Session控制
$window.localStorage 实现Session的本地持久
ion-infinite-scroll 实现分页

##4.文件列表 index.html 主页面 js:

app.js 路由和模块引入
authservices.js 登录控制
common.js xml转json
controllers.js 控制器
ticketservices.js工单查询服务 templates:
about.html 关于
login.html 登录
myinfo.html 我的
tabs.html Tab
ticket-detail.html 工单详细
ticket-index.html 工单索引

##5.license MIT license

diego-mi/ionic-otrs-app

ionic-otrs-app