usd 0.1.5 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eeb6a5b08aafdc142ff2fa07c8dcf1859ca4993a2e2749c44aec12bc4bd2488a
-  data.tar.gz: 4d9a1b2f4dd5364b344f2e80f2e0e886698105734121a466e378a7710631f96e
+  metadata.gz: d3fcd67e1d03c8438152bd6a247c644d72b4d7300ae8e434d5e0920772df6473
+  data.tar.gz: 49289a822d2906027417ac0d56d621a1cd1b53766ff651b5069858a8bb221d6e
 SHA512:
-  metadata.gz: a9f89726f11a5c925b63e21ed7a6ce9c7acbd3d7af152a1d80aae41afb1ceaa0cde4cee27ee0ccc50ebc7b787152a515b06157fbbe73f4536218759d5d47fb90
-  data.tar.gz: 6cd80c617bb13cdf72e7720811f83632eaa4865c33181e43ea764a68a7a84b3ad3dc158d04de870b75a97d397010846248eb8bc962ef006acf8c11fc1dd4b83a
+  metadata.gz: 4e4f7fde898d1b6477b9c08e96811b738d45e40fffffd16f3c0d474c1629d3e2a0ba4079b453623917a1d111f11b6989e83378b63e728c334936c4ecce271f5b
+  data.tar.gz: b517f049992b629a745e23c0af441814a7f45486a9a0617b6a69ae319cd6c68df9cf0561ac1033d1d4bc63e045d281836067f40e24fc6ca6c2985d9f401967e0

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2019 Oliver Gaida
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -8,7 +8,7 @@ There is a ruby class and a commandline tool rusdc.
 just install the gem:
 
 ```bash
-sudo gem install usd
+gem install usd
 ```
 
 Be aware that you need some compiler-tools and the ruby headers:
@@ -27,34 +27,35 @@ If you use the `rusdc find` command with `--format mlr` option then you need `ml
 
 - [mlr - Miller](http://johnkerl.org/miller/doc/index.html) - a great tool for data-transforming to and from json, csv and many more
 
-Place the `mlr`-binary in a path, which is in your PATH-Environment.
+Place the `mlr`-binary in a path, which is in your PATH-Environment. Download-Url for mlr-releases: [https://github.com/johnkerl/miller/releases](https://github.com/johnkerl/miller/releases)
 
 # functions from the commandline-tool `rusdc`
 
 ```
 rusdc
 Commands:
