Dropbox para Salesforce: configurações avançadas de administrador

Atualizado Dec 18, 2023

Após configurar o Dropbox para Salesforce com a configuração padrão, você pode querer personalizar sua integração do Dropbox para Salesforce conforme descrito neste artigo.

Usar objetos personalizados ou objetos padrão além das configurações padrão

Siga estas instruções para usar objetos personalizados ou objetos fora daqueles inclusos na configuração padrão (Conta, Contato, Caso, Oportunidade, Lead):

Entre no site do Salesforce.
Abra o ícone de engrenagem e clique em Configuração.
Na seção Ferramentas de plataforma, clique em Código personalizado.
Clique em Páginas Visualforce.
Na lista de páginas, clique em Novo.
Defina uma Etiqueta e um Nome para sua página Visualforce.
Substitua a marcação do Visualforce por uma das opções de código abaixo. O valor de standardController precisará ser substituído pelo nome da API do objeto. Para um objeto padrão, o nome da API é o mesmo que o do objeto. A API do objeto "Contrato", por exemplo, também será "Contrato".

Dropbox para [Objeto]:

<apex:page standardController="INSERT—API—NAME—HERE" docType="html-5.0" showHeader="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false">
<Dropbox_for_SF:Dropbox />
</apex:page>

Todo o Dropbox para [Objeto]:

<apex:page standardController="INSERT—API—NAME—HERE" docType="html-5.0" showHeader="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false">
  <Dropbox_for_SF:Dropbox AllDropbox="true" />
</apex:page>

Clique em Salvar.

Caso não esteja usando o Salesforce Lightning, siga estas instruções:

Entre no site do Salesforce.
Clique em Configuração.
Em Compilação, clique em Desenvolver.
Clique em Páginas Visualforce.
Na lista de páginas, clique em Novo.
Defina uma Etiqueta e um Nome para sua página Visualforce.
Substitua a marcação do Visualforce pelo código detalhado acima. O valor de standardController precisará ser substituído pelo nome da API do objeto. Para um objeto padrão, o nome da API é o mesmo que o do objeto. A API do objeto "Contrato", por exemplo, também será "Contrato".
Clique em Salvar.

Para atualizar o layout do objeto com a página Visualforce criada anteriormente, siga as instruções abaixo:

Clique em Gerenciador de objetos.
Selecione o objeto que você quer editar.
Clique em Layouts de página.
Selecione o layout que você quer editar.
Do topo da caixa de configurações, arraste e solte uma Seção na página.
Preencha o Nome da seção e configure o layout como uma coluna.
Clique em OK.
Acesse o item Páginas Visualforce e arraste e solte a página correspondente na seção Dropbox.
Clique em Salvar.
Quando as páginas Visualforce forem adicionadas, clique no ícone da chave inglesa.
Na página Opções, configure as propriedades da página do Visualforce para 100% de largura e 400 pixels de altura, e marque a caixa de seleção Exibir barras de rolagem.

Caso não esteja usando o Salesforce Lightning, siga estas instruções específicas:

Clique em Configuração.
Na barra de pesquisa no canto superior esquerdo, procure por "ObjectManager".
Escolha o objeto que deseja editar e clique em Layouts de página no lado esquerdo.
Ao lado do layout com o qual deseja trabalhar, clique na seta do menu e selecione Editar.
Do topo da caixa de configurações, arraste e solte uma Seção na página.
Preencha o Nome da seção e configure o layout como uma coluna.
Clique em OK.
Acesse o item Páginas Visualforce e arraste e solte a página correspondente na seção Dropbox.
Clique em Salvar.
Quando as páginas Visualforce forem adicionadas, clique no ícone da chave inglesa.
Na página Opções, configure as propriedades da página do Visualforce para 100% de largura e 400 pixels de altura, e marque a caixa de seleção Exibir barras de rolagem.

