usd 0.2.2 → 0.2.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3fcd67e1d03c8438152bd6a247c644d72b4d7300ae8e434d5e0920772df6473
-  data.tar.gz: 49289a822d2906027417ac0d56d621a1cd1b53766ff651b5069858a8bb221d6e
+  metadata.gz: f696d29388c8753c8af789acf542239241211c06846def69b792a9cc95eee735
+  data.tar.gz: 53f51965deba761faa9d759d77661599631609e2e7e4cf04d76eaa30088347a7
 SHA512:
-  metadata.gz: 4e4f7fde898d1b6477b9c08e96811b738d45e40fffffd16f3c0d474c1629d3e2a0ba4079b453623917a1d111f11b6989e83378b63e728c334936c4ecce271f5b
-  data.tar.gz: b517f049992b629a745e23c0af441814a7f45486a9a0617b6a69ae319cd6c68df9cf0561ac1033d1d4bc63e045d281836067f40e24fc6ca6c2985d9f401967e0
+  metadata.gz: 317cd855b80a7fd240cccfb94211529c7857bcd4fa0347c72b7c29a4ec10135f713e1edc45d42de469febfa4fe405ffe137db92e0a0db9b1a54ba812eb2a9848
+  data.tar.gz: 02d8a72b2f6a552cd999629409e739ae7e87eeed93b10a5e9daa16c875a51f6afcaf474811931c20d75dd07840e749b62a00ae8d8b233849d21b498451451cd5

data/README.md

@@ -21,6 +21,14 @@ yum group install "Development Tools"
 yum install ruby-devel
 ```
 
+# documentation
+
+see [https://github.com/ogaida/usd/wiki](https://github.com/ogaida/usd/wiki)
+
+## bash-completion
+
+see [https://github.com/ogaida/usd/wiki/bash-completion](https://github.com/ogaida/usd/wiki/bash-completion)
+
 # external tools
 
 If you use the `rusdc find` command with `--format mlr` option then you need `mlr`.
@@ -32,28 +40,31 @@ Place the `mlr`-binary in a path, which is in your PATH-Environment. Download-Ur
 # 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, 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.
+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> [wc]                                         # 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|id>                                     # shows one object by name or id
+rusdc get_all_attachments_of_co <co_name>                                    # get all attachments of a changeorder and save all th...
+rusdc get_attachment_of_ci <ci_name> <filename>                              # download an attachment of a CI and print it out on s...
+rusdc get_attachment_of_co <co_name> <filename>                              # download an attachment of a changeorder and print it...
+rusdc help [COMMAND]                                                         # Describe available commands or one specific command
+rusdc in_add_2_chg <changeorder> <incident>                                  # add incident to changeorder
+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_add_org <nr> <org>                                                  # add an Organisation to a ConfigurationItem
+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|wc> <key> <value>                       # updates a direct (not referenced) attribute of one o...
+rusdc update_attr_by_id <obj> <id> <key> <value>                             # updates a plain attribute of one object by id, does ...
+rusdc update_ref_attr <obj> <common_name> <key> <value>                      # updates a referenced attribute of one object.
+rusdc update_ref_attr_by_id <obj> <id> <key> <value_id>                      # updates a referenced attribute of one object_id by v...
 ```
 
 # environment-variables
@@ -81,3 +92,14 @@ then
   export usdpass
 fi
 ```
+
+# example - find records
+
+```bash
+$ rusdc find nr "name like 'foo%'" name,description --format mlr
+name  description
+foo1  foo QS
+foo2  foo TEST
+```
+
+more examples under [find examples-Wikipage](https://github.com/ogaida/usd/wiki/find-examples) or in the [change_log](https://github.com/ogaida/usd/blob/master/change_log.md)

data/bin/rusdc

@@ -89,6 +89,7 @@ class Rusdc < Thor
   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")
+    exitcode=0
     unless (fields =~ /^[\w\_,@]+$/)
       puts "fields-problem: there must be only letters, numbers, comma, the @-sign or underscore, nothing else!"
     else
@@ -96,6 +97,7 @@ class Rusdc < Thor
       mlr_array = []
       con.debug = options[:debug]
       e = con.search(object,{'fields' => fields,"wc" => wc})
+      exitcode=1  if e.count == 0
       fields_array=fields.split(/,/)
       e.each do |elem|
         # init all requested keys with empty strings, better for mlr format and needed for fields-order
@@ -105,7 +107,7 @@ class Rusdc < Thor
         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
+              elem[elem_key]=Time.at(elem[elem_key]).to_s if elem[elem_key] != "" # not empty
             end
           end
           if fields_array.include?(elem_key)
@@ -125,9 +127,11 @@ class Rusdc < Thor
       case options[:format]
       when "json"
         puts mlr
+        exit exitcode
       when "yaml"
         # keys not sorted, maybe a todo
         puts e.to_yaml
+        exit exitcode
       when "mlr"
         # hierfuer muss mlr verfuegbar sein
         file = Tempfile.new('json')
@@ -136,8 +140,10 @@ class Rusdc < Thor
         file.close
         puts `#{cmd}`
         file.unlink