-  rusdc chg_add_nr              # <CO> <CI> - add a CI to a changeorder
-  rusdc chg_list_nr             # <CO> - list all CIs of one changeorder
-  rusdc create                  # pipe json-data to create object
-  rusdc field_names             # <object-type> list all fields of an object including its format
-  rusdc find                    # <object-type> <where-clause> [fields - Komma getrennt (id,name)] - finds each object which meets the wc-condition
-  rusdc get                     # <object-type> <common_name> shows one object
-  rusdc get_attachment_of_ci    # <ci_name> <filename>, download an attachment of a CI and print it out on stdout
-  rusdc get_attachment_of_co    # <co_name> <filename>, download an attachment of a changeorder and print it out on stdout
-  rusdc help [COMMAND]          # Describe available commands or one specific command
-  rusdc list_attachments_of_ci  # <ci_name>, list all attachments of a CI
-  rusdc list_attachments_of_co  # <co_name>, list all attachments of a changeorder
-  rusdc nr_add_child            # <nr-name> <child-name>, add one child CI to another CI
-  rusdc nr_changes              # <nr> [inactive-too] - list all open changeorders of one CI
-  rusdc nr_childs               # <ci-name> , lists all childs CIs of a specific CI
-  rusdc nr_incidents            # <nr> [inactive-too] - lists all incident of a specific CI
-  rusdc nr_parents              # nr_parents <ci-name> , lists all parent CIs of a specific CI
-  rusdc update                  # pipe json-data to update object
+  rusdc chg_add_nr <co> <ci>                                                   # add a CI to a changeorder
+  rusdc chg_list_nr <co>                                                       # list all CIs of one changeorder
+  rusdc create                                                                 # pipe json-data to create object
+  rusdc field_names <object-type>                                              # list all fields of an object including its format
+  rusdc find <object-type> [where-clause] [fields, comma separated] [options]  # finds each object which meets the wc-condition
+  rusdc get <object-type> <common_name>                                        # shows one object
+  rusdc get_attachment_of_ci <ci_name> <filename>                              # download an attachment of a CI and print it out on stdout
+  rusdc get_attachment_of_co <co_name> <filename>                              # download an attachment of a changeorder and print it out on stdout
+  rusdc help [COMMAND]                                                         # Describe available commands or one specific command
+  rusdc in_list_child_ins <in>                                                 # list all child-incidents of one incident
+  rusdc list_attachments_of_ci <ci_name>                                       # list all attachments of a CI
+  rusdc list_attachments_of_co <co_name>                                       # list all attachments of a changeorder
+  rusdc nr_add_child <nr-name> <child-name>                                    # add one child CI to another CI
+  rusdc nr_changes <nr> [inactive-too]                                         # list all open changeorders of one CI
+  rusdc nr_childs <ci-name>                                                    # lists all childs CIs of a specific CI
+  rusdc nr_incidents <nr> [inactive-too]                                       # lists all incident of a specific CI
+  rusdc nr_parents <ci-name>                                                   # lists all parent CIs of a specific CI
+  rusdc update                                                                 # pipe json-data to update object
+  rusdc update_attr <obj> <common_name> <key> <value>                          # updates a direct (not referenced) attribute of one object.
+  rusdc update_ref_attr <obj> <common_name> <key> <value>                      # updates a referenced attribute of one object.
 ```
 
-the german text will be translated soon.
-
 # environment-variables
 
 rusdc needs some environment-variables. there are:

data/bin/rusdc

@@ -7,7 +7,7 @@ require "usd"
 
 class Rusdc < Thor
 
-  desc "chg_add_nr", "<CO> <CI> - add a CI to a changeorder"
+  desc "chg_add_nr <co> <ci>", "add a CI to a changeorder"
   def chg_add_nr(co, ci)
     template = ERB.new <<-EOF
       {
@@ -25,9 +25,9 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => json})
   end
 
-  desc "chg_list_nr", "<CO> - list all CIs of one changeorder"
+  desc "chg_list_nr <co>", "list all CIs of one changeorder"
   def chg_list_nr(co)
-    invoke 'find', ['lrel_asset_chgnr', %(chg.chg_ref_num = '#{co}'), "nr"], {:format => "mlr", :mlr_format => "xtab"}
+    invoke 'find', ['lrel_asset_chgnr', %(chg.chg_ref_num = '#{co}'), "nr"], {:format => "mlr"}
   end
 
   desc "create", "pipe json-data to create object"
@@ -35,64 +35,79 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => STDIN.read})
   end
 
-  desc "field_names","<object-type> list all fields of an object including its format"
-  def field_names(object)
-    e = loadcon.search(object,{'fields' => "*","start" => "1", "size" => "1"})[0]
+  desc "field_names <object-type> [wc]","list all fields of an object including its format"
+  def field_names(object,wc="")
+    e = loadcon.search(object,{'fields' => "*","wc"=>wc,"start" => "1", "size" => "1"})[0]
     e.keys.sort.each do |k|
-      puts "#{k} (#{e[k].class})"
       if e[k].class  == Hash
+        puts "#{k} (#{e[k].class}):"
         puts e[k].jp
+      else
+        puts "#{k} (#{e[k].class}) : #{e[k]}"
       end
     end
   end
 
-  desc "find", "<object-type> <where-clause> [fields - Komma getrennt (id,name)] - finds each object which meets the wc-condition"
+  desc "find <object-type> [where-clause] [fields, comma separated] [options]", "finds each object which meets the wc-condition"
   long_desc <<-LONGDESC
 
 
-    Mit --mlr_format kann man das output-Format von Miller (mlr) ändern auf csv, md (markdown), xtab (sehr übersichtlich), dkvp (Delimited key-value pairs) ..., siehe `mlr --help`
+    with --mlr_format you may change the output-format of Miller (mlr) to csv, md (markdown), xtab , dkvp (delimited key-value pairs) ..., refer `mlr --help`
+
+    Examples:
 
-    Beispiele:
+    - all grc objects (! don't use this kind of query for objecttype like nr, in, chg etc., whose number of objects is too big)
+    rusdc find grc
 
-    - alle aktiven CIs die mit sygosrv beginnen und die Zahl 58 enthalten:
-    ./rusdc find nr "name like 'servername' and delete_flag.sym = 'Active' " "id,name" --format mlr
+    - all aktive ci which start with the string `servername`, only print the fields @id and name:
+    rusdc find nr "name like 'servername%' and delete_flag.sym = 'Active' " "@id,name" --format mlr
 
-    - meine aktiven Incidents:
-    ./rusdc find --format mlr in "assignee.last_name = 'gaida' and status.sym in ('Service pending','Work in progress.','Customer Pending','Open','Hold','Resolved')" ref_num,z_project,summary,status,call_back_date,affected_resource,orig_user_organization
+    - my active incidents with most importent fields:
+    rusdc find --format mlr in "assignee.last_name = 'gaida' and status.sym in ('Service pending','Work in progress.','Customer Pending','Open','Hold','Resolved')" ref_num,z_project,summary,status,call_back_date,affected_resource,orig_user_organization
 
-    - Activity-Log eines Incidents:
-    ./rusdc find alg "call_req_id.ref_num = 'I00001'" "call_req_id,action_desc,analyst,description,time_stamp,type" --format mlr --mlr_format xtab
+    - activity-Log of an incident in xtab format:
+    rusdc find alg "call_req_id.ref_num = 'I00001'" "call_req_id,action_desc,analyst,description,time_stamp,type" --format mlr --mlr_format xtab
 
-    - nur die Beschreibungen Activity-Log eines Incidents:
-    ./rusdc find alg "call_req_id.ref_num = 'I00001'" "description" --format mlr --mlr_format csv
+    - the same but only the field description in csv-format:
+    rusdc find alg "call_req_id.ref_num = 'I00001'" "description" --format mlr --mlr_format csv
 
-    - Incidents einer Maschine
-    ./rusdc find in "affected_resource.name = 'servername'" "ref_num,summary" --format mlr
+    - incidents of the ci with the name `servername`
+    rusdc find in "affected_resource.name = 'servername'" "ref_num,summary" --format mlr
 
-    - Kombiniert, alle Activity-Log-Beschreibungen aller Incidents einer Maschine:
-    ./rusdc find alg "call_req_id.affected_resource.name = 'servername'" "description" --format mlr
+    - combination of all activity-log-description of all incidents of a specific ci in pprint-Miller-format:
+    rusdc find alg "call_req_id.affected_resource.name = 'servername'" "description" --format mlr
 
-    - Changes einer Maschine:
+    - changeorders of a secific ci:
     rusdc find chg "asset.nr.name = 'servername'" "@COMMON_NAME,summary,status" --format mlr
 
-    - Alle Maschinen finden die mit goes beginnen und deren childs auf Linux und Windows prüfen:
+    - find all active ci whose name start with dc and check if they have children like Windows or Linux server:
     for ci in $(rusdc find nr "name like 'dc%' and delete_flag.sym = 'active'" "name" --format mlr | sed '1 d'); do rusdc nr_childs $ci > help ; echo "$ci: $(grep -iP '^(Linux|.*MS windows).*server' help)" ; done
 
   LONGDESC
-  option :format, :type => :string, :default => "json"
-  option :mlr_format, :type => :string, :default => "pprint"
-  option :nice_time, :type => :boolean, :default => true
-  option :debug, :type => :boolean, :default => false
-  def find(object, wc, fields="*")
+  option :format, :type => :string, :default => "json", :banner => "[json|yaml|mlr]"
+  option :mlr_format, :type => :string, :default => "pprint",:banner => "[pprint|json|md|csv|xtab]"
+  option :nice_time, :type => :boolean, :default => true,:banner => "[true|false]"
+  option :debug, :type => :boolean, :default => false,:banner => "[true|false]"
+  def find(object, wc="", fields="@COMMON_NAME")
     unless (fields =~ /^[\w\_,@]+$/)
-      puts "fields-problem: there must be only letters, numbers, comma and underscore, nothing else!"
+      puts "fields-problem: there must be only letters, numbers, comma, the @-sign or underscore, nothing else!"
     else
       con = loadcon
+      mlr_array = []
       con.debug = options[:debug]
       e = con.search(object,{'fields' => fields,"wc" => wc})
       fields_array=fields.split(/,/)
       e.each do |elem|
+        # init all requested keys with empty strings, better for mlr format and needed for fields-order
+        fields_array.each do |elem_key|
+            elem[elem_key]="" unless elem.has_key?(elem_key)
+        end
         elem.keys.each do |elem_key|
+          if options[:nice_time]
+            if elem_key =~ /(date|last_mod|warranty_start|warranty_end|time_stamp)$/
+              elem[elem_key]=Time.at(elem[elem_key]).to_s
+            end
+          end
           if fields_array.include?(elem_key)
             if elem[elem_key].class == Hash
               elem_value = elem[elem_key]["@COMMON_NAME"]
@@ -103,32 +118,21 @@ class Rusdc < Thor
             elem.delete(elem_key)
           end
         end
-        # fill up not found keys
-        fields_array.each do |elem_key|
-          unless elem.has_key?(elem_key)
-            elem[elem_key]=""
-          end
-        end
-      end
-      if options[:nice_time]
-        e.each_index do |i|
-          e[i].keys.each do |key|
-            if key =~ /(date|last_mod|warranty_start|warranty_end|time_stamp)$/
-              e[i][key]=Time.at(e[i][key]).to_s
-            end
-          end
-        end
+        # sort the keys
+        mlr_array << Hash[fields_array.map {|k| [k, elem[k]]}].jp
       end
+      mlr = "[" + mlr_array.join(",") + "]"
       case options[:format]
       when "json"
-        puts e.jp
+        puts mlr
       when "yaml"
+        # keys not sorted, maybe a todo
         puts e.to_yaml
       when "mlr"
         # hierfuer muss mlr verfuegbar sein
         file = Tempfile.new('json')
         cmd = %(mlr --ijson --o#{options[:mlr_format]} cat #{file.path})
-        file.write(e.jp)
+        file.write(mlr)
         file.close
         puts `#{cmd}`
         file.unlink
