Переработка - API3 Объект — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показано 10 промежуточных версий 3 участников)
Строка 2: Строка 2:
  
 
===Объект===
 
===Объект===
−
* ИдИС - идентификатор документа в ИС (строка)
+
Тип: Документ
−
* Номер - номер документа (строка)
+
 
−
* Дата - дата документа (строка в формате "ДД.ММ.ГГГГ")
+
'''Структура:'''
−
* НашаОрганизация - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
+
* ИдИС — идентификатор документа в ИС, строка
−
* МеткаРабочегоВремени  - объект [[МеткаРабочегоВремени_-_API3_Объект|МеткаРабочегоВремени]]
+
* Номер* — номер документа, строка
−
* Подразделение  - объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]]
+
* Дата — дата документа, строка в формате "ДД.ММ.ГГГГ"
−
* Причина - строка, берется из комментария
+
* Название — название, строка
−
* ДатаНач - дата начала переработки(строка в формате "ДД.ММ.ГГГГ")
+
* НашаОрганизация* — объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
−
* ДатаКнц - дата конца переработки(строка в формате "ДД.ММ.ГГГГ")
+
* Примечание — строка
−
* Сотрудники - массив записей, данные о сотрудниках в переработке
+
* ДатаНач* — дата начала переработки, строка в формате "ДД.ММ.ГГГГ"
−
** Сотрудник * - объект [[Сотрудник_-_API3_Объект|Сотрудник]]
+
* ДатаКнц — дата конца переработки, строка в формате "ДД.ММ.ГГГГ"
−
** ЧастноеЛицо * - объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]]
+
* Примечание — причина переработки, строка
−
** КоличествоЧасов - строка, количество часов оплачиваемой переработки
+
* <span style="color:#E70000">МеткаРабочегоВремени</span> — объект [[МеткаРабочегоВремени_-_API3_Объект|МеткаРабочегоВремени]]
 +
* Сотрудники — данные о сотрудниках в переработке, массив записей
 +
** ЧастноеЛицо* — объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]]
 +
** Сотрудник — объект [[Сотрудник _-_API3_Объект|Сотрудник ]]
 +
** Отработка — переработка засчитывается в счет отгулов или нет, булево
 +
** МеткаРабочегоВремени — объект [[МеткаРабочегоВремени_-_API3_Объект|МеткаРабочегоВремени]]
 +
** Дни — дни переработок конкретного сотрудника, массив записей
 +
*** ДатаНач — дата переработки, конкретный день, строка в формате "ДД.ММ.ГГГГ"
 +
*** ВремяПлан — длительность переработки, строка в формате "ЧЧ:ММ"
 +
 
 +
 
 +
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
  
 
'''Пример:'''
 
'''Пример:'''
 
<source lang="json">
 
<source lang="json">
 