+        exit exitcode
       else
         puts "das Format #{options[:format]} ist nicht hinterlegt. Es gibt nur json, yaml oder mlr."
+        exit 2
       end
     end # fields check
   end
@@ -166,7 +172,7 @@ class Rusdc < Thor
     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"]
+      attmnt = loadcon.request("/caisd-rest/attmnt/#{att["attmnt"]["@id"]}")["attmnt"]
       filename = attmnt["orig_file_name"]
       puts "save #{filename}"
       f = File.open(filename, 'w')
@@ -180,7 +186,7 @@ class Rusdc < Thor
   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|
-      attmnt = loadcon.request("/caisd-rest/attmnt/COMMON_NAME-#{att["attmnt"]["@COMMON_NAME"]}")["attmnt"]
+      attmnt = loadcon.request("/caisd-rest/attmnt/#{att["attmnt"]["@id"]}")["attmnt"]
       if attmnt["orig_file_name"] == filename
         puts loadcon.request("/caisd-rest/attmnt/#{attmnt["@id"]}/file-resource",{:unchanged => true})
       end
@@ -192,13 +198,18 @@ class Rusdc < Thor
     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"]
+      attmnt = loadcon.request("/caisd-rest/attmnt/#{att["attmnt"]["@id"]}")["attmnt"]
       if attmnt["orig_file_name"] == filename
         puts loadcon.request("/caisd-rest/attmnt/#{attmnt["@id"]}/file-resource",{:unchanged => true})
       end
     end
   end
 
+  desc "in_add_2_chg <changeorder> <incident>", "add incident to changeorder"
+  def in_add_2_chg(chg, incident)
+    invoke('update_ref_attr',['in', incident, 'change', chg])
+  end
+
   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"})
@@ -208,7 +219,7 @@ class Rusdc < Thor
   def list_attachments_of_ci(ciname)
     att_nr = loadcon.search("lrel_attachments_nr",{'fields' => "attmnt","wc" => "nr.name = '#{ciname}'"})
     att_nr.each do |att|
-      puts loadcon.request("/caisd-rest/attmnt/COMMON_NAME-#{att["attmnt"]["@COMMON_NAME"]}")["attmnt"]["orig_file_name"]
+      puts loadcon.request("/caisd-rest/attmnt/#{att["attmnt"]["@id"]}")["attmnt"]["orig_file_name"]
     end
   end
 
@@ -217,7 +228,7 @@ class Rusdc < Thor
     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|
-      puts loadcon.request("/caisd-rest/attmnt/COMMON_NAME-#{att["attmnt"]["@COMMON_NAME"]}")["attmnt"]["orig_file_name"]
+      puts loadcon.request("/caisd-rest/attmnt/#{att["attmnt"]["@id"]}")["attmnt"]["orig_file_name"]
     end
   end
 
@@ -239,6 +250,29 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => json})
   end
 
+  # $ rusdc find lrel_oenv_orgref "nr.name like 'servername1'" org
+  # [{
+  #   "org": "Orname1"
+  # }]
+
+  desc "nr_add_org <nr> <org>", "add an Organisation to a ConfigurationItem"
+  def nr_add_org(nr, org)
+    template = ERB.new <<-EOF
+      {
+        "lrel_oenv_orgref": {
+          "nr": {
+            "@id": "<%= uid_nr %>"
+          },
+          "org": {
+            "@id": "<%= uid_org %>"
+          }
+        }
+      }
+    EOF
+    json = template.result_with_hash(:uid_org => loadcon.request("/caisd-rest/org/COMMON_NAME-#{org}")["org"]["@id"], :uid_nr => loadcon.request("/caisd-rest/nr/COMMON_NAME-#{nr}")["nr"]["@id"])
+    puts loadcon.create({:type => "json", :data => json})
+  end
+
   desc "nr_changes <nr> [inactive-too]", "list all open changeorders of one CI"
   option :inactive_too, :type => :boolean, :default => false
   def nr_changes(nr)
