synchrodatasource.class.inc.php 110 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721
  1. <?php
  2. // Copyright (C) 2012 Combodo SARL
  3. //
  4. // This program is free software; you can redistribute it and/or modify
  5. // it under the terms of the GNU General Public License as published by
  6. // the Free Software Foundation; version 3 of the License.
  7. //
  8. // This program is distributed in the hope that it will be useful,
  9. // but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11. // GNU General Public License for more details.
  12. //
  13. // You should have received a copy of the GNU General Public License
  14. // along with this program; if not, write to the Free Software
  15. // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  16. /**
  17. * Data Exchange - synchronization with external applications (incoming data)
  18. *
  19. * @author Erwan Taloc <erwan.taloc@combodo.com>
  20. * @author Romain Quetiez <romain.quetiez@combodo.com>
  21. * @author Denis Flaven <denis.flaven@combodo.com>
  22. * @license http://www.opensource.org/licenses/gpl-3.0.html LGPL
  23. */
  24. class SynchroExceptionNotStarted extends CoreException
  25. {
  26. }
  27. class SynchroDataSource extends cmdbAbstractObject
  28. {
  29. public static function Init()
  30. {
  31. $aParams = array
  32. (
  33. "category" => "core/cmdb,view_in_gui",
  34. "key_type" => "autoincrement",
  35. "name_attcode" => array('name'),
  36. "state_attcode" => "",
  37. "reconc_keys" => array(),
  38. "db_table" => "priv_sync_datasource",
  39. "db_key_field" => "id",
  40. "db_finalclass_field" => "realclass",
  41. "display_template" => "",
  42. "icon" => "../images/synchro.png",
  43. );
  44. MetaModel::Init_Params($aParams);
  45. //MetaModel::Init_InheritAttributes();
  46. MetaModel::Init_AddAttribute(new AttributeString("name", array("allowed_values"=>null, "sql"=>"name", "default_value"=>null, "is_null_allowed"=>false, "depends_on"=>array())));
  47. MetaModel::Init_AddAttribute(new AttributeString("description", array("allowed_values"=>null, "sql"=>"description", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
  48. MetaModel::Init_AddAttribute(new AttributeEnum("status", array("allowed_values"=>new ValueSetEnum('implementation,production,obsolete'), "sql"=>"status", "default_value"=>"implementation", "is_null_allowed"=>false, "depends_on"=>array())));
  49. MetaModel::Init_AddAttribute(new AttributeExternalKey("user_id", array("targetclass"=>"User", "jointype"=>null, "allowed_values"=>null, "sql"=>"user_id", "is_null_allowed"=>true, "on_target_delete"=>DEL_MANUAL, "depends_on"=>array())));
  50. MetaModel::Init_AddAttribute(new AttributeExternalKey("notify_contact_id", array("targetclass"=>"Contact", "jointype"=>null, "allowed_values"=>null, "sql"=>"notify_contact_id", "is_null_allowed"=>true, "on_target_delete"=>DEL_MANUAL, "depends_on"=>array())));
  51. MetaModel::Init_AddAttribute(new AttributeClass("scope_class", array("class_category"=>"bizmodel,addon/authentication", "more_values"=>"", "sql"=>"scope_class", "default_value"=>null, "is_null_allowed"=>false, "depends_on"=>array())));
  52. // Declared here for a future usage, but ignored so far
  53. MetaModel::Init_AddAttribute(new AttributeString("scope_restriction", array("allowed_values"=>null, "sql"=>"scope_restriction", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
  54. //MetaModel::Init_AddAttribute(new AttributeDateTime("last_synchro_date", array("allowed_values"=>null, "sql"=>"last_synchro_date", "default_value"=>"", "is_null_allowed"=>false, "depends_on"=>array())));
  55. // Format: seconds (int)
  56. MetaModel::Init_AddAttribute(new AttributeDuration("full_load_periodicity", array("allowed_values"=>null, "sql"=>"full_load_periodicity", "default_value"=>86400, "is_null_allowed"=>true, "depends_on"=>array())));
  57. // MetaModel::Init_AddAttribute(new AttributeString("reconciliation_list", array("allowed_values"=>null, "sql"=>"reconciliation_list", "default_value"=>null, "is_null_allowed"=>false, "depends_on"=>array())));
  58. MetaModel::Init_AddAttribute(new AttributeEnum("reconciliation_policy", array("allowed_values"=>new ValueSetEnum('use_primary_key,use_attributes'), "sql"=>"reconciliation_policy", "default_value"=>"use_attributes", "is_null_allowed"=>false, "depends_on"=>array())));
  59. MetaModel::Init_AddAttribute(new AttributeEnum("action_on_zero", array("allowed_values"=>new ValueSetEnum('create,error'), "sql"=>"action_on_zero", "default_value"=>"create", "is_null_allowed"=>false, "depends_on"=>array())));
  60. MetaModel::Init_AddAttribute(new AttributeEnum("action_on_one", array("allowed_values"=>new ValueSetEnum('update,error'), "sql"=>"action_on_one", "default_value"=>"update", "is_null_allowed"=>false, "depends_on"=>array())));
  61. MetaModel::Init_AddAttribute(new AttributeEnum("action_on_multiple", array("allowed_values"=>new ValueSetEnum('take_first,create,error'), "sql"=>"action_on_multiple", "default_value"=>"error", "is_null_allowed"=>false, "depends_on"=>array())));
  62. MetaModel::Init_AddAttribute(new AttributeEnum("delete_policy", array("allowed_values"=>new ValueSetEnum('ignore,delete,update,update_then_delete'), "sql"=>"delete_policy", "default_value"=>"ignore", "is_null_allowed"=>false, "depends_on"=>array())));
  63. MetaModel::Init_AddAttribute(new AttributeString("delete_policy_update", array("allowed_values"=>null, "sql"=>"delete_policy_update", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
  64. // Format: seconds (unsigned int)
  65. MetaModel::Init_AddAttribute(new AttributeDuration("delete_policy_retention", array("allowed_values"=>null, "sql"=>"delete_policy_retention", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
  66. MetaModel::Init_AddAttribute(new AttributeLinkedSet("attribute_list", array("linked_class"=>"SynchroAttribute", "ext_key_to_me"=>"sync_source_id", "allowed_values"=>null, "count_min"=>0, "count_max"=>0, "depends_on"=>array())));
  67. // Not used yet !
  68. MetaModel::Init_AddAttribute(new AttributeEnum("user_delete_policy", array("allowed_values"=>new ValueSetEnum('everybody,administrators,nobody'), "sql"=>"user_delete_policy", "default_value"=>"nobody", "is_null_allowed"=>true, "depends_on"=>array())));
  69. MetaModel::Init_AddAttribute(new AttributeURL("url_icon", array("allowed_values"=>null, "sql"=>"url_icon", "default_value"=>null, "is_null_allowed"=>true, "target"=> '_top', "depends_on"=>array())));
  70. // The field below is not a real URL since it can contain placeholders like $replica->primary_key$ which are not syntactically allowed in a real URL
  71. MetaModel::Init_AddAttribute(new AttributeString("url_application", array("allowed_values"=>null, "sql"=>"url_application", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
  72. // Display lists
  73. MetaModel::Init_SetZListItems('details', array(
  74. 'col:0'=> array(
  75. 'fieldset:SynchroDataSource:Description' => array('name','description','status','scope_class','user_id','notify_contact_id','url_icon','url_application')),
  76. 'col:1'=> array(
  77. 'fieldset:SynchroDataSource:Reconciliation' => array('reconciliation_policy','action_on_zero','action_on_one','action_on_multiple'),
  78. 'fieldset:SynchroDataSource:Deletion' => array('user_delete_policy','full_load_periodicity','delete_policy','delete_policy_update','delete_policy_retention'))
  79. )
  80. );
  81. MetaModel::Init_SetZListItems('list', array('scope_class', 'status', 'user_id', 'full_load_periodicity')); // Attributes to be displayed for a list
  82. // Search criteria
  83. MetaModel::Init_SetZListItems('standard_search', array('name', 'status', 'scope_class', 'user_id')); // Criteria of the std search form
  84. // MetaModel::Init_SetZListItems('advanced_search', array('name')); // Criteria of the advanced search form
  85. }
  86. public function DisplayBareRelations(WebPage $oPage, $bEditMode = false)
  87. {
  88. if (!$this->IsNew())
  89. {
  90. $oPage->SetCurrentTab(Dict::S('Core:SynchroAttributes'));
  91. $oAttributeSet = $this->Get('attribute_list');
  92. $aAttributes = array();
  93. while($oAttribute = $oAttributeSet->Fetch())
  94. {
  95. $aAttributes[$oAttribute->Get('attcode')] = $oAttribute;
  96. }
  97. // Columns of the form
  98. $aAttribs = array();
  99. foreach(array('attcode', 'reconciliation', 'update', 'update_policy', 'reconciliation_attcode') as $s )
  100. {
  101. $aAttribs[$s] = array( 'label' => Dict::S("Core:SynchroAtt:$s"), "description" => Dict::S("Core:SynchroAtt:$s+"));
  102. }
  103. // Rows of the form
  104. $aValues = array();
  105. foreach(MetaModel::ListAttributeDefs($this->GetTargetClass()) as $sAttCode=>$oAttDef)
  106. {
  107. if ($oAttDef->IsWritable())
  108. {
  109. if (isset($aAttributes[$sAttCode]))
  110. {
  111. $oAttribute = $aAttributes[$sAttCode];
  112. }
  113. else
  114. {
  115. if ($oAttDef->IsExternalKey())
  116. {
  117. $oAttribute = new SynchroAttExtKey();
  118. $oAttribute->Set('reconciliation_attcode', ''); // Blank means by pkey
  119. }
  120. elseif ($oAttDef->IsLinkSet() && $oAttDef->IsIndirect())
  121. {
  122. $oAttribute = new SynchroAttLinkSet();
  123. // Todo - add these settings into the form
  124. $oAttribute->Set('row_separator', MetaModel::GetConfig()->Get('link_set_item_separator'));
  125. $oAttribute->Set('attribute_separator', MetaModel::GetConfig()->Get('link_set_attribute_separator'));
  126. $oAttribute->Set('value_separator', MetaModel::GetConfig()->Get('link_set_value_separator'));
  127. $oAttribute->Set('attribute_qualifier', MetaModel::GetConfig()->Get('link_set_attribute_qualifier'));
  128. }
  129. elseif ($oAttDef->IsScalar())
  130. {
  131. $oAttribute = new SynchroAttribute();
  132. }
  133. else
  134. {
  135. $oAttribute = null;
  136. }
  137. if (!is_null($oAttribute))
  138. {
  139. $oAttribute->Set('sync_source_id', $this->GetKey());
  140. $oAttribute->Set('attcode', $sAttCode);
  141. $oAttribute->Set('reconcile', MetaModel::IsReconcKey($this->GetTargetClass(), $sAttCode) ? 1 : 0);
  142. $oAttribute->Set('update', 1);
  143. $oAttribute->Set('update_policy', 'master_locked');
  144. }
  145. }
  146. if (!is_null($oAttribute))
  147. {
  148. if (!$bEditMode)
  149. {
  150. // Read-only mode
  151. $aRow['reconciliation'] = $oAttribute->Get('reconcile') == 1 ? Dict::S('Core:SynchroReconcile:Yes') : Dict::S('Core:SynchroReconcile:No');
  152. $aRow['update'] = $oAttribute->Get('update') == 1 ? Dict::S('Core:SynchroUpdate:Yes') : Dict::S('Core:SynchroUpdate:No');
  153. $aRow['attcode'] = MetaModel::GetLabel($this->GetTargetClass(), $oAttribute->Get('attcode'));
  154. $aRow['update_policy'] = $oAttribute->GetAsHTML('update_policy');
  155. if ($oAttDef->IsExternalKey())
  156. {
  157. $aRow['reconciliation_attcode'] = $oAttribute->GetAsHTML('reconciliation_attcode');
  158. }
  159. else
  160. {
  161. $aRow['reconciliation_attcode'] = '&nbsp;';
  162. }
  163. }
  164. else
  165. {
  166. // Edit mode
  167. $sAttCode = $oAttribute->Get('attcode');
  168. $sChecked = $oAttribute->Get('reconcile') == 1 ? 'checked' : '';
  169. $aRow['reconciliation'] = "<input type=\"checkbox\" name=\"reconciliation[$sAttCode]\" $sChecked/>";
  170. $sChecked = $oAttribute->Get('update') == 1 ? 'checked' : '';
  171. $aRow['update'] = "<input type=\"checkbox\" name=\"update[$sAttCode]\" $sChecked/>";
  172. $aRow['attcode'] = MetaModel::GetLabel($this->GetTargetClass(), $oAttribute->Get('attcode'));
  173. $oUpdateAttDef = MetaModel::GetAttributeDef(get_class($oAttribute), 'update_policy');
  174. $aRow['update_policy'] = cmdbAbstractObject::GetFormElementForField($oPage, get_class($oAttribute), 'update_policy', $oUpdateAttDef, $oAttribute->Get('update_policy'), '', 'update_policy_'.$sAttCode, "[$sAttCode]");
  175. if ($oAttDef->IsExternalKey())
  176. {
  177. $aRow['reconciliation_attcode'] = $oAttribute->GetReconciliationFormElement($oAttDef->GetTargetClass(), "attr_reconciliation_attcode[$sAttCode]");
  178. }
  179. else
  180. {
  181. $aRow['reconciliation_attcode'] = '&nbsp;';
  182. }
  183. }
  184. $aValues[] = $aRow;
  185. }
  186. }
  187. }
  188. $oPage->p(Dict::Format('Class:SynchroDataSource:DataTable', $this->GetDataTable()));
  189. $oPage->Table($aAttribs, $aValues);
  190. $this->DisplayStatusTab($oPage);
  191. }
  192. parent::DisplayBareRelations($oPage, $bEditMode);
  193. }
  194. /**
  195. * Displays the status (SynchroLog) of the datasource in a graphical manner
  196. * @param $oPage WebPage
  197. * @return void
  198. */
  199. protected function DisplayStatusTab(WebPage $oPage)
  200. {
  201. $oPage->SetCurrentTab(Dict::S('Core:SynchroStatus'));
  202. $sSelectSynchroLog = 'SELECT SynchroLog WHERE sync_source_id = :source_id';
  203. $oSetSynchroLog = new CMDBObjectSet(DBObjectSearch::FromOQL($sSelectSynchroLog), array('start_date' => false) /* order by*/, array('source_id' => $this->GetKey()));
  204. if ($oSetSynchroLog->Count() > 0)
  205. {
  206. $oLastLog = $oSetSynchroLog->Fetch();
  207. $sStartDate = $oLastLog->Get('start_date');
  208. $oLastLog->Get('stats_nb_replica_seen');
  209. $iLastLog = 0;
  210. $iDSid = $this->GetKey();
  211. if ($oLastLog->Get('status') == 'running')
  212. {
  213. // Still running !
  214. $oPage->p('<h2>'.Dict::Format('Core:Synchro:SynchroRunningStartedOn_Date', $sStartDate).'</h2>');
  215. }
  216. else
  217. {
  218. $sEndDate = $oLastLog->Get('end_date');
  219. $iLastLog = $oLastLog->GetKey();
  220. $oPage->p('<h2>'.Dict::Format('Core:Synchro:SynchroEndedOn_Date', $sEndDate).'</h2>');
  221. $sOQL = "SELECT SynchroReplica WHERE sync_source_id=$iDSid";
  222. $oSet = new DBObjectSet(DBObjectSearch::FromOQL($sOQL));
  223. $iCountAllReplicas = $oSet->Count();
  224. $sAllReplicas = "<a href=\"../synchro/replica.php?operation=oql&datasource=$iDSid&oql=$sOQL\">$iCountAllReplicas</a>";
  225. $sOQL = "SELECT SynchroReplica WHERE sync_source_id=$iDSid AND status_last_error !=''";
  226. $oSet = new DBObjectSet(DBObjectSearch::FromOQL($sOQL));
  227. $iCountAllErrors = $oSet->Count();
  228. $sAllErrors = "<a href=\"../synchro/replica.php?operation=oql&datasource=$iDSid&oql=$sOQL\">$iCountAllErrors</a>";
  229. $sOQL = "SELECT SynchroReplica WHERE sync_source_id=$iDSid AND status_last_warning !=''";
  230. $oSet = new DBObjectSet(DBObjectSearch::FromOQL($sOQL));
  231. $iCountAllWarnings = $oSet->Count();
  232. $sAllWarnings = "<a href=\"../synchro/replica.php?operation=oql&datasource=$iDSid&oql=$sOQL\">$iCountAllWarnings</a>";
  233. $oPage->p('<h2>'.Dict::Format('Core:Synchro:ListReplicas_AllReplicas_Errors_Warnings', $sAllReplicas, $sAllErrors, $sAllWarnings).'</h2>');
  234. }
  235. $oPage->add('<table class="synoptics"><tr><td style="color:#333;vertical-align:top">');
  236. // List all the log entries for the user to select
  237. $oPage->add('<h2 style="line-height:55px;">'.Dict::S('Core:Synchro:History').'</h2>');
  238. $oSetSynchroLog->Rewind();
  239. $oPage->add('<select size="25" onChange="UpdateSynoptics(this.value);">');
  240. $sSelected = ' selected'; // First log is selected by default
  241. $sScript = "var aSynchroLog = {\n";
  242. while($oLog = $oSetSynchroLog->Fetch())
  243. {
  244. $sLogTitle = Dict::Format('Core:SynchroLogTitle', $oLog->Get('status'), $oLog->Get('start_date'));
  245. $oPage->add('<option value="'.$oLog->GetKey().'"'.$sSelected.'>'.$sLogTitle.'</option>');
  246. $sSelected = ''; // only the first log is selected by default
  247. $aData = $this->ProcessLog($oLog);
  248. $sScript .= '"'.$oLog->GetKey().'": '.json_encode($aData).",\n";
  249. }
  250. $sScript .= "end: 'Done'";
  251. $sScript .= "};\n";
  252. $sScript .= <<<EOF
  253. var sLastLog = '$iLastLog';
  254. function ToggleSynoptics(sId, bShow)
  255. {
  256. if (bShow)
  257. {
  258. $(sId).show();
  259. }
  260. else
  261. {
  262. $(sId).hide();
  263. }
  264. }
  265. function UpdateSynoptics(id)
  266. {
  267. var aValues = aSynchroLog[id];
  268. if (aValues == undefined) return;
  269. for (var sKey in aValues)
  270. {
  271. $('#c_'+sKey).html(aValues[sKey]);
  272. var fOpacity = (aValues[sKey] == 0) ? 0.3 : 1;
  273. $('#'+sKey).fadeTo("slow", fOpacity);
  274. }
  275. //alert('id = '+id+', lastLog='+sLastLog+', id==sLastLog: '+(id==sLastLog)+' obj_updated_errors: '+aValues['obj_updated_errors']);
  276. if ( (id == sLastLog) && (aValues['obj_new_errors'] > 0) )
  277. {
  278. $('#new_errors_link').show();
  279. }
  280. else
  281. {
  282. $('#new_errors_link').hide();
  283. }
  284. if ( (id == sLastLog) && (aValues['obj_updated_errors'] > 0) )
  285. {
  286. $('#updated_errors_link').show();
  287. }
  288. else
  289. {
  290. $('#updated_errors_link').hide();
  291. }
  292. if ( (id == sLastLog) && (aValues['obj_disappeared_errors'] > 0) )
  293. {
  294. $('#disappeared_errors_link').show();
  295. }
  296. else
  297. {
  298. $('#disappeared_errors_link').hide();
  299. }
  300. ToggleSynoptics('#cw_obj_created_warnings', aValues['obj_created_warnings'] > 0);
  301. ToggleSynoptics('#cw_obj_new_updated_warnings', aValues['obj_new_updated_warnings'] > 0);
  302. ToggleSynoptics('#cw_obj_new_unchanged_warnings', aValues['obj_new_unchanged_warnings'] > 0);
  303. ToggleSynoptics('#cw_obj_updated_warnings', aValues['obj_updated_warnings'] > 0);
  304. ToggleSynoptics('#cw_obj_unchanged_warnings', aValues['obj_unchanged_warnings'] > 0);
  305. }
  306. EOF
  307. ;
  308. $oPage->add_script($sScript);
  309. $oPage->add('</select>');
  310. $oPage->add('</td><td style="vertical-align:top;">');
  311. // Now build the big "synoptics" view
  312. $aData = $this->ProcessLog($oLastLog);
  313. $sNbReplica = $this->GetIcon()."&nbsp;".Dict::Format('Core:Synchro:Nb_Replica', "<span id=\"c_nb_replica_total\">{$aData['nb_replica_total']}</span>");
  314. $sNbObjects = MetaModel::GetClassIcon($this->GetTargetClass())."&nbsp;".Dict::Format('Core:Synchro:Nb_Class:Objects', $this->GetTargetClass(), "<span id=\"c_nb_obj_total\">{$aData['nb_obj_total']}</span>");
  315. $oPage->add(
  316. <<<EOF
  317. <table class="synoptics">
  318. <tr class="synoptics_header">
  319. <td>$sNbReplica</td><td>&nbsp;</td><td>$sNbObjects</td>
  320. </tr>
  321. <tr>
  322. EOF
  323. );
  324. $sBaseOQL = "SELECT SynchroReplica WHERE sync_source_id=".$this->GetKey()." AND status_last_error!=''";
  325. $oPage->add($this->HtmlBox('repl_ignored', $aData, '#999').'<td colspan="2">&nbsp;</td>');
  326. $oPage->add("</tr>\n<tr>");
  327. $oPage->add($this->HtmlBox('repl_disappeared', $aData, '#630', 'rowspan="4"').'<td rowspan="4" class="arrow">=&gt;</td>'.$this->HtmlBox('obj_disappeared_no_action', $aData, '#333'));
  328. $oPage->add("</tr>\n<tr>");
  329. $oPage->add($this->HtmlBox('obj_deleted', $aData, '#000'));
  330. $oPage->add("</tr>\n<tr>");
  331. $oPage->add($this->HtmlBox('obj_obsoleted', $aData, '#630'));
  332. $oPage->add("</tr>\n<tr>");
  333. $sOQL = urlencode($sBaseOQL." AND status='obsolete'");
  334. $oPage->add($this->HtmlBox('obj_disappeared_errors', $aData, '#C00', '', " <a style=\"color:#fff\" href=\"../synchro/replica.php?operation=oql&datasource=$iDSid&oql=$sOQL\" id=\"disappeared_errors_link\">Show</a>"));
  335. $oPage->add("</tr>\n<tr>");
  336. $oPage->add($this->HtmlBox('repl_existing', $aData, '#093', 'rowspan="3"').'<td rowspan="3" class="arrow">=&gt;</td>'.$this->HtmlBox('obj_unchanged', $aData, '#393'));
  337. $oPage->add("</tr>\n<tr>");
  338. $oPage->add($this->HtmlBox('obj_updated', $aData, '#3C3'));
  339. $oPage->add("</tr>\n<tr>");
  340. $sOQL = urlencode($sBaseOQL." AND status='modified'");
  341. $oPage->add($this->HtmlBox('obj_updated_errors', $aData, '#C00', '', " <a style=\"color:#fff\" href=\"../synchro/replica.php?operation=oql&datasource=$iDSid&oql=$sOQL\" id=\"updated_errors_link\">Show</a>"));
  342. $oPage->add("</tr>\n<tr>");
  343. $oPage->add($this->HtmlBox('repl_new', $aData, '#339', 'rowspan="4"').'<td rowspan="4" class="arrow">=&gt;</td>'.$this->HtmlBox('obj_new_unchanged', $aData, '#393'));
  344. $oPage->add("</tr>\n<tr>");
  345. $oPage->add($this->HtmlBox('obj_new_updated', $aData, '#3C3'));
  346. $oPage->add("</tr>\n<tr>");
  347. $oPage->add($this->HtmlBox('obj_created', $aData, '#339'));
  348. $oPage->add("</tr>\n<tr>");
  349. $sOQL = urlencode($sBaseOQL." AND status='new'");
  350. $oPage->add($this->HtmlBox('obj_new_errors', $aData, '#C00', '', " <a style=\"color:#fff\" href=\"../synchro/replica.php?operation=oql&datasource=$iDSid&oql=$sOQL\" id=\"new_errors_link\">Show</a>"));
  351. $oPage->add("</tr>\n</table>\n");
  352. $oPage->add('</td></tr></table>');
  353. $oPage->add_ready_script("UpdateSynoptics('$iLastLog')");
  354. }
  355. else
  356. {
  357. $oPage->p('<h2>'.Dict::S('Core:Synchro:NeverRun').'</h2>');
  358. }
  359. }
  360. protected function HtmlBox($sId, $aData, $sColor, $sHTMLAttribs = '', $sErrorLink = '')
  361. {
  362. $iCount = $aData[$sId];
  363. $sCount = "<span id=\"c_{$sId}\">$iCount</span>";
  364. $sLabel = Dict::Format('Core:Synchro:label_'.$sId, $sCount);
  365. $sOpacity = ($iCount==0) ? "opacity:0.3;" : "";
  366. if (isset($aData[$sId.'_warnings']))
  367. {
  368. $sLabel .= " <span id=\"cw_{$sId}_warnings\"><img src=\"../images/error.png\" style=\"vertical-align:middle\"/> (<span id=\"c_{$sId}_warnings\">".$aData[$sId.'_warnings']."</span>)</span>";
  369. }
  370. return "<td id=\"$sId\" style=\"background-color:$sColor;$sOpacity;\" {$sHTMLAttribs}>{$sLabel}{$sErrorLink}</td>";
  371. }
  372. protected function ProcessLog($oLastLog)
  373. {
  374. $aData = array(
  375. 'obj_deleted' => $oLastLog->Get('stats_nb_obj_deleted'),
  376. 'obj_obsoleted' => $oLastLog->Get('stats_nb_obj_obsoleted'),
  377. 'obj_disappeared_errors' => $oLastLog->Get('stats_nb_obj_obsoleted_errors') + $oLastLog->Get('stats_nb_obj_deleted_errors'),
  378. 'obj_disappeared_no_action' => $oLastLog->Get('stats_nb_replica_disappeared_no_action'),
  379. 'obj_updated' => $oLastLog->Get('stats_nb_obj_updated'),
  380. 'obj_updated_warnings' => $oLastLog->Get('stats_nb_obj_updated_warnings'),
  381. 'obj_updated_errors' => $oLastLog->Get('stats_nb_obj_updated_errors'),
  382. 'obj_new_updated' => $oLastLog->Get('stats_nb_obj_new_updated'),
  383. 'obj_new_updated_warnings' => $oLastLog->Get('stats_nb_obj_new_updated_warnings'),
  384. 'obj_new_unchanged' => $oLastLog->Get('stats_nb_obj_new_unchanged'),
  385. 'obj_created' => $oLastLog->Get('stats_nb_obj_created'),
  386. 'obj_created_warnings' => $oLastLog->Get('stats_nb_obj_created_warnings'),
  387. 'obj_created_errors' => $oLastLog->Get('stats_nb_obj_created_errors'),
  388. 'obj_unchanged_warnings' => $oLastLog->Get('stats_nb_obj_unchanged_warnings'),
  389. );
  390. $iReconciledErrors = $oLastLog->Get('stats_nb_replica_reconciled_errors');
  391. $iDisappeared = $aData['obj_disappeared_errors'] + $aData['obj_obsoleted'] + $aData['obj_deleted'] + $aData['obj_disappeared_no_action'];
  392. $aData['repl_disappeared'] = $iDisappeared;
  393. $iNewErrors = $aData['obj_created_errors'] + $oLastLog->Get('stats_nb_replica_reconciled_errors');
  394. $aData['obj_new_errors'] = $iNewErrors;
  395. $iNew = $aData['obj_created'] + $iNewErrors + $aData['obj_new_updated'] + $aData['obj_new_unchanged'];
  396. $aData['repl_new'] = $iNew;
  397. $iExisting = $oLastLog->Get('stats_nb_replica_seen') - $iNew;
  398. $aData['repl_existing'] = $iExisting;
  399. $aData['obj_unchanged'] = $iExisting - $aData['obj_updated'] - $aData['obj_updated_errors'];
  400. $iIgnored = $oLastLog->Get('stats_nb_replica_total') - $iNew - $iExisting - $iDisappeared;
  401. $aData['repl_ignored'] = $iIgnored;
  402. $aData['nb_obj_total'] = $iNew + $iExisting + $iDisappeared;
  403. $aData['nb_replica_total'] = $aData['nb_obj_total'] + $iIgnored;
  404. return $aData;
  405. }
  406. public function GetIcon($bImgTag = true, $sMoreStyles = '')
  407. {
  408. if ($this->Get('url_icon') == '') return MetaModel::GetClassIcon(get_class($this), $bImgTag);
  409. if ($bImgTag)
  410. {
  411. return "<img src=\"".$this->Get('url_icon')."\" style=\"vertical-align:middle;$sMoreStyles\"/>";
  412. }
  413. return $this->Get('url_icon');
  414. }
  415. /**
  416. * Get the actual hyperlink to the remote application for the given replica and dest object
  417. */
  418. public function GetApplicationUrl(DBObject $oDestObj, SynchroReplica $oReplica)
  419. {
  420. if ($this->Get('url_application') == '') return '';
  421. $aSearches = array();
  422. $aReplacements = array();
  423. foreach(MetaModel::ListAttributeDefs($this->GetTargetClass()) as $sAttCode=>$oAttDef)
  424. {
  425. if ($oAttDef->IsScalar())
  426. {
  427. $aSearches[] = '$this->'.$sAttCode.'$';
  428. $aReplacements[] = $oDestObj->Get($sAttCode);
  429. }
  430. }
  431. $aData = $oReplica->LoadExtendedDataFromTable($this->GetDataTable());
  432. foreach($aData as $sColumn => $value)
  433. {
  434. $aSearches[] = '$replica->'.$sColumn.'$';
  435. $aReplacements[] = $value;
  436. }
  437. return str_replace($aSearches, $aReplacements, $this->Get('url_application'));
  438. }
  439. public function GetAttributeFlags($sAttCode, &$aReasons = array(), $sTargetState = '')
  440. {
  441. if (($sAttCode == 'scope_class') && (!$this->IsNew()))
  442. {
  443. return OPT_ATT_READONLY;
  444. }
  445. return parent::GetAttributeFlags($sAttCode, $aReasons, $sTargetState);
  446. }
  447. public function UpdateObjectFromPostedForm($sFormPrefix = '', $sAttList = null, $sTargetState = '')
  448. {
  449. parent::UpdateObjectFromPostedForm($sFormPrefix, $sAttList, $sTargetState);
  450. // And now read the other post parameters...
  451. $oAttributeSet = $this->Get('attribute_list');
  452. $aAttributes = array();
  453. while($oAttribute = $oAttributeSet->Fetch())
  454. {
  455. $aAttributes[$oAttribute->Get('attcode')] = $oAttribute;
  456. }
  457. $aReconcile = utils::ReadPostedParam('reconciliation', array());
  458. $aUpdate = utils::ReadPostedParam('update', array());
  459. $aUpdatePolicy = utils::ReadPostedParam('attr_update_policy', array());
  460. $aReconciliation = utils::ReadPostedParam('attr_reconciliation_attcode', array());
  461. // update_policy cannot be empty, so there is one entry per attribute, use this to iterate
  462. // through all the writable attributes
  463. foreach($aUpdatePolicy as $sAttCode => $sValue)
  464. {
  465. if(!isset($aAttributes[$sAttCode]))
  466. {
  467. $oAttribute = $this->CreateSynchroAtt($sAttCode);
  468. }
  469. else
  470. {
  471. $oAttribute = $aAttributes[$sAttCode];
  472. }
  473. $bReconcile = 0;
  474. if (isset($aReconcile[$sAttCode]))
  475. {
  476. $bReconcile = $aReconcile[$sAttCode] == 'on' ? 1 : 0;
  477. }
  478. $bUpdate = 0 ; // Default / initial value
  479. if (isset($aUpdate[$sAttCode]))
  480. {
  481. $bUpdate = $aUpdate[$sAttCode] == 'on' ? 1 : 0;
  482. }
  483. $oAttribute->Set('reconcile', $bReconcile);
  484. $oAttribute->Set('update', $bUpdate);
  485. $oAttribute->Set('update_policy', $sValue);
  486. if ($oAttribute instanceof SynchroAttExtKey)
  487. {
  488. $oAttribute->Set('reconciliation_attcode', $aReconciliation[$sAttCode]);
  489. }
  490. elseif ($oAttribute instanceof SynchroAttLinkSet)
  491. {
  492. }
  493. $oAttributeSet->AddObject($oAttribute);
  494. }
  495. $this->Set('attribute_list', $oAttributeSet);
  496. }
  497. /**
  498. * Creates a new SynchroAttXXX object in memory with the default values
  499. */
  500. protected function CreateSynchroAtt($sAttCode)
  501. {
  502. $oAttDef = MetaModel::GetAttributeDef($this->GetTargetClass(), $sAttCode);
  503. if ($oAttDef->IsExternalKey())
  504. {
  505. $oAttribute = new SynchroAttExtKey();
  506. $oAttribute->Set('reconciliation_attcode', ''); // Blank means by pkey
  507. }
  508. elseif ($oAttDef->IsLinkSet() && $oAttDef->IsIndirect())
  509. {
  510. $oAttribute = new SynchroAttLinkSet();
  511. // Todo - set those value from the form
  512. $oAttribute->Set('row_separator', MetaModel::GetConfig()->Get('link_set_item_separator'));
  513. $oAttribute->Set('attribute_separator', MetaModel::GetConfig()->Get('link_set_attribute_separator'));
  514. $oAttribute->Set('value_separator', MetaModel::GetConfig()->Get('link_set_value_separator'));
  515. $oAttribute->Set('attribute_qualifier', MetaModel::GetConfig()->Get('link_set_attribute_qualifier'));
  516. }
  517. else
  518. {
  519. $oAttribute = new SynchroAttribute();
  520. }
  521. $oAttribute->Set('sync_source_id', $this->GetKey());
  522. $oAttribute->Set('attcode', $sAttCode);
  523. $oAttribute->Set('reconcile', 0);
  524. $oAttribute->Set('update', 0);
  525. $oAttribute->Set('update_policy', 'master_locked');
  526. return $oAttribute;
  527. }
  528. /**
  529. * Overload the standard behavior
  530. */
  531. public function ComputeValues()
  532. {
  533. parent::ComputeValues();
  534. if ($this->IsNew())
  535. {
  536. // When inserting a new datasource object, also create the SynchroAttribute objects
  537. // for each field of the target class
  538. // Create all the SynchroAttribute records
  539. $oAttributeSet = $this->Get('attribute_list');
  540. if ($oAttributeSet->Count() == 0)
  541. {
  542. foreach(MetaModel::ListAttributeDefs($this->GetTargetClass()) as $sAttCode=>$oAttDef)
  543. {
  544. if ($oAttDef->IsWritable())
  545. {
  546. $oAttDef = MetaModel::GetAttributeDef($this->GetTargetClass(), $sAttCode);
  547. if ($oAttDef->IsExternalKey())
  548. {
  549. $oAttribute = new SynchroAttExtKey();
  550. $oAttribute->Set('reconciliation_attcode', ''); // Blank means by pkey
  551. }
  552. elseif ($oAttDef->IsLinkSet() && $oAttDef->IsIndirect())
  553. {
  554. $oAttribute = new SynchroAttLinkSet();
  555. // Todo - set those value from the form
  556. $oAttribute->Set('row_separator', MetaModel::GetConfig()->Get('link_set_item_separator'));
  557. $oAttribute->Set('attribute_separator', MetaModel::GetConfig()->Get('link_set_attribute_separator'));
  558. $oAttribute->Set('value_separator', MetaModel::GetConfig()->Get('link_set_value_separator'));
  559. $oAttribute->Set('attribute_qualifier', MetaModel::GetConfig()->Get('link_set_attribute_qualifier'));
  560. }
  561. elseif ($oAttDef->IsScalar())
  562. {
  563. $oAttribute = new SynchroAttribute();
  564. }
  565. else
  566. {
  567. $oAttribute = null;
  568. }
  569. if (!is_null($oAttribute))
  570. {
  571. $oAttribute->Set('sync_source_id', $this->GetKey());
  572. $oAttribute->Set('attcode', $sAttCode);
  573. $oAttribute->Set('reconcile', MetaModel::IsReconcKey($this->GetTargetClass(), $sAttCode) ? 1 : 0);
  574. $oAttribute->Set('update', 1);
  575. $oAttribute->Set('update_policy', 'master_locked');
  576. $oAttributeSet->AddObject($oAttribute);
  577. }
  578. }
  579. }
  580. $this->Set('attribute_list', $oAttributeSet);
  581. }
  582. }
  583. }
  584. public function DoCheckToWrite()
  585. {
  586. parent::DoCheckToWrite();
  587. // Check that there is at least one reconciliation key defined
  588. if ($this->Get('reconciliation_policy') == 'use_attributes')
  589. {
  590. $oSet = $this->Get('attribute_list');
  591. $oSynchroAttributeList = $oSet->ToArray();
  592. $bReconciliationKey = false;
  593. foreach($oSynchroAttributeList as $oSynchroAttribute)
  594. {
  595. if ($oSynchroAttribute->Get('reconcile') == 1)
  596. {
  597. $bReconciliationKey = true; // At least one key is defined
  598. break;
  599. }
  600. }
  601. if (!$bReconciliationKey)
  602. {
  603. $this->m_aCheckIssues[] = Dict::Format('Class:SynchroDataSource/Error:AtLeastOneReconciliationKeyMustBeSpecified');
  604. }
  605. }
  606. // If 'update_then_delete' is specified there must be a delete_retention_period
  607. if (($this->Get('delete_policy') == 'update_then_delete') && ($this->Get('delete_policy_retention') == 0))
  608. {
  609. $this->m_aCheckIssues[] = Dict::Format('Class:SynchroDataSource/Error:DeleteRetentionDurationMustBeSpecified');
  610. }
  611. // If update is specified, then something to update must be defined
  612. if ((($this->Get('delete_policy') == 'update_then_delete') || ($this->Get('delete_policy') == 'update'))
  613. && ($this->Get('delete_policy_update') == ''))
  614. {
  615. $this->m_aCheckIssues[] = Dict::Format('Class:SynchroDataSource/Error:DeletePolicyUpdateMustBeSpecified');
  616. }
  617. }
  618. public function GetTargetClass()
  619. {
  620. return $this->Get('scope_class');
  621. }
  622. public function GetDataTable()
  623. {
  624. $sName = strtolower($this->GetTargetClass());
  625. $sName = str_replace('\'"&@|\\/ ', '_', $sName); // Remove forbidden characters from the table name
  626. $sName .= '_'.$this->GetKey(); // Add a suffix for unicity
  627. $sTable = MetaModel::GetConfig()->GetDBSubName()."synchro_data_$sName"; // Add the prefix if any
  628. return $sTable;
  629. }
  630. /**
  631. * When the new datasource has been created, let's create the synchro_data table
  632. * that will hold the data records and the correspoding triggers which will maintain
  633. * both tables in sync
  634. */
  635. protected function AfterInsert()
  636. {
  637. parent::AfterInsert();
  638. $sTable = $this->GetDataTable();
  639. $sReplicaTable = MetaModel::DBGetTable('SynchroReplica');
  640. $aColumns = $this->GetSQLColumns();
  641. $aFieldDefs = array();
  642. // Allow '0', otherwise mysql will render an error when the id is not given
  643. // (the trigger is expected to set the value, but it is not executed soon enough)
  644. $aFieldDefs[] = "id INTEGER(11) NOT NULL DEFAULT 0 ";
  645. $aFieldDefs[] = "`primary_key` VARCHAR(255) NULL DEFAULT NULL";
  646. foreach($aColumns as $sColumn => $ColSpec)
  647. {
  648. $aFieldDefs[] = "`$sColumn` $ColSpec NULL DEFAULT NULL";
  649. }
  650. $aFieldDefs[] = "INDEX (id)";
  651. $aFieldDefs[] = "INDEX (primary_key)";
  652. $sFieldDefs = implode(', ', $aFieldDefs);
  653. $sCreateTable = "CREATE TABLE `$sTable` ($sFieldDefs) ENGINE = ".MYSQL_ENGINE." CHARACTER SET utf8 COLLATE utf8_unicode_ci;";
  654. CMDBSource::Query($sCreateTable);
  655. $aTriggers = $this->GetTriggersDefinition();
  656. foreach($aTriggers as $key => $sTriggerSQL)
  657. {
  658. CMDBSource::Query($sTriggerSQL);
  659. }
  660. }
  661. /**
  662. * Gets the definitions of the 3 triggers: before insert, before update and after delete
  663. * @return array An array with 3 entries, one for each of the SQL queries
  664. */
  665. protected function GetTriggersDefinition()
  666. {
  667. $sTable = $this->GetDataTable();
  668. $sReplicaTable = MetaModel::DBGetTable('SynchroReplica');
  669. $aColumns = $this->GetSQLColumns();
  670. $aResult = array();
  671. $sTriggerInsert = "CREATE TRIGGER `{$sTable}_bi` BEFORE INSERT ON `$sTable`";
  672. $sTriggerInsert .= " FOR EACH ROW";
  673. $sTriggerInsert .= " BEGIN";
  674. $sTriggerInsert .= " INSERT INTO `{$sReplicaTable}` (`sync_source_id`, `status_last_seen`, `status`) VALUES ({$this->GetKey()}, NOW(), 'new');";
  675. $sTriggerInsert .= " SET NEW.id = LAST_INSERT_ID();";
  676. $sTriggerInsert .= " END;";
  677. $aResult['bi'] = $sTriggerInsert;
  678. $aModified = array();
  679. foreach($aColumns as $sColumn => $ColSpec)
  680. {
  681. // <=> is a null-safe 'EQUALS' operator (there is no equivalent for "DIFFERS FROM")
  682. $aModified[] = "NOT(NEW.`$sColumn` <=> OLD.`$sColumn`)";
  683. }
  684. $sIsModified = '('.implode(') OR (', $aModified).')';
  685. // Update the replica
  686. //
  687. // status is forced to "new" if the replica was obsoleted directly from the state "new" (dest_id = null)
  688. // otherwise, if status was either 'obsolete' or 'synchronized' it is turned into 'modified' or 'synchronized' depending on the changes
  689. // otherwise, the status is left as is
  690. $sTriggerUpdate = "CREATE TRIGGER `{$sTable}_bu` BEFORE UPDATE ON `$sTable`";
  691. $sTriggerUpdate .= " FOR EACH ROW";
  692. $sTriggerUpdate .= " BEGIN";
  693. $sTriggerUpdate .= " IF @itopuser is null THEN";
  694. $sTriggerUpdate .= " UPDATE `{$sReplicaTable}` SET status_last_seen = NOW(), `status` = IF(`status` = 'obsolete', IF(`dest_id` IS NULL, 'new', 'modified'), IF(`status` IN ('synchronized') AND ($sIsModified), 'modified', `status`)) WHERE sync_source_id = {$this->GetKey()} AND id = OLD.id;";
  695. $sTriggerUpdate .= " SET NEW.id = OLD.id;"; // make sure this id won't change
  696. $sTriggerUpdate .= " END IF;";
  697. $sTriggerUpdate .= " END;";
  698. $aResult['bu'] = $sTriggerUpdate;
  699. $sTriggerDelete = "CREATE TRIGGER `{$sTable}_ad` AFTER DELETE ON `$sTable`";
  700. $sTriggerDelete .= " FOR EACH ROW";
  701. $sTriggerDelete .= " BEGIN";
  702. $sTriggerDelete .= " DELETE FROM `{$sReplicaTable}` WHERE id = OLD.id;";
  703. $sTriggerDelete .= " END;";
  704. $aResult['ad'] = $sTriggerDelete;
  705. return $aResult;
  706. }
  707. protected function AfterDelete()
  708. {
  709. parent::AfterDelete();
  710. $sTable = $this->GetDataTable();
  711. $sDropTable = "DROP TABLE `$sTable`";
  712. CMDBSource::Query($sDropTable);
  713. // TO DO - check that triggers get dropped with the table
  714. }
  715. /**
  716. * Checks if the data source definition is consistent with the schema of the target class
  717. * @param $bDiagnostics boolean True to only diagnose the consistency, false to actually apply some changes
  718. * @param $bVerbose boolean True to get some information in the std output (echo)
  719. * @return bool Whether or not the database needs fixing for this data source
  720. */
  721. public function CheckDBConsistency($bDiagnostics, $bVerbose, $oChange = null)
  722. {
  723. $bFixNeeded = false;
  724. $aMissingFields = array();
  725. $oAttributeSet = $this->Get('attribute_list');
  726. $aAttributes = array();
  727. while($oAttribute = $oAttributeSet->Fetch())
  728. {
  729. $sAttCode = $oAttribute->Get('attcode');
  730. if (MetaModel::IsValidAttCode($this->GetTargetClass(), $sAttCode))
  731. {
  732. $aAttributes[$sAttCode] = $oAttribute;
  733. }
  734. else
  735. {
  736. // Old field remaining
  737. if ($bVerbose)
  738. {
  739. echo "Irrelevant field description for the field '$sAttCode', for the data synchro task ".$this->GetName()." (".$this->GetKey()."), will be removed.\n";
  740. }
  741. $bFixNeeded = true;
  742. if (!$bDiagnostics)
  743. {
  744. if ($oChange == null)
  745. {
  746. $oChange = MetaModel::NewObject("CMDBChange");
  747. $oChange->Set("date", time());
  748. $sUserString = CMDBChange::GetCurrentUserName();
  749. $oChange->Set("userinfo", $sUserString);
  750. $oChange->DBInsert();
  751. }
  752. // Fix the issue
  753. $oAttribute->DBDeleteTracked($oChange);
  754. }
  755. }
  756. }
  757. $sTable = $this->GetDataTable();
  758. foreach($this->ListTargetAttributes() as $sAttCode=>$oAttDef)
  759. {
  760. if (!isset($aAttributes[$sAttCode]))
  761. {
  762. $bFixNeeded = true;
  763. $aMissingFields[] = $sAttCode;
  764. // New field missing...
  765. if ($bVerbose)
  766. {
  767. echo "Missing field description for the field '$sAttCode', for the data synchro task ".$this->GetName()." (".$this->GetKey()."), will be created with default values.\n";
  768. }
  769. if (!$bDiagnostics)
  770. {
  771. if ($oChange == null)
  772. {
  773. $oChange = MetaModel::NewObject("CMDBChange");
  774. $oChange->Set("date", time());
  775. $sUserString = CMDBChange::GetCurrentUserName();
  776. $oChange->Set("userinfo", $sUserString);
  777. $oChange->DBInsert();
  778. }
  779. // Fix the issue
  780. $oAttribute = $this->CreateSynchroAtt($sAttCode);
  781. $oAttribute->DBInsertTracked($oChange);
  782. }
  783. }
  784. else
  785. {
  786. $aColumns = $this->GetSQLColumns(array($sAttCode));
  787. foreach($aColumns as $sColName => $sColumnDef)
  788. {
  789. $bOneColIsMissing = false;
  790. if (!CMDBSource::IsField($sTable, $sColName))
  791. {
  792. $bFixNeeded = true;
  793. $bOneColIsMissing = true;
  794. if ($bVerbose)
  795. {
  796. if (count($aColumns) > 1)
  797. {
  798. echo "Missing column '$sColName', in the table '$sTable' for the data synchro task ".$this->GetName()." (".$this->GetKey()."). The columns '".implode("', '", $aColumns )." will be re-created.'.\n";
  799. }
  800. else
  801. {
  802. echo "Missing column '$sColName', in the table '$sTable' for the data synchro task ".$this->GetName()." (".$this->GetKey()."). The column '$sColName' will be added.\n";
  803. }
  804. }
  805. }
  806. else if (strcasecmp(CMDBSource::GetFieldType($sTable, $sColName), $sColumnDef) != 0)
  807. {
  808. $bFixNeeded = true;
  809. $bOneColIsMissing = true;
  810. if (count($aColumns) > 1)
  811. {
  812. echo "Incorrect column '$sColName' (".CMDBSource::GetFieldType($sTable, $sColName)." instead of ".$sColumnDef."), in the table '$sTable' for the data synchro task ".$this->GetName()." (".$this->GetKey()."). The columns '".implode("', '", $aColumns )." will be re-created.'.\n";
  813. }
  814. else
  815. {
  816. echo "Incorrect column '$sColName' (".CMDBSource::GetFieldType($sTable, $sColName)." instead of ".$sColumnDef."), in the table '$sTable' for the data synchro task ".$this->GetName()." (".$this->GetKey()."). The column '$sColName' will be added.\n";
  817. }
  818. }
  819. if ($bOneColIsMissing)
  820. {
  821. $aMissingFields[] = $sAttCode;
  822. }
  823. }
  824. }
  825. }
  826. if ($bFixNeeded && (count($aMissingFields) > 0))
  827. {
  828. $aRepairQueries = array();
  829. // The structure of the table needs adjusting
  830. $aColumns = $this->GetSQLColumns($aMissingFields);
  831. $aFieldDefs = array();
  832. foreach($aColumns as $sAttCode => $sColumnDef)
  833. {
  834. if (CMDBSource::IsField($sTable, $sAttCode))
  835. {
  836. $aRepairQueries[] = "ALTER TABLE `$sTable` CHANGE `$sAttCode` `$sAttCode` $sColumnDef";
  837. }
  838. else
  839. {
  840. $aFieldDefs[] = "`$sAttCode` $sColumnDef";
  841. }
  842. }
  843. if (count($aFieldDefs) > 0)
  844. {
  845. $aRepairQueries[] = "ALTER TABLE `$sTable` ADD (".implode(',', $aFieldDefs).");";
  846. }
  847. // The triggers as well must be adjusted
  848. $aTriggersDefs = $this->GetTriggersDefinition();
  849. $aRepairQueries[] = "DROP TRIGGER IF EXISTS `{$sTable}_bi`;";
  850. $aRepairQueries[] = $aTriggersDefs['bi'];
  851. $aRepairQueries[] = "DROP TRIGGER IF EXISTS `{$sTable}_bu`;";
  852. $aRepairQueries[] = $aTriggersDefs['bu'];
  853. $aRepairQueries[] = "DROP TRIGGER IF EXISTS `{$sTable}_ad`;";
  854. $aRepairQueries[] = $aTriggersDefs['ad'];
  855. if ($bDiagnostics)
  856. {
  857. if ($bVerbose)
  858. {
  859. // Report the issue
  860. echo "The structure of the table $sTable for the data synchro task ".$this->GetName()." (".$this->GetKey().") must be altered (missing or incorrect fields: ".implode(',', $aMissingFields).").\n";
  861. echo "The trigger {$sTable}_bi, {$sTable}_bu, {$sTable}_ad for the data synchro task ".$this->GetName()." (".$this->GetKey().") must be re-created.\n";
  862. echo implode("\n", $aRepairQueries)."\n";
  863. }
  864. }
  865. else
  866. {
  867. // Fix the issue
  868. foreach($aRepairQueries as $sSQL)
  869. {
  870. CMDBSource::Query($sSQL);
  871. if ($bVerbose)
  872. {
  873. echo "$sSQL\n";
  874. }
  875. }
  876. }
  877. }
  878. return $bFixNeeded;
  879. }
  880. public function SendNotification($sSubject, $sBody)
  881. {
  882. $iContact = $this->Get('notify_contact_id');
  883. if ($iContact == 0)
  884. {
  885. // Leave silently...
  886. return;
  887. }
  888. $oContact = MetaModel::GetObject('Contact', $iContact);
  889. // Determine the email attribute (the first one will be our choice)
  890. $sEmailAttCode = null;
  891. foreach (MetaModel::ListAttributeDefs(get_class($oContact)) as $sAttCode => $oAttDef)
  892. {
  893. if ($oAttDef instanceof AttributeEmailAddress)
  894. {
  895. $sEmailAttCode = $sAttCode;
  896. // we've got one, exit the loop
  897. break;
  898. }
  899. }
  900. if (is_null($sEmailAttCode))
  901. {
  902. // Leave silently...
  903. return;
  904. }
  905. $sTo = $oContact->Get($sEmailAttCode);
  906. $sFrom = $sTo;
  907. $sBody = '<p>Data synchronization: '.$this->GetHyperlink().'</p>'.$sBody;
  908. $sSubject = 'iTop Data Sync - '.$this->GetName().' - '.$sSubject;
  909. $oEmail = new Email();
  910. $oEmail->SetRecipientTO($sTo);
  911. $oEmail->SetRecipientFrom($sFrom);
  912. $oEmail->SetSubject($sSubject);
  913. $oEmail->SetBody($sBody);
  914. if ($oEmail->Send($aIssues) == EMAIL_SEND_ERROR)
  915. {
  916. // mmmm, what can I do?
  917. }
  918. }
  919. /**
  920. * Get the list of attributes eligible to the synchronization
  921. */
  922. public function ListTargetAttributes()
  923. {
  924. $aRet = array();
  925. foreach(MetaModel::ListAttributeDefs($this->GetTargetClass()) as $sAttCode => $oAttDef)
  926. {
  927. if ($sAttCode == 'finalclass') continue;
  928. if (!$oAttDef->IsWritable()) continue;
  929. if ($oAttDef->IsLinkSet() && !$oAttDef->IsIndirect()) continue;
  930. $aRet[$sAttCode] = $oAttDef;
  931. }
  932. return $aRet;
  933. }
  934. /**
  935. * Get the list of SQL columns corresponding to a particular list of attribute codes
  936. * Defaults to the whole list of columns for the current class
  937. */
  938. public function GetSQLColumns($aAttributeCodes = null)
  939. {
  940. $aColumns = array();
  941. $sClass = $this->GetTargetClass();
  942. if (is_null($aAttributeCodes))
  943. {
  944. $aAttributeCodes = array();
  945. foreach($this->ListTargetAttributes() as $sAttCode => $oAttDef)
  946. {
  947. $aAttributeCodes[] = $sAttCode;
  948. }
  949. }
  950. foreach($aAttributeCodes as $sAttCode)
  951. {
  952. $oAttDef = MetaModel::GetAttributeDef($sClass, $sAttCode);
  953. if ($oAttDef->IsExternalKey())
  954. {
  955. // The pkey might be used as well as any other key column
  956. $aColumns[$sAttCode] = 'VARCHAR(255)';
  957. }
  958. else
  959. {
  960. foreach($oAttDef->GetImportColumns() as $sField => $sDBFieldType)
  961. {
  962. $aColumns[$sField] = $sDBFieldType;
  963. }
  964. }
  965. }
  966. return $aColumns;
  967. }
  968. /**
  969. * Get the list of Date and Datetime SQL columns
  970. */
  971. public function GetDateSQLColumns()
  972. {
  973. $aDateAttributes = array();
  974. $sClass = $this->GetTargetClass();
  975. foreach(MetaModel::ListAttributeDefs($sClass) as $sAttCode => $oAttDef)
  976. {
  977. if ($oAttDef instanceof AttributeDateTime)
  978. {
  979. $aDateAttributes[] = $sAttCode;
  980. }
  981. }
  982. return $this->GetSQLColumns($aDateAttributes);
  983. }
  984. public function IsRunning()
  985. {
  986. $sOQL = "SELECT SynchroLog WHERE sync_source_id = :source_id AND status='running'";
  987. $oSet = new DBObjectSet(DBObjectSearch::FromOQL($sOQL), array('start_date' => false) /* order by*/, array('source_id' => $this->GetKey()) /* aArgs */, array(), 1 /* limitCount */, 0 /* limitStart */);
  988. if ($oSet->Count() < 1)
  989. {
  990. $bRet = false;
  991. }
  992. else
  993. {
  994. $bRet = true;
  995. }
  996. return $bRet;
  997. }
  998. public function GetLatestLog()
  999. {
  1000. $oLog = null;
  1001. $sOQL = "SELECT SynchroLog WHERE sync_source_id = :source_id";
  1002. $oSet = new DBObjectSet(DBObjectSearch::FromOQL($sOQL), array('start_date' => false) /* order by*/, array('source_id' => $this->GetKey()) /* aArgs */, array(), 1 /* limitCount */, 0 /* limitStart */);
  1003. if ($oSet->Count() >= 1)
  1004. {
  1005. $oLog = $oSet->Fetch();
  1006. }
  1007. return $oLog;
  1008. }
  1009. // TO DO: remove if still unused
  1010. /**
  1011. * Retrieve from the log, the date of the last completed import
  1012. * @return DateTime
  1013. */
  1014. public function GetLastCompletedImportDate()
  1015. {
  1016. $date = null;
  1017. $sOQL = "SELECT SynchroLog WHERE sync_source_id = :source_id AND status='completed'";
  1018. $oSet = new DBObjectSet(DBObjectSearch::FromOQL($sOQL), array('end_date' => false) /* order by*/, array('source_id' => $this->GetKey()) /* aArgs */, array(), 0 /* limitCount */, 0 /* limitStart */);
  1019. if ($oSet->Count() >= 1)
  1020. {
  1021. $oLog = $oSet->Fetch();
  1022. $date = $oLog->Get('end_date');
  1023. }
  1024. return $date;
  1025. }
  1026. }
  1027. class SynchroAttribute extends cmdbAbstractObject
  1028. {
  1029. public static function Init()
  1030. {
  1031. $aParams = array
  1032. (
  1033. "category" => "core/cmdb,view_in_gui",
  1034. "key_type" => "autoincrement",
  1035. "name_attcode" => "",
  1036. "state_attcode" => "",
  1037. "reconc_keys" => array(),
  1038. "db_table" => "priv_sync_att",
  1039. "db_key_field" => "id",
  1040. "db_finalclass_field" => "",
  1041. "display_template" => "",
  1042. );
  1043. MetaModel::Init_Params($aParams);
  1044. MetaModel::Init_InheritAttributes();
  1045. MetaModel::Init_AddAttribute(new AttributeExternalKey("sync_source_id", array("targetclass"=>"SynchroDataSource", "jointype"=> "", "allowed_values"=>null, "sql"=>"sync_source_id", "is_null_allowed"=>false, "on_target_delete"=>DEL_SILENT, "depends_on"=>array())));
  1046. MetaModel::Init_AddAttribute(new AttributeExternalField("sync_source_name", array("allowed_values"=>null, "extkey_attcode"=> 'sync_source_id', "target_attcode"=>"name")));
  1047. MetaModel::Init_AddAttribute(new AttributeString("attcode", array("allowed_values"=>null, "sql"=>"attcode", "default_value"=>null, "is_null_allowed"=>false, "depends_on"=>array())));
  1048. MetaModel::Init_AddAttribute(new AttributeBoolean("update", array("allowed_values"=>null, "sql"=>"update", "default_value"=>true, "is_null_allowed"=>false, "depends_on"=>array())));
  1049. MetaModel::Init_AddAttribute(new AttributeBoolean("reconcile", array("allowed_values"=>null, "sql"=>"reconcile", "default_value"=>false, "is_null_allowed"=>false, "depends_on"=>array())));
  1050. MetaModel::Init_AddAttribute(new AttributeEnum("update_policy", array("allowed_values"=>new ValueSetEnum('master_locked,master_unlocked,write_if_empty'), "sql"=>"update_policy", "default_value"=>"master_locked", "is_null_allowed"=>false, "depends_on"=>array())));
  1051. // Display lists
  1052. MetaModel::Init_SetZListItems('details', array('sync_source_id', 'attcode', 'update', 'reconcile', 'update_policy')); // Attributes to be displayed for the complete details
  1053. MetaModel::Init_SetZListItems('list', array('sync_source_id', 'attcode', 'update', 'reconcile', 'update_policy')); // Attributes to be displayed for a list
  1054. // Search criteria
  1055. // MetaModel::Init_SetZListItems('standard_search', array('name')); // Criteria of the std search form
  1056. // MetaModel::Init_SetZListItems('advanced_search', array('name')); // Criteria of the advanced search form
  1057. }
  1058. }
  1059. class SynchroAttExtKey extends SynchroAttribute
  1060. {
  1061. public static function Init()
  1062. {
  1063. $aParams = array
  1064. (
  1065. "category" => "core/cmdb,view_in_gui",
  1066. "key_type" => "autoincrement",
  1067. "name_attcode" => "",
  1068. "state_attcode" => "",
  1069. "reconc_keys" => array(),
  1070. "db_table" => "priv_sync_att_extkey",
  1071. "db_key_field" => "id",
  1072. "db_finalclass_field" => "",
  1073. "display_template" => "",
  1074. );
  1075. MetaModel::Init_Params($aParams);
  1076. MetaModel::Init_InheritAttributes();
  1077. MetaModel::Init_AddAttribute(new AttributeString("reconciliation_attcode", array("allowed_values"=>null, "sql"=>"reconciliation_attcode", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
  1078. // Display lists
  1079. MetaModel::Init_SetZListItems('details', array('sync_source_id', 'attcode', 'update', 'reconcile', 'update_policy', 'reconciliation_attcode')); // Attributes to be displayed for the complete details
  1080. MetaModel::Init_SetZListItems('list', array('sync_source_id', 'attcode', 'update', 'reconcile', 'update_policy')); // Attributes to be displayed for a list
  1081. // Search criteria
  1082. // MetaModel::Init_SetZListItems('standard_search', array('name')); // Criteria of the std search form
  1083. // MetaModel::Init_SetZListItems('advanced_search', array('name')); // Criteria of the advanced search form
  1084. }
  1085. public function GetReconciliationFormElement($sTargetClass, $sFieldName)
  1086. {
  1087. $sHtml = "<select name=\"$sFieldName\">\n";
  1088. $sSelected = (''== $this->Get('reconciliation_attcode')) ? ' selected' : '';
  1089. $sHtml .= "<option value=\"\" $sSelected>".Dict::S('Core:SynchroAttExtKey:ReconciliationById')."</option>\n";
  1090. foreach(MetaModel::ListAttributeDefs($sTargetClass) as $sAttCode => $oAttDef)
  1091. {
  1092. if ($oAttDef->IsScalar())
  1093. {
  1094. $sSelected = ($sAttCode == $this->Get('reconciliation_attcode')) ? ' selected' : '';
  1095. $sHtml .= "<option value=\"$sAttCode\" $sSelected>".MetaModel::GetLabel($sTargetClass, $sAttCode)."</option>\n";
  1096. }
  1097. }
  1098. $sHtml .= "</select>\n";
  1099. return $sHtml;
  1100. }
  1101. }
  1102. class SynchroAttLinkSet extends SynchroAttribute
  1103. {
  1104. public static function Init()
  1105. {
  1106. $aParams = array
  1107. (
  1108. "category" => "core/cmdb,view_in_gui",
  1109. "key_type" => "autoincrement",
  1110. "name_attcode" => "",
  1111. "state_attcode" => "",
  1112. "reconc_keys" => array(),
  1113. "db_table" => "priv_sync_att_linkset",
  1114. "db_key_field" => "id",
  1115. "db_finalclass_field" => "",
  1116. "display_template" => "",
  1117. );
  1118. MetaModel::Init_Params($aParams);
  1119. MetaModel::Init_InheritAttributes();
  1120. MetaModel::Init_AddAttribute(new AttributeString("row_separator", array("allowed_values"=>null, "sql"=>"row_separator", "default_value"=>'|', "is_null_allowed"=>true, "depends_on"=>array())));
  1121. MetaModel::Init_AddAttribute(new AttributeString("attribute_separator", array("allowed_values"=>null, "sql"=>"attribute_separator", "default_value"=>';', "is_null_allowed"=>true, "depends_on"=>array())));
  1122. MetaModel::Init_AddAttribute(new AttributeString("value_separator", array("allowed_values"=>null, "sql"=>"value_separator", "default_value"=>':', "is_null_allowed"=>true, "depends_on"=>array())));
  1123. MetaModel::Init_AddAttribute(new AttributeString("attribute_qualifier", array("allowed_values"=>null, "sql"=>"attribute_qualifier", "default_value"=>'\'', "is_null_allowed"=>true, "depends_on"=>array())));
  1124. // Display lists
  1125. MetaModel::Init_SetZListItems('details', array('sync_source_id', 'attcode', 'update', 'reconcile', 'update_policy', 'row_separator', 'attribute_separator', 'value_separator', 'attribute_qualifier')); // Attributes to be displayed for the complete details
  1126. MetaModel::Init_SetZListItems('list', array('sync_source_id', 'attcode', 'update', 'reconcile', 'update_policy')); // Attributes to be displayed for a list
  1127. // Search criteria
  1128. // MetaModel::Init_SetZListItems('standard_search', array('name')); // Criteria of the std search form
  1129. // MetaModel::Init_SetZListItems('advanced_search', array('name')); // Criteria of the advanced search form
  1130. }
  1131. }
  1132. //class SynchroLog extends Event
  1133. class SynchroLog extends DBObject
  1134. {
  1135. public static function Init()
  1136. {
  1137. $aParams = array
  1138. (
  1139. "category" => "core/cmdb,view_in_gui",
  1140. "key_type" => "autoincrement",
  1141. "name_attcode" => "",
  1142. "state_attcode" => "",
  1143. "reconc_keys" => array(),
  1144. "db_table" => "priv_sync_log",
  1145. "db_key_field" => "id",
  1146. "db_finalclass_field" => "",
  1147. "display_template" => "",
  1148. );
  1149. MetaModel::Init_Params($aParams);
  1150. MetaModel::Init_InheritAttributes();
  1151. // MetaModel::Init_AddAttribute(new AttributeString("userinfo", array("allowed_values"=>null, "sql"=>"userinfo", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
  1152. MetaModel::Init_AddAttribute(new AttributeExternalKey("sync_source_id", array("targetclass"=>"SynchroDataSource", "jointype"=> "", "allowed_values"=>null, "sql"=>"sync_source_id", "is_null_allowed"=>false, "on_target_delete"=>DEL_SILENT, "depends_on"=>array())));
  1153. MetaModel::Init_AddAttribute(new AttributeDateTime("start_date", array("allowed_values"=>null, "sql"=>"start_date", "default_value"=>"", "is_null_allowed"=>true, "depends_on"=>array())));
  1154. MetaModel::Init_AddAttribute(new AttributeDateTime("end_date", array("allowed_values"=>null, "sql"=>"end_date", "default_value"=>"", "is_null_allowed"=>true, "depends_on"=>array())));
  1155. MetaModel::Init_AddAttribute(new AttributeEnum("status", array("allowed_values"=>new ValueSetEnum('running,completed,error'), "sql"=>"status", "default_value"=>"running", "is_null_allowed"=>false, "depends_on"=>array())));
  1156. MetaModel::Init_AddAttribute(new AttributeInteger("status_curr_job", array("allowed_values"=>null, "sql"=>"status_curr_job", "default_value"=>0, "is_null_allowed"=>true, "depends_on"=>array())));
  1157. MetaModel::Init_AddAttribute(new AttributeInteger("status_curr_pos", array("allowed_values"=>null, "sql"=>"status_curr_pos", "default_value"=>0, "is_null_allowed"=>true, "depends_on"=>array())));
  1158. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_replica_seen", array("allowed_values"=>null, "sql"=>"stats_nb_replica_seen", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1159. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_replica_total", array("allowed_values"=>null, "sql"=>"stats_nb_replica_total", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1160. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_deleted", array("allowed_values"=>null, "sql"=>"stats_nb_obj_deleted", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1161. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_deleted_errors", array("allowed_values"=>null, "sql"=>"stats_deleted_errors", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1162. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_obsoleted", array("allowed_values"=>null, "sql"=>"stats_nb_obj_obsoleted", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1163. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_obsoleted_errors", array("allowed_values"=>null, "sql"=>"stats_nb_obj_obsoleted_errors", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1164. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_created", array("allowed_values"=>null, "sql"=>"stats_nb_obj_created", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1165. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_created_errors", array("allowed_values"=>null, "sql"=>"stats_nb_obj_created_errors", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1166. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_created_warnings", array("allowed_values"=>null, "sql"=>"stats_nb_obj_created_warnings", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1167. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_updated", array("allowed_values"=>null, "sql"=>"stats_nb_obj_updated", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1168. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_updated_errors", array("allowed_values"=>null, "sql"=>"stats_nb_obj_updated_errors", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1169. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_updated_warnings", array("allowed_values"=>null, "sql"=>"stats_nb_obj_updated_warnings", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1170. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_unchanged_warnings", array("allowed_values"=>null, "sql"=>"stats_nb_obj_unchanged_warnings", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1171. // MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_replica_reconciled", array("allowed_values"=>null, "sql"=>"stats_nb_replica_reconciled", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1172. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_replica_reconciled_errors", array("allowed_values"=>null, "sql"=>"stats_nb_replica_reconciled_errors", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1173. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_replica_disappeared_no_action", array("allowed_values"=>null, "sql"=>"stats_nb_replica_disappeared_no_action", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1174. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_new_updated", array("allowed_values"=>null, "sql"=>"stats_nb_obj_new_updated", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1175. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_new_updated_warnings", array("allowed_values"=>null, "sql"=>"stats_nb_obj_new_updated_warnings", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1176. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_new_unchanged", array("allowed_values"=>null, "sql"=>"stats_nb_obj_new_unchanged", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1177. MetaModel::Init_AddAttribute(new AttributeInteger("stats_nb_obj_new_unchanged_warnings", array("allowed_values"=>null, "sql"=>"stats_nb_obj_new_unchanged_warnings", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1178. MetaModel::Init_AddAttribute(new AttributeText("last_error", array("allowed_values"=>null, "sql"=>"last_error", "default_value"=>'', "is_null_allowed"=>true, "depends_on"=>array())));
  1179. MetaModel::Init_AddAttribute(new AttributeLongText("traces", array("allowed_values"=>null, "sql"=>"traces", "default_value"=>'', "is_null_allowed"=>true, "depends_on"=>array())));
  1180. MetaModel::Init_AddAttribute(new AttributeInteger("memory_usage_peak", array("allowed_values"=>null, "sql"=>"memory_usage_peak", "default_value"=>0, "is_null_allowed"=>false, "depends_on"=>array())));
  1181. // Display lists
  1182. MetaModel::Init_SetZListItems('details', array('sync_source_id', 'start_date', 'end_date', 'status', 'stats_nb_replica_total', 'stats_nb_replica_seen', 'stats_nb_obj_created', /*'stats_nb_replica_reconciled',*/ 'stats_nb_obj_updated', 'stats_nb_obj_obsoleted', 'stats_nb_obj_deleted',
  1183. 'stats_nb_obj_created_errors', 'stats_nb_replica_reconciled_errors', 'stats_nb_replica_disappeared_no_action', 'stats_nb_obj_updated_errors', 'stats_nb_obj_obsoleted_errors', 'stats_nb_obj_deleted_errors', 'stats_nb_obj_new_unchanged', 'stats_nb_obj_new_updated', 'traces')); // Attributes to be displayed for the complete details
  1184. MetaModel::Init_SetZListItems('list', array('sync_source_id', 'start_date', 'end_date', 'status', 'stats_nb_replica_seen')); // Attributes to be displayed for a list
  1185. // Search criteria
  1186. // MetaModel::Init_SetZListItems('standard_search', array('name')); // Criteria of the std search form
  1187. // MetaModel::Init_SetZListItems('advanced_search', array('name')); // Criteria of the advanced search form
  1188. }
  1189. /**
  1190. * Helper
  1191. */
  1192. function GetErrorCount()
  1193. {
  1194. return $this->Get('stats_nb_obj_deleted_errors')
  1195. + $this->Get('stats_nb_obj_obsoleted_errors')
  1196. + $this->Get('stats_nb_obj_created_errors')
  1197. + $this->Get('stats_nb_obj_updated_errors')
  1198. + $this->Get('stats_nb_replica_reconciled_errors');
  1199. }
  1200. /**
  1201. * Increments a statistics counter
  1202. */
  1203. function Inc($sCode)
  1204. {
  1205. $this->Set($sCode, 1+$this->Get($sCode));
  1206. }
  1207. /**
  1208. * Implement traces management
  1209. */
  1210. protected $m_aTraces = array();
  1211. public function AddTrace($sMsg, $oReplica = null)
  1212. {
  1213. if (MetaModel::GetConfig()->Get('synchro_trace') == 'none')
  1214. {
  1215. return;
  1216. }
  1217. if ($oReplica)
  1218. {
  1219. $sDestClass = $oReplica->Get('dest_class');
  1220. if (!empty($sDestClass))
  1221. {
  1222. $sPrefix = $oReplica->GetKey().','.$sDestClass.'::'.$oReplica->Get('dest_id').',';
  1223. }
  1224. else
  1225. {
  1226. $sPrefix = $oReplica->GetKey().',,';
  1227. }
  1228. }
  1229. else
  1230. {
  1231. $sPrefix = ',,';
  1232. }
  1233. $this->m_aTraces[] = $sPrefix.$sMsg;
  1234. }
  1235. public function GetTraces()
  1236. {
  1237. return $this->m_aTraces;
  1238. }
  1239. protected function TraceToText()
  1240. {
  1241. if (MetaModel::GetConfig()->Get('synchro_trace') != 'save')
  1242. {
  1243. // none, or display only
  1244. return;
  1245. }
  1246. $sPrevTrace = $this->Get('traces');
  1247. $oAttDef = MetaModel::GetAttributeDef(get_class($this), 'traces');
  1248. $iMaxSize = $oAttDef->GetMaxSize();
  1249. if (strlen($sPrevTrace) > 0)
  1250. {
  1251. $sTrace = $sPrevTrace."\n".implode("\n", $this->m_aTraces);
  1252. }
  1253. else
  1254. {
  1255. $sTrace = implode("\n", $this->m_aTraces);
  1256. }
  1257. if (strlen($sTrace) >= $iMaxSize)
  1258. {
  1259. $sTrace = substr($sTrace, 0, $iMaxSize - 255)."...\nTruncated (size: ".strlen($sTrace).')';
  1260. }
  1261. $this->Set('traces', $sTrace);
  1262. //DBUpdate may be called many times... the operation should not be repeated
  1263. $this->m_aTraces = array();
  1264. }
  1265. protected function OnInsert()
  1266. {
  1267. $this->TraceToText();
  1268. parent::OnInsert();
  1269. }
  1270. protected function OnUpdate()
  1271. {
  1272. $this->TraceToText();
  1273. $sMemPeak = max($this->Get('memory_usage_peak'), ExecutionKPI::memory_get_peak_usage());
  1274. $this->Set('memory_usage_peak', $sMemPeak);
  1275. parent::OnUpdate();
  1276. }
  1277. }
  1278. class SynchroReplica extends DBObject implements iDisplay
  1279. {
  1280. static $aSearches = array(); // Cache of OQL queries used for reconciliation (per data source)
  1281. protected $aWarnings;
  1282. public static function Init()
  1283. {
  1284. $aParams = array
  1285. (
  1286. "category" => "core/cmdb,view_in_gui",
  1287. "key_type" => "autoincrement",
  1288. "name_attcode" => "",
  1289. "state_attcode" => "",
  1290. "reconc_keys" => array(),
  1291. "db_table" => "priv_sync_replica",
  1292. "db_key_field" => "id",
  1293. "db_finalclass_field" => "",
  1294. "display_template" => "",
  1295. );
  1296. MetaModel::Init_Params($aParams);
  1297. MetaModel::Init_InheritAttributes();
  1298. MetaModel::Init_AddAttribute(new AttributeExternalKey("sync_source_id", array("targetclass"=>"SynchroDataSource", "jointype"=> "", "allowed_values"=>null, "sql"=>"sync_source_id", "is_null_allowed"=>false, "on_target_delete"=>DEL_SILENT, "depends_on"=>array())));
  1299. MetaModel::Init_AddAttribute(new AttributeExternalField("base_class", array("allowed_values"=>null, "extkey_attcode"=> 'sync_source_id', "target_attcode"=>"scope_class")));
  1300. MetaModel::Init_AddAttribute(new AttributeInteger("dest_id", array("allowed_values"=>null, "sql"=>"dest_id", "default_value"=>0, "is_null_allowed"=>true, "depends_on"=>array())));
  1301. MetaModel::Init_AddAttribute(new AttributeClass("dest_class", array("class_category"=>"", "more_values"=>"", "sql"=>"dest_class", "default_value"=>'Organization', "is_null_allowed"=>true, "depends_on"=>array())));
  1302. MetaModel::Init_AddAttribute(new AttributeDateTime("status_last_seen", array("allowed_values"=>null, "sql"=>"status_last_seen", "default_value"=>"", "is_null_allowed"=>false, "depends_on"=>array())));
  1303. MetaModel::Init_AddAttribute(new AttributeEnum("status", array("allowed_values"=>new ValueSetEnum('new,synchronized,modified,orphan,obsolete'), "sql"=>"status", "default_value"=>"new", "is_null_allowed"=>false, "depends_on"=>array())));
  1304. MetaModel::Init_AddAttribute(new AttributeBoolean("status_dest_creator", array("allowed_values"=>null, "sql"=>"status_dest_creator", "default_value"=>0, "is_null_allowed"=>true, "depends_on"=>array())));
  1305. MetaModel::Init_AddAttribute(new AttributeString("status_last_error", array("allowed_values"=>null, "sql"=>"status_last_error", "default_value"=>'', "is_null_allowed"=>true, "depends_on"=>array())));
  1306. MetaModel::Init_AddAttribute(new AttributeString("status_last_warning", array("allowed_values"=>null, "sql"=>"status_last_warning", "default_value"=>'', "is_null_allowed"=>true, "depends_on"=>array())));
  1307. MetaModel::Init_AddAttribute(new AttributeDateTime("info_creation_date", array("allowed_values"=>null, "sql"=>"info_creation_date", "default_value"=>"", "is_null_allowed"=>true, "depends_on"=>array())));
  1308. MetaModel::Init_AddAttribute(new AttributeDateTime("info_last_modified", array("allowed_values"=>null, "sql"=>"info_last_modified", "default_value"=>"", "is_null_allowed"=>true, "depends_on"=>array())));
  1309. // Display lists
  1310. MetaModel::Init_SetZListItems('details', array('' .
  1311. 'col:0'=> array(
  1312. 'fieldset:SynchroDataSource:Definition' => array('sync_source_id','dest_id','dest_class'),
  1313. 'fieldset:SynchroDataSource:Status' => array('status','status_last_seen','status_dest_creator','status_last_error','status_last_warning'),
  1314. 'fieldset:SynchroDataSource:Information' => array('info_creation_date','info_last_modified'))
  1315. )
  1316. );
  1317. MetaModel::Init_SetZListItems('list', array('sync_source_id', 'dest_id', 'dest_class', 'status_last_seen', 'status', 'status_dest_creator', 'status_last_error', 'status_last_warning')); // Attributes to be displayed for a list
  1318. // Search criteria
  1319. MetaModel::Init_SetZListItems('standard_search', array('sync_source_id', 'status_last_seen', 'status', 'status_dest_creator', 'dest_class', 'dest_id', 'status_last_error', 'status_last_warning')); // Criteria of the std search form
  1320. // MetaModel::Init_SetZListItems('advanced_search', array('name')); // Criteria of the advanced search form
  1321. }
  1322. public function __construct($aRow = null, $sClassAlias = '', $aAttToLoad = null, $aExtendedDataSpec = null)
  1323. {
  1324. parent::__construct($aRow, $sClassAlias, $aAttToLoad, $aExtendedDataSpec);
  1325. $this->aWarnings = array();
  1326. }
  1327. protected function AddWarning($sWarningMessage)
  1328. {
  1329. $this->aWarnings[] = $sWarningMessage;
  1330. }
  1331. protected function ResetWarnings()
  1332. {
  1333. $this->aWarnings = array();
  1334. }
  1335. protected function HasWarnings()
  1336. {
  1337. return (count($this->aWarnings) > 0);
  1338. }
  1339. protected function RecordWarnings()
  1340. {
  1341. $sWarningMessage = '';
  1342. $MAX_WARNING_LENGTH = 255;
  1343. switch(count($this->aWarnings))
  1344. {
  1345. case 0:
  1346. $sWarningMessage = '';
  1347. break;
  1348. case 1:
  1349. $sWarningMessage = $this->aWarnings[0];
  1350. break;
  1351. default:
  1352. $sWarningMessage = count($this->aWarnings)." warnings: ".implode(' ', $this->aWarnings);
  1353. break;
  1354. }
  1355. if (strlen($sWarningMessage) > $MAX_WARNING_LENGTH)
  1356. {
  1357. $sWarningMessage = substr($sWarningMessage, 0, $MAX_WARNING_LENGTH - 3).'...';
  1358. }
  1359. $this->Set('status_last_warning', $sWarningMessage);
  1360. }
  1361. public function DBInsert()
  1362. {
  1363. throw new CoreException('A synchronization replica must be created only by the mean of triggers');
  1364. }
  1365. // Overload the deletion -> the replica has been created by the mean of a trigger,
  1366. // it will be deleted by the mean of a trigger too
  1367. protected function DBDeleteSingleObject()
  1368. {
  1369. $this->OnDelete();
  1370. if (!MetaModel::DBIsReadOnly())
  1371. {
  1372. $oDataSource = MetaModel::GetObject('SynchroDataSource', $this->Get('sync_source_id'));
  1373. $sTable = $oDataSource->GetDataTable();
  1374. $sSQL = "DELETE FROM `$sTable` WHERE id = '{$this->GetKey()}'";
  1375. CMDBSource::Query($sSQL);
  1376. }
  1377. $this->AfterDelete();
  1378. $this->m_bIsInDB = false;
  1379. $this->m_iKey = null;
  1380. }
  1381. public function SetLastError($sMessage, $oException = null)
  1382. {
  1383. if ($oException)
  1384. {
  1385. $sText = $sMessage.$oException->getMessage();
  1386. }
  1387. else
  1388. {
  1389. $sText = $sMessage;
  1390. }
  1391. if (strlen($sText) > 255)
  1392. {
  1393. $sText = substr($sText, 0, 200).'...('.strlen($sText).' chars)...';
  1394. }
  1395. $this->Set('status_last_error', $sText);
  1396. }
  1397. public function Synchro($oDataSource, $aReconciliationKeys, $aAttributes, $oChange, &$oStatLog)
  1398. {
  1399. $this->ResetWarnings();
  1400. switch($this->Get('status'))
  1401. {
  1402. case 'new':
  1403. $this->Set('status_dest_creator', false);
  1404. // If needed, construct the query used for the reconciliation
  1405. if (!isset(self::$aSearches[$oDataSource->GetKey()]))
  1406. {
  1407. $aCriterias = array();
  1408. foreach($aReconciliationKeys as $sFilterCode => $oSyncAtt)
  1409. {
  1410. $aCriterias[] = ($sFilterCode == 'primary_key' ? 'id' : $sFilterCode).' = :'.$sFilterCode;
  1411. }
  1412. $sOQL = "SELECT ".$oDataSource->GetTargetClass()." WHERE ".implode(' AND ', $aCriterias);
  1413. self::$aSearches[$oDataSource->GetKey()] = DBObjectSearch::FromOQL($sOQL);
  1414. }
  1415. // Get the criterias for the search
  1416. $aFilterValues = array();
  1417. foreach($aReconciliationKeys as $sFilterCode => $oSyncAtt)
  1418. {
  1419. $value = $this->GetValueFromExtData($sFilterCode, $oSyncAtt, $oStatLog);
  1420. if (!is_null($value))
  1421. {
  1422. $aFilterValues[$sFilterCode] = $value;
  1423. }
  1424. else
  1425. {
  1426. // TO DO: can we retry this ??
  1427. // Reconciliation could not be performed - log and EXIT
  1428. $oStatLog->AddTrace("Could not reconcile on null value for attribute '$sFilterCode'", $this);
  1429. $this->SetLastError("Could not reconcile on null value for attribute '$sFilterCode'");
  1430. $oStatLog->Inc('stats_nb_replica_reconciled_errors');
  1431. return;
  1432. }
  1433. }
  1434. $oDestSet = new DBObjectSet(self::$aSearches[$oDataSource->GetKey()], array(), $aFilterValues);
  1435. $iCount = $oDestSet->Count();
  1436. $aConditions = array();
  1437. foreach($aFilterValues as $sCode => $sValue)
  1438. {
  1439. $aConditions[] = $sCode.'='.$sValue;
  1440. }
  1441. $sConditionDesc = implode(' AND ', $aConditions);
  1442. // How many objects match the reconciliation criterias
  1443. switch($iCount)
  1444. {
  1445. case 0:
  1446. $oStatLog->AddTrace("Nothing found on: $sConditionDesc", $this);
  1447. if ($oDataSource->Get('action_on_zero') == 'create')
  1448. {
  1449. $bCreated = $this->CreateObjectFromReplica($oDataSource->GetTargetClass(), $aAttributes, $oChange, $oStatLog);
  1450. if ($bCreated)
  1451. {
  1452. if ($this->HasWarnings())
  1453. {
  1454. $oStatLog->Inc('stats_nb_obj_created_warnings');
  1455. }
  1456. }
  1457. else
  1458. {
  1459. // Creation error has precedence over any warning
  1460. $this->ResetWarnings();
  1461. }
  1462. }
  1463. else // assumed to be 'error'
  1464. {
  1465. $oStatLog->AddTrace("Failed to reconcile (no match)", $this);
  1466. // Recoverable error
  1467. $this->SetLastError('Could not find a match for reconciliation');
  1468. $oStatLog->Inc('stats_nb_replica_reconciled_errors');
  1469. }
  1470. break;
  1471. case 1:
  1472. $oStatLog->AddTrace("Found 1 object on: $sConditionDesc", $this);
  1473. if ($oDataSource->Get('action_on_one') == 'update')
  1474. {
  1475. $oDestObj = $oDestSet->Fetch();
  1476. $bModified = $this->UpdateObjectFromReplica($oDestObj, $aAttributes, $oChange, $oStatLog, 'stats_nb_obj_new', 'stats_nb_replica_reconciled_errors');
  1477. $this->Set('dest_id', $oDestObj->GetKey());
  1478. $this->Set('dest_class', get_class($oDestObj));
  1479. if ($this->HasWarnings())
  1480. {
  1481. if ($bModified)
  1482. {
  1483. $oStatLog->Inc('stats_nb_obj_new_updated_warnings');
  1484. }
  1485. else
  1486. {
  1487. $oStatLog->Inc('stats_nb_obj_new_unchanged_warnings');
  1488. }
  1489. }
  1490. }
  1491. else
  1492. {
  1493. // assumed to be 'error'
  1494. $oStatLog->AddTrace("Failed to reconcile (1 match)", $this);
  1495. // Recoverable error
  1496. $this->SetLastError('Found a match while expecting several');
  1497. $oStatLog->Inc('stats_nb_replica_reconciled_errors');
  1498. }
  1499. break;
  1500. default:
  1501. $oStatLog->AddTrace("Found $iCount objects on: $sConditionDesc", $this);
  1502. if ($oDataSource->Get('action_on_multiple') == 'error')
  1503. {
  1504. $oStatLog->AddTrace("Failed to reconcile (N>1 matches)", $this);
  1505. // Recoverable error
  1506. $this->SetLastError($iCount.' destination objects match the reconciliation criterias: '.$sConditionDesc);
  1507. $oStatLog->Inc('stats_nb_replica_reconciled_errors');
  1508. }
  1509. elseif ($oDataSource->Get('action_on_multiple') == 'create')
  1510. {
  1511. $bCreated = $this->CreateObjectFromReplica($oDataSource->GetTargetClass(), $aAttributes, $oChange, $oStatLog);
  1512. if ($bCreated)
  1513. {
  1514. if ($this->HasWarnings())
  1515. {
  1516. $oStatLog->Inc('stats_nb_obj_created_warnings');
  1517. }
  1518. }
  1519. else
  1520. {
  1521. // Creation error has precedence over any warning
  1522. $this->ResetWarnings();
  1523. }
  1524. }
  1525. else
  1526. {
  1527. // assumed to be 'take_first'
  1528. $oDestObj = $oDestSet->Fetch();
  1529. $bModified = $this->UpdateObjectFromReplica($oDestObj, $aAttributes, $oChange, $oStatLog, 'stats_nb_obj_new', 'stats_nb_replica_reconciled_errors');
  1530. $this->Set('dest_id', $oDestObj->GetKey());
  1531. $this->Set('dest_class', get_class($oDestObj));
  1532. if ($this->HasWarnings())
  1533. {
  1534. if ($bModified)
  1535. {
  1536. $oStatLog->Inc('stats_nb_obj_new_updated_warnings');
  1537. }
  1538. else
  1539. {
  1540. $oStatLog->Inc('stats_nb_obj_new_unchanged_warnings');
  1541. }
  1542. }
  1543. }
  1544. }
  1545. $this->RecordWarnings();
  1546. break;
  1547. case 'synchronized': // try to recover synchronized replicas with warnings
  1548. case 'modified':
  1549. $oDestObj = MetaModel::GetObject($oDataSource->GetTargetClass(), $this->Get('dest_id'));
  1550. if ($oDestObj == null)
  1551. {
  1552. $this->Set('status', 'orphan'); // The destination object has been deleted !
  1553. $this->SetLastError('Destination object deleted unexpectedly');
  1554. $oStatLog->Inc('stats_nb_obj_updated_errors');
  1555. }
  1556. else
  1557. {
  1558. $bModified = $this->UpdateObjectFromReplica($oDestObj, $aAttributes, $oChange, $oStatLog, 'stats_nb_obj', 'stats_nb_obj_updated_errors');
  1559. if ($this->HasWarnings())
  1560. {
  1561. if ($bModified)
  1562. {
  1563. $oStatLog->Inc('stats_nb_obj_updated_warnings');
  1564. }
  1565. else
  1566. {
  1567. $oStatLog->Inc('stats_nb_obj_unchanged_warnings');
  1568. }
  1569. }
  1570. }
  1571. $this->RecordWarnings();
  1572. break;
  1573. default: // Do nothing in all other cases
  1574. }
  1575. }
  1576. /**
  1577. * Updates the destination object with the Extended data found in the synchro_data_XXXX table
  1578. */
  1579. protected function UpdateObjectFromReplica($oDestObj, $aAttributes, $oChange, &$oStatLog, $sStatsCode, $sStatsCodeError)
  1580. {
  1581. $aValueTrace = array();
  1582. $bModified = false;
  1583. try
  1584. {
  1585. foreach($aAttributes as $sAttCode => $oSyncAtt)
  1586. {
  1587. $value = $this->GetValueFromExtData($sAttCode, $oSyncAtt, $oStatLog);
  1588. if (!is_null($value))
  1589. {
  1590. $oDestObj->Set($sAttCode, $value);
  1591. $aValueTrace[] = "$sAttCode: $value";
  1592. }
  1593. }
  1594. // Really modified ?
  1595. if ($oDestObj->IsModified())
  1596. {
  1597. $oDestObj->DBUpdateTracked($oChange);
  1598. $bModified = true;
  1599. $oStatLog->AddTrace('Updated object - Values: {'.implode(', ', $aValueTrace).'}', $this);
  1600. if (($sStatsCode != '') &&(MetaModel::IsValidAttCode(get_class($oStatLog), $sStatsCode.'_updated')))
  1601. {
  1602. $oStatLog->Inc($sStatsCode.'_updated');
  1603. }
  1604. $this->Set('info_last_modified', date('Y-m-d H:i:s'));
  1605. }
  1606. else
  1607. {
  1608. $oStatLog->AddTrace('Unchanged object', $this);
  1609. if (($sStatsCode != '') &&(MetaModel::IsValidAttCode(get_class($oStatLog), $sStatsCode.'_unchanged')))
  1610. {
  1611. $oStatLog->Inc($sStatsCode.'_unchanged');
  1612. }
  1613. }
  1614. $this->Set('status_last_error', '');
  1615. $this->Set('status', 'synchronized');
  1616. }
  1617. catch(Exception $e)
  1618. {
  1619. $oStatLog->AddTrace("Failed to update destination object: {$e->getMessage()}", $this);
  1620. $this->SetLastError('Unable to update destination object: ', $e);
  1621. $oStatLog->Inc($sStatsCodeError);
  1622. }
  1623. return $bModified;
  1624. }
  1625. /**
  1626. * Creates the destination object populating it with the Extended data found in the synchro_data_XXXX table
  1627. * @return bool Whether or not the object was created
  1628. */
  1629. protected function CreateObjectFromReplica($sClass, $aAttributes, $oChange, &$oStatLog)
  1630. {
  1631. $bCreated = false;
  1632. $oDestObj = MetaModel::NewObject($sClass);
  1633. try
  1634. {
  1635. $aValueTrace = array();
  1636. foreach($aAttributes as $sAttCode => $oSyncAtt)
  1637. {
  1638. $value = $this->GetValueFromExtData($sAttCode, $oSyncAtt, $oStatLog);
  1639. if (!is_null($value))
  1640. {
  1641. $oDestObj->Set($sAttCode, $value);
  1642. $aValueTrace[] = "$sAttCode: $value";
  1643. }
  1644. }
  1645. $iNew = $oDestObj->DBInsertTracked($oChange);
  1646. $this->Set('dest_id', $oDestObj->GetKey());
  1647. $this->Set('dest_class', get_class($oDestObj));
  1648. $this->Set('status_dest_creator', true);
  1649. $this->Set('status_last_error', '');
  1650. $this->Set('status', 'synchronized');
  1651. $this->Set('info_creation_date', date('Y-m-d H:i:s'));
  1652. $bCreated = true;
  1653. $oStatLog->AddTrace("Created (".implode(', ', $aValueTrace).")", $this);
  1654. $oStatLog->Inc('stats_nb_obj_created');
  1655. }
  1656. catch(Exception $e)
  1657. {
  1658. $oStatLog->AddTrace("Failed to create $sClass ({$e->getMessage()})", $this);
  1659. $this->SetLastError('Unable to create destination object: ', $e);
  1660. $oStatLog->Inc('stats_nb_obj_created_errors');
  1661. }
  1662. return $bCreated;
  1663. }
  1664. /**
  1665. * Update the destination object with given values
  1666. */
  1667. public function UpdateDestObject($aValues, $oChange, &$oStatLog)
  1668. {
  1669. try
  1670. {
  1671. if ($this->Get('dest_class') == '')
  1672. {
  1673. $this->SetLastError('No destination object to update');
  1674. $oStatLog->Inc('stats_nb_obj_obsoleted_errors');
  1675. }
  1676. else
  1677. {
  1678. $oDestObj = MetaModel::GetObject($this->Get('dest_class'), $this->Get('dest_id'));
  1679. foreach($aValues as $sAttCode => $value)
  1680. {
  1681. if (!MetaModel::IsValidAttCode(get_class($oDestObj), $sAttCode))
  1682. {
  1683. throw new Exception("Unknown attribute code '$sAttCode'");
  1684. }
  1685. $oDestObj->Set($sAttCode, $value);
  1686. }
  1687. $this->Set('info_last_modified', date('Y-m-d H:i:s'));
  1688. $oDestObj->DBUpdateTracked($oChange);
  1689. $oStatLog->AddTrace("Replica marked as obsolete", $this);
  1690. $oStatLog->Inc('stats_nb_obj_obsoleted');
  1691. }
  1692. }
  1693. catch(Exception $e)
  1694. {
  1695. $this->SetLastError('Unable to update the destination object: ', $e);
  1696. $oStatLog->Inc('stats_nb_obj_obsoleted_errors');
  1697. }
  1698. }
  1699. /**
  1700. * Delete the destination object
  1701. */
  1702. public function DeleteDestObject($oChange, &$oStatLog)
  1703. {
  1704. if($this->Get('status_dest_creator'))
  1705. {
  1706. try
  1707. {
  1708. $oDestObj = MetaModel::GetObject($this->Get('dest_class'), $this->Get('dest_id'));
  1709. $oCheckDeletionPlan = new DeletionPlan();
  1710. if ($oDestObj->CheckToDelete($oCheckDeletionPlan))
  1711. {
  1712. $oActualDeletionPlan = new DeletionPlan();
  1713. $oDestObj->DBDeleteTracked($oChange, null, $oActualDeletionPlan);
  1714. $this->DBDeleteTracked($oChange);
  1715. $oStatLog->Inc('stats_nb_obj_deleted');
  1716. }
  1717. else
  1718. {
  1719. $sIssues = implode("\n", $oCheckDeletionPlan->GetIssues());
  1720. throw(new Exception($sIssues));
  1721. }
  1722. }
  1723. catch(Exception $e)
  1724. {
  1725. $this->SetLastError('Unable to delete the destination object: ', $e);
  1726. $this->Set('status', 'obsolete');
  1727. $this->DBUpdateTracked($oChange);
  1728. $oStatLog->Inc('stats_nb_obj_deleted_errors');
  1729. }
  1730. }
  1731. else
  1732. {
  1733. $this->DBDeleteTracked($oChange);
  1734. $oStatLog->Inc('stats_nb_replica_disappeared_no_action');
  1735. }
  1736. }
  1737. /**
  1738. * Get the value from the 'Extended Data' located in the synchro_data_xxx table for this replica
  1739. * Note: sExtAttCode could be a standard attcode, or 'primary_key'
  1740. */
  1741. protected function GetValueFromExtData($sExtAttCode, $oSyncAtt, &$oStatLog)
  1742. {
  1743. // $aData should contain attributes defined either for reconciliation or create/update
  1744. $aData = $this->GetExtendedData();
  1745. if ($sExtAttCode == 'primary_key')
  1746. {
  1747. return $aData['primary_key'];
  1748. }
  1749. // $sExtAttCode is a valid attribute code
  1750. //
  1751. $sClass = $this->Get('base_class');
  1752. $oAttDef = MetaModel::GetAttributeDef($sClass, $sExtAttCode);
  1753. if (!is_null($oSyncAtt) && ($oSyncAtt instanceof SynchroAttExtKey))
  1754. {
  1755. $rawValue = $aData[$sExtAttCode];
  1756. if (is_null($rawValue))
  1757. {
  1758. // Null means "ignore" this attribute
  1759. return null;
  1760. }
  1761. $sReconcAttCode = $oSyncAtt->Get('reconciliation_attcode');
  1762. if (!empty($sReconcAttCode))
  1763. {
  1764. $sRemoteClass = $oAttDef->GetTargetClass();
  1765. $oObj = MetaModel::GetObjectByColumn($sRemoteClass, $sReconcAttCode, $rawValue, false);
  1766. if ($oObj)
  1767. {
  1768. $retValue = $oObj->GetKey();
  1769. }
  1770. else
  1771. {
  1772. if ($rawValue != '')
  1773. {
  1774. // Note: differs from null (in which case the value would be left unchanged)
  1775. $oStatLog->AddTrace("Could not find [unique] object for '$sExtAttCode': searched on $sReconcAttCode = '$rawValue'", $this);
  1776. $this->AddWarning("Could not find [unique] object for '$sExtAttCode': searched on $sReconcAttCode = '$rawValue'");
  1777. }
  1778. $retValue = 0;
  1779. }
  1780. }
  1781. else
  1782. {
  1783. $retValue = $rawValue;
  1784. }
  1785. }
  1786. elseif (!is_null($oSyncAtt) && ($oSyncAtt instanceof SynchroAttLinkSet))
  1787. {
  1788. $rawValue = $aData[$sExtAttCode];
  1789. if (is_null($rawValue))
  1790. {
  1791. // Null means "ignore" this attribute
  1792. return null;
  1793. }
  1794. // MakeValueFromString() throws an exception in case of failure
  1795. $retValue = $oAttDef->MakeValueFromString($rawValue, $oSyncAtt->Get('row_separator'), $oSyncAtt->Get('attribute_separator'), $oSyncAtt->Get('value_separator'), $oSyncAtt->Get('attribute_qualifier'));
  1796. }
  1797. else
  1798. {
  1799. $aColumns = $oAttDef->GetImportColumns();
  1800. foreach($aColumns as $sColumn => $sFormat)
  1801. {
  1802. // In any case, a null column means "ignore this attribute"
  1803. //
  1804. if (is_null($aData[$sColumn]))
  1805. {
  1806. return null;
  1807. }
  1808. }
  1809. $retValue = $oAttDef->FromImportToValue($aData, $sExtAttCode);
  1810. }
  1811. return $retValue;
  1812. }
  1813. /**
  1814. * Maps the given context parameter name to the appropriate filter/search code for this class
  1815. * @param string $sContextParam Name of the context parameter, i.e. 'org_id'
  1816. * @return string Filter code, i.e. 'customer_id'
  1817. */
  1818. public static function MapContextParam($sContextParam)
  1819. {
  1820. if ($sContextParam == 'menu')
  1821. {
  1822. return null;
  1823. }
  1824. else
  1825. {
  1826. return $sContextParam;
  1827. }
  1828. }
  1829. /**
  1830. * This function returns a 'hilight' CSS class, used to hilight a given row in a table
  1831. * There are currently (i.e defined in the CSS) 4 possible values HILIGHT_CLASS_CRITICAL,
  1832. * HILIGHT_CLASS_WARNING, HILIGHT_CLASS_OK, HILIGHT_CLASS_NONE
  1833. * To Be overridden by derived classes
  1834. * @param void
  1835. * @return String The desired higlight class for the object/row
  1836. */
  1837. public function GetHilightClass()
  1838. {
  1839. // Possible return values are:
  1840. // HILIGHT_CLASS_CRITICAL, HILIGHT_CLASS_WARNING, HILIGHT_CLASS_OK, HILIGHT_CLASS_NONE
  1841. return HILIGHT_CLASS_NONE; // Not hilighted by default
  1842. }
  1843. public static function GetUIPage()
  1844. {
  1845. return '../synchro/replica.php';
  1846. }
  1847. function DisplayDetails(WebPage $oPage, $bEditMode = false)
  1848. {
  1849. // Object's details
  1850. //$this->DisplayBareHeader($oPage, $bEditMode);
  1851. $oPage->AddTabContainer(OBJECT_PROPERTIES_TAB);
  1852. $oPage->SetCurrentTabContainer(OBJECT_PROPERTIES_TAB);
  1853. $oPage->SetCurrentTab(Dict::S('UI:PropertiesTab'));
  1854. $this->DisplayBareProperties($oPage, $bEditMode);
  1855. }
  1856. function DisplayBareProperties(WebPage $oPage, $bEditMode = false, $sPrefix = '', $aExtraParams = array())
  1857. {
  1858. if ($bEditMode) return; // Not editable
  1859. $oPage->add('<table style="vertical-align:top"><tr style="vertical-align:top"><td>');
  1860. $aDetails = array();
  1861. $sClass = get_class($this);
  1862. $oPage->add('<fieldset>');
  1863. $oPage->add('<legend>'.Dict::S('Core:SynchroReplica:PrivateDetails').'</legend>');
  1864. $aZList = MetaModel::FlattenZlist(MetaModel::GetZListItems($sClass, 'details'));
  1865. foreach( $aZList as $sAttCode)
  1866. {
  1867. $sDisplayValue = $this->GetAsHTML($sAttCode);
  1868. $aDetails[] = array('label' => '<span title="'.MetaModel::GetDescription($sClass, $sAttCode).'">'.MetaModel::GetLabel($sClass, $sAttCode).'</span>', 'value' => $sDisplayValue);
  1869. }
  1870. $oPage->Details($aDetails);
  1871. $oPage->add('</fieldset>');
  1872. if (strlen($this->Get('dest_class')) > 0)
  1873. {
  1874. $oDestObj = MetaModel::GetObject($this->Get('dest_class'), $this->Get('dest_id'), false);
  1875. if (is_object($oDestObj))
  1876. {
  1877. $oPage->add('<fieldset>');
  1878. $oPage->add('<legend>'.Dict::Format('Core:SynchroReplica:TargetObject', $oDestObj->GetHyperlink()).'</legend>');
  1879. $oDestObj->DisplayBareProperties($oPage, false, $sPrefix, $aExtraParams);
  1880. $oPage->add('<fieldset>');
  1881. }
  1882. }
  1883. $oPage->add('</td><td>');
  1884. $oPage->add('<fieldset>');
  1885. $oPage->add('<legend>'.Dict::S('Core:SynchroReplica:PublicData').'</legend>');
  1886. $oSource = MetaModel::GetObject('SynchroDataSource', $this->Get('sync_source_id'));
  1887. $sSQLTable = $oSource->GetDataTable();
  1888. $aData = $this->LoadExtendedDataFromTable($sSQLTable);
  1889. $aHeaders = array('attcode' => array('label' => 'Attribute Code', 'description' => ''),
  1890. 'data' => array('label' => 'Value', 'description' => ''));
  1891. $aRows = array();
  1892. foreach($aData as $sKey => $value)
  1893. {
  1894. $aRows[] = array('attcode' => $sKey, 'data' => $value);
  1895. }
  1896. $oPage->Table($aHeaders, $aRows);
  1897. $oPage->add('</fieldset>');
  1898. $oPage->add('</td></tr></table>');
  1899. }
  1900. public function LoadExtendedDataFromTable($sSQLTable)
  1901. {
  1902. $sSQL = "SELECT * FROM $sSQLTable WHERE id=".$this->GetKey();
  1903. $rQuery = CMDBSource::Query($sSQL);
  1904. return CMDBSource::FetchArray($rQuery);
  1905. }
  1906. }
  1907. /**
  1908. * Context of an ongoing synchronization
  1909. * Two usages:
  1910. * 1) Public usage: execute the synchronization
  1911. * $oSynchroExec = new SynchroExecution($oDataSource[, $iLastFullLoad]);
  1912. * $oSynchroExec->Process($iMaxChunkSize);
  1913. *
  1914. * 2) Internal usage: continue the synchronization (split into chunks, each performed in a separate process)
  1915. * This is implemented in the page priv_sync_chunk.php
  1916. * $oSynchroExec = SynchroExecution::Resume($oDataSource, $iLastFullLoad, $iSynchroLog, $iChange, $iMaxToProcess, $iJob, $iNextInJob);
  1917. * $oSynchroExec->Process()
  1918. */
  1919. class SynchroExecution
  1920. {
  1921. protected $m_oDataSource = null;
  1922. protected $m_oLastFullLoadStartDate = null;
  1923. protected $m_oChange = null;
  1924. protected $m_oStatLog = null;
  1925. // Context computed one for optimization and report inconsistencies ASAP
  1926. protected $m_aExtDataSpec = array();
  1927. protected $m_aReconciliationKeys = array();
  1928. protected $m_aAttributes = array();
  1929. protected $m_iCountAllReplicas = 0;
  1930. /**
  1931. * Constructor
  1932. * @param SynchroDataSource $oDataSource Synchronization task
  1933. * @param DateTime $oLastFullLoadStartDate Date of the last full load (start date/time), if known
  1934. * @return void
  1935. */
  1936. public function __construct($oDataSource, $oLastFullLoadStartDate = null)
  1937. {
  1938. $this->m_oDataSource = $oDataSource;
  1939. $this->m_oLastFullLoadStartDate = $oLastFullLoadStartDate;
  1940. }
  1941. /**
  1942. * Create the persistant information records, for the current synchronization
  1943. * In fact, those records ARE defining what is the "current" synchronization
  1944. */
  1945. protected function PrepareLogs()
  1946. {
  1947. if (!is_null($this->m_oChange))
  1948. {
  1949. return;
  1950. }
  1951. // Create a change used for logging all the modifications/creations happening during the synchro
  1952. $this->m_oChange = MetaModel::NewObject("CMDBChange");
  1953. $this->m_oChange->Set("date", time());
  1954. $sUserString = CMDBChange::GetCurrentUserName();
  1955. $this->m_oChange->Set("userinfo", $sUserString.' '.Dict::S('Core:SyncDataExchangeComment'));
  1956. $iChangeId = $this->m_oChange->DBInsert();
  1957. // Start logging this execution (stats + protection against reentrance)
  1958. //
  1959. $this->m_oStatLog = new SynchroLog();
  1960. $this->m_oStatLog->Set('sync_source_id', $this->m_oDataSource->GetKey());
  1961. $this->m_oStatLog->Set('start_date', time());
  1962. $this->m_oStatLog->Set('status', 'running');
  1963. $this->m_oStatLog->Set('stats_nb_replica_seen', 0);
  1964. $this->m_oStatLog->Set('stats_nb_replica_total', 0);
  1965. $this->m_oStatLog->Set('stats_nb_obj_deleted', 0);
  1966. $this->m_oStatLog->Set('stats_nb_obj_deleted_errors', 0);
  1967. $this->m_oStatLog->Set('stats_nb_obj_obsoleted', 0);
  1968. $this->m_oStatLog->Set('stats_nb_obj_obsoleted_errors', 0);
  1969. $this->m_oStatLog->Set('stats_nb_obj_created', 0);
  1970. $this->m_oStatLog->Set('stats_nb_obj_created_errors', 0);
  1971. $this->m_oStatLog->Set('stats_nb_obj_created_warnings', 0);
  1972. $this->m_oStatLog->Set('stats_nb_obj_updated', 0);
  1973. $this->m_oStatLog->Set('stats_nb_obj_updated_warnings', 0);
  1974. $this->m_oStatLog->Set('stats_nb_obj_updated_errors', 0);
  1975. $this->m_oStatLog->Set('stats_nb_obj_unchanged_warnings', 0);
  1976. // $this->m_oStatLog->Set('stats_nb_replica_reconciled', 0);
  1977. $this->m_oStatLog->Set('stats_nb_replica_reconciled_errors', 0);
  1978. $this->m_oStatLog->Set('stats_nb_replica_disappeared_no_action', 0);
  1979. $this->m_oStatLog->Set('stats_nb_obj_new_updated', 0);
  1980. $this->m_oStatLog->Set('stats_nb_obj_new_updated_warnings', 0);
  1981. $this->m_oStatLog->Set('stats_nb_obj_new_unchanged',0);
  1982. $this->m_oStatLog->Set('stats_nb_obj_new_unchanged_warnings',0);
  1983. $sSelectTotal = "SELECT SynchroReplica WHERE sync_source_id = :source_id";
  1984. $oSetTotal = new DBObjectSet(DBObjectSearch::FromOQL($sSelectTotal), array() /* order by*/, array('source_id' => $this->m_oDataSource->GetKey()));
  1985. $this->m_iCountAllReplicas = $oSetTotal->Count();
  1986. $this->m_oStatLog->Set('stats_nb_replica_total', $this->m_iCountAllReplicas);
  1987. $this->m_oStatLog->DBInsertTracked($this->m_oChange);
  1988. }
  1989. /**
  1990. * Prevent against the reentrance... or allow the current task to do things forbidden by the others !
  1991. */
  1992. public static $m_oCurrentTask = null;
  1993. public static function GetCurrentTaskId()
  1994. {
  1995. if (is_object(self::$m_oCurrentTask))
  1996. {
  1997. return self::$m_oCurrentTask->GetKey();
  1998. }
  1999. else
  2000. {
  2001. return null;
  2002. }
  2003. }
  2004. /**
  2005. * Prepare structures in memory, to speedup the processing of a given replica
  2006. */
  2007. public function PrepareProcessing($bFirstPass = true)
  2008. {
  2009. if ($this->m_oDataSource->Get('status') == 'obsolete')
  2010. {
  2011. throw new SynchroExceptionNotStarted(Dict::S('Core:SyncDataSourceObsolete'));
  2012. }
  2013. if (!UserRights::IsAdministrator() && $this->m_oDataSource->Get('user_id') != UserRights::GetUserId())
  2014. {
  2015. throw new SynchroExceptionNotStarted(Dict::S('Core:SyncDataSourceAccessRestriction'));
  2016. }
  2017. // Get the list of SQL columns
  2018. $sClass = $this->m_oDataSource->GetTargetClass();
  2019. $aAttCodesExpected = array();
  2020. $aAttCodesToReconcile = array();
  2021. $aAttCodesToUpdate = array();
  2022. $sSelectAtt = "SELECT SynchroAttribute WHERE sync_source_id = :source_id AND (update = 1 OR reconcile = 1)";
  2023. $oSetAtt = new DBObjectSet(DBObjectSearch::FromOQL($sSelectAtt), array() /* order by*/, array('source_id' => $this->m_oDataSource->GetKey()) /* aArgs */);
  2024. while ($oSyncAtt = $oSetAtt->Fetch())
  2025. {
  2026. if ($oSyncAtt->Get('update'))
  2027. {
  2028. $aAttCodesToUpdate[$oSyncAtt->Get('attcode')] = $oSyncAtt;
  2029. }
  2030. if ($oSyncAtt->Get('reconcile'))
  2031. {
  2032. $aAttCodesToReconcile[$oSyncAtt->Get('attcode')] = $oSyncAtt;
  2033. }
  2034. $aAttCodesExpected[$oSyncAtt->Get('attcode')] = $oSyncAtt;
  2035. }
  2036. $aColumns = $this->m_oDataSource->GetSQLColumns(array_keys($aAttCodesExpected));
  2037. $aExtDataFields = array_keys($aColumns);
  2038. $aExtDataFields[] = 'primary_key';
  2039. $this->m_aExtDataSpec = array(
  2040. 'table' => $this->m_oDataSource->GetDataTable(),
  2041. 'join_key' => 'id',
  2042. 'fields' => $aExtDataFields
  2043. );
  2044. // Get the list of attributes, determine reconciliation keys and update targets
  2045. //
  2046. if ($this->m_oDataSource->Get('reconciliation_policy') == 'use_attributes')
  2047. {
  2048. $this->m_aReconciliationKeys = $aAttCodesToReconcile;
  2049. }
  2050. elseif ($this->m_oDataSource->Get('reconciliation_policy') == 'use_primary_key')
  2051. {
  2052. // Override the settings made at the attribute level !
  2053. $this->m_aReconciliationKeys = array("primary_key" => null);
  2054. }
  2055. if ($bFirstPass)
  2056. {
  2057. $this->m_oStatLog->AddTrace("Update of: {".implode(', ', array_keys($aAttCodesToUpdate))."}");
  2058. $this->m_oStatLog->AddTrace("Reconciliation on: {".implode(', ', array_keys($this->m_aReconciliationKeys))."}");
  2059. }
  2060. if (count($aAttCodesToUpdate) == 0)
  2061. {
  2062. $this->m_oStatLog->AddTrace("No attribute to update");
  2063. throw new SynchroExceptionNotStarted('There is no attribute to update');
  2064. }
  2065. if (count($this->m_aReconciliationKeys) == 0)
  2066. {
  2067. $this->m_oStatLog->AddTrace("No attribute for reconciliation");
  2068. throw new SynchroExceptionNotStarted('No attribute for reconciliation');
  2069. }
  2070. $this->m_aAttributes = array();
  2071. foreach($aAttCodesToUpdate as $sAttCode => $oSyncAtt)
  2072. {
  2073. $oAttDef = MetaModel::GetAttributeDef($this->m_oDataSource->GetTargetClass(), $sAttCode);
  2074. if ($oAttDef->IsWritable())
  2075. {
  2076. $this->m_aAttributes[$sAttCode] = $oSyncAtt;
  2077. }
  2078. }
  2079. // Compute and keep track of the limit date taken into account for obsoleting replicas
  2080. //
  2081. if ($this->m_oLastFullLoadStartDate == null)
  2082. {
  2083. // No previous import known, use the full_load_periodicity value... and the current date
  2084. $this->m_oLastFullLoadStartDate = new DateTime(); // Now
  2085. $iLoadPeriodicity = $this->m_oDataSource->Get('full_load_periodicity'); // Duration in seconds
  2086. if ($iLoadPeriodicity > 0)
  2087. {
  2088. $sInterval = "-$iLoadPeriodicity seconds";
  2089. $this->m_oLastFullLoadStartDate->Modify($sInterval);
  2090. }
  2091. else
  2092. {
  2093. $this->m_oLastFullLoadStartDate = new DateTime('1970-01-01');
  2094. }
  2095. }
  2096. if ($bFirstPass)
  2097. {
  2098. $this->m_oStatLog->AddTrace("Limit Date: ".$this->m_oLastFullLoadStartDate->Format('Y-m-d H:i:s'));
  2099. }
  2100. }
  2101. /**
  2102. * Perform a synchronization between the data stored in the replicas (&synchro_data_xxx_xx table)
  2103. * and the iTop objects. If the lastFullLoadStartDate is NOT specified then the full_load_periodicity
  2104. * is used to determine which records are obsolete.
  2105. * @return void
  2106. */
  2107. public function Process()
  2108. {
  2109. $this->PrepareLogs();
  2110. self::$m_oCurrentTask = $this->m_oDataSource;
  2111. try
  2112. {
  2113. $this->DoSynchronize();
  2114. $this->m_oStatLog->Set('end_date', time());
  2115. $this->m_oStatLog->Set('status', 'completed');
  2116. $this->m_oStatLog->DBUpdateTracked($this->m_oChange);
  2117. $iErrors = $this->m_oStatLog->GetErrorCount();
  2118. if ($iErrors > 0)
  2119. {
  2120. $sIssuesOQL = "SELECT SynchroReplica WHERE sync_source_id=".$this->m_oDataSource->GetKey()." AND status_last_error!=''";
  2121. $sAbsoluteUrl = utils::GetAbsoluteUrlAppRoot();
  2122. $sIssuesURL = "{$sAbsoluteUrl}synchro/replica.php?operation=oql&datasource=".$this->m_oDataSource->GetKey()."&oql=".urlencode($sIssuesOQL);
  2123. $sSeeIssues = "<p></p>";
  2124. $sStatistics = "<h1>Statistics</h1>\n";
  2125. $sStatistics .= "<ul>\n";
  2126. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('start_date').": ".$this->m_oStatLog->Get('start_date')."</li>\n";
  2127. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('end_date').": ".$this->m_oStatLog->Get('end_date')."</li>\n";
  2128. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_replica_seen').": ".$this->m_oStatLog->Get('stats_nb_replica_seen')."</li>\n";
  2129. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_replica_total').": ".$this->m_oStatLog->Get('stats_nb_replica_total')."</li>\n";
  2130. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_deleted').": ".$this->m_oStatLog->Get('stats_nb_obj_deleted')."</li>\n";
  2131. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_deleted_errors').": ".$this->m_oStatLog->Get('stats_nb_obj_deleted_errors')."</li>\n";
  2132. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_obsoleted').": ".$this->m_oStatLog->Get('stats_nb_obj_obsoleted')."</li>\n";
  2133. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_obsoleted_errors').": ".$this->m_oStatLog->Get('stats_nb_obj_obsoleted_errors')."</li>\n";
  2134. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_created').": ".$this->m_oStatLog->Get('stats_nb_obj_created')." (".$this->m_oStatLog->Get('stats_nb_obj_created_warnings')." warnings)"."</li>\n";
  2135. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_created_errors').": ".$this->m_oStatLog->Get('stats_nb_obj_created_errors')."</li>\n";
  2136. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_updated').": ".$this->m_oStatLog->Get('stats_nb_obj_updated')." (".$this->m_oStatLog->Get('stats_nb_obj_updated_warnings')." warnings)"."</li>\n";
  2137. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_updated_errors').": ".$this->m_oStatLog->Get('stats_nb_obj_updated_errors')."</li>\n";
  2138. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_replica_reconciled_errors').": ".$this->m_oStatLog->Get('stats_nb_replica_reconciled_errors')."</li>\n";
  2139. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_replica_disappeared_no_action').": ".$this->m_oStatLog->Get('stats_nb_replica_disappeared_no_action')."</li>\n";
  2140. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_new_updated').": ".$this->m_oStatLog->Get('stats_nb_obj_new_updated')." (".$this->m_oStatLog->Get('stats_nb_obj_new_updated_warnings')." warnings)"."</li>\n";
  2141. $sStatistics .= "<li>".$this->m_oStatLog->GetLabel('stats_nb_obj_new_unchanged').": ".$this->m_oStatLog->Get('stats_nb_obj_new_unchanged')." (".$this->m_oStatLog->Get('stats_nb_obj_new_unchanged_warnings')." warnings)"."</li>\n";
  2142. $sStatistics .= "</ul>\n";
  2143. $this->m_oDataSource->SendNotification("errors ($iErrors)", "<p>The synchronization has been executed, $iErrors errors have been encountered. Click <a href=\"$sIssuesURL\">here</a> to see the records being currently in error.</p>".$sStatistics);
  2144. }
  2145. else
  2146. {
  2147. //$this->m_oDataSource->SendNotification('success', '<p>The synchronization has been successfully executed.</p>');
  2148. }
  2149. }
  2150. catch (SynchroExceptionNotStarted $e)
  2151. {
  2152. // Set information for reporting... but delete the object in DB
  2153. $this->m_oStatLog->Set('end_date', time());
  2154. $this->m_oStatLog->Set('status', 'error');
  2155. $this->m_oStatLog->Set('last_error', $e->getMessage());
  2156. $this->m_oStatLog->DBDeleteTracked($this->m_oChange);
  2157. $this->m_oDataSource->SendNotification('fatal error', '<p>The synchronization could not start: \''.$e->getMessage().'\'</p><p>Please check its configuration</p>');
  2158. }
  2159. catch (Exception $e)
  2160. {
  2161. $this->m_oStatLog->Set('end_date', time());
  2162. $this->m_oStatLog->Set('status', 'error');
  2163. $this->m_oStatLog->Set('last_error', $e->getMessage());
  2164. $this->m_oStatLog->DBUpdateTracked($this->m_oChange);
  2165. $this->m_oDataSource->SendNotification('exception', '<p>The synchronization has been interrupted: \''.$e->getMessage().'\'</p><p>Please contact the application support team</p>');
  2166. }
  2167. self::$m_oCurrentTask = null;
  2168. return $this->m_oStatLog;
  2169. }
  2170. /**
  2171. * Do the entire synchronization job
  2172. */
  2173. protected function DoSynchronize()
  2174. {
  2175. $this->m_oStatLog->Set('status_curr_job', 1);
  2176. $this->m_oStatLog->Set('status_curr_pos', -1);
  2177. $iMaxChunkSize = utils::ReadParam('max_chunk_size', 0, true /* allow CLI */);
  2178. if ($iMaxChunkSize > 0)
  2179. {
  2180. // Split the execution into several processes
  2181. // Each process will call DoSynchronizeChunk()
  2182. // The loop will end when a process does not reply "continue" on the last line of its output
  2183. if (!utils::IsModeCLI())
  2184. {
  2185. throw new SynchroExceptionNotStarted(Dict::S('Core:SyncSplitModeCLIOnly'));
  2186. }
  2187. $aArguments = array();
  2188. $aArguments['source'] = $this->m_oDataSource->GetKey();
  2189. $aArguments['log'] = $this->m_oStatLog->GetKey();
  2190. $aArguments['change'] = $this->m_oChange->GetKey();
  2191. $aArguments['chunk'] = $iMaxChunkSize;
  2192. if ($this->m_oLastFullLoadStartDate)
  2193. {
  2194. $aArguments['last_full_load'] = $this->m_oLastFullLoadStartDate->Format('Y-m-d H:i:s');
  2195. }
  2196. else
  2197. {
  2198. $aArguments['last_full_load'] = '';
  2199. }
  2200. $this->m_oStatLog->DBUpdate($this->m_oChange);
  2201. $iStepCount = 0;
  2202. do
  2203. {
  2204. $aArguments['step_count'] = $iStepCount;
  2205. $iStepCount++;
  2206. list ($iRes, $aOut) = utils::ExecITopScript('synchro/priv_sync_chunk.php', $aArguments);
  2207. // Reload the log that has been modified by the processes
  2208. $this->m_oStatLog->Reload();
  2209. $sLastRes = strtolower(trim(end($aOut)));
  2210. switch($sLastRes)
  2211. {
  2212. case 'continue':
  2213. $bContinue = true;
  2214. break;
  2215. case 'finished':
  2216. $bContinue = false;
  2217. break;
  2218. default:
  2219. $this->m_oStatLog->AddTrace("The script did not reply with the expected keywords:");
  2220. $aIndentedOut = array();
  2221. foreach ($aOut as $sOut)
  2222. {
  2223. $aIndentedOut[] = "-> $sOut";
  2224. $this->m_oStatLog->AddTrace(">>> $sOut");
  2225. }
  2226. throw new Exception("Encountered an error in an underspinned process:\n".implode("\n", $aIndentedOut));
  2227. }
  2228. }
  2229. while ($bContinue);
  2230. }
  2231. else
  2232. {
  2233. $this->PrepareProcessing(/* first pass */);
  2234. $this->DoJob1();
  2235. $this->DoJob2();
  2236. $this->DoJob3();
  2237. }
  2238. }
  2239. /**
  2240. * Do the synchronization job, limited to some amount of work
  2241. * This verb has been designed to be called from within a separate process
  2242. * @return true if the process has to be continued
  2243. */
  2244. public function DoSynchronizeChunk($oLog, $oChange, $iMaxChunkSize)
  2245. {
  2246. // Initialize the structures...
  2247. self::$m_oCurrentTask = $this->m_oDataSource;
  2248. $this->m_oStatLog = $oLog;
  2249. $this->m_oChange = $oChange;
  2250. // Prepare internal structures (not the first pass)
  2251. $this->PrepareProcessing(false);
  2252. $iCurrJob = $this->m_oStatLog->Get('status_curr_job');
  2253. $iCurrPos = $this->m_oStatLog->Get('status_curr_pos');
  2254. $this->m_oStatLog->AddTrace("Synchronizing chunk - curr_job:$iCurrJob, curr_pos:$iCurrPos, max_chunk_size:$iMaxChunkSize");
  2255. $bContinue = false;
  2256. switch ($iCurrJob)
  2257. {
  2258. case 1:
  2259. default:
  2260. $this->DoJob1($iMaxChunkSize, $iCurrPos);
  2261. $bContinue = true;
  2262. break;
  2263. case 2:
  2264. $this->DoJob2($iMaxChunkSize, $iCurrPos);
  2265. $bContinue = true;
  2266. break;
  2267. case 3:
  2268. $bContinue = $this->DoJob3($iMaxChunkSize, $iCurrPos);
  2269. break;
  2270. }
  2271. $this->m_oStatLog->DBUpdate($this->m_oChange);
  2272. self::$m_oCurrentTask = null;
  2273. return $bContinue;
  2274. }
  2275. /**
  2276. * Do the synchronization job #1: Obsolete replica "untouched" for some time
  2277. * @param integer $iMaxReplica Limit the number of replicas to process
  2278. * @param integer $iCurrPos Current position where to resume the processing
  2279. * @return true if the process must be continued
  2280. */
  2281. protected function DoJob1($iMaxReplica = null, $iCurrPos = -1)
  2282. {
  2283. $sLimitDate = $this->m_oLastFullLoadStartDate->Format('Y-m-d H:i:s');
  2284. // Get all the replicas that were not seen in the last import and mark them as obsolete
  2285. $sDeletePolicy = $this->m_oDataSource->Get('delete_policy');
  2286. if ($sDeletePolicy != 'ignore')
  2287. {
  2288. $sSelectToObsolete = "SELECT SynchroReplica WHERE id > :curr_pos AND sync_source_id = :source_id AND status IN ('new', 'synchronized', 'modified', 'orphan') AND status_last_seen < :last_import";
  2289. $oSetScope = new DBObjectSet(DBObjectSearch::FromOQL($sSelectToObsolete), array() /* order by*/, array('source_id' => $this->m_oDataSource->GetKey(), 'last_import' => $sLimitDate, 'curr_pos' => $iCurrPos));
  2290. $iCountScope = $oSetScope->Count();
  2291. if (($this->m_iCountAllReplicas > 10) && ($this->m_iCountAllReplicas == $iCountScope))
  2292. {
  2293. throw new SynchroExceptionNotStarted(Dict::S('Core:SyncTooManyMissingReplicas'));
  2294. }
  2295. if ($iMaxReplica)
  2296. {
  2297. // Consider a given subset, starting from replica iCurrPos, limited to the count of iMaxReplica
  2298. // The replica have to be ordered by id
  2299. $oSetToProcess = new DBObjectSet(DBObjectSearch::FromOQL($sSelectToObsolete), array('id'=>true) /* order by*/, array('source_id' => $this->m_oDataSource->GetKey(), 'last_import' => $sLimitDate, 'curr_pos' => $iCurrPos));
  2300. $oSetToProcess->SetLimit($iMaxReplica);
  2301. }
  2302. else
  2303. {
  2304. $oSetToProcess = $oSetScope;
  2305. }
  2306. $iLastReplicaProcessed = -1;
  2307. while($oReplica = $oSetToProcess->Fetch())
  2308. {
  2309. $iLastReplicaProcessed = $oReplica->GetKey();
  2310. switch ($sDeletePolicy)
  2311. {
  2312. case 'update':
  2313. case 'update_then_delete':
  2314. $this->m_oStatLog->AddTrace("Destination object to be updated", $oReplica);
  2315. $aToUpdate = array();
  2316. $aToUpdateSpec = explode(';', $this->m_oDataSource->Get('delete_policy_update')); //ex: 'status:obsolete;description:stopped',
  2317. foreach($aToUpdateSpec as $sUpdateSpec)
  2318. {
  2319. $aUpdateSpec = explode(':', $sUpdateSpec);
  2320. if (count($aUpdateSpec) == 2)
  2321. {
  2322. $sAttCode = $aUpdateSpec[0];
  2323. $sValue = $aUpdateSpec[1];
  2324. $aToUpdate[$sAttCode] = $sValue;
  2325. }
  2326. }
  2327. $oReplica->Set('status_last_error', '');
  2328. if ($oReplica->Get('dest_id') == '')
  2329. {
  2330. $oReplica->Set('status', 'obsolete');
  2331. $this->m_oStatLog->Inc('stats_nb_replica_disappeared_no_action');
  2332. }
  2333. else
  2334. {
  2335. $oReplica->UpdateDestObject($aToUpdate, $this->m_oChange, $this->m_oStatLog);
  2336. if ($oReplica->Get('status_last_error') == '')
  2337. {
  2338. // Change the status of the replica IIF
  2339. $oReplica->Set('status', 'obsolete');
  2340. }
  2341. }
  2342. $oReplica->DBUpdateTracked($this->m_oChange);
  2343. break;
  2344. case 'delete':
  2345. default:
  2346. $this->m_oStatLog->AddTrace("Destination object to be DELETED", $oReplica);
  2347. $oReplica->DeleteDestObject($this->m_oChange, $this->m_oStatLog);
  2348. }
  2349. }
  2350. if ($iMaxReplica)
  2351. {
  2352. if ($iMaxReplica < $iCountScope)
  2353. {
  2354. // Continue with this job!
  2355. $this->m_oStatLog->Set('status_curr_pos', $iLastReplicaProcessed);
  2356. return true;
  2357. }
  2358. }
  2359. } // if ($sDeletePolicy != 'ignore'
  2360. //Count "seen" objects
  2361. $sSelectSeen = "SELECT SynchroReplica WHERE sync_source_id = :source_id AND status IN ('new', 'synchronized', 'modified', 'orphan') AND status_last_seen >= :last_import";
  2362. $oSetSeen = new DBObjectSet(DBObjectSearch::FromOQL($sSelectSeen), array() /* order by*/, array('source_id' => $this->m_oDataSource->GetKey(), 'last_import' => $sLimitDate));
  2363. $this->m_oStatLog->Set('stats_nb_replica_seen', $oSetSeen->Count());
  2364. // Job complete!
  2365. $this->m_oStatLog->Set('status_curr_job', 2);
  2366. $this->m_oStatLog->Set('status_curr_pos', -1);
  2367. return false;
  2368. }
  2369. /**
  2370. * Do the synchronization job #2: Create and modify object for new/modified replicas
  2371. * @param integer $iMaxReplica Limit the number of replicas to process
  2372. * @param integer $iCurrPos Current position where to resume the processing
  2373. * @return true if the process must be continued
  2374. */
  2375. protected function DoJob2($iMaxReplica = null, $iCurrPos = -1)
  2376. {
  2377. $sLimitDate = $this->m_oLastFullLoadStartDate->Format('Y-m-d H:i:s');
  2378. // Get all the replicas that are 'new' or modified or synchronized with a warning
  2379. //
  2380. $sSelectToSync = "SELECT SynchroReplica WHERE id > :curr_pos AND (status = 'new' OR status = 'modified' OR (status = 'synchronized' AND status_last_warning != '')) AND sync_source_id = :source_id AND status_last_seen >= :last_import";
  2381. $oSetScope = new DBObjectSet(DBObjectSearch::FromOQL($sSelectToSync), array() /* order by*/, array('source_id' => $this->m_oDataSource->GetKey(), 'last_import' => $sLimitDate, 'curr_pos' => $iCurrPos), $this->m_aExtDataSpec);
  2382. $iCountScope = $oSetScope->Count();
  2383. if ($iMaxReplica)
  2384. {
  2385. // Consider a given subset, starting from replica iCurrPos, limited to the count of iMaxReplica
  2386. // The replica have to be ordered by id
  2387. $oSetToProcess = new DBObjectSet(DBObjectSearch::FromOQL($sSelectToSync), array('id'=>true) /* order by*/, array('source_id' => $this->m_oDataSource->GetKey(), 'last_import' => $sLimitDate, 'curr_pos' => $iCurrPos), $this->m_aExtDataSpec);
  2388. $oSetToProcess->SetLimit($iMaxReplica);
  2389. }
  2390. else
  2391. {
  2392. $oSetToProcess = $oSetScope;
  2393. }
  2394. $iLastReplicaProcessed = -1;
  2395. while($oReplica = $oSetToProcess->Fetch())
  2396. {
  2397. $iLastReplicaProcessed = $oReplica->GetKey();
  2398. $oReplica->Synchro($this->m_oDataSource, $this->m_aReconciliationKeys, $this->m_aAttributes, $this->m_oChange, $this->m_oStatLog);
  2399. $oReplica->DBUpdateTracked($this->m_oChange);
  2400. }
  2401. if ($iMaxReplica)
  2402. {
  2403. if ($iMaxReplica < $iCountScope)
  2404. {
  2405. // Continue with this job!
  2406. $this->m_oStatLog->Set('status_curr_pos', $iLastReplicaProcessed);
  2407. return true;
  2408. }
  2409. }
  2410. // Job complete!
  2411. $this->m_oStatLog->Set('status_curr_job', 3);
  2412. $this->m_oStatLog->Set('status_curr_pos', -1);
  2413. return false;
  2414. }
  2415. /**
  2416. * Do the synchronization job #3: Delete replica depending on the obsolescence scheme
  2417. * @param integer $iMaxReplica Limit the number of replicas to process
  2418. * @param integer $iCurrPos Current position where to resume the processing
  2419. * @return true if the process must be continued
  2420. */
  2421. protected function DoJob3($iMaxReplica = null, $iCurrPos = -1)
  2422. {
  2423. $sDeletePolicy = $this->m_oDataSource->Get('delete_policy');
  2424. if ($sDeletePolicy != 'update_then_delete')
  2425. {
  2426. // Job complete!
  2427. $this->m_oStatLog->Set('status_curr_job', 0);
  2428. $this->m_oStatLog->Set('status_curr_pos', -1);
  2429. return false;
  2430. }
  2431. $bFirstPass = ($iCurrPos == -1);
  2432. // Get all the replicas that are to be deleted
  2433. //
  2434. $oDeletionDate = $this->m_oLastFullLoadStartDate;
  2435. $iDeleteRetention = $this->m_oDataSource->Get('delete_policy_retention'); // Duration in seconds
  2436. if ($iDeleteRetention > 0)
  2437. {
  2438. $sInterval = "-$iDeleteRetention seconds";
  2439. $oDeletionDate->Modify($sInterval);
  2440. }
  2441. $sDeletionDate = $oDeletionDate->Format('Y-m-d H:i:s');
  2442. if ($bFirstPass)
  2443. {
  2444. $this->m_oStatLog->AddTrace("Deletion date: $sDeletionDate");
  2445. }
  2446. $sSelectToDelete = "SELECT SynchroReplica WHERE id > :curr_pos AND sync_source_id = :source_id AND status IN ('obsolete') AND status_last_seen < :last_import";
  2447. $oSetScope = new DBObjectSet(DBObjectSearch::FromOQL($sSelectToDelete), array() /* order by*/, array('source_id' => $this->m_oDataSource->GetKey(), 'last_import' => $sDeletionDate, 'curr_pos' => $iCurrPos));
  2448. $iCountScope = $oSetScope->Count();
  2449. if ($iMaxReplica)
  2450. {
  2451. // Consider a given subset, starting from replica iCurrPos, limited to the count of iMaxReplica
  2452. // The replica have to be ordered by id
  2453. $oSetToProcess = new DBObjectSet(DBObjectSearch::FromOQL($sSelectToDelete), array('id'=>true) /* order by*/, array('source_id' => $this->m_oDataSource->GetKey(), 'last_import' => $sDeletionDate, 'curr_pos' => $iCurrPos));
  2454. $oSetToProcess->SetLimit($iMaxReplica);
  2455. }
  2456. else
  2457. {
  2458. $oSetToProcess = $oSetScope;
  2459. }
  2460. $iLastReplicaProcessed = -1;
  2461. while($oReplica = $oSetToProcess->Fetch())
  2462. {
  2463. $iLastReplicaProcessed = $oReplica->GetKey();
  2464. $this->m_oStatLog->AddTrace("Destination object to be DELETED", $oReplica);
  2465. $oReplica->DeleteDestObject($this->m_oChange, $this->m_oStatLog);
  2466. }
  2467. if ($iMaxReplica)
  2468. {
  2469. if ($iMaxReplica < $iCountScope)
  2470. {
  2471. // Continue with this job!
  2472. $this->m_oStatLog->Set('status_curr_pos', $iLastReplicaProcessed);
  2473. return true;
  2474. }
  2475. }
  2476. // Job complete!
  2477. $this->m_oStatLog->Set('status_curr_job', 0);
  2478. $this->m_oStatLog->Set('status_curr_pos', -1);
  2479. return false;
  2480. }
  2481. }
  2482. $oAdminMenu = new MenuGroup('AdminTools', 80 /* fRank */, 'SynchroDataSource', UR_ACTION_MODIFY, UR_ALLOWED_YES);
  2483. new OQLMenuNode('DataSources', 'SELECT SynchroDataSource', $oAdminMenu->GetIndex(), 12 /* fRank */, true, 'SynchroDataSource', UR_ACTION_MODIFY, UR_ALLOWED_YES);
  2484. // new OQLMenuNode('Replicas', 'SELECT SynchroReplica', $oAdminMenu->GetIndex(), 12 /* fRank */, true, 'SynchroReplica', UR_ACTION_MODIFY, UR_ALLOWED_YES);
  2485. // new WebPageMenuNode('Test:RunSynchro', '../synchro/synchro_exec.php', $oAdminMenu->GetIndex(), 13 /* fRank */, 'SynchroDataSource');
  2486. ?>