<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<div class="moz-cite-prefix">Dear all,</div>
<div class="moz-cite-prefix"><br>
</div>
<div class="moz-cite-prefix">please find attached for review the new
version of the M&C Book.</div>
<div class="moz-cite-prefix"><br>
</div>
<div class="moz-cite-prefix">Best regards,<br>
Serge<br>
</div>
<div class="moz-cite-prefix"><br>
</div>
<div class="moz-cite-prefix">Le 14/12/2023 à 14:41, Coelho, César a
écrit :<br>
</div>
<blockquote type="cite"
cite="mid:6e058c49827f433793f4af7ba2d17306@cgi.com">
<div class="moz-text-html" lang="x-western">
<div class="WordSection1">
<p class="msipheader6711822b" style="margin:0in"><span
style="font-size:8.0pt;font-family:"Arial",sans-serif;color:black">Trusted
3rd Party</span><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Hi Serge,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I agree with your assessment, option 1
seems to be the best.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Best regards,<o:p></o:p></p>
<p class="MsoNormal">César Coelho<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div
style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> MOIMS-SC
<a class="moz-txt-link-rfc2396E" href="mailto:moims-sc-bounces@mailman.ccsds.org"><moims-sc-bounces@mailman.ccsds.org></a> <b>
On Behalf Of </b>Serge Lacourte via MOIMS-SC<br>
<b>Sent:</b> Friday, December 8, 2023 5:13 PM<br>
<b>To:</b> <a class="moz-txt-link-abbreviated" href="mailto:moims-sc@mailman.ccsds.org">moims-sc@mailman.ccsds.org</a><br>
<b>Subject:</b> [Moims-sc] M&C Book revision<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div align="center">
<table class="MsoNormalTable"
style="width:100.0%;background:#F8E5E5" width="100%"
cellspacing="0" cellpadding="0" border="1">
<tbody>
<tr>
<td style="padding:.75pt .75pt .75pt .75pt">
<p class="MsoNormal"><span
style="font-size:7.5pt;font-family:"Arial",sans-serif;color:red">EXTERNAL
SENDER:
</span><span
style="font-size:7.5pt;font-family:"Arial",sans-serif;color:black">Do
not click any links or open any attachments
unless you trust the sender and know the
content is safe.</span><span
style="font-size:7.5pt;font-family:"Arial",sans-serif;color:red"><br>
EXPÉDITEUR EXTERNE: </span><span
style="font-size:7.5pt;font-family:"Arial",sans-serif;color:black">Ne
cliquez sur aucun lien et n’ouvrez aucune
pièce jointe à moins qu’ils ne proviennent
d’un expéditeur fiable, ou que vous ayez
l'assurance que le contenu provient d'une
source sûre.</span><o:p></o:p></p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p>Dear all,<o:p></o:p></p>
<p>I am about to release the new version of the M&C Book
to the working group. However I would like to get first your
opinion about an API change, which impacts several
operations.<o:p></o:p></p>
<p>With the move from COM objects to MAL v2 objects, I
initially changed the API of several operations to accept a
List<ObjectRef> parameter (instead of COM objects
identifiers). Then we agreed in WG to change this API into a
single domain and a list of keys, for a subset of those
operations, namely:<o:p></o:p></p>
<ul type="disc">
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level1 lfo3">
Parameter: getReportingConfiguration, enableReporting,
disableReporting, setReportingPeriod<o:p></o:p></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level1 lfo3">
Alert: getAlertConfiguration, enableGeneration,
disableGeneration<o:p></o:p></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l0 level1 lfo3">
Aggregation: getReportingConfiguration, enableReporting,
disableReporting, setReportingPeriod<o:p></o:p></li>
</ul>
<p>It looks now inconsistent with a few other operations,
which still use a List<ObjectRef> parameter, namely<o:p></o:p></p>
<ul type="disc">
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l5 level1 lfo6">
Parameter: getValue, setValue<o:p></o:p></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l5 level1 lfo6">
Aggregation: getValue, removeAggregation<o:p></o:p></li>
</ul>
<p>We have a choice then:<o:p></o:p></p>
<ol type="1" start="1">
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l3 level1 lfo9">
change the API of those 4 operations in the same way, to
get a more homogeneous API<o:p></o:p></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l3 level1 lfo9">
keep it as it is now<o:p></o:p></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;mso-list:l3 level1 lfo9">
revert to a "List<ObjectRef>" API for all operations<o:p></o:p></li>
</ol>
<p>My preferred choice is 1. Here is a table to explain the
alternatives and help you make your choice:<o:p></o:p></p>
<table class="MsoNormalTable" style="width:100.0%"
width="100%" cellpadding="0" border="1">
<tbody>
<tr>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">definitions:
List<ObjectRef><o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">domain: List<Identifier><br>
keys: List<Identifier><o:p></o:p></p>
</td>
</tr>
<tr>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">explicit List of ObjectRef to the
Definition objects concerned by the operation<o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">implicit List of ObjectRef to the
Definition objects concerned by the operation, built
as<br>
- single domain field shared by all ObjectRef<br>
- each key field from the input list<br>
- version field set to 0<o:p></o:p></p>
</td>
</tr>
<tr>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
</tr>
<tr>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">pros<o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">standard usage of the MAL v2
ObjectRef<o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">more user friendly? (reason for
the WG choice in the first place?)<o:p></o:p></p>
</td>
</tr>
<tr>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top"><br>
</td>
</tr>
<tr>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">cons<o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">Gives access to older versions of
a Definition object, which is a drawback if this
should never be allowed.<o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">Only the latest version of the
Definition object is accessible. Operating over an
old version is not possible.<o:p></o:p></p>
</td>
</tr>
<tr>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">cons<o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">More verbose with the possible
duplication of the domain field, and the provision
of a possibly useless version field<o:p></o:p></p>
</td>
<td style="padding:1.5pt 1.5pt 1.5pt 1.5pt" valign="top">
<p class="MsoNormal">Limits the list to Definition
objects that share the same input domain. Operating
over objects from different domains would require
multiple calls.<o:p></o:p></p>
</td>
</tr>
</tbody>
</table>
<p>Thank you for your feedback.<o:p></o:p></p>
<p>Best regards,<br>
Serge<o:p></o:p></p>
<pre>-- <o:p></o:p></pre>
<pre>Serge Lacourte<o:p></o:p></pre>
<pre>Directeur general<o:p></o:p></pre>
<pre>ScalAgent Distributed Technologies SA<o:p></o:p></pre>
<pre>tel. +33 4 76 29 79 81<o:p></o:p></pre>
<pre>mobile. +33 6 86 47 41 06<o:p></o:p></pre>
</div>
</div>
</blockquote>
<p><br>
</p>
<pre class="moz-signature" cols="72">--
Serge Lacourte
Directeur general
ScalAgent Distributed Technologies SA
tel. +33 4 76 29 79 81
mobile. +33 6 86 47 41 06</pre>
</body>
</html>