usd 0.2.4.1 → 1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13c57a8b5a92e0b256e188f927a641bba10a04b0a0c15d570e129922c5420f03
-  data.tar.gz: 1ba480177e62fe2641ae626806a09205a457d24bf23d10c96f491a9c804a38c6
+  metadata.gz: 34c19bfe569d436235dd61b312a9f7edcb191c3598daf05f77c94664efda6a5a
+  data.tar.gz: 1e84341f1befdb3eb2dab78e2a0516f7b21b55413e6635da588deefd889d3ce8
 SHA512:
-  metadata.gz: 3729de4008529124375de72ad3c81d0fdb4bc500c6569ed768e803759984dc6905e8c6e531a86e69960d7188639da6208fdc5da3cb48a2dfbed91a8f11f1db7e
-  data.tar.gz: 851d6e77c77eb6385bf84b50689f5975c171b8bb9642ec3b76fca8bf40719b103372570514b2d218af81d8087f9fdcc004257fcbbc7e9e62831299f146e90db4
+  metadata.gz: 80fa09424ea66980cee551c30dcdc337237c25c125ea66105a43f1672e5da297d9fc64730f4d1e2650ecf2c3692408c22566a447cd3d729a018c2f065276afff
+  data.tar.gz: 19172f70b81b7ede21f11639c6469a3f5d85137499e4611b065a3a6042529b3a1aa213d943114dc7ad86024fb2644b5557c9610b6363c6347c0e90505c845df3

data/README.md

@@ -21,6 +21,15 @@ yum group install "Development Tools"
 yum install ruby-devel
 ```
 
+# documentation
+
+- see [https://github.com/ogaida/usd/wiki](https://github.com/ogaida/usd/wiki)
+- if you are looking for dependencies in between the objects, objectnames or relational objects, then have a look at [techdocs.broadcom.com](https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/business-management/ca-service-management/14-1/reference/ca-service-desk-manager-reference-commands/objects-and-attributes.html)
+
+## 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`.
@@ -38,24 +47,25 @@ rusdc create                                                                 # p
 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 these to current folder
