Studio
Introdução
As ferramentas do Studio permitem que você personalize as informações exibidas nos módulos e como elas são apresentadas.
Para acessar o Studio, faça login como usuário Administrador. No canto superior direito da tela, você encontrará um menu com o ícone de perfil. Clique nesse ícone e selecione "Admin". Role para baixo na página e clique em "Studio".
Ao abrir o Studio, será exibida uma lista de todos os módulos que podem ser personalizados. Clique para selecionar o módulo desejado.
Para cada módulo, há vários componentes que podem ser editados.
Labels: Visualizar/editar rótulos dos campos e o nome do módulo
Fields: Visualizar/editar propriedades dos campos e adicionar novos campos
Relationships: Visualizar/editar/adicionar relacionamentos entre módulos
Layouts: Personalizar as visualizações de edição/detalhe/lista e filtros
Subpanels: Definir quais colunas são exibidas nos subpainéis do módulo
Rótulos
Selecionando o componente Labels, será listados todos os rótulos dos campos para o módulo. As edições nos rótulos serão refletidas nas disposições do módulo.
Clique e digite para realizar as alterações necessárias nos rótulos e depois clique em SAVE & DEPLOY.
Uma mensagem de confirmação aparecerá assim que as alterações forem salvas. Agora você poderá ver as alterações nos rótulos ao navegar para o módulo.
Clicar em CHANGE MODULE NAME permitirá alterar o rótulo do módulo em si. Consulte a seção Rename Modules da documentação Developer Tools para mais detalhes.
Campos
Selecionando o componente Fields, serão exibidos todos os campos disponíveis para o módulo, com seu rótulo e tipo de dado.
Adicionando um Campo
Você pode adicionar um campo personalizado ao módulo selecionado clicando em ADD FIELD.
Digite os detalhes para o novo campo. Dependendo do tipo de dado selecionado, algumas ou todas as propriedades a seguir podem ser definidas para o campo:
| Data Type: | O tipo selecionado determina o tipo de caractere que pode ser inserido no campo. Por exemplo, somente números inteiros podem ser inseridos em campos do tipo Integer. |
| Field Name: | O nome do campo deve ser alfanumérico e não conter espaços. Underscores são válidos. |
| Display Label | O rótulo que será exibido junto ao campo nas visualizações. |
| System Label: | Este rótulo é usado para referenciar o campo no código. |
| Help Text: | Texto explicativo opcional exibido temporariamente quando o usuário passa o mouse sobre o campo. |
| Comment Text: | Visível apenas no Studio e Module Builder, serve como uma descrição para uso do administrador. |
| Default Value: | O campo terá o valor definido aqui, a menos que o usuário informe um valor novo. |
| Max Size: | Número máximo de caracteres que podem ser inseridos no campo. |
| Mass Update: | Habilita a funcionalidade de atualização em massa para este campo. |
| Required Field: | Se um valor deve ser necessariamente informado para que o registro possa ser salvo. |
| Audit: | Se esta opção for selecionada, as mudanças no valor do campo podem ser rastreadas no Change Log do registro. |
| Inline Edit: | Define se o campo pode ser editado inline, quando essa opção estiver habilitada nas Configurações do Sistema. |
| Importable: | Seleciona se o campo pode, não pode ou deve ser importado usando o Import Wizard. |
| DuplicateMerge: | Opção para habilitar ou desabilitar as funcionalidades Merge Duplicates e Find Duplicates. |
Tipos de Campos
O Studio já inclui vários tipos diferentes de campos que podem ser criados no CRM.
Os seguintes tipos de dados estão disponíveis ao criar campos no Studio:
| Data Types | Descrição |
| Address | Cria campos para rua, cidade, CEP, estado e país. Campos de endereço personalizados não podem ser agrupados como os campos padrão (exemplo: endereço para cobrança) |
| Checkbox | Cria uma checkbox para campos de dados com ação Sim/Não |
| Currency | Cria um campo para entrar um valor monetário. O sistema cria automaticamente um dropdown do tipo de moeda caso o campo não exista no módulo |
| Date | Cria um campo para entrada de data. Inclui botão com popup de calendário |
| DateTime | Cria um campo para entrada de data e hora. Inclui botão de calendário para seleção pela popup, e dropdown para seleção da hora |
| Decimal | Cria um campo para armazenar um número arredondado com precisão decimal especificada. O CRM armazena a representação exata do número no banco de dados (exemplo para precisão 2: 2.539 será armazenado como 2.60) |
| DropDown | Cria um campo para associar uma lista dropdown de valores |
| DynamicDropdown | Cria uma lista dropdown da qual você pode relacionar um único registro de vários módulos. |
| Flex Relate | Especifica relacionamento de um-para-muitos com outro módulo, permitindo vínculos com vários tipos de módulos. Por exemplo, Notes usam Flex Relate para se relacionar com Accounts, Contacts, Leads, etc. Apenas um campo do tipo Flex Relate é permitido por módulo, por isso não é possível adicionar outro desse tipo nos módulos Accounts, Calls, Meetings, Notes e Tasks. |
| Float | Cria um campo para armazenar número arredondado com precisão decimal especificada. O armazenamento varia conforme o banco de dados usado pelo CRM. |
| HTML | Cria texto formatado em HTML estático para exibição nas visualizações de registro |
| IFrame | Cria um campo para armazenar uma URL para exibir num iFrame nas visualizações de registro. A URL pode ser gerada dinamicamente a partir de dados em outros campos. |
| Image | Cria um campo de imagem para upload e exibição em registro |
| Integer | Cria um campo para números inteiros positivos ou negativos, sem casas decimais |
| Multiselect | Cria uma lista dropdown onde múltiplos valores podem ser selecionados simultaneamente |
| Phone | Cria um campo para entrada de número telefônico |
| Radio | Cria um botão de opção para selecionar um valor único de uma lista dropdown |
| Relate | Cria um campo para associar um registro a outro módulo em relacionamento unidirecional. É possível adicionar vários campos Relate a um módulo. Campos Relate e relacionamentos personalizados são independentes. Alterações em um não se refletem no outro. Campos Relate podem ser adicionados em relatórios, porém dados do registro relacionado não podem ser acessados no relatório. Para isso, crie um relacionamento personalizado. |
| TextArea | Cria uma área de texto aberta para múltiplas linhas |
| URL | Cria um campo para armazenar uma URL e exibi-la como link clicável. A URL pode ser gerada dinamicamente a partir de dados em outros campos. |
| TextField | Cria um campo para linha única de texto |
Adicionando um Campo Dropdown
Ao adicionar um campo do tipo DropDown, você precisa especificar a lista dropdown, que contém os itens que serão exibidos na lista.
Você pode selecionar uma lista dropdown existente, se apropriado, ou clicar em ADD para criar uma nova.
Para cada item a incluir na lista, informe:
| Item Name | Usado para referenciar o item dropdown no código. Deve ser alfanumérico, começar com letra e não conter espaços. |
| Display Name | Texto mostrado ao usuário. Pode conter espaços e caracteres especiais. |
Clique em ADD para adicionar cada novo item.
Para adicionar um item em branco, clique em ADD sem preencher Item Name nem Display Name. Não é possível adicionar nome em branco com label preenchido.
A lista pode ser opcionalmente ordenada alfabeticamente pelos Display Names clicando no botão SORT. Para definir um item padrão, utilize a opção “default value” nas configurações do campo que usará essa dropdown.
Clique em SAVE para salvar a nova lista dropdown e retornar às propriedades do campo.
Os itens da lista dropdown que você criou agora estarão visíveis. Se desejar, você pode selecionar um valor padrão para o dropdown.
Editando um Campo
Clique em um campo para visualizar suas propriedades. Elas podem ser editadas da mesma forma descrita para adicionar um novo campo.
Excluindo um Campo
Somente campos criados no Studio podem ser excluídos via Studio. Campos padrão (core) não podem ser excluídos.
Selecione o campo que deseja excluir e clique em DELETE. Uma mensagem de aviso aparecerá solicitando sua confirmação, pois tanto o campo quanto todos os dados relacionados serão apagados do banco e o campo não aparecerá mais nas visualizações do módulo.
Relacionamentos
Um relacionamento representa uma ligação bidirecional entre dois módulos. Selecionando o componente Relationships são exibidos todos os relacionamentos entre o módulo selecionado e outros módulos ativos.
Clique em um relacionamento para visualizar suas propriedades.
Clique em ADD RELATIONSHIP para adicionar um novo relacionamento para o módulo selecionado.
O Primary Module será definido automaticamente para o módulo selecionado.
Especifique o tipo de relacionamento:
One to One
Em um relacionamento Um-a-Um, cada registro do módulo primário pode ter apenas um registro relacionado no módulo relacionado, e vice-versa. Esse tipo de relacionamento adicionará um campo relate a ambos os módulos.
One to Many
Em um relacionamento Um-para-Muitos, registros do módulo primário podem ser relacionados a um ou mais registros do módulo relacionado, mas cada registro do módulo relacionado está relacionado a apenas um registro do módulo primário. Isso adicionará um campo relate aos registros do módulo relacionado, enquanto o módulo primário exibirá um subpainel onde múltiplos registros relacionados podem ser adicionados.
Many to Many
Em um relacionamento Muitos-para-Muitos, registros de ambos os módulos podem ser relacionados a múltiplos registros do outro módulo. Cada módulo exibirá um subpainel para os registros relacionados.
Onde existirem subpainéis, as visualizações de subpainéis para o(s) módulo(s) poderão ser selecionadas.
Clique em SAVE AND DEPLOY para salvar o relacionamento.
Layouts
Os layouts podem ser editados no Studio para personalizar as visualizações dos módulos apresentadas aos usuários.
Visualização de Edição
A visualização de edição é exibida ao editar um registro ou ao criar um novo.
O layout atual é exibido no painel principal à direita. Os campos não utilizados aparecem listados à esquerda.
Dica: Selecione Sync to Detail View caso queira que as mudanças feitas na localização dos campos também sejam aplicadas automaticamente na visualização de detalhe. Lembre-se que, com essa opção ativada, não será possível realizar alterações na visualização de detalhe.
Adicionando Campos
Os campos podem ser adicionados à visualização como uma nova linha em um painel (seção) existente ou criando um novo painel.
Arraste e solte o elemento New Row ou New Panel para o local desejado no layout à direita.
Quando um novo painel for adicionado, ele pode ser renomeado clicando no ícone de lápis. Isso abrirá a edição do rótulo do painel. Edite o rótulo e clique em SAVE para voltar ao layout.
Uma nova linha será criada automaticamente com duas colunas.
Arraste e solte os campos desejados na nova linha. Clicar no botão + irá estender o campo para ocupar as duas colunas.
Clique em SAVE AND DEPLOY para salvar as alterações no layout. Elas ficarão visíveis ao navegar até a visualização de edição do módulo.
Removendo Campos
Para remover campos, linhas ou painéis do layout, arraste-os para a área de exclusão à esquerda.
Clique em SAVE AND DEPLOY para salvar as alterações no layout.
Visualização de Detalhe
A visualização de detalhe é somente leitura, exibida quando um registro é aberto.
O layout da visualização de detalhe pode ser editado da mesma forma que a visualização de edição. Note que, se Sync to Detail View estiver selecionado na visualização de edição, não será possível editar a visualização de detalhe.
Visualização de Lista
A visualização de lista aparece ao abrir um módulo, e exibe todos os registros.
Personalize quais campos são exibidos na visualização de lista e a ordem em que aparecem.
| Default | Campos nesta coluna serão exibidos por padrão na visualização de lista. Você pode reordenar os campos arrastando-os. |
| Available | Campos disponíveis para o usuário adicionar via o botão Column Chooser na visualização de lista. |
| Hidden | Campos ocultos para usuários e que não podem ser adicionados à visualização. |
Arraste e solte os campos entre as colunas para personalizar a visualização da lista.
Subpainéis
Use esta seção para personalizar quais campos são exibidos em um subpainel específico.
Selecione o subpainel. Os campos na coluna Default serão exibidos no subpainel. Arraste e solte os campos entre as colunas conforme desejado.
Clique em SAVE & DEPLOY
Exportar Personalizações
Você pode exportar personalizações feitas nos módulos via Studio e carregar em outra instância do CRM utilizando o Module Loader.
Digite um nome para o pacote e, opcionalmente, autor e descrição.
Selecione os módulos que contêm as personalizações que deseja exportar. Apenas módulos com personalizações aparecerão para seleção.
Clique em EXPORT. Será criado e baixado um arquivo .zip com as personalizações. Use o Module Loader para carregar e instalar as customizações em outra instância do CRM.