{
 
{
−
  "Дата": "2018-12-31",
+
    'ИдИС': '6a66b740-fd74-11ee-a19b-74563c66f6c0_1',
−
  "Номер": "2",
+
    'Дата': '18.04.2024',  
−
  "Причина": "переработка необходимости",
+
    'Номер': '00IS-000001/OV/1',  
−
  "ИдСБИС": "18810",
+
    'Название': 'Переработка №00IS-000001/OV/1 от 18.04.2024',  
−
  "ИмяСБИС": "Переработка",
+
    'НашаОрганизация': {
−
  "ДатаНач": "2018-12-31",
+
        'ИмяИС': 'Справочники.Организации',  
−
  "ДатаКнц": "2018-12-31",
+
        'ИдИС': '75b4e7fd-5f44-11ed-9ca5-74d4350d6e6c',  
−
  "НашаОрганизация": {
+
        'ИмяСБИС': 'НашаОрганизация',  
−
     "ИдСБИС": "123",
+
        'Ини': 'СинхВыгрузка_НашаОрганизация'
−
     "ИмяСБИС": "НашаОрганизация"
+
     },  
−
  },
+
     'Примечание': 'Переработка №00IS-000001/OV от 18.04.2024',  
−
  "МеткаРабочегоВремени": {
+
    'Сотрудники': [{
−
    "ИдСБИС": "12313",
+
        'ЧастноеЛицо': {
−
    "ИмяСБИС": "МеткаРабочегоВремени"
+
            'ИмяИС': 'Справочники.ФизическиеЛица',  
−
  },
+
            'ИдИС': '8d454940-7ac4-11ed-9ca6-74d4350d6e6c',
−
  "Подразделение": {
+
            'ИмяСБИС': 'ЧастноеЛицо',  
−
    "ИдСБИС": "12313",
+
            'Ини': 'СинхВыгрузка_ЧастноеЛицо'
−
    "ИмяСБИС": "СтруктураПредприятия"
+
        },  
−
  },
+
        'Сотрудник': {
−
  "Сотрудники" : [
+
            'ИмяИС': 'Справочники.Сотрудники',
−
    {
+
            'ИдИС': '8d45493f-7ac4-11ed-9ca6-74d4350d6e6c',  
−
        "Сотрудник": {
+
            'ИмяСБИС': 'Сотрудник',
−
          "ИдСБИС": "123",
+
            'Ини': 'СинхВыгрузка_Сотрудник'
−
          "ИмяСБИС": "Сотрудник"
+
         },  
−
         },
+
         'Отработка': False,
−
         "ЧастноеЛицо": {
+
        'Примечание': 'Переработка №00IS-000001/OV от 18.04.2024',  
−
          "ИдСБИС": "123",
+
        'МеткаРабочегоВремени': {
−
          "ИмяСБИС": "ЧастноеЛицо"
+
            'ИмяСБИС': 'МеткаРабочегоВремени',
−
        },
+
            'ИдИС': 'ПолуторнаяСтавка',  
−
        "КоличествоЧасов": "3"
+
            'Ини': 'СинхВыгрузка_МеткаРабочегоВремени'
−
    },
+
        },  
−
    {
+
         'Дни': [{
−
         "Сотрудник": {
+
            'ДатаНач': '08.04.2024',  
−
          "ИдСБИС": "321",
+
            'ВремяПлан': '02:00'
−
          "ИмяСБИС": "Сотрудник"
+
         },  
−
         },
+
         {
−
         "ЧастноеЛицо": {
+
            'ДатаНач': '11.04.2024',  
−
          "ИдСБИС": "321",
+
            'ВремяПлан': '02:00'
−
          "ИмяСБИС": "ЧастноеЛицо"
+
         }]
−
         },
+
    }],  
−
        "КоличествоЧасов": "3"
+
    'ИмяСБИС': 'Переработка',
−
     }
+
     'ДатаНач': '08.04.2024',
−
  ]
+
    'ДатаКнц': '11.04.2024',
−
 
+
    'ИмяИС': 'Документы.РаботаСверхурочно'
 
}
 
}
 
</source>
 
</source>
  
 
===Естественные ключи===
 
===Естественные ключи===
−
* Ключ1 - номер документа + дата документа + организация (вес = 3)
+
* Ключ1 — номер документа + дата документа + организация (вес = 3)
−
** Ключ1_1 - номер документа
+
** Ключ1_1 — номер документа
−
** Ключ1_2 - дата документа
+
** Ключ1_2 — дата документа
−
** Ключ1_3 - идентификатор организации
+
** Ключ1_3 — идентификатор организации
−
* Ключ2 - не используется
+
* Ключ2 — не используется
−
* Ключ3 - не используется
+
* Ключ3 — не используется
  
 
===Зависит от объектов===
 
===Зависит от объектов===
Строка 79: Строка 90:
 
* ЧастноеЛицо
 
* ЧастноеЛицо
 
* МеткаРабочегоВремени
 
* МеткаРабочегоВремени
−
* СтруктураПредприятия
+
 
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===

Текущая версия на 16:18, 9 октября 2024

Документ оплате сверхурочных часов (переработка). Сейчас существует только выгрузка из ИС в СБИС (зуп 2.5)

Объект

Тип: Документ

