attask 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 88ed344df13fb30c56ff6c2a2b08f087451e2655
-  data.tar.gz: 19e3128dcfd64a64e8dc15fc6d24ecfe9f90917b
+  metadata.gz: 9e3a1d68670cb5fd2f28639ab038293367eaed6a
+  data.tar.gz: a509263ae912cd9d9f438690926c0ba37f37ffab
 SHA512:
-  metadata.gz: aa7d63596bb8e7810d30ba6937841994a80fa7e074ca98692ba2984057f61d4edac4ecfc5888736b639ed28ea8a7bda569ffad953ac09ab526fcb7b2e85126f9
-  data.tar.gz: ad277c829fed7b1731aee522b6191b79a6e4a5c1b929ae4ba945bfaf6ffbfa2c6f55e2e8a24bc1246b48bd34a49ae392ab6a90228df3b5fdd1a992912c59b842
+  metadata.gz: 288900f25fad2c60ab3fc48e6adc52c18da16738b0eb8c4f1563a690ba5bdd5a5f4616456921ef97024cae4988af3d6cadc42879a065d12d343003950700f2b1
+  data.tar.gz: 44911bb28f9f867c30e75960853d5f5ac99f158fdae1533505ceae2bb1a4ac9e950a89bfd5a3c8435ce000eccaab2d639ce9826221e5d1568fde74da8bafa5ca

data/README.md

@@ -0,0 +1,83 @@
+# Attask
+
+A classe Attask::Client é a interface HTTP da Attask onde é possível fazer as requisições encontradas na [https://developers.workfront.com/api-docs/#Actions](documentação).
+
+## Como usar
+
+Configure os dados de acesso
+
+```ruby
+# Exemplo:
+Attask.configure do |config|
+  config.username = ENV['ATTASK_USERNAME']
+  config.password = ENV['ATTASK_PASSWORD']
+end
+```
+
+### Queries
+
+**Queries aceitas:** `eq`, `ne`, `gte`, `lte`, `isnull`, `notnull` e `contains`.
+
+Exemplo de uma query usando between:
+
+```ruby
+require_relative 'lib/attask/client.rb'
+
+# Setando o objeto que quero` buscar
+object = 'TASK'
+
+# Montando a query
+query = {
+  'plannedCompletionDate'       => '$$TODAY-7',
+  'plannedCompletionDate_Range' => '$$TODAY',
+  'plannedCompletionDate_Mod'   => 'between'
+}
+
+client = Attask::Client.new({ timeout: 120 })
+client.search(object, query)
+```
+
+### Fields
+
+Para cada Objeto, existem uma quantidade de campos (`fields`) que você pode obter a partir dele em seu retorno. Para saber os campos que cada objeto, entre neste [https://developers.workfront.com/api-docs/api-explorer/](link). Lembrando que atualmente utilizamos a versão 6.0 da API da attask.
+
+Exemplo utilizando o objeto `DOCU`, solicitando o campo `downloadURL`:
+
+```ruby
+require_relative 'lib/attask/client.rb'
+# Setando o objeto que quero buscar
+object = 'DOCU'
+
+# definindo os campos que eu quero que retorne
+fields = ['downloadURL']
+
+client = Attask::Client.new({ timeout: 120 })
+client.search(object, { '$$LIMIT' => 2000 }, fields)
+```
+
+## Upload de arquivos
+
+```ruby
+require_relative 'lib/attask/client.rb'
+client = Attask::Client.new
+
+filename = 'teste.txt'
+description = 'descricao'
+object_code = 'TASK'
+object_id = '586ab38f001b36bfbb586053760aec3d'
+
+# Crie um handle
+handle = client.handle("./#{filename}", 'text/plain')
+
+# Com o handle em mãos, faca a requisição para envio de um documento
+
+params = {
+  description: description,
+  docObjCode: object_code,
+  objID: object_id,
+  handle: handle,
+  name: filename
+}.to_json
+
+client.upload(params)
+```

data/lib/attask/client.rb

@@ -4,10 +4,10 @@
 module Attask
   # lib/attask/client.rb
   class Client
-    ENDPOINT = 'https://fcbbrasil.attask-ondemand.com/attask/api/v6.0'
-
-    def initialize(opts = {})
+    def initialize(app, opts = {})
+      @app = app
       @opts = opts
+      @endpoint = "https://#{app}.attask-ondemand.com/attask/api/v6.0"
       @session_id = session_id
     end
 
@@ -60,10 +60,19 @@ module Attask
       request(:post, path)
     end
 
+    def download(download_url, filename, save_to)
+      params = @session_id
+      s_id = @session_id['sessionID']
+      path =
+        "https://#{@app}.attask-ondemand.com/#{download_url}&sessionID=#{s_id}"
+      response = request(:get, path)
+      save_file(filename, response)
+    end
+
     private
 
     def mount_path(object_code, object_id = '')
-      "#{ENDPOINT}/#{object_code}#{object_id}"
+      "#{@endpoint}/#{object_code}#{object_id}"
     end
 
     def session_id
@@ -83,6 +92,10 @@ module Attask
       end
     end
 
+    def save_file(filename, file)
+      File.open(filename, 'wb') { |f| f.write(file) }
+    end
+
     def request(method, path, params = {}, headers = {})
       Request.new(path, @opts).send(method, '', params, headers).body
     end

data/lib/attask/request.rb

@@ -35,11 +35,9 @@ module Attask
 
     def make_request(method, path, params = {}, headers = {})
       response = @conn.send(method, path, params, headers)
-      if response.headers['Content-Type'].match?(%r{^application/json})
-        Response.new(Oj.load(response.body))
-      else
-        Response.new(response.body)
-      end
+      body = response.body
+      return Response.new(body) if response.headers['Content-Type'].nil?
+      Response.new(Oj.load(body))
     end
   end
 end

data/lib/attask/version.rb

@@ -3,5 +3,5 @@
 
 module Attask
   # The current Attask version.
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: attask
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Paulo Henrique Bruce