[расширение] Добавление работ в 1С:Документооборот с использованием inline-бота telegram

upd 2024.12.14

1. Развернул на самом дешевом VPS DigitalOcean.com на центос 7 и бот продолжил свою работу
2. Немного подправил код 

upd 2024.03.08

1. Добавил реализацию для развертки на CentOS 7
2. Переписал с python-telegram-bot на другую библиотеку pyTelegramBotAPI
3. Время на переписки/разговоры с заказчиками при сдаче работ существенно сократилось — на вопрос как доказать выполнение работ обычно достаточно просто форварднуть сообщение с подписью пользователя

upd 2024.12.21

1. Добавил сортировку проектов на стороне ДО по убыванию количества фактических часов за прошедшие 3 месяца
2. Кнопки убираются после проведения записи в ежедневный отчет

upd 2024.11.25

В связи с выходом 8.3.11 переделал на расширение для 1С:Документооборот

В нашей организации применяется почасовка, и в документообороте необходимо каждый день вбивать описание сделанных работ в ежедневный отчёт. Менеджер в конце периода собирает все, что туда запостили сотрудники, и рассылает на согласование заказчикам. Поэтому, чтобы не возникало лишних вопросов от заказчика, желательно максимально подробно описать то, что было сделано.

Вроде все логично, но заполнять эти отчёты жутко лень. И это заполнение откладывается на последние дни перед закрытием. И вот в момент заполнения уже и особо не помнишь, что там было сделано.

Плюс периодически и заказчик может пойти в отказ. Типа не делалось это, а если и делалось, то не два часа, а пятнадцать минут.

Пробовал вести записи на каждый день, пока едешь в метро. Но и это если и помогало, то недолго. И не решало проблемы с заказчиками, которые отказывались подписывать эти работы.

Для решения вышеперечисленных проблем решил сделать инлайн бота в telegram.

Выглядеть это должно было примерно следующим образом:
1. Пишешь в чатике с заказчиком, что сделано
2. Ставишь часы
3. Указываешь проект
4. Просишь заказчика подписать сразу же
5. По нажатию "провести" запись попадает в мой ежедневный отчет

Исходя из задачи от ДО мне надо:
1. Получить список проектов по пользователю
2. Записать проект часы в документ ежедневный отчёт

Эту задачу решил подняв http-сервис. Вдохновением была статья с курсов-по-1с.

Бот должен делать следующее:
1. Из инлайн команды создавать сообщение
2. Читать список проектов из http-сервиса ДО
3. Позволять редактировать затраченное время
4. Иметь возможность фиксировать подпись заказчика
5. Постить результат в ДО используя http-сервис

Бота решил писать на python

Для решения решил задействовать поднятый у нас разработческий сервер на CentOS 6.

Для теста создал простейшую базу на 1С и опубликовал ее через Apache

Общение с api telegram происходит с использованием telegram-bot-api. В момент написания первого бота использовал эту статью.

#!/usr/bin/python
import gstdobot2config #файл с настройками
import telebot
import time
import sys
from telebot import types
import json, requests

bot = telebot.TeleBot(gstdobot2config.token)
messagedata = {}
timebutton = [u"+1ч", u"+30м", u"+15м", u"-15м", u"-30м", u"-1ч"]
timevalues = [60*60,    60*30,   60*15,  -60*15,  -60*30, -60*60]

def getmessagetext(data):
return '<b>{0}</b>
{1}
<b>{2}</b>
{3}
<b>{4}</b>
{5} ч
<b>{6}</b>
{7}
<b>{8}</b>
{9}
<b>{10}</b>
{11}'.format(
u"Описание работы:", data['WorkDescription'],
u"Сотрудник:", data['UserID'],
u"Затрачено времени:", data['Duration']/60/60,
u"Проект:", data['Project']['Name'],
u"Подписано:", data['Signed'],
u"Проведено:", data['Posted'])

def getkeyboard(dataid, userid, start, stop):
try:
getTimeIKB = lambda name: types.InlineKeyboardButton(name, callback_data='t:'+str(timebutton.index(name))+':'+dataid)
projects = requests.get(gstdobot2config.urlProjects + userid,auth=(gstdobot2config.login, gstdobot2config.password)).json()
getProjectIKB = lambda project: types.InlineKeyboardButton(project['Name'], callback_data='p:'+str(projects.index(project))+':'+dataid)
back    = types.InlineKeyboardButton('U92;', callback_data='g:0:'+dataid)
forward = types.InlineKeyboardButton('U94;', callback_data='g:1:'+dataid)
btns = []
if start == 1:
btns = list(map(getProjectIKB, projects))[:5] + [forward]
elif stop == len(projects)-1:
btns = [back] + list(map(getProjectIKB, projects))[-5:]
else :
btns = [back] + list(map(getProjectIKB, projects))[start:stop] + [forward]
keyboard = types.InlineKeyboardMarkup()
keyboard.row(*btns)
btns = list(map(getTimeIKB, timebutton))
keyboard.row(*btns)
keyboard.row(types.InlineKeyboardButton(u"Подписать", callback_data='s:0:'+dataid), types.InlineKeyboardButton(u"Провести", callback_data='w:0:'+dataid))
return keyboard
except Exception as e:
print(e)

@bot.inline_handler(lambda query: len(query.query) > 10)
def query_text(inline_query):
try:
data = {'Project': {'Name':'','Code':''},
'UserID': str(inline_query.from_user.id),
'WorkType': u"ПУСТО",
'Duration': 0,
'Start': 1,
'Stop': 5,
'Signed': [],
'Posted': u"НЕТ",
'WorkDescription': inline_query.query}
dataid = inline_query.id
messagedata[dataid] = data
keyboard = getkeyboard(dataid, data['UserID'], data['Start'], data['Stop'])
result = types.InlineQueryResultArticle(
id=inline_query.id,
title=inline_query.query, description="Описание работы",
input_message_content=types.InputTextMessageContent(message_text=getmessagetext(data), parse_mode='HTML'),
reply_markup = keyboard
)
bot.answer_inline_query(inline_query.id, [result])
except Exception as e:
print(e)

@bot.callback_query_handler(func=lambda cmd: True)
def inline(cmd):
try:
buttontype, buttonid, messageid = cmd.data.split(':')
data = messagedata[messageid]
projects = requests.get(gstdobot2config.urlProjects + data['UserID'],auth=(gstdobot2config.login, gstdobot2config.password)).json()
if buttontype == 't':
data['Duration'] = data['Duration'] + timevalues[int(buttonid)]
elif buttontype == 'p':
data['Project'] = projects[int(buttonid)]
elif buttontype == 'g' and buttonid == '0':
data['Start'] = max(1, data['Start']-4)
data['Stop'] = max(5,data['Start']+4)
elif buttontype == 'g' and buttonid == '1':
data['Stop'] = min(len(projects)-1, data['Stop']+4)
data['Start'] = min(len(projects)-5, data['Stop']-4)
elif buttontype == 'w':
writedata = {'WorkType': 'общие'}
writedata['UserID'] = data['UserID']
writedata['WorkDescription'] = data['WorkDescription']
writedata['ProjectCode'] = data['Project']['Code']
writedata['Duration'] = data['Duration']
r = requests.post(gstdobot2config.urlPost, json=writedata,auth=(gstdobot2config.login, gstdobot2config.password))
data['Posted'] = u"ДА"
elif buttontype == 's':
voter = str(cmd.from_user.first_name) + ' ' + str(cmd.from_user.last_name);
if not voter in set(data['Signed']):
data['Signed'].append(voter)
content = getmessagetext(data)
bot.edit_message_text(
inline_message_id=cmd.inline_message_id,
text=content, parse_mode="HTML"
)
if data['Posted'] == u"НЕТ":
bot.edit_message_reply_markup(
inline_message_id=cmd.inline_message_id,
reply_markup=getkeyboard(messageid, data['UserID'], data['Start'], data['Stop'])
)
except Exception as e:
print(e)


def main_loop():
bot.polling(True)
while 1:
time.sleep(3)


if __name__ == '__main__':
try:
main_loop()
except KeyboardInterrupt:
print >> sys.stderr, '
Exiting by user request.
'
sys.exit(0)

Еще надо было создать службу что бы она запускалась. Это для CentOS 6:

#!/bin/sh
### BEGIN INIT INFO
# Provides:          gst-do-telegram-bot
# Required-Start:    $local_fs $network $named $time $syslog
# Required-Stop:     $local_fs $network $named $time $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Description:       gst do telegram bot
### END INIT INFO

SCRIPT='/usr/bin/python3 /usr/local/bin/gstdobot.py'
RUNAS=root

PIDFILE=/var/run/gst-do-telegram-bot.pid
LOGFILE=/var/log/gst-do-telegram-bot.log

start() {
if [ -f /var/run/$PIDNAME ] && kill -0 $(cat /var/run/$PIDNAME); then
echo 'Service already running' >&2
return 1
fi
echo 'Starting service…' >&2
local CMD="$SCRIPT &> "$LOGFILE" & echo $!"
su -c "$CMD" $RUNAS > "$PIDFILE"
echo 'Service started' >&2
}

stop() {
if [ ! -f "$PIDFILE" ] || ! kill -0 $(cat "$PIDFILE"); then
echo 'Service not running' >&2
return 1
fi
echo 'Stopping service…' >&2
kill -15 $(cat "$PIDFILE") && rm -f "$PIDFILE"
echo 'Service stopped' >&2
}

uninstall() {
echo -n "Are you really sure you want to uninstall this service? That cannot be undone. [yes|No] "
local SURE
read SURE
if [ "$SURE" = "yes" ]; then
stop
rm -f "$PIDFILE"
echo "Notice: log file is not be removed: '$LOGFILE'" >&2
update-rc.d -f gst-do-telegram-bot remove
rm -fv "$0"
fi
}

case "$1" in
start)
start
;;
stop)
stop
;;
uninstall)
uninstall
;;
restart)
stop
start
;;
*)
echo "Usage: $0 {start|stop|restart|uninstall}"
esac

А это для CentOS 7:

[Unit]
Description=GST support DO telegram bot
After=syslog.target
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/usr/local/bin/gstdobot
ExecStart=/usr/bin/python3 /usr/local/bin/gstdobot/gstdobot2.py
RestartSec=10
Restart=always

[Install]
WantedBy=multi-user.target

Из моментов, которые реализованы откровенно плохо
1. При печати сообщения в инлайн запоминаются лишние итерации, побороть можно фиксируя нужную итерацию при посте этого сообщения, но как это сделать, пока не разобрался.
2. Нет сортировки проектов, хочу сделать на стороне ДО сортировать по убыванию количества запощенных часов
3. Не убираются кнопки после проведения записи в ежедневный отчет

Использую бота уже неделю, пока заполнять не так обломно, как лезть в ДО или восстанавливать свои сокращения перед выставлением счетов.

Посмотрим, что будет с заказчиками которые любили резать часы.

Содержание архива для CentOS 6: 

gst-do-telegram-bot — файл для запуска сервиса разместил на CentOS 6 в каталоге /etc/init.d
gstdobot.py — бот на питоне разместил на CentOS 6 в каталоге /usr/local/bin/
gstdobotconfig.py — конфиг файл где, кто, куда разместил на CentOS 6 в каталоге /usr/local/bin/
telegram-http-service.dt — пример реализации со стороны 1С:Предприятия — для работы с ботом должна быть опубликована и видна из инета — (логин:пароль — X:1qaz2wsx)

Содержание архива для CentOS 7: 

gst-do-telegram-bot.service — файл для запуска сервиса разместил на CentOS 7 в каталоге /etc/systemd/system/
gstdobot2.py — бот на питоне разместил на CentOS 7 в каталоге /usr/local/bin/gstdobot/
gstdobot2config.py — конфиг файл где, кто, куда разместил на CentOS 7 в каталоге /usr/local/bin/gstdobot/
telegram-http-service.dt — пример реализации со стороны 1С:Предприятия — для работы с ботом должна быть опубликована и видна из инета — (логин:пароль — X:1qaz2wsx)