Salesforce Workbench
introdução
Workbench é um conjunto poderoso, baseado na web, de ferramentas concebidas para interagir com Salesforce.com organizações através da Force.com APIs.Este artigo descreve vários tópicos importantes do grupo de trabalho “Salesforce Workbench”.:
- manipulação de dados usando bancada de trabalho.
- utilização de API de repouso e métodos assíncronos na bancada de trabalho.
- migração por bancadas de trabalho.
- diferença entre a consola de desenvolvimento e a bancada de trabalho.
- cenários que descrevem as funcionalidades do workbench.
Login Salesforce Workbench
- Login into Workbench usando o seguinte URL.
URL: https://workbench.developerforce.com/login.php
- selecione o ambiente, a versão da API e insira as credenciais da Salesforce.
- a bancada de trabalho da Salesforce é exibida após o login de sucesso.
- Manipulação de Dados usando o workbench
Navegue até ‘Dados’ para executar várias operações de manipulação de dados.
1.1 para efectuar operações de inserção, actualização e Upsert,
- seleccione um objecto da lista ‘Tipo de Objecto’.
- seleccione a opção’ single record ‘ou’ From file ‘ e carregue em Seguinte.
- envia QUALQUER ficheiro CSV ou ZIP válido na opção ‘de ficheiro’.
- carregue no botão “Confirmar” para confirmar o número de Registos Insert / Update / Upert.
- Após a bem sucedida operação de manipulação de dados, a tela exibe,
- ID do Salesforce dos registros
- Resultado
- Status
1.2 para efectuar as operações de remoção, remoção e purga,
- seleccione a opção’ single record ‘ou’ From File ‘ e carregue em Seguinte.
- introduza o ID de Registo (ID da Salesforce) para Apagar, Apagar ou purgar.
- carregue no botão “Confirmar” para confirmar o número de registos de apagamento / apagamento / purga.
- Workbench exibe o “ID da Salesforce” e o estado do resultado após uma manipulação de dados bem sucedida.
- utilização de API de repouso e métodos assíncronos na bancada de trabalho
2.1 REST Explorer
REST Explorer in workbench ajuda o usuário a explorar e descobrir a API de descanso, permitindo assim que o usuário recupere, crie, atualize ou delete os dados na Salesforce org.
- navegue para a página ‘Utilities’ e selecione ‘REST Explorer’
- por padrão, o método HTTP é definido como ‘GET’.
- se carregar no botão ‘Headers’, irá mostrar os’ Request Headers ‘
- a resposta é definida para o formato’ JSON ‘ por omissão. Também pode ser alterado para ‘XML’
2.1.1 métodos HTTP na API REST
Método 1: POST
- para a criação de registos utilizando a API de repouso, é utilizado o método “POST”.
- certifique-se que define a ligação como ‘/sobjects/URI’.
- definir o “organismo de pedido” com campos e valores.
- carregue no botão “Executar” para receber a mensagem de resposta confirmando a inserção bem sucedida.
Método 2: Obter
- para ler um registo da Salesforce org, é utilizado o método “GET”.
- define a consulta SOQL que devolve todos os registos presentes na Salesforce org.
Query: / services / data / v41. 0/query/?q = seleccionar+Id, Nome+de + conta + limite+5
- clique no botão ‘Executar’ para receber a mensagem de sucesso, bem como a ‘resposta Raw’.
Método 3: PATCH
- para edição / actualização de Registos através da API de repouso, é utilizado o método “PATCH”.
- definir o “organismo de pedido” com campos e valores para a actualização dos registos.
- clique no botão “Executar” para receber a mensagem de resposta.
Método 4: apagar
- Para Apagar Registos através da API de repouso, utiliza-se o método “apagar”.
- define o URI de acordo com o objecto a eliminar e introduza o seu ID relacionado.
- clique no botão ‘Executar’ para receber a mensagem de resposta confirmando a remoção bem sucedida.
2.2 métodos assíncronos em workbench
Código Apex e o estado dos trabalhos API podem ser executados em workbench através de métodos assíncronos.
2.2.1 Apex executar
- usando Apex executar o usuário pode criar, atualizar e excluir os registros.
- navegar para utilitários à Apex executar.
- digite o código Apex no espaço fornecido, que funciona como uma janela anônima.
- seleccione a “categoria de registo “como” código Apex ” e “nível de registo “como ” depuração”.
- clique no botão ‘Executar’ para ver os resultados da execução Apex na mesma janela.
2.2.2 o estado de trabalho da API A Granel
- o estado de trabalho da API a granel é usado para mostrar o “estado de carga de dados assíncrona e os resultados”
- navegar para o estado de trabalho da API A Granel.
- introduza o ‘ID da tarefa’ no campo de texto fornecido.
- carregue no botão ‘Obter o estado’ para obter o estado das tarefas de processamento de dados a granel e mostrar na mesma janela.
- Migração através Workbench
Migração na bancada de trabalho ajuda o usuário a ‘Recuperar’ e ‘Implantar’ as componentes de Metadados que ajudam a estruturar a organização como aplicativos personalizados, objetos e outros componentes.
3.1 Recuperar
Para recuperar Metadados componentes da organização,
- Preparar um arquivo XML com os padrões e tipos definidos com a versão da API para o pedido.
- navegue para a migração para recuperar
- na secção Manifesto Não embalado, seleccione o ficheiro XML de pacote criado para obter os atributos do componente.Opcionalmente, indique os ‘nomes dos pacotes’ e seleccione a opção ‘pacote único’ e carregue em Seguinte.
- após o envio bem sucedido do ficheiro XML, carregue no ‘recuperar’
- Carregue em ‘Transferir ficheiro ZIP’ Para ver os componentes de metadados implantados a partir da organização.
3.2 Implantar
Para implantar os componentes de Metadados para a organização,
- Crie uma pasta com o ‘Pacote XML’ na raiz e uma sub-pasta com o nome do componente. Fecha a pasta.
- navegar para a migração à implantação
- na secção escolher, seleccione a pasta com o pacote XML para implantar os componentes de metadados.Opcionalmente, seleccione as opções abaixo e carregue em Seguinte.
- após um upload bem sucedido, clique no ‘Implay’
- confirme a implementação de resultados com sucesso, se não verificar os arquivos para quaisquer erros.
4.A diferença entre o Console do desenvolvedor e o Workbench
o Salesforce Object Query Language (SOQL) e o Salesforce Object Search Language (SOSL) pode ser executado tanto no Console do desenvolvedor como no workbench.
a principal diferença entre o uso de consola de desenvolvedor e workbench é a Interface do Usuário. Workbench fornece aos usuários uma IU melhorada para consultar os registros.
- as consultas de SOQL podem ser construídas apenas seleccionando a lista “Object” e “fields”.
- as consultas podem ser filtradas usando ‘Sort results by’ e ‘Filter results by’ drop-down.
- Na bancada, os resultados da consulta podem ser vistos como,
- Lista
- Matriz
- em Massa CSV
- XML
- Os registros que são excluídos e arquivados podem ser excluídos ou incluídos.
- Os resultados da consulta SOQL podem ser exportados através de ‘Massa CSV’ opção para analisar os dados para uso futuro.
- as consultas SOSL podem ser construídas especificando as opções’ Search for ‘e’ Returning object’.
- Os resultados da SOSL as consultas são apresentadas no formato de Lista especificando o ID. Passe o mouse sobre a IDENTIFICAÇÃO para efectuar acções tais como,
- Atualização
- Apagar
- desfazer exclusão
- Purge
- Visualizar no Salesforce
5.Scenarios describing Workbench’s functionalities
Scenario 1
pede-se a um utilizador que descubra a contagem de componentes de metadados numa organização da Salesforce.
,
- navegar para os tipos de meta-dados da Página informação & componentes.
- seleccione quaisquer meta-dados da lista de largada.
- após a seleção, workbench descreve e exibe o “número Total de componentes” presente nos metadados específicos.
Scenario 2
Export data for the Users who are assigned to Permission sets.
Para atingir esse cenário usando a Bancada de trabalho,
- Navegue para Consultas à Consulta SOQL
- Selecione “PermissionSetAssignment’ no objeto drop-down, e os campos necessários.
- seleccione “CSV a granel” como opção e carregue em consulta.
- Isto irá levar o utilizador para uma próxima tela que mostra o ID da tarefa e o estado da tarefa.
- carregue no botão baixar para exportar a consulta de SOQL para um ficheiro CSV.
Cenário 3
um utilizador não conseguiu entrar e não estava a obter a senha de reset email quando tentou repor a senha.
,
- navegue para o Utilitários de gestão de senhas
- carregue na opção ‘Reiniciar’ e indique o ID do utilizador.
- carregue no botão ‘mudar a senha’ para repor a senha.
- carregue na opção ‘ Set ‘ e indique o ID do utilizador.
- indique os valores dos campos “Senha” e “senha de confirmação”.
- Carregue em ‘Alterar a senha’ para alterar a senha do utilizador.
vantagens da bancada de trabalho
- dá-nos acesso a dados e informações estruturais de todos os objectos do sistema.
- para usuários congelados ou bloqueados, consultas SOQL em Workbench ajuda a visualizar os dados.
- aqueles em Mac podem usá-lo sem software adicional.
desvantagens do workbench
- Workbench tem uma incapacidade de salvar e reutilizar mapeamentos de carga de dados, como podemos fazer com o carregador de dados.
- Workbench não tem capacidade para fazer linha de comando ou ações agendadas, como com o carregador de dados.