Пример создания плагина

Здравствуйте,

Распишу по объектам в БД VOGBIT, что нужно по минимуму для такой задачи создавать в базе. Коллеги подскажут, если нужно, по коду, по тем моментам, которые, возможно, не ясны.

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

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

Разберем по шагам.

Деталь – номенклатурная позиция.

Техпроцесс детали – коллекция компонентов, у которой Owner = номенклатура «Деталь». Тип связи коллекции нужно поставить LT_ManProcess (здесь и далее везде пишу для используемых типов связей, параметров, статусов их идентификаторы). Обозначение коллекции ставьте любое, какое хотите. Статус ставьте тоже любой какой нравится, только НЕ ST_Invalid. Любой другой. Например, ST_Designing.

Дальше добавляем в техпроцесс операции. Операция сама – это номенклатурная позиция. Находим нужную в справочнике и добавляем её, как компонент в коллекцию LT_ManProcess (техпроцесс детали). Тип связи компонента ставим LT_Operation. Количество и единицу измерения не заполняем для этого компонента, оставляем пустыми.

Дальше нужно для операции задать место выполнения и трудоемкость.

Место выполнения (участок), в принципе, у Вас может быть настроено в самом VOGBIT по умолчанию для «операции» в справочнике «Номенклатура». Тогда в техпроцессе уже указывать в явном виде его не нужно, при формировании заданий «подхватится» настроенный по умолчанию участок. Чтобы указать в явном виде для операции место выполнения в техпроцессе, находим в справочнике «Подразделения» нужный производственный участок и добавляем его к компоненту  LT_Operation (операции) в коллекции LT_ManProcess (в техпроцессе), как связанный объект с типом связи LT_Place.

Если вы используете пооперационное нормирование, то чтобы потом создались задания для производства, нужно ещё добавть хоть какую-нибудь «Трудоемкость» к операции. Для этого добавьте параметр T_OPR_HOUR (float) к компоненту LT_Operation (операции) в коллекции LT_ManProcess (в техпроцессе), значение = Тшт в часах.

Всё, по минимуму – достаточно.

Т.е. создаете номенклатуру деталей. К каждой детали коллекцию LT_ManProcess (техпроцесс), в неё добавляете нужные компоненты LT_Operation (операции), к каждому такому компоненту добавляете связанный объект LT_Place (подразделение, участок), и параметр T_OPR_HOUR (трудоемкость).

На этом то, что вставлять в «заказ» у нас есть.

Переходим к созданию и заполнению «Производственного заказа».

Создаёте номенклатурную позицию – «Заказ». Обозначение и наименование – по Вашему усмотрению.

Для этой номенклатурной позиции создаёте коллекцию компонентов LT_MAN_CHART (тех. карта заказа). Обозначение коллекции ставьте любое, какое нравится, статус ставьте ST_InWork (с любым другим её не будет видно в окне «Производственные заказы»).

В эту коллекцию LT_MAN_CHART добавляете из номенклатуры созданные нами ранее «Детали», как компоненты. Тип связи при этом можете использовать, в принципе, почти какой хотите, тут нет особых ограничений, но стандартно используется LT_Product (изделие). В некоторых случаях - LT_Part (деталь), LT_Assemble_Unit (сборочная единица). Обязательно поставьте для компонентов в коллекции LT_MAN_CHART (позиций в карте заказа) количество и единицы измерения (в подавляющем большинстве случаев ставится «шт»).

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

P.S.

В заключении вставлю свои 5 копеек…

Для пользователей, у которых «каждый новый заказ – это новая номенклатура», но при этом само производство довольно простое, в современных версиях VOGBIT есть некоторое количество штатных, встроенных функций, которые довольно сильно зачастую облегчают жизнь простым пользователям, без необходимости прибегать к программированию. Например:

• Штатная встроенная функция «загрузки» номенклатуры из Excel файла;

• Функция создания номенклатуры «из списка файлов» - это для случаев, когда в качестве исходных данных по некоему «заказу» на входе у пользователя есть папка с какими-нибудь PDF с чертежами деталей или DXFс развертками и т.п. Есть в современном VOGBIT такая функция – взять мышкой эти файлы из папки и «перетащить» их в окно VOGBIT. И при этом создается в базе номенклатура с названием, как имя файла, и сами файлы сразу к ней прицепляются. Умеет эта штука даже «разбирать» сама название файла автоматически на «обозначение» и «наименование», но только для случаев, когда имена файлов составлены по принципу <обозначение_наименование> (или наоборот).

• Если по содержанию техпроцесса много деталей в заказе ничем не отличаются, то необязательно в современном VOGBIT делать отдельный техпроцесс на каждую такую деталь. Можно сделать штатными средствами в базе один «техпроцесс-шаблон», а потом просто добавить (не создавая технологии для каждой отдельно) детали в состав производственного заказа, выделить там их все и сказать «делать все, вот по этому шаблону техпроцесса». И всё, можно сразу создавать задания для производства.

Вот эти вещи есть в VOGBIT (в последних версиях) уже готовые, "из коробки".

long CreateManProcess(long nmkId)
{
   var ccs = ExtensibleApplication.Application.General.ComponentCollections(nmkId);
   var cc = ccs.AddNew();
   try
   {
      cc.Notation.Value = "Техпроцесс";
      cc.LinkTypeID.Value = //сюда ID типа связи с UID = LT_ManProcess>
      cc.StatusID.Value = //сюда ID статуса
      cc.Save();
   }
   finally
   {
      cc.Cancel();
   }

   return cc.ID.AsLongInt;
}

Компонент. На входе Id ТП и Id номенклатуры операции (в вашем случае tokarkaID):

long AddOperation(long collectionId, long compNmkId)
{
   var comps = ExtensibleApplication.Application.General.Components(collectionId);
   var comp = comps.AddNew();
   try
   {
      comp.NomenclatureID.Value = compNmkId;
      comp.LinkTypeID.Value = //сюда ID типа связи с UID = LT_Operation>
      comp.Save();
   }
   finally
   {
      comp.Cancel();
   }
}

ObjectParameter AddObjectParameter(long objectId, long parameterId, object parameterValue)
{
   var objectParameters = Utils.App.General.ObjectParameters(objectId);
   var objParam = objectParameters.AddNew();
   try
   {
      objParam.ParameterID.Value = parameterId;
      objParam.ParameterValue.Value = parameterValue;
      objParam.Save();
   }
   finally
   {
      objParam.Cancel();
   }
   return objParam;
}