Тази е основната функция и е предназначена да импортира заработки от друга система.

Добре е всяка ПК да е с една рецепта (макар да не е задължително, но така се улеснява проверата в последствие, ако е необходимо)! Това е нормален случай, когато ПК е и маршрутна карта за производството на дадени изделия. В данните лисва номера на рецептата и заработката ще се въведе във всички рецепти от ПК (с номер CNum), в чиито списък с операции и работни центрове присъстват тези от импортирания запис.

Идентификацията се извършва по idOperCard, RefNum.

Функцията работи по следния начин:

Детайлно, работата на функцията е разгледана по-нататък.

Функция за автоматизирано въвеждане и обновяване на списъка с работници от външната система към Colibri® ERP. Структурата на подаваните от външната система данни е следната:

 
array(
    	"idPersonal" => array("name" => "idPersonal", "type" => "xsd:integer")
    	, "PersNum" => array("name" => "PersNum", "type" => "xsd:string")
    	, "RefNum" => array("name" => "RefNum", "type" => "xsd:string")
    	, "PersName" => array("name" => "PersName", "type" => "xsd:string")
    	, "isActive" => array("name" => "isActive", "type" => "xsd:integer")
)

              

Задължителни полета са:

Ето един примерен масив в PHP код, който може да бъде подаван от външна система, за да се допълва или модифицира списъка с персонала в Colibri® ERP:

$workman[] = 
      	array(
      		"RefNum" => "YYYYY"
      		, "PersName" => "Харалампи Хаджипокарахаралампиев"
      		, "isActive" => "1"
      	);

              

Ако в списъка с персонала на Colibri® ERP липсва човек с RefNum, посочен в записа, то се добавя нов работник в този списък.

Ако в списъка с персонала на Colibri® ERP вече има човек с RefNum, посочен в записа, се модифицират неговото име в съответствие с PersName, а неговата активност спрямо Colibri® ERP в съответствие със стойността на isActive.

Функцията връща масив от записи, съдържащи данните за наличните в Colibri® ERP операции от списъка с операции, заедно със съответния работен център (сектор).

Структурата на получавания масив е следната:

array(
    	"idOper" => array("name" => "idOper", "type" => "xsd:integer")
    	, "idSector" => array("name" => "idSector", "type" => "xsd:integer")
    	, "ONum" => array("name" => "ONum", "type" => "xsd:string")
    	, "OName" => array("name" => "OName", "type" => "xsd:string")
    	, "SectorNum" => array("name" => "SectorNum", "type" => "xsd:string")
    	, "SectorName" => array("name" => "SectorName", "type" => "xsd:string")
)

              

Където:

Ето и пример за отговор от Colibri® ERP - масив с данни за операция и сектор:

  0 => 
  array (
      'idOper' => 68,
      'idSector' => 13,
      'ONum' => 'ШЛ',
      'OName' => 'Шлайфане',
      'SectorNum' => 'У-Ш',
      'SectorName' => 'Участък- шлайфане',
    ),
.........
)

              

Примерен код на PHP извикване на функция GetOperations:

<?php

include("nusoap.php");

// Entry point data
$WS_URL = "https://dev3.edabg.com/erp/ws/wsbase.php?wsdl";


// Initializing client
$sc = new nusoap_client($WS_URL, true);
$err = $sc->getError();
if ($err) {
	echo "Constructor error $err\n";
}

$sc->soap_defencoding = "UTF-8";
$sc->decode_utf8 = false;
$sc->data_encoding = "UTF-8";
$sc->encode_utf8 = false;

// Login използвайки потребител soap който е от тип web service
$result = $sc->call("erpSOAPServer..Login",
	array("username" => "soap", "password" => "123"));
echo "Calling ...<br>";


//------------------------------------------------------
// Test for function $result = $sc->call("erpSOAPProd..GetOperations",
//------------------------------------------------------
$result = $sc->call("erpSOAPProd..GetOperations");