@@ -138,10 +142,15 @@ class Rusdc < Thor
     end # fields check
   end
 
-  desc "get", "<object-type> <common_name> shows one object"
+  desc "get <object-type> <common_name|id>", "shows one object by name or id"
+  option :by_id, :type => :boolean, :default => false
   option :yaml, :type => :boolean, :default => false
-  def get(object, cn)
-    e = loadcon.request("/caisd-rest/#{object}/COMMON_NAME-#{cn}")
+  def get(object, ident)
+    if options[:by_id] || ident =~ /^U'[0-9A-F]/i
+      e = loadcon.request("/caisd-rest/#{object}/#{ident}")
+    else
+      e = loadcon.request("/caisd-rest/#{object}/COMMON_NAME-#{ident}")
+    end
     if e.class == Hash
       puts options[:yaml] ?  e[object].to_yaml : e[object].jp
     elsif e.message == "409 Conflict"
@@ -151,7 +160,23 @@ class Rusdc < Thor
     end
   end
 
-  desc "get_attachment_of_ci", "<ci_name> <filename>, download an attachment of a CI and print it out on stdout"
+  desc "get_all_attachments_of_co <co_name>", "get all attachments of a changeorder and save all these to current folder"
+  def get_all_attachments_of_co(coname)
+    # todo : care more about eml-multipart: https://github.com/mikel/mail
+    chg_id=loadcon.request("/caisd-rest/chg/COMMON_NAME-#{coname}")["chg"]["@id"]
+    att_nr = loadcon.search("lrel_attachments_changes",{'fields' => "attmnt","wc" => "chg = #{chg_id}"})
+    att_nr.each do |att|
+      attmnt = loadcon.request("/caisd-rest/attmnt/COMMON_NAME-#{att["attmnt"]["@COMMON_NAME"]}")["attmnt"]
+      filename = attmnt["orig_file_name"]
+      puts "save #{filename}"
+      f = File.open(filename, 'w')
+      f.write(loadcon.request("/caisd-rest/attmnt/#{attmnt["@id"]}/file-resource",{:unchanged => true}))
+      f.close
+    end
+    puts "all attachments were saved"
+  end
+
+  desc "get_attachment_of_ci <ci_name> <filename>", "download an attachment of a CI and print it out on stdout"
   def get_attachment_of_ci(ciname, filename)
     att_nr = loadcon.search("lrel_attachments_nr",{'fields' => "attmnt","wc" => "nr.name = '#{ciname}'"})
     att_nr.each do |att|