Структура:

  • ИдИС — идентификатор документа в ИС, строка
  • Номер* — номер документа, строка
  • Дата — дата документа, строка в формате "ДД.ММ.ГГГГ"
  • Название — название, строка
  • НашаОрганизация* — объект НашаОрганизация
  • Примечание — строка
  • ДатаНач* — дата начала переработки, строка в формате "ДД.ММ.ГГГГ"
  • ДатаКнц — дата конца переработки, строка в формате "ДД.ММ.ГГГГ"
  • Примечание — причина переработки, строка
  • МеткаРабочегоВремени — объект МеткаРабочегоВремени
  • Сотрудники — данные о сотрудниках в переработке, массив записей
    • ЧастноеЛицо* — объект ЧастноеЛицо
    • Сотрудник — объект Сотрудник
    • Отработка — переработка засчитывается в счет отгулов или нет, булево
    • МеткаРабочегоВремени — объект МеткаРабочегоВремени
    • Дни — дни переработок конкретного сотрудника, массив записей
      • ДатаНач — дата переработки, конкретный день, строка в формате "ДД.ММ.ГГГГ"
      • ВремяПлан — длительность переработки, строка в формате "ЧЧ:ММ"


Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону

Пример: 

{
    'ИдИС': '6a66b740-fd74-11ee-a19b-74563c66f6c0_1', 
    'Дата': '18.04.2024', 
    'Номер': '00IS-000001/OV/1', 
    'Название': 'Переработка №00IS-000001/OV/1 от 18.04.2024', 
    'НашаОрганизация': {
        'ИмяИС': 'Справочники.Организации', 
        'ИдИС': '75b4e7fd-5f44-11ed-9ca5-74d4350d6e6c', 
        'ИмяСБИС': 'НашаОрганизация', 
        'Ини': 'СинхВыгрузка_НашаОрганизация'
    }, 
    'Примечание': 'Переработка №00IS-000001/OV от 18.04.2024', 
    'Сотрудники': [{
        'ЧастноеЛицо': {
            'ИмяИС': 'Справочники.ФизическиеЛица', 
            'ИдИС': '8d454940-7ac4-11ed-9ca6-74d4350d6e6c', 
            'ИмяСБИС': 'ЧастноеЛицо', 
            'Ини': 'СинхВыгрузка_ЧастноеЛицо'
        }, 
        'Сотрудник': {
            'ИмяИС': 'Справочники.Сотрудники', 
            'ИдИС': '8d45493f-7ac4-11ed-9ca6-74d4350d6e6c', 
            'ИмяСБИС': 'Сотрудник', 
            'Ини': 'СинхВыгрузка_Сотрудник'
        }, 
        'Отработка': False, 
        'Примечание': 'Переработка №00IS-000001/OV от 18.04.2024', 
        'МеткаРабочегоВремени': {
            'ИмяСБИС': 'МеткаРабочегоВремени', 
            'ИдИС': 'ПолуторнаяСтавка', 
            'Ини': 'СинхВыгрузка_МеткаРабочегоВремени'
         }, 
        'Дни': [{
            'ДатаНач': '08.04.2024', 
            'ВремяПлан': '02:00'
        }, 
        {
            'ДатаНач': '11.04.2024', 
            'ВремяПлан': '02:00'
        }]
    }], 
    'ИмяСБИС': 'Переработка', 
    'ДатаНач': '08.04.2024', 
    'ДатаКнц': '11.04.2024', 
    'ИмяИС': 'Документы.РаботаСверхурочно'
}

Естественные ключи

  • Ключ1 — номер документа + дата документа + организация (вес = 3)
    • Ключ1_1 — номер документа
    • Ключ1_2 — дата документа
    • Ключ1_3 — идентификатор организации
  • Ключ2 — не используется
  • Ключ3 — не используется

Зависит от объектов

  • НашаОрганизация
  • Сотрудник
  • ЧастноеЛицо
  • МеткаРабочегоВремени


Используемые методы БЛ

  • Переработка.Прочитать
  • Переработка.Создать
  • Переработка.Записать
  • XmlJson.Convert
  • ЛицоДокумента.СписокЛицДокументаСЗатратами
  • ЛицоДокумента.Удалить
  • ЛицоДокумента.Создать
  • ЛицоДокумента.ЗаписатьВсехСотрудниковПереработки
Источник — «http://wiki.razgovorov.ru/index.php?title=Переработка_-_API3_Объект&oldid=6871»