if ($sc->fault) {
	echo "Fault:<br>";
	echo "<pre>".var_export($result,true)."</pre>";
} else {
	$err = $sc->getError();
	if ($err) {
		echo "Error: $err<br>";
	} else {
		echo "<pre>".var_export($result,true)."</pre>";
	}
}
//------------------------------------------------------
// End of Test for function $result = $sc->call("erpSOAPProd..GetOperations",
//------------------------------------------------------

echo "<hr>Request<br>";
echo "<pre>"._h(var_export($sc->request,true))."</pre>";
echo "<hr>Response<br>";
echo "<pre>"._h(var_export($sc->response,true))."</pre>";

$result = $sc->call("erpSOAPServer..Logout");
?>

              

Този web service е предназначен да предаде на външна система за електронно събиране на заработките, списък от тройки ПК-операция-сектор (CNum-ONum-SectorNum), за да бъдат използвани при натрупването на информация за изпълнение по тях.

Функцията връща масив от записи, съдържащи данните за използваните в момента (в производствени карти) операции, заедно със съответния им работен център (сектор). Това са тройки ПК-операция-сектор, които са за производствени карти, които не са приключени.

Структурата на данните, които връща функцията е следната:

array(
	"OrderNum" => array("name" => "OrderNum", "type" => "xsd:string")
	, "OrderDate" => array("name" => "OrderDate", "type" => "xsd:dateTime")
	, "OrderName" => array("name" => "OrderName", "type" => "xsd:string")
	, "CNum" => array("name" => "CNum", "type" => "xsd:string")
	, "CDate" => array("name" => "CDate", "type" => "xsd:dateTime")
	, "CName" => array("name" => "CName", "type" => "xsd:string")
	, "idRecipe" => array("name" => "idRecipe", "type" => "xsd:integer")
	, "RNum" => array("name" => "RNum", "type" => "xsd:string")
	, "RName" => array("name" => "RName", "type" => "xsd:string")
	, "MNum" => array("name" => "MNum", "type" => "xsd:string")
	, "MName" => array("name" => "MName", "type" => "xsd:string")
	, "idOperCard" => array("name" => "idOperCard", "type" => "xsd:integer")
	, "idOper" => array("name" => "idOper", "type" => "xsd:integer")
	, "ONum" => array("name" => "ONum", "type" => "xsd:string")
	, "OName" => array("name" => "OName", "type" => "xsd:string")
	, "idSector" => array("name" => "idSector", "type" => "xsd:integer")
	, "SectorNum" => array("name" => "SectorNum", "type" => "xsd:string")
	, "SectorName" => array("name" => "SectorName", "type" => "xsd:string")
	, "toDo_max" => array("name" => "toDo_max", "type" => "xsd:double")
	, "toDo" => array("name" => "toDo", "type" => "xsd:double")
	, "QuantityOK" => array("name" => "QuantityOK", "type" => "xsd:double")
	, "QuantityWaste" => array("name" => "QuantityWaste", "type" => "xsd:double")
	, "QuantityWasteSubj" => array("name" => "QuantityWasteSubj", "type" => "xsd:double")
)

              

Където имаме:

В отговора, полетата toDo_max и toDo, показват (в момента на изпълнение на функцията GetActiveOpers), какво количество е планирано да се произведе по операцията и какво количество системата очаква да се изработи по дадена тройка ПК-операция-Сектор, т.е. колко броя детайли стоят пред дадена операция от даден маршрут (ПК), за да бъдат изпълнени.

По този начин върнатата стойност в полетата toDo_max и toDo може да се използва за контрол на регистрираното от работниците изпълнение във външната система за електронно отчитане на изработеното.

И накрая, количествени данни за производствената операция и работния център в момента на изпълнение на сървиса: Данни за производствената операция и работния център:

Функциите GetActiveOpers, PutWork трябва да се изпъняват в този ред – циклично – (GetActiveOpers, PutWork); (GetActiveOpers, PutWork),...

След всяко изпълнение на PutWork се променят бройките за изпълнение за тройките ПК-операция-Сектор и последващото изпълнение на GetActiveOpers ще върне нови стойности за полетата toDo_max и toDo.

Всичко по детайлите на извикване на функцията GetActiveOpers е аналогично на функцията GetOperations.

Данните от GetActiveOpers могат да бъдат използвани от външна система за анализ на завършеността или въобще за анализ на актуалното състояние в проиводтвото.

Примерен код за въвеждане на изпълнение от външна система изглежда по следния начин (PHP):

<?php

include("../params.inc.php");
//include(PATH_INCLUDE."auth.inc.php");
//include(PATH_INCLUDE."basepage.inc.php");

include("nusoap.php");

// Entry point data
$WS_URL = "https://dev3.edabg.com/erp/ws/wsbase.php?wsdl";


// Initializing client
$sc = new nusoap_client($WS_URL, true);
$err = $sc->getError();
if ($err) {
	echo "Constructor error $err\n";
}

$sc->soap_defencoding = "UTF-8";
$sc->decode_utf8 = false;
$sc->data_encoding = "UTF-8";
$sc->encode_utf8 = false;

// Login използвайки потребител soap който е от тип web service
$result = $sc->call("erpSOAPServer..Login",
	array("username" => "soap", "password" => "123"));
echo "Calling ...<br>";

//------------------------------------------------------
// Test for function $result = $sc->call("erpSOAPProd..PutWork",
//------------------------------------------------------

	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12378"
			, "RefNum" => "10002"
			, "QuantityOK" => "100"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "25.03.2020 17:56:21"
		);
	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12378"
			, "RefNum" => "00005"
			, "QuantityOK" => "1"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "11.01.2018 16:05:05"
		);
	
	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12379"
			, "RefNum" => "00005"
			, "QuantityOK" => "3"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "11.01.2018 16:05:10"
		);

	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12380"
			, "RefNum" => "00005"
			, "QuantityOK" => "1"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "11.01.2018 16:05:15"
		);
	
	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12382"
			, "RefNum" => "00005"
			, "QuantityOK" => "1"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "11.01.2018 16:05:20"
		);
	
	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12383"
			, "RefNum" => "00005"
			, "QuantityOK" => "3"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "11.01.2018 16:05:25"
		);
	
	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12385"
			, "RefNum" => "00005"
			, "QuantityOK" => "3"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "11.01.2018 16:05:30"
		);
	
	$work[] = 
		array(
			"idOperPersCard" => ""
			, "idOperCard" => "12386"
			, "RefNum" => "00005"
			, "QuantityOK" => "2"
			, "QuantityWaste" => ""
			, "QuantityWasteSubj" => ""
			, "CompleteTime" => "11.01.2018 16:05:35"
		);

	$result = $sc->call("erpSOAPProd..PutWork", array($work));

	if ($sc->fault) {
		echo "Fault:<br>";
		echo "<pre>".var_export($result,true)."</pre>";
	} else {
		$err = $sc->getError();
		if ($err) {
			echo "Error: $err<br>";
		} else {
			echo "<pre>".var_export($result,true)."</pre>";
		}
	}

//------------------------------------------------------
// End of Test for function $result = $sc->call("erpSOAPProd..PutWork",
//------------------------------------------------------

echo "<hr>Request<br>";
echo "<pre>"._h(var_export($sc->request,true))."</pre>";
echo "<hr>Response<br>";
echo "<pre>"._h(var_export($sc->response,true))."</pre>";

$result = $sc->call("erpSOAPServer..Logout");
?>

              

При извикването на функцията PutWork с горепосочения идентификационен уникален код на операциите idOperCard, след тест за коректност на изпратените данни, се записват всички изпратени заработки. idOperCard се получава от изпълнението на предшестващия сървис GetActiveOpers.

Подаването на записите не изисква специална подредба. Функцията PutWork подрежда записите според реда на изпълнение, зададен в рецептата от съответната ПК и по времето на изпълнение (CompleteTime). Затова е необходимо всяка ПК да се разглежда като маршрутна карта за производство по една рецептура. След сортирането по ред на изпълнение следва сортиране по час на изпълнение – CompleteTime. Така записите за една и съща двойка операция-сектор (ONum-SectorNum) се подреждат и по време на изпълнение.