@@ -162,7 +187,7 @@ class Rusdc < Thor
     end
   end
 
-  desc "get_attachment_of_co", "<co_name> <filename>, download an attachment of a changeorder and print it out on stdout"
+  desc "get_attachment_of_co <co_name> <filename>", "download an attachment of a changeorder and print it out on stdout"
   def get_attachment_of_co(coname, filename)
     chg_id=loadcon.request("/caisd-rest/chg/COMMON_NAME-#{coname}")["chg"]["@id"]
     att_nr = loadcon.search("lrel_attachments_changes",{'fields' => "attmnt","wc" => "chg = #{chg_id}"})
@@ -174,7 +199,12 @@ class Rusdc < Thor
     end
   end
 
-  desc "list_attachments_of_ci", "<ci_name>, list all attachments of a CI"
+  desc "in_list_child_ins <in>", "list all child-incidents of one incident"
+  def in_list_child_ins(incident)
+    invoke('find',['cr', "parent.ref_num = '#{incident}'", "ref_num"], {:format => "mlr"})
+  end
+
+  desc "list_attachments_of_ci <ci_name>", "list all attachments of a CI"
   def list_attachments_of_ci(ciname)
     att_nr = loadcon.search("lrel_attachments_nr",{'fields' => "attmnt","wc" => "nr.name = '#{ciname}'"})
     att_nr.each do |att|