@@ -375,7 +409,7 @@ class Rusdc < Thor
     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"
+  desc "update_ref_attr_by_id <obj> <id> <key> <value_id>", "updates a referenced attribute of one object_id by value-id"
   def update_ref_attr_by_id(obj, id, k, v)
     template = ERB.new <<-EOF
       {

data/change_log.md

@@ -1,4 +1,106 @@
-# changelog
+# rusdc changelog
+
+## 0.2.5.3
+
+- neu function : `rusdc nr_add_org <nr> <org>  # add an Organisation to a ConfigurationItem`
+
+#### fixes:
+
+- rusdc - line 110: more robust when querying date fields
+
+## 0.2.4.2
+
+the same fixes as in 0.2.4.1 for:
+
+```
+rusdc list_attachments_of_ci <ci_name>
+rusdc list_attachments_of_co <co_name>    
+```
+
+## 0.2.4.1
+
+### fixes
+
+- `rusdc get_attachment_of_ci` : attachment with spaces in path could not be downloaded
+
+## 0.2.4
+
+- find function has exitcode > 0 if no records has been found
+
+```
+$ rusdc find nr "name = 'not_here'"  || echo 'i am not here, please create me'
+[]
+i am not here, please create me
+$ rusdc find cnt "last_name = 'Gaida'"  && echo 'i am here, you may update me'
+[{
+  "@COMMON_NAME": "Gaida, Oliver "
+}]
+i am here, you may update me
+```
+
+### fixes
+
+- `rusdc get_all_attachments_of_co` : attachment with spaces in path could not be downloaded
+
+## 0.2.3
+
+- new function `in_add_2_chg` - add incident to changeorder
+
+Usage:
+
+```
+
+  rusdc in_add_2_chg <changeorder> <incident>
+```
+
+Example:
+
+```
+$ rusdc find in "change.chg_ref_num = 'CO000001'"  --format mlr
+@COMMON_NAME
+I000001
+I000002
+$ rusdc in_add_2_chg CO000001 I000003
+$ rusdc find in "change.chg_ref_num = 'CO000001'"  --format mlr
+@COMMON_NAME
+I000001
+I000002
+I000003
+```
+
+## 0.2.2
+
+- extented function `update_attr`, now you may use a where-clause instead of a `common_name` to filter the object(s) to update
+
+Example 1:
+
+update many CIs with one statement...b
+
+```bash
+$ rusdc find nr "name like 'server[12]'" name,description --format mlr
+name    description
+server1 vorher
+server2 vorher
+$ rusdc update_attr nr "name like 'server[12]'" description "new description"
+$ rusdc find nr "name like 'server[12]'" name,description --format mlr
+name    description
+server1 new description
+server2 new description
+```
+
+Example 2:
+
+update a CI which has a special attribute value:
+
+```bash
+$ rusdc find nr "serial_number = 'ABC123ABC987'" name,serial_number,warranty_end --format mlr
+name    serial_number warranty_end
+server1 ABC123ABC987  2020-11-30 00:00:00 +0100
+$ rusdc update_attr nr "serial_number = 'ABC123ABC987'" warranty_end "01.02.2022"
+$ rusdc find nr "serial_number = 'ABC123ABC987'" name,serial_number,warranty_end --format mlr
+name    serial_number warranty_end
+server1 ABC123ABC987  2022-02-01 00:00:00 +0100
+```
 
 ## 0.2.1
 

data/usd.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |spec|
   spec.name = 'usd'
-  spec.version = '0.2.2'
-  spec.date = '2019-11-26'
+  spec.version = '0.2.5.3'
+  spec.date = '2020-07-15'
   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.2.2
+  version: 0.2.5.3
 platform: ruby
 authors:
 - Oliver Gaida
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-26 00:00:00.000000000 Z
+date: 2020-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor