ramco 0.1.2 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd44c1cc33aeb833b2361b21eb6e2dcbdd2b852bd8c46993ef272276b0964660
-  data.tar.gz: 7d00666754d90a2b54e3c71de2c84649183b5421cea6bbd05f17c0e15ebdafc2
+  metadata.gz: d3385579b7d7b795e9d1404e6707327487cf46946d8060028afa13597854c7ba
+  data.tar.gz: 10dbbab9475a7715766a38848a0be042791126fafc1dfc1d485c4fd658340896
 SHA512:
-  metadata.gz: 4303addff9362c7b601ae3eaec6833a325728dbb1e760a8a4c1f8477caa9fbe8e6ab7507629bf59b5e5f6f7da472ece142a30a380f96e9e5f2eb8e4972d245d8
-  data.tar.gz: eb4c0537d6cb73dad7988532cd6f2a2a9878f280ffed03fd0c2f70e23ca2cd1e0dc40d3ddfc3ef75c0b7b13b5539d16ff82ec357bed7e493380dd0dcff580bc2
+  metadata.gz: 8487bbb88d0b9d02b07372381265631039d484c9640d2f758039cbd5f306719013ba89e6f3395618dd431329ac608fd3d9499ded1e1c2cafecfd319d320d2ab9
+  data.tar.gz: a820ac998c0325f3c7682cedbdd89fba630d442871bdaeadce8e1220a5d70f2b312e4a50f6f08640898b374d024de03e11e27c431b09ea9ab0d124e3b53b87f3

data/README.md

@@ -80,6 +80,55 @@ Returns the globally unique id of a contact that matches the provided cobalt_use
     * cobalt_username = User’s username
     * cobalt_password = User’s password
 