@@ -182,7 +212,7 @@ class Rusdc < Thor
     end
   end
 
-  desc "list_attachments_of_co", "<co_name>, list all attachments of a changeorder"
+  desc "list_attachments_of_co <co_name>", "list all attachments of a changeorder"
   def list_attachments_of_co(coname)
     chg_id=loadcon.request("/caisd-rest/chg/COMMON_NAME-#{coname}")["chg"]["@id"]
     att_nr = loadcon.search("lrel_attachments_changes",{'fields' => "attmnt","wc" => "chg = #{chg_id}"})
@@ -191,7 +221,7 @@ class Rusdc < Thor
     end
   end
 
-  desc "nr_add_child", "<nr-name> <child-name>, add one child CI to another CI"
+  desc "nr_add_child <nr-name> <child-name>", "add one child CI to another CI"
   def nr_add_child(nr, child)
     template = ERB.new <<-EOF
       {
@@ -209,7 +239,7 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => json})
   end
 
-  desc "nr_changes", "<nr> [inactive-too] - list all open changeorders of one CI"
+  desc "nr_changes <nr> [inactive-too]", "list all open changeorders of one CI"
   option :inactive_too, :type => :boolean, :default => false
   def nr_changes(nr)
     wc_add = (options[:inactive_too] ? "" : " and status.sym in ('Service pending','Work in progress','Customer Pending','Open','Hold')")
@@ -217,20 +247,20 @@ class Rusdc < Thor
     invoke 'find', ['chg', wc, 'chg_ref_num,summary,status'], {:format => "mlr"}
   end
 
-  desc "nr_childs", "<ci-name> , lists all childs CIs of a specific CI"
+  desc "nr_childs <ci-name>", "lists all childs CIs of a specific CI"
   def nr_childs(name)
     loadcon.search("hier",{'fields' => "*","wc" => "parent.name = '#{name}'"}).each do |c|
       puts c["child"]["@COMMON_NAME"]
     end
   end
 