Em seguida, você precisará configurar um novo gatilho de objeto para seu objeto personalizado ou objeto não padrão seguindo as instruções abaixo:

Entre no site do Salesforce.
Abra o ícone de engrenagem e clique em Configuração.
Selecione o Gerenciador de objetos em Objetos e campos.
Selecione o objeto personalizado.
Clique em Gatilhos.
Clique em Nova.
Copie o bloco de código a seguir no campo de entrada com os nomes apropriados inseridos.

Trigger <TRIGGER_NAME> on <OBJECT_API_NAME> (after update, after delete) {
    
        if(Trigger.isAfter && Trigger.isUpdate){
            Dropbox_for_SF.HandleRecordChange.OnRecordChange(Trigger.old, Trigger.new);
        }
    
        if(Trigger.isAfter && Trigger.isDelete){
            Dropbox_for_SF.HandleRecordChange.HandleMerge(Trigger.old);
        }
    
    }

Caso não esteja usando o Salesforce Lightning, siga estas instruções para configurar o gatilho de objeto personalizado:

Entre no site do Salesforce.
Clique em Configuração.
Em Compilação, clique em Criar.
Selecione Objetos.
Selecione o objeto personalizado.
Na seção Gatilhos, clique em Novo.
Copie o bloco de código acima no campo de entrada com os nomes apropriados inseridos.

Para resolver o problema de cobertura de código, siga as instruções abaixo:

Adicione o código a seguir como uma Classe Apex personalizada com o nome CustomTests no conjunto de alterações personalizado:

@isTest
public class CustomTest
{
  static testMethod void update<OBJECT_API_NAME>() {
      <OBJECT_API_NAME>  a = new <OBJECT_API_NAME> (Name='test');
      insert a;
      Test.startTest();
      a.Name = 'new test';
      update a;
      Test.stopTest();
      system.assertEquals('new test', a.name);
  }
}

Execute novamente todos os testes na seção do Desenvolvedor.

Habilitar o Dropbox para Salesforce no Salesforce1 Mobile

Para usar o Dropbox para Salesforce no Salesforce1 Mobile, você precisa adicionar um cartão móvel no layout da página.

Entre no site do Salesforce.
Abra o ícone de engrenagem e clique em Configuração.
Na seção Ferramentas de plataforma, clique em Objetos e campos.
Clique em Gerenciador de objetos.
Selecione o objeto que você quer editar.
Clique em Layouts de página.
Selecione o layout que você quer editar.
Desça até a seção Cartões móveis (apenas Salesforce1).
Na caixa de Configurações, no topo da sua tela, clique em Páginas Visualforce.
Arraste e solte Dropbox para dispositivos móveis para [Objeto] na seção Cartões móveis (apenas Salesforce1).
Clique em Salvar.

Agora você pode disponibilizar objetos personalizados para o Salesforce1 Mobile. Para tornar objetos personalizados compatíveis com o Salesforce1 mobile, primeiro é preciso habilitar esse recurso durante a configuração da página Visualforce. Siga estes passos para tornar seus objetos personalizados visíveis:

Entre no site do Salesforce.
Abra o ícone de engrenagem e clique em Configuração.
Na seção Ferramentas de plataforma, clique em Código personalizado.
Clique em Páginas Visualforce.
Clique em Nova.
Dê à sua página uma Etiqueta e um Nome.
Marque a caixa Disponível para aplicativos para dispositivos móveis Salesforce e páginas Lightning.
Copie e cole o código exibido acima dessas instruções, substituindo o trecho inserir nome de API pelo nome de API do seu objeto.
Clique em Salvar.

Caso não esteja usando o Salesforce Lightning, siga estas instruções específicas:

Entre no site do Salesforce.
Clique em Configuração.
Em Compilação, clique em Personalizar.
Escolha o objeto que deseja editar na seção Personalizar e clique em Layouts de página.
Ao lado do layout com o qual deseja trabalhar, clique em Editar.
Desça até a seção Cartões móveis (apenas Salesforce1).
Na caixa de Configurações, no topo da sua tela, clique em Páginas Visualforce.
Arraste e solte Dropbox para dispositivos móveis para [Objeto] na seção Cartões móveis (apenas Salesforce1).
Clique em Salvar.

Entre no site do Salesforce.
Clique em Configuração.
Em Compilação, clique em Desenvolver.
Clique em Páginas Visualforce.
Na lista de páginas, clique em Novo.
Defina uma Etiqueta e um Nome para sua página Visualforce.
Dê à sua página uma Etiqueta e um Nome.
Marque a caixa Disponível para aplicativos para dispositivos móveis Salesforce e páginas Lightning .
Copie e cole o código exibido abaixo, substituindo o trecho inserir nome de API, pelo nome de API do seu objeto.
Clique em Salvar.

<apex:page standardController=“INSERT—API—NAME—HERE” docType =“html-5.0” showHeader=“false” sidebar=“false” applyHtmlTag=“false” applyBodyTag="false">
<Dropbox_for_SF:DropboxMobile / >
</apex:page>

Encontrar nome da API de objeto do Salesforce

Cada objeto no Salesforce tem um nome de API. Se estiver trabalhando com objetos personalizados, você pode encontrar o nome de API seguindo estas instruções:

Entre no site do Salesforce.
Clique em Configuração.
Na seção Compilação, na coluna da esquerda, clique em Criar.
Clique em Objetos nas opções do menu suspenso.
Clique no nome do objeto.
Após clicar na etiqueta do objeto, você verá o nome da API.

Criar modelos de registro de objetos

Usando pastas modelo, o Dropbox para Salesforce pode construir uma estrutura de pastas para você. Essas pastas conectam os registros do Salesforce às pastas no seu Dropbox.

As pastas que o Dropbox para Salesforce criar estarão vazias por padrão. Caso você queira que elas contenham estruturas de subpastas próprias, você pode fazê-lo pelo recurso de modelo de pasta.

Entre no site do Salesforce.
Verifique qual endereço de e-mail está conectado ao Dropbox para Salesforce.
- Clique na guia Opções do Dropbox em sua conta Salesforce. Lá poderá visualizar o endereço de e-mail
No dropbox.com, abra a pasta Documentos Salesforce.
Clique no nome da pasta objeto com a qual deseja trabalhar.
Crie uma nova pasta com o nome "modelo".
Crie a estrutura que deseja adicionando arquivos e pastas na pasta modelo.
No Salesforce, clique na guia Opções do Dropbox.
Desça até Configurações de objetos padrão e clique em Editar.
Marque a caixa de seleção Habilitar modelo ao lado do objeto com o qual deseja trabalhar.
Clique em Salvar.

Observação:

Pastas modelo não são retroativas. Qualquer estrutura de pasta que você tenha criado antes da nova estrutura de modelo estabelecida não será afetada
Para acionar a geração do modelo em um registro, adicione um arquivo à pasta do Dropbox desse registro na pasta Documentos Salesforce em seu Dropbox
Pastas modelo funcionarão apenas para objetos que estiverem na pasta pública “Documentos Salesforce”. No momento elas não são compatíveis com objetos na pasta “Documentos privados Salesforce”
As pastas modelo não funcionam com objetos personalizados ou que tenham convenções de nomenclatura.

Seguir nomes de registro do Salesforce

Por padrão, a renomeação de um registro do Salesforce não altera o nome da pasta no Dropbox. No entanto, você pode ativar a renomeação automática. Assim, você garante que, ao renomear uma pasta no Dropbox para Salesforce, ela também seja renomeada no Dropbox.

Entre no site do Salesforce.
Clique na guia Opções do Dropbox.
Desça até Configurações de objetos padrão e clique em Editar.
Clique em Seguir nomes de registro do Salesforce ao lado dos objetos para os quais você deseja habilitar a renomeação automática.
Clique em Salvar.

Observação:

Caso você esteja em uma pasta compartilhada com a opção Renomear automaticamente, o Dropbox para Salesforce vai atualizar os registros dos nomes para todos os usuários na pasta compartilhada
Para objetos padrão, a renomeação automática pode ser configurada por padrão. Para objetos personalizados, você precisará configurar um gatilho para o objeto em questão, como mostrado na seção "Usar objetos personalizados" acima

Modificar configurações de compartilhamento

Administradores Salesforce podem configurar o Dropbox para Salesforce seguindo o modelo existente de segurança Salesforce. Por padrão, o Dropbox para Salesforce segue o modelo de segurança Salesforce.

Caso queira modificar as configurações de integração de compartilhamento, siga as instruções abaixo:

Entre no site do Salesforce.
Clique na guia Opções do Dropbox.
Desça até Configurações de objetos padrão e clique em Editar.
Marque a caixa de seleção Seguir compartilhamento Salesforce, ao lado dos objetos que gostaria de habilitar.
Clique em Salvar.

Observação:

Caso você tenha habilitado a opção Seguir Salesforce Sharing para objetos com um padrão de compartilhamento geral para empresa privada, uma pasta Documentos privados do Salesforce será criada ao adicionar arquivos ou pastas por meio do componente do Dropbox para novos registros. Essa pasta só será adicionada à conta do Dropbox do proprietário do registro
Novas configurações de segurança não são retroativas: pastas criadas antes de mudanças nas configurações de segurança não seguirão as novas configurações
As configurações de compartilhamento do Salesforce podem ser encontradas aqui: Configuração > Segurança > Configurações de compartilhamento
A pasta “Documentos Salesforce” terá de ser compartilhada com todos os usuários do Dropbox para Salesforce na equipe
Apenas usuários do Salesforce com acesso ao objeto privado do Salesforce verão o conteúdo do Dropbox por meio da integração do Dropbox para Salesforce

Restringir o acesso apenas à sua equipe

Administradores Salesforce podem gerenciar o modo como um usuário Salesforce conecta o Dropbox para Salesforce.

Entre no site do Salesforce.
Clique na guia Opções do Dropbox.
Desça até a seção Dropbox Business e clique em Restringir login a contas do Dropbox Business.
Clique em Editar.
Em Acesso ao Dropbox Business marque Apenas membros da equipe.
Clique em Salvar.

Dar acesso a usuários do Salesforce

Entre no site do Salesforce.
Abra o ícone de engrenagem e clique em Configuração.
Na seção Administração, clique em Usuários.
Clique na guia Perfis.
Clique no nome do perfil que deseja editar.
Desça até Acesso a páginas do Visualforce habilitado no final da página e clique em Editar.
Selecione todas as páginas que começam com "Dropbox_for_SF".
Clique na flecha Adicionar.
Clique em Salvar.
Na página do perfil em que está trabalhando, desça até a seção Acesso da classe Apex habilitado e clique em Editar.
Selecione todas as classes que começam com Dropbox_for_SF.
Clique na flecha Adicionar.
Clique em Salvar.

Caso não esteja usando o Salesforce Lightning, siga estas instruções específicas:

Entre no site do Salesforce.
Clique em Configuração.
Acesse a seção Administrar e clique em Gerenciar usuários.
Clique na guia Perfis.
Clique no nome do perfil que deseja editar.
Desça até Acesso a páginas do Visualforce habilitado no final da página e clique em Editar.
Selecione todas as páginas que começam com "Dropbox_for_SF".
Clique na flecha Adicionar.
Clique em Salvar.
Na página do perfil em que está trabalhando, desça até a seção Acesso da classe Apex habilitado e clique em Editar.
Selecione todas as classes que começam com wbdbox.
Clique na flecha Adicionar.
Clique em Salvar.

Fazer sua própria estrutura de nomes de pasta