Нека да обърнем внимание на операция ONum = П-002 от кода. За нея има три записа за общо количество 5 изпълнения, т.е. изпратени са 5 изпълнения, въпреки, че по ПК е зададено да се изпълнят 3. Това е ситуация, при която се прави опит за преизпълнение и системата в отговора си връща информация за това несъответствие.

Резултатът в Colibri® ERP след изпълнение на запитването е следния:

Всички записи в таба Изпълнение на ПК съответстват точно на изпратената чрез разглеждания web service информация. Информацията е приета от Colibri® ERP и вече е обработена по съответния начин в ПК.

Ето как изглежда изпълнението по маршрута на разглежданата ПК:

Преизпълнението на операция с номер П-002 се вижда с отрицателното количество за изпълнение (-2).

Какво ще се предприеме нататък е въпрос на вътрешна организация във фирмата, но може да се открие къде е направено преизпълнение, да се коригира съответния запис или записи и отново да се изпълни запитването, за да се въведат заработките отново.

Функцията PutWork, която е в основата на разглеждания web service връща отговор на всяко запитване. Отговорът може да съдържа:

Ето как изглежда основната част от отговора на разглежданото в нашия пример запитване:

Calling ...

array (
  0 => 
  array (
    'idOperPersCard' => 1342,
    'RefNum' => '00005',
    'QuantityOK' => 3,
    'QuantityWaste' => 0,
    'QuantityWasteSubj' => 0,
    'CompleteTime' => '11.01.2018 16:05:25',
    'toDo' => 0,
    'Note' => 'OK',
  ),
  1 => 
  array (
    'idOperPersCard' => 1342,
    'RefNum' => '00005',
    'QuantityOK' => 1,
    'QuantityWaste' => 0,
    'QuantityWasteSubj' => 0,
    'CompleteTime' => '11.01.2018 16:05:05',
    'toDo' => 2,
    'Note' => 'OK',
  ),
  2 => 
  array (
    'idOperPersCard' => 1342,
    'RefNum' => '00005',
    'QuantityOK' => 1,
    'QuantityWaste' => 0,
    'QuantityWasteSubj' => 0,
    'CompleteTime' => '11.01.2018 16:05:20',
    'toDo' => 1,
    'Note' => 'OK',
  ),
  3 => 
  array (
    'idOperPersCard' => 1342,
    'RefNum' => '00005',
    'QuantityOK' => 3,
    'QuantityWaste' => 0,
    'QuantityWasteSubj' => 0,
    'CompleteTime' => '11.01.2018 16:05:30',
    'toDo' => -2,
    'Note' => 'ПРЕДУПРЕЖДЕНИЕ! След обработка на записа има преизпълнение на операцията с 2!',
  ),
  4 => 
  array (
    'idOperPersCard' => 1342,
    'RefNum' => '00005',
    'QuantityOK' => 3,
    'QuantityWaste' => 0,
    'QuantityWasteSubj' => 0,
    'CompleteTime' => '11.01.2018 16:05:10',
    'toDo' => 2,
    'Note' => 'OK',
  ),
  5 => 
  array (
    'idOperPersCard' => 1342,
    'RefNum' => '00005',
    'QuantityOK' => 1,
    'QuantityWaste' => 0,
    'QuantityWasteSubj' => 0,
    'CompleteTime' => '11.01.2018 16:05:15',
    'toDo' => 2,
    'Note' => 'OK',
  ),
  6 => 
  array (
    'idOperPersCard' => 1342,
    'RefNum' => '00005',
    'QuantityOK' => 2,
    'QuantityWaste' => 0,
    'QuantityWasteSubj' => 0,
    'CompleteTime' => '11.01.2018 16:05:35',
    'toDo' => 0,
    'Note' => 'OK',
  ),
)

              

Ако върнатия отговор е без съобщения за грешки или несъответствия, то информацията вече успешно е предадена в съответните ПК на модул производство в Colibri® ERP и е отразен направения напредък по производствените маршрути.

Ако е необходимо, т.е. върнати са съобщения за несъответствия, могат да бъдат предприети съответните действия за коригиране на грешно подадената информация и запитването да се изпрати отново.