-  desc "nr_incidents", "<nr> [inactive-too] -  lists all incident of a specific CI"
+  desc "nr_incidents <nr> [inactive-too]", "lists all incident of a specific CI"
   option :inactive_too, :type => :boolean, :default => false
   def nr_incidents(nr)
     invoke 'find', ['in', %(affected_resource.name = '#{nr}'#{options[:inactive_too] ? "" : " and not status.sym in ('Cancelled','Closed')"}), "ref_num,summary,status"], {:format => "mlr"}
   end
 
-  desc "nr_parents", "nr_parents <ci-name> , lists all parent CIs of a specific CI"
+  desc "nr_parents <ci-name>", "lists all parent CIs of a specific CI"
   def nr_parents(name)
     loadcon.search("hier",{'fields' => "*","wc" => "child.name = '#{name}'"}).each do |c|
       puts c["parent"]["@COMMON_NAME"]
@@ -250,6 +280,122 @@ class Rusdc < Thor
     puts loadcon.update({:type => "json", :data => STDIN.read})
   end
 
+  desc "update_attr <obj> <common_name|wc> <key> <value>", "updates a direct (not referenced) attribute of one or more objects."
+  option :plain_text, :type => :boolean, :default => false
+  def update_attr(obj, cn, k, v)
+    if k =~ /(date|last_mod|warranty_start|warranty_end|time_stamp)$/
+      v=Time.parse(v).to_i
+    end
+    if cn =~ /([<>=]| like )/
+      obj_arr=loadcon.search(obj,{'fields' => "@id","wc"=>"#{cn} and delete_flag.sym = 'Active'"})
+      obj_arr.each do |inner_obj|
+        inner_id=inner_obj["@id"]
+        template = ERB.new <<-EOF
+          {
+            "<%= obj %>": {
+              "@id": "<%= id %>",
+              "<%= k %>": "<%= v %>"
+            }
+          }
+        EOF
+        json = template.result_with_hash({
+            :obj => obj,
+            :id => inner_id,
+            :k => k,
+            :v => v
+          })
+        puts loadcon.update({:type => "json", :data => json})
+      end
+    else
+      if options[:plain_text]
+        data={
+          obj => {
+            "@COMMON_NAME" => cn,
+            k => v
+          }
+        }
+        json = JSON.pretty_generate(data)
+      else
+        template = ERB.new <<-EOF
+          {
+            "<%= obj %>": {
+              "@COMMON_NAME": "<%= cn %>",
+              "<%= k %>": "<%= v %>"
+            }
+          }
+        EOF
+        json = template.result_with_hash({
+          :obj => obj,
+          :cn => cn,
+          :k => k,
+          :v => v
+        })
+      end
+      puts loadcon.update({:type => "json", :data => json})
+    end
+  end
+
+  desc "update_attr_by_id <obj> <id> <key> <value>", "updates a plain attribute of one object by id, does not work"
+  def update_attr_by_id(obj, id, k, v)
+    template = ERB.new <<-EOF
+      {
+        "<%= obj %>": {
+          "@id": "<%= id %>",
+          "<%= k %>": "<%= v %>"
+        }
+      }
+    EOF
+    json = template.result_with_hash({
+        :obj => obj,
+        :id => id,
+        :k => k,
+        :v => v
+      })
+    puts loadcon.update({:type => "json", :data => json})
+  end
+
+  desc "update_ref_attr <obj> <common_name> <key> <value>", "updates a referenced attribute of one object."
+  def update_ref_attr(obj, cn, k, v)
+    template = ERB.new <<-EOF
+      {
+        "<%= obj %>": {
+          "@COMMON_NAME": "<%= cn %>",
+          "<%= k %>": {
+            "@COMMON_NAME": "<%= v %>"
+          }
+        }
+      }
+    EOF
+    json = template.result_with_hash({
+        :obj => obj,
+        :cn => cn,
+        :k => k,
+        :v => v
+      })
+    puts loadcon.update({:type => "json", :data => json})
+  end
+
+  desc "update_ref_attr_by_id <obj> <id> <key> <value>", "updates a referenced attribute of one object by id"
+  def update_ref_attr_by_id(obj, id, k, v)
+    template = ERB.new <<-EOF
+      {
+        "<%= obj %>": {
+          "@id": "<%= id %>",
+          "<%= k %>": {
+            "@id": "<%= v %>"
+          }
+        }
+      }
+    EOF
+    json = template.result_with_hash({
+        :obj => obj,
+        :id => id,
+        :k => k,
+        :v => v
+      })
+    puts loadcon.update({:type => "json", :data => json})
+  end
+
 
   private
 

data/change_log.md

@@ -0,0 +1,76 @@
+# changelog
+
+## 0.2.1
+
+- function `update_attr` has a new option for putting plain text with linebreaks in it.
+
+- new funciton `update_ref_attr_by_id` sometimes there are problem if you try to update via common_name, so here you can use the `@id` instead.
+
+- `rusdc get` now supports id too
+
+- rusdc field_names , now there is a second parameter [wc]. So that's a way to show all fields of a special opbject.
+
+Example:
+
+```
+rusdc field_names wf "@id = 1535123" | head -3
+@COMMON_NAME (String) :
+@REL_ATTR (String) : 1535123
+@id (String) : 1535123
+```
+
+## 0.1.9
+
+- function update_attr will parse with Time-Module if the key match the regular expression: `(date|last_mod|warranty_start|warranty_end|time_stamp)`. And then the value will be change to epoche-seconds
+
+Example:
+
+```
+rusdc update_attr chg CO000001 call_back_date "2020-01-01 11:11:11 +0100"
+```
+
+- new function in rusdc `get_all_attachments_of_co`. In the first implementation it will save all attachments with its original name in the current folder. existing files may be overwritten. Caution!
+
+## 0.1.8
+
+- new function in rusdc `update_attr`
+
+Example for `update_attr`:
+
+```bash
+> rusdc help update_attr
+Usage:
+  rusdc update_attr <obj> <common_name> <key> <value>
+
+updates a direct (not referenced) attribute of one object.
+
+> rusdc get cnt 'gaida, oliver' | grep alt_phone
+  "alt_phone": "",
+> rusdc update_attr cnt 'gaida, oliver' alt_phone "+49123456789"
+> rusdc get cnt 'gaida, oliver' | grep alt_phone
+  "alt_phone": "+49123456789",
+```
+
+- new function in rusdc `update_ref_attr`
+
+Example for `update_ref_attr`:
+
+```bash
+> rusdc help update_ref_attr
+Usage:
+  rusdc update_ref_attr <obj> <common_name> <key> <value>
+
+updates a referenced attribute of one object.
+> rusdc find chg "chg_ref_num = 'CO000001'" status --format mlr
+status
+Work in progress
+> rusdc update_ref_attr chg CO000001 status "Service pending"
+> rusdc find chg "chg_ref_num = 'CO000001'" status --format mlr
+status
+Service pending
+```
+
+## 0.1.7
+
+- fix sorting the output of `rusdc find`
+- add new rusdc function `rusdc in_list_child_ins`

data/lib/usd.rb

@@ -21,8 +21,9 @@ class Usd
     @base_url = base_url
     @user = user
     @debug = false
-    if File.exist?(".usd") and hash[:save_access_key]
-      tt = YAML.load(File.open(".usd","r"))
+    remfile = "#{ENV["HOME"]}/.usd"
+    if File.exist?(remfile) and hash[:save_access_key]
+      tt = YAML.load(File.open(remfile,"r"))
       if (tt.expiration_date - Time.now.to_i ) > 900 and tt.base_url == base_url
         @access_key = tt.access_key
         @expiration_date = tt.expiration_date
@@ -56,7 +57,7 @@ class Usd
           @access_key = authData['rest_access']['access_key']
           @expiration_date = authData['rest_access']['expiration_date']
           if hash[:save_access_key]
-            f=File.open(".usd","w")
+            f=File.open(remfile,"w")
             f.puts self.to_yaml
             f.close
           end
@@ -146,8 +147,13 @@ class Usd
     end
     puts "update - data: #{JSON.pretty_generate(data)}" if @debug
     object = data.keys[0]
-    cn = data[object]["@COMMON_NAME"]
-    request("/caisd-rest/#{object}/COMMON_NAME-#{cn}",{:method => "put", :json => data.to_json, :header => header({'X-Obj-Attrs' => 'COMMON_NAME'})})
+    if  data[object].has_key?("@id")
+      request("/caisd-rest/#{object}/#{data[object]["@id"]}",{:method => "put", :json => data.to_json, :header => header({'X-Obj-Attrs' => 'COMMON_NAME'})})
+    elsif data[object].has_key?("@COMMON_NAME")
+      request("/caisd-rest/#{object}/COMMON_NAME-#{data[object]["@COMMON_NAME"]}",{:method => "put", :json => data.to_json, :header => header({'X-Obj-Attrs' => 'COMMON_NAME'})})
+    else
+      puts "specify @COMMON_NAME or @id at least."
+    end
   end
 
   def set_url_parm(params_hash,attribute_name,default)

data/usd.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |spec|
   spec.name = 'usd'
-  spec.version = '0.1.5'
-  spec.date = '2019-10-31'
+  spec.version = '0.2.2'
+  spec.date = '2019-11-26'
   spec.summary = "SDM REST-API-Calls"
   spec.description = "a Ruby class and a commandlinetool for SDM REST-API-Calls"
   spec.authors = ["Oliver Gaida"]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: usd
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.2
 platform: ruby
 authors:
 - Oliver Gaida
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-31 00:00:00.000000000 Z
+date: 2019-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -77,9 +77,11 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE.md
 - README.md
 - bin/rusdc
 - bin/set_env
+- change_log.md
 - lib/usd.rb
 - usd.gemspec
 homepage: https://github.com/ogaida/usd