Modifier to become Action-Option

From
Bret Jordan <>
Date
2017-09-06T15:17:00+00:00
ID
Thread
Modifier to become Action-Option
Yes, I fully support this change.  In addition to this we have design issue with our current structure.  Today we have:
{
  "action": {
    "type": "copy",
    "options": {}
  },
  "target": {
    "file": {
      "specifiers: {},
      "options": {}
    }
  }
}
This represents a bad form with its design.  The action property is flat while the target is nested.  We should do one or the other. There are two real options here, and they both have the same semantic meaning.  Personally, flat designs are generally  more preferable, and they represent a good design principle (flatter is better than nested).  The advantage of nested is you can quickly make parsing decisions about which struct to unmarshal content in to based on the key name. So I can go either way, but  we should pick one style of encoding.
Option 1:
{
  "action": {
    "type": "copy",
    "options": {}
  },
  "target": {
    "type" : "file",
    "specifiers: {},
    "options": {}
  }
}
Option 2:
{
  "action": {
    "copy": {
      "options": {}
    }
  },
  "target": {
    "file": {
      "specifiers: {},
      "options": {}
    }
  }
}
Bret
From:   <> on behalf of  <>
Sent:  Monday, September 4, 2017 3:18:37 PM
To:  TC OpenC2
Subject:  [EXT] [openc2] Modifier to become Action-Option

An issue was discussed and resolved at the last Language Subcommittee  that the Modifier field move under Action and be action-option. Since  this is a relatively major change, it is being communicated to the the  TC mailing list.
A wiki page was created for this issue at
https://clicktime.symantec.com/a/1/4ZB73huEVk4m4G4BVhqWi7fMUB0u1Oc_vLzhEIH4Qr8=?d=lgF3yCMdJLpr2hoS6bxs4YL-vUnzWGbkKQEzB2bgA_H5mbF_oFvunb9iw0XNrDodmItASA4L3KRPul2fmVkB74LP2gBcgZRiTA4mpq_PESfctOcLwm9LDtlauaaYY8oL3vVIq3fkEqEs9IYXuI3tFnAmdE2M8qSUgk5a3ZY6P4zZJej-ZSP8VamePJyrY9yJkSEuJTr63eRaeHzIBx0R4N1GA8Zy9QY2RVWdF2bXWm3QmJz94qdql27QkX09F7SPJn-2l61rhwh8RdeWnYTR5iZx41tT1YrBTn7kimp3M41Jl7vRgzyGo3hqh45e9QwK36pQTtzJY91NCdq7FP-zA0gUPhKwcRmJdjoWXk8ojA8lGd0iM3dMW1N0xOPUvADrwK6dz7f7rW4SZSu6gKs9DBKMCAyvr4kpjShh0BEi-OB7almext8XHOClGRH7-_aFMqz7rslqaa_zi9YJxajl56ANUeRrw1cO0ipBXM4kYOk%3D&u=https%3A%2F%2Fwiki.oasis-open.org%2Fopenc2%2FModifierOnAction
but the content will  be repeated here:
"The language specification previously defined the openc2 command as  having 4 components:
+ action (mandatory)
+ target (mandatory)
+ actuator (optional)
+ modifier (optional)

At the 29-Aug-2017 Language Subcommittee meeting, Allan Thomson of  Looking Glass raised the issue of whether 'modifier' belonged as a peer  to action or as part of action. Targets have target-specifiers and  target-options and the issue was whether modifier was really an  action-option. Bret Jordan of Symantec supported this view with the  argument it would be easier for vendors to adopt openc2 since it would  be easier to understand. The issue was raised by DuncanSparrell  (speaking as sFractal Consulting and software developer of ocas, not as  co-chair) that this was a significant change to something that has been  stable for 2 years and that any software already written would have to  be changed. It was observed that the purpose of the SC was to get input  and that changes were to be expected.
The argument that it would increase vendor adoption was significant as  everyone agreed that increased vendor adoption would be beneficial.  Consensus was reached that modifier would move to action-option. The  changes to the Language Specification that result from this will be  reviewed at the next meeting."
Duncan Sparrell  sFractal Consulting LLC  iPhone, iTypo, iApologize

---------------------------------------------------------------------

To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://clicktime.symantec.com/a/1/Km-wOTq-1nndQkBooSUDh3NIDtFY7FPX5qgQs5818tI=?d=lgF3yCMdJLpr2hoS6bxs4YL-vUnzWGbkKQEzB2bgA_H5mbF_oFvunb9iw0XNrDodmItASA4L3KRPul2fmVkB74LP2gBcgZRiTA4mpq_PESfctOcLwm9LDtlauaaYY8oL3vVIq3fkEqEs9IYXuI3tFnAmdE2M8qSUgk5a3ZY6P4zZJej-ZSP8VamePJyrY9yJkSEuJTr63eRaeHzIBx0R4N1GA8Zy9QY2RVWdF2bXWm3QmJz94qdql27QkX09F7SPJn-2l61rhwh8RdeWnYTR5iZx41tT1YrBTn7kimp3M41Jl7vRgzyGo3hqh45e9QwK36pQTtzJY91NCdq7FP-zA0gUPhKwcRmJdjoWXk8ojA8lGd0iM3dMW1N0xOPUvADrwK6dz7f7rW4SZSu6gKs9DBKMCAyvr4kpjShh0BEi-OB7almext8XHOClGRH7-_aFMqz7rslqaa_zi9YJxajl56ANUeRrw1cO0ipBXM4kYOk%3D&u=https%3A%2F%2Fwww.oasis-open.org%2Fapps%2Forg%2Fworkgroup%2Fportal%2Fmy_workgroups.php