+## UpdateEntity
+
+Allows for modification of attributes of existing Entities.
+
+    ramco.update_entity({"entity" => "Contact", "guid" => "6868642f-0144-e811-9c17-00155d10120d", "attribute_values" => "FirstName=#Jane#,Birthday=1980-12-31,EmailVerified=true,NumChildren=3"})
+
+  * Post params:
+    * Entity = Type of entity being modified (ex: Contact)
+    * Guid = guid of entity being modified
+    * AttributeValues = Comma separated attribute=value pairs.
+    * StringDelimiter (optional) = User-specified delimiter used to wrap string values (default is #)
+
+### The AttributeValue parameter syntax
+
+A comma delimited list of attribute value pairs like: 
+
+    FirstName=#Joe#,Birthday=1980-12-31,EmailVerified=true,NumChildren=3
+
+Strings must be wrapped with a delimiter. The default delimiter is ‘#’ but a user-specified delimiter can be utilized by including the optional StringDelimiter param.
+
+OptionSets must be set to a numeric value valid for that optionset, or zero to clear current existing value. To determine values that are valid for an optionset, use the GetOptionSet api call.
+Note that when updating an attribute of type EntityReferene, usually only the guid needs to be specified. In cases where the EntityReference can be of more than one type (ex: OwnerId can be SystemUser or Team) the value must be type:guid (SystemUser:fb50333e-6b9f-e111-8d5d- 00155d000140).
+
+In instances where the string delimiter occurs in the string itself (ex: ‘Some#Text’), the delimiter must be Base64Encoded (ex: ‘SomeIw==Text’). Of course the option to change the delimiter using the StringDelimiter parameter exists as well.
+
+
+## CreateEntity
+
+Allows for creation of a new entity record.
+
+    ramco.create_entity({"entity" => "Contact", "attribute_values" => "FirstName=#Jane#,Birthday=1980-12-31,EmailVerified=true,NumChildren=3"})
+
+  * Post params:
+    * Entity = Type of entity being modified (ex: Contact)
+    * AttributeValues = Comma separated attribute=value pairs.
+    * StringDelimiter (optional) = User-specified delimiter used to wrap string values (default is #)
+
+### The AttributeValue parameter syntax
+
+The AttributeValue parameter for CreateEntity follows the same format as that for UpdateEntity.
+
+### PrimaryIdAttribute
+
+Every entity type has a PrimaryIdAttribute which can be determined with a GetEntityMetadata call. If a specific guid is desired for the entity being created, it can be added to the AttributeValues parameter along with the other specified values. If the PrimaryIdAttribute is not specified, one will be automatically generated.
+
+Example creating a Contact record (ContactId is PrimaryIdAttribute): 
+
+    FirstName=#John#,LastName=#Doe#,ContactId= 84a4d17f-2e48-4a4b-bb28-26f7c14fc926, Birthday=1980-12-31
+
 ## ClearCache
 
 Clears the server-side metadata cache. If an entity or attribute has been added (or removed), then clearing the cache will permit the changes to be reflected immediately. The cache will normally expire every 24 hours.

data/lib/ramco/api/entity.rb

@@ -17,6 +17,39 @@ class Ramco
         params['operation'] = "GetEntity"
         request(connection, params)
       end
+    
+      # CreateEntity
+      # Allows for creation of a new entity record.
+      #
+      # Entity = Type of entity being modified (ex: Contact)
+      # AttributeValues = Comma separated attribute=value pairs.
+      # StringDelimiter (optional) = User-specified delimiter used to wrap string values (default is #)
+      #
+      # {"entity" => "Contact", "attribute_values" => "FirstName=#Jane#,Birthday=1980-12-31,EmailVerified=true,NumChildren=3"}
+      #
+      # Returns json
+      #
+      def create_entity(params={})
+        params['operation'] = "CreateEntity"
+        request(connection, params)
+      end
+
+      # UpdateEntity
+      # Allows for modification of attributes of existing Entities.
+      #
+      # Entity = Type of entity being modified (ex: Contact)
+      # Guid = guid of entity being modified
+      # AttributeValues = Comma separated attribute=value pairs.
+      # StringDelimiter (optional) = User-specified delimiter used to wrap string values (default is #)
+      #
+      # {"entity" => "Contact", "attribute_values" => "FirstName=#Jane#,Birthday=1980-12-31,EmailVerified=true,NumChildren=3"}
+      #
+      # Returns json
+      #
+      def update_entity(params={})
+        params['operation'] = "UpdateEntity"
+        request(connection, params)
+      end
     end
   end
 end

data/lib/ramco/version.rb

@@ -1,3 +1,3 @@
 class Ramco
-  VERSION = "0.1.2"
+  VERSION = "0.2.2"
 end

data/ramco.gemspec

@@ -4,7 +4,7 @@ require "ramco/version"
 Gem::Specification.new do |spec|
   spec.name          = "ramco"
   spec.version       = Ramco::VERSION
-  spec.required_ruby_version = ">= 2.4.6"
+  spec.required_ruby_version = ">= 2.6.6"
   spec.authors       = ["Kurt Kowitz"]
   spec.email         = ["kurt@connectspaceinc.com"]
 
@@ -18,14 +18,14 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency 'faraday', '~> 0.9'
-  spec.add_dependency 'faraday_middleware', '~> 0.9'
-  spec.add_dependency 'multi_json', '~> 1.3'
-  spec.add_dependency 'typhoeus', '~> 0.7.0'
-  
+  spec.add_dependency 'faraday', ['>= 1.9', '< 2.0']
+  spec.add_dependency 'faraday_middleware', '~> 1.2'
+  spec.add_dependency 'multi_json', '~> 1.15'
+  spec.add_dependency 'typhoeus', '~> 1.4'
+
   spec.add_development_dependency "bundler"
   spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec', '~>3.0'
+  spec.add_development_dependency 'rspec', '~>3.1'
   spec.add_development_dependency 'json_pure'
   spec.add_development_dependency 'webmock'
   spec.add_development_dependency 'vcr'

data/spec/ramco/api/entity_spec.rb

@@ -13,4 +13,30 @@ describe Ramco::API::Entity do
       end
     end
   end
+  
+  describe "#update_entity" do
+    it "should update an entity" do
+      VCR.use_cassette('update entity') do
+        response = subject.update_entity({"entity" => "Contact", "guid" => "6868642f-0144-e811-9c17-00155d10120d", "attribute_values" => "FirstName=#Jane#,LastName=#Doe#"})
+        expect(response).to be_instance_of(Hash)  
+        expect(response).to have_key "ContactId"
+        expect(response["ContactId"]).to eq("6868642f-0144-e811-9c17-00155d10120d")
+        expect(response["FirstName"]).to eq("Jane")
+        expect(response["LastName"]).to eq("Doe")
+      end
+    end
+  end
+  
+  describe "#create_entity" do
+    it "should create an entity" do
+      VCR.use_cassette('create entity') do
+        response = subject.create_entity({"entity" => "Contact", "attribute_values" => "FirstName=#Jane#,LastName=#Doe#"})
+        expect(response).to be_instance_of(Hash)  
+        expect(response).to have_key "ContactId"
+        expect(response["ContactId"]).to eq("6868642f-0144-e811-9c17-00155d10120d")
+        expect(response["FirstName"]).to eq("Jane")
+        expect(response["LastName"]).to eq("Doe")
+      end
+    end
+  end
 end

metadata

@@ -1,71 +1,77 @@
 --- !ruby/object:Gem::Specification
 name: ramco
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.2
 platform: ruby
 authors:
 - Kurt Kowitz
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-04-24 00:00:00.000000000 Z
+date: 2022-02-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.9'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.9'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: faraday_middleware
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: typhoeus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.0
+        version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.0
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +106,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: json_pure
   requirement: !ruby/object:Gem::Requirement
@@ -206,7 +212,7 @@ homepage: https://github.com/message-blocks/ramco
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -214,15 +220,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.6
+      version: 2.6.6
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Access RAMCOAMS in ruby.
 test_files: