本任务的目的是通知通信终端向外发送一条短信。在此,我们对GSM通信终端、CDMA通信终端均采用同一规范,不做区分。同时,我们对发送普通短信与发送长短信也不做区分。对发送英文短信与中文短信仍不做区分。这样,可以极大限度的方便大家编程,提供程序效率。本任务文件的书写规范如下:
行号 | 应书写内容 | 示范 |
0 | 固定格式:“1”或者“发送常规短信”,代表当前我们的要做的事情就是发送一条短信出去。 | 1 |
1 | 当前任务在贵系统中的唯一任务ID(0表示由中间件自动分配)。为了方便大家准确跟踪每一个任务的最终执行情况,我们应该对每一个任务分配一个唯一的ID,即标识。任务ID的书写可以由任何字母或数字及其组合构成,其中不得包含括号。如果您无需跟踪一个任务的执行结果,可以将此任务ID设置为0。 | 0 |
2 | 指定端口号或资费卡(0表示自动分配)。表示指定使用哪一个端口或哪一张资费卡来执行本次任务。如果设置为0,就由中间件系统自动为其分配一个端口。自动分配端口的原则是在网内执行任务。也就是说,如果您对移动用户发送短信,系统将自动查找移动设备来进行发送,如果找不到移动设备,系统就会返回自动分配端口失败。如果同时发现了多个移动设备,系统会优先分配本月做事最少的设备来进行本次作业。 | 0 |
3 | 有效期截止时间(0表示永不过期,否则必须设置为一个有效的具体时间,如:2010-1-1 12:00:00)。由于设备繁忙等因素,未必您每次提交的任务都能得到及时的处理。本设置的意义在于通知中间件,如果当前时间已经超过本有效期设定,则放弃执行本次任务,直接返回失败。 | 0 |
4 | 接收方号码,即本条短信发送给谁。每个任务中只能指定一个号码。如果需要同时发送多条短信,请自行循环提交多个任务文件。号码前不得加国家码或者区号、0等字符。目前本系统暂时不支持发送国际短信和港澳台短信。 | 13456886648 |
5 | 短信内容。即本条短信的正文部分,不能为空。如果您所输入的短信内容超过了一条普通短信所能容纳的最大限度,系统将自动启用长短信功能进行发送。请注意:发送长短信,运费商会按照发送多条普通短信计费,具体扣费标准见下面第9行中的描述,而不是只扣一条短信的费用。如果在您的短信内容中必须包含回车、换行或者制表字符,请使用{{回车}}、{{换行}}或者{{制表}}来代替。 | 老公老公我爱你,{{换行}}阿弥陀佛保佑你,{{换行}}愿你事事都如意,{{换行}}我们不分离。 |
6 | 参考信息。参考信息的作用在于跟踪对方回复。当您发出一条短信后,如果对方对其进行了回复,那么您在此所设置的参考信息将被传递回来。如果同一个端口向同一个号码连续发送了多条信息,那么系统只能传回最后一次发送时您所设定的参考信息。参考信息的书写规范与任务ID的书写规范一样,可以由任何字母或数字及其组合构成。 | ABCDEFG-1234567 |
7 | 优先级别。只有当使用CDMA通信终端给C网用户发送短信时方可支持本功能。可取值1~4,数值越大越优先。0表示不支持。当CDMA手机收到此类短信的时候,屏幕上可能会出现“加急”等字样。 | 0 |
8 | 回拨号码。同上,仅C网网内短信支持,0表示不支持。当CDMA手机收到此类消息的时候,屏幕上可能会出现您在此所设置的回拨号码,用来提醒用户如果要回复的话请拨打本号码。回拨号码不一定要是实际存在的号码,因此,您还可以利用本功能扩展出其他功能。 | 0 |
9 | 数据编码。0表示自动选择。除此之外,您还可以将此值设置为7、8或16,分别表示采用7BIT、8BIT或者16BIT的编码方式来发送本条短信。凡是包含中文信息的短信,哪怕其中只有一个中文文字,都只能采用16BIT的编码模式,在这种模式下发送普通短信,每条短信最多只能容纳70个字符;如果发送长短信,则按照每67个字扣费一条的方式进行扣费。纯英文信息通常采用7BIT的编码模式发送,在这种模式下发送普通短信,每条短信最多可以容纳160个字符;如果发送长短信,则按照每153个字符扣费一条的方式进行扣费。在某种特殊情况下我们发送纯英文信息也可以采用8BIT的编码模式发送,在这种模式下发送普通短信,每条短信可以容纳140个字符;如果发送长短信,则按照每134个字符扣费一条的方式进行扣费。个别手机可能不支持显示8BIT短信,届时用户可能会收不到该短信、看不见内容或者看到的只是乱码,严重时甚至可能会导致手机系统崩溃,当然这种情况只会发生在劣质手机身上,也许用户早就想鸟枪换炮了。 | 0 |
10 | 发送失败后的可重试次数,0表示禁止重试,此值设置最多不得超过9。某些时候,由于网络故障或者信号不好等原因可能导致短信发送失败,设置此项值后在这种情况下系统就会自动进行重试,而不会直接返回失败。但是请注意,某些重要短信并不能轻易重试,如在空中充值系统中发送的充值指令短信,在这种情况下就建议最好设置为0,否则极有可能给用户带来某种不可估量且无法挽回的经济损失或者其他损失。 | 0 |