O Dropbox para Salesforce pode criar uma estrutura de pasta que espelha a configuração do Salesforce no Dropbox. Porém, administradores podem alterar a estrutura padrão ou a convenção de nomes em suas pastas criadas com base em uma lógica objeto-por-objeto.

A convenção padrão de nomes para objetos de “Contato” é Nome, Sobrenome. Mas é possível alterar isso para Sobrenome, Nome. Se você fizer essa alteração, as configurações de nomes seguirão a sua preferência nos próximos registros criados.

Entre no site do Salesforce.
Abra o ícone de engrenagem e clique em Configuração.
Na seção Ferramentas de plataforma, clique em Objetos e campos.
Clique em Gerenciador de objetos.
Selecione o objeto que você quer editar.
Clique em Campos e relacionamentos.
Clique em Nova.
Em Tipo de dados selecione Fórmula.
Clique em Próximo.
Digite “Caminho personalizado do Dropbox” na caixa Etiqueta do campo.
Digite "Custom_Dropbox_Path" na caixa Nome do campo.
Selecione Texto em Tipo de fórmula de retorno e clique em Próximo.
Digite sua fórmula (por exemplo: "Contact/" & LastName & ", " & FirstName) e clique em Avançar.
Selecione a caixa Visível ao lado dos perfis aos quais gostaria de fornecer acesso de edição.
Clique em Próximo.
Clique em Salvar.

Caso não esteja usando o Salesforce Lightning, siga estas instruções específicas:

Entre no site do Salesforce.
Clique em Configuração.
Na seção Compilação, na coluna da esquerda, clique em Personalizar.
Selecione Contatos.
Clique em Campos.
Desça até a lista Campos personalizados de contatos e Lista de relacionamento e clique em Novo.
Em Tipo de dados selecione Fórmula.
Clique em Próximo.
Digite "caminho personalizado do Dropbox" na caixa Etiqueta do campo.
Digite "Custom_Dropbox_Path" na caixa Nome do campo.
Selecione Texto em Tipo de fórmula de retorno e clique em Próximo.
Digite sua fórmula e clique em Próximo.
Selecione a caixa Visível ao lado dos perfis aos quais gostaria de fornecer acesso de edição.
Clique em Próximo.
Clique em Salvar.

Observação:

Objetos com uma convenção de nomenclatura personalizada terão suas pastas de registro começando a aparecer diretamente na pasta Documentos do Salesforce. Caso queira fazer com que as pastas de registro apareçam na pasta objeto (como Contatos), como aconteceria sem o nome personalizado, você vai precisar especificar isso na fórmula adicionada. Por exemplo, "Contact/" & LastName & ", " & FirstName
Essas alterações não são retroativas. Elas se aplicam apenas às novas pastas criadas.
Você pode usar esse processo em todos os objetos padrão e personalizados, e pode adicionar outros campos, texto, números ou datas para personalizar ainda mais seus caminhos para pastas.

Adicionar o Dropbox aos Layouts do editor

Para tornar a interface do Dropbox acessível no Chatter, adicione o Dropbox como uma Ação rápida no Editor global:

Entre no site do Salesforce.
Abra o ícone de engrenagem e clique em Configuração.
Na seção Ferramentas de plataforma, clique em Interface do usuário.
Clique em Ações globais.
Clique em Layouts do editor.
Selecione o objeto que você quer editar.
Clique em Campos e relacionamentos.
Na coluna Ação, clique em Editar ao lado da entrada Layout global.
Arraste e solte o Dropbox da seção Ações rápidas até a seção Editor global.

Caso não esteja usando o Salesforce Lightning, siga estas instruções específicas:

Entre no site do Salesforce.
Clique em Configuração.
Clique em Criar.
Clique em Ações globais.
Clique em Layouts do editor.
Na coluna Ação, clique em Editar ao lado da entrada Layout global.
Arraste e solte o Dropbox da seção Ações rápidas até a seção Editor global.