Método uploadFile

Propósito

Você pode usar esse método para anexar arquivos a registros.

URL de solicitação

Formato XML:
https://crm.zoho.com/crm/private/xml/Leads/uploadFile?authtoken= Auth Token & scope = crmapi & id = ID e conteúdo do registro = Fluxo de entrada de arquivo

Formato JSON:
https://crm.zoho.com/crm/private/json/Leads/uploadFile?authtoken= Auth Token & scope = crmapi & id = ID e conteúdo do registro = Fluxo de entrada de arquivo

 Solicitar Parâmetros

ParâmetroTipo de dadosDescrição
authtoken *CordaCadeia alfanumérica criptografada para autenticar suas credenciais do Zoho.
escopo*CordaEspecifique o valor como crmapi
identidade*CordaEspecifique o ID exclusivo do “registro” ou “nota” ao qual o arquivo deve ser anexado.
conteúdoFileInputStreamPassar o fluxo de entrada de arquivo do arquivo
attachmentUrlCordaAnexe um URL a um registro.

* – parâmetro obrigatório

Nota importante:

  • O tamanho total do arquivo não deve exceder 20 MB.
  • Seu programa pode solicitar até 60 chamadas uploadFile por minuto. Se o usuário da API solicitar mais de 60 chamadas, o sistema bloqueará o acesso à API por 5 minutos.
  • Se o tamanho exceder 20 MB, você receberá a seguinte mensagem de erro: ” O tamanho do arquivo não deve exceder 20 MB “. Esse limite não se aplica a URLs anexados via attachmentUrl.
  • O arquivo anexado estará disponível na seção Anexos da Página de Detalhes do Registro.
  • Os arquivos podem ser anexados aos registros em todos os módulos, exceto Relatórios, Painéis e Previsões.
  • No caso do parâmetro attachmentUrl, o conteúdo não é necessário, pois o anexo é de um URL.
    Exemplo para attachmentUrl : crm / private / xml / Leads / uploadFile? Authtoken = ***** & scope = crmpi & id = <entity_id> & attachmentUrl = <inserir_ URL>

Código Java para fazer upload de um arquivo para um registro

Você pode executar este programa em seu ambiente Java para fazer upload de um arquivo para um registro.

No programa, você precisa especificar valores para o seguinte:
  • Seu token de autenticação
  • O ID do registro
  • O URL de solicitação de uploadFile no formato mencionado acima
  • O caminho do arquivo ou seja, a localização do arquivo

import java.io. *;
import org.apache.commons.httpclient. *;
import org.apache.commons.httpclient.methods. *;
import org.apache.commons.httpclient.methods.multipart.Part;
import org.apache.commons.httpclient.methods.multipart.FilePart;
import org.apache.commons.httpclient.methods.multipart.StringPart;
import org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity;
import org.apache.commons.httpclient.methods.multipart.PartSource;
import org.apache.commons.httpclient.methods.multipart.ByteArrayPartSource;

public class UploadFile
{
public static void main (Cadeia de caracteres a [])
{
try
{
Cadeia auth_token = “USER AUTH TOKEN”;
Cadeia auth_scope = “crmapi”;
String targetURL = “https://crm.zoho.com/crm/private/xml/Leads/uploadFile”;
String recordId = “ID DO REGISTRO”;
String file = “NOME DO ARQUIVO”;
Arquivo f = novo Arquivo (arquivo);
FileInputStream fis = novo FileInputStream (f);
ByteArrayOutputStream bos = new ByteArrayOutputStream ();
int c;
while ((c = fis.read ())! = -1)
{
bos.write (c);
}
byte [] fbArray = bos.toByteArray ();
targetURL = targetURL + “? authtoken =” + auth_token + “& scope =” + auth_scope;
PartSource ps = new ByteArrayPartSource (arquivo, fbArray);
PostMethod post = new PostMethod (targetURL);
Part [] campos = {new FilePart (“content”, ps), novo StringPart (“id”, recordId),};
post.setRequestEntity (novo MultipartRequestEntity (campos, post.getParams ()));
HttpClient httpclient = new HttpClient ();
httpclient.executeMethod (post);
String postResp = post.getResponseBodyAsString ();
System.out.println (“postResp ===========>:” + postResp);
}
catch (exceção e)
{
e.printStackTrace ();
}
}
}

Resposta da Amostra

<? xml version = “1.0” encoding = “UTF-8”?>
<resposta uri = “/ crm / private / xml / Leads / uploadFile”>
<resultado>
<message> O arquivo foi anexado com sucesso </ message>
< recorddetail>
<FL val = “Id”> 335751000000578001 </ FL>
<FL val = “Hora de criação”> 2012-06-20 14:57:34 </ FL>
<FL val = “Hora de modificação”> 2012-06 -20 14:57:34 </ FL>
<FL val = “Criado por”> <! [CDATA [krrish]]> </ FL>
<FL val = “Modificado por”> <! [CDATA [krrish]] > </ FL>
</ recorddetail>
</ result>
</ response>

Limites de armazenamento de dados

O armazenamento gratuito padrão disponível no Free Edition é de 1 GB por conta do Org. Além desses 1 GB gratuitos, os seguintes são os limites de armazenamento de dados em cada edição paga, aplicável por usuário.

  • Edição Profissional – 512 MB por licença de usuário
  • Standard Edition – 512 MB por licença de usuário
  • Enterprise Edition – 1 GB por licença de usuário
  • CRM Plus – 1 GB por licença de usuário
  • Armazenamento de arquivo extra: USD 4 / Mês / 5 GB
    Para os usuários existentes, o preço revisado será aplicável a partir do próximo ciclo de faturamento.