-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 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 or more objects.
-rusdc update_attr_by_id <obj> <id> <key> <value>                             # updates a plain attribute of one object by id, does not work
+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 value-id
+rusdc update_ref_attr_by_id <obj> <id> <key> <value_id>                      # updates a referenced attribute of one object_id by v...
 ```
 
 # environment-variables

data/bin/rusdc

@@ -107,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)
@@ -127,6 +127,7 @@ class Rusdc < Thor
       case options[:format]
       when "json"
         puts mlr
+        e
         exit exitcode
       when "yaml"
         # keys not sorted, maybe a todo
@@ -186,7 +187,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"]["@id"]}")["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
@@ -198,7 +199,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"]
       if attmnt["orig_file_name"] == filename
         puts loadcon.request("/caisd-rest/attmnt/#{attmnt["@id"]}/file-resource",{:unchanged => true})
       end
@@ -219,7 +220,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
 
@@ -228,7 +229,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
 
@@ -250,6 +251,24 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => json})
   end
 
+  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)
@@ -365,8 +384,8 @@ class Rusdc < Thor
     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)
+  desc "update_ref_attr <obj> <common_name> <key> <value> [ref_obj=nr]", "updates a referenced attribute of one object."
+  def update_ref_attr(obj, cn, k, v, ref_obj = "nr")
     template = ERB.new <<-EOF
       {
         "<%= obj %>": {
@@ -383,7 +402,15 @@ class Rusdc < Thor
         :k => k,
         :v => v
       })
-    puts loadcon.update({:type => "json", :data => json})
+    data = loadcon.update({:type => "json", :data => json})
+    if data.class == RestClient::BadRequest
+      puts "BadRequest-Response from USD-API, try to update via IDs. be aware to specify a ref_obj if it's not nr."
+      cn_id = loadcon.search(obj,{'fields' => "@id","wc" => "#{Usd::CN[obj]} = '#{cn}' and delete_flag = 0"})[0]["@id"]
+      value_id = loadcon.search(ref_obj,{'fields' => "@id","wc" => "#{Usd::CN[obj]} = '#{v}' and delete_flag = 0"})[0]["@id"]
+      invoke "update_ref_attr_by_id", [obj, cn_id, k, value_id]
+    else
+      puts data
+    end
   end
 
   desc "update_ref_attr_by_id <obj> <id> <key> <value_id>", "updates a referenced attribute of one object_id by value-id"

data/change_log.md

@@ -1,5 +1,104 @@
 # rusdc changelog
 
+## 1.0
+
+- `update_ref_attr` rusdc-function fetches the IDs to update the object by itself.
+
+## 0.3
+
+- some common_name resolution
+
+```ruby
+class Usd
+  CN={
+    "chg" => "chg_ref_num",
+    "cnt" => "combo_name",
+    "arcpur_rule" => "name",
+    "ca_tou" => "name",
+    "cost_cntr" => "name",
+    "country" => "name",
+    "dept" => "name",
+    "gl_code" => "name",
+    "job_func" => "name",
+    "loc" => "name",
+    "nr" => "name",
+    "opsys" => "name",
+    "org" => "name",
+    "tab" => "name",
+    "auto_close" => "sym",
+    "aty" => "sym",
+    "act_type_assoc" => "sym",
+    "ca_cmpny" => "sym",
+    "closure_code" => "sym",
+    "cmth" => "sym",
+    "symptom_code" => "sym",
+    "state" => "sym",
+    "crt" => "sym",
+    "ctab" => "sym",
+    "ctp" => "sym",
+    "dcon_typ" => "sym",
+    "dlgsrvr" => "sym",
+    "dmn" => "sym",
+    "doc_rep" => "sym",
+    "fmgrp" => "sym",
+    "ical_alarm" => "sym",
+    "ical_event_template" => "sym",
+    "imp" => "sym",
+    "intfc" => "sym",
+    "kwrd" => "sym",
+    "mfrmod" => "sym",
+    "mgsstat" => "sym",
+    "nrf" => "sym",
+    "options" => "sym",
+    "outage_type" => "sym",
+    "perscnt" => "sym",
+    "position" => "sym",
+    "pr_trans" => "sym",
+    "prod" => "sym",
+    "quick_tpl_types" => "sym",
+    "rc" => "sym",
+    "resocode" => "sym",
+    "resomethod" => "sym",
+    "response" => "sym",
+    "rrf" => "sym",
+    "rss" => "sym",
+    "seq" => "sym",
+    "sev" => "sym",
+    "site" => "sym",
+    "slatpl" => "sym",
+    "special_handling" => "sym",
+    "svc_contract" => "sym",
+    "typecnt" => "sym",
+    "tz" => "sym",
+    "tspan" => "sym",
+    "transition_type" => "sym",
+    "urg" => "sym",
+    "vpt" => "sym",
+    "wrkshft" => "sym",
+    "cr" => "ref_num",
+    "in" => "ref_num",
+    "pr" => "ref_num"
+  }
+end
+```
+
+## 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

data/lib/usd.rb

@@ -10,6 +10,76 @@ require 'tempfile'
 
 class Usd
 
+  CN={
+    "chg" => "chg_ref_num",
+    "cnt" => "combo_name",
+    "arcpur_rule" => "name",
+    "ca_tou" => "name",
+    "cost_cntr" => "name",
+    "country" => "name",
+    "dept" => "name",
+    "gl_code" => "name",
+    "job_func" => "name",
+    "loc" => "name",
+    "nr" => "name",
+    "opsys" => "name",
+    "org" => "name",
+    "tab" => "name",
+    "auto_close" => "sym",
+    "aty" => "sym",
+    "act_type_assoc" => "sym",
+    "ca_cmpny" => "sym",
+    "closure_code" => "sym",
+    "cmth" => "sym",
+    "symptom_code" => "sym",
+    "state" => "sym",
+    "crt" => "sym",
+    "ctab" => "sym",
+    "ctp" => "sym",
+    "dcon_typ" => "sym",
+    "dlgsrvr" => "sym",
+    "dmn" => "sym",
+    "doc_rep" => "sym",
+    "fmgrp" => "sym",
+    "ical_alarm" => "sym",
+    "ical_event_template" => "sym",
+    "imp" => "sym",
+    "intfc" => "sym",
+    "kwrd" => "sym",
+    "mfrmod" => "sym",
+    "mgsstat" => "sym",
+    "nrf" => "sym",
+    "options" => "sym",
+    "outage_type" => "sym",
+    "perscnt" => "sym",
+    "position" => "sym",
+    "pr_trans" => "sym",
+    "prod" => "sym",
+    "quick_tpl_types" => "sym",
+    "rc" => "sym",
+    "resocode" => "sym",
+    "resomethod" => "sym",
+    "response" => "sym",
+    "rrf" => "sym",
+    "rss" => "sym",
+    "seq" => "sym",
+    "sev" => "sym",
+    "site" => "sym",
+    "slatpl" => "sym",
+    "special_handling" => "sym",
+    "svc_contract" => "sym",
+    "typecnt" => "sym",
+    "tz" => "sym",
+    "tspan" => "sym",
+    "transition_type" => "sym",
+    "urg" => "sym",
+    "vpt" => "sym",
+    "wrkshft" => "sym",
+    "cr" => "ref_num",
+    "in" => "ref_num",
+    "pr" => "ref_num"
+  }
+
   RestClient.proxy = ""
 
   attr_reader :base_url, :user, :access_key, :expiration_date, :debug

data/usd.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |spec|
   spec.name = 'usd'
-  spec.version = '0.2.4.1'
-  spec.date = '2020-01-28'
+  spec.version = '1.1'
+  spec.date = '2020-08-31'
   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.4.1
+  version: '1.1'
 platform: ruby
 authors:
 - Oliver Gaida
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-28 00:00:00.000000000 Z
+date: 2020-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor