Use esta atividade para atualizar objetos existentes ou criar novos
objetos no Saleforce.com.
Sobre Esta Tarefa
A atividade usa um ID externo, geralmente
uma chave estrangeira, para determinar se deve atualizar um objeto existente ou
criar um novo objeto no Salesforce.com.
Embora a API do Salesforce.com limite
a 200 objetos o número de objetos que ela pode criar em uma única chamada upsert,
o conector do Cast Iron Salesforce.com
não tem esse limite. É possível usar a atividade
Executar Upsert de Objetos para criar um número ilimitado de
objetos.
Para usar a atividade
Executar Upsert de Objetos:
Procedimento
- Na guia Atividades, abra o diretório
Salesforce.com para localizar a atividade Executar
Upsert de Objetos.
- Inclua a atividade em uma Orquestração. A
Lista de Verificação e o
Resumo da atividade são exibidos abaixo da
orquestração.
- Selecione um terminal Salesforce.com. Para obter instruções sobre como criar ou editar um terminal
Salesforce.com, consulte
Criando
ou Editando um Terminal Salesforce.com.
- Configure
a atividade, escolhendo um tipo de objeto Salesforce.com e preferências de campos
do objeto.
Nota: É possível escolher apenas tipos de objetos que o Integration
Appliance pode atualizar ou criar e conter pelo menos um campo
ID Externo. Quando você seleciona o tipo de objeto, o
Studio exibe os IDs externos definidos no tipo de objeto no campo
ID Externo da área de janela Configurar.
Não é possível editar os IDs listados na lista ID
Externo.
O ID externo que você seleciona se torna um campo obrigatório, não é
possível limpar este campo a partir da tabela Preferências do
Campo do Objeto.
Se apenas um ID externo estiver disponível, o Studio selecionará
automaticamente este campo na tabela Preferências do Campo do
Objeto.
- Especifique os parâmetros
Tentar Novamente e
Expirar para a atividade.
- Mapeie a entrada da atividade.
- Mapeie a saída da atividade.
Resultados
Mapeie a entrada da atividade Executar Upsert de Objetos
- Na
Lista de Verificação, selecione
Mapear Entradas.
O elemento objects é exibido no painel Para Atividade.
- Clique com o botão direito do mouse no nó padrão
e escolha Mostrar Parâmetros Opcionais, para
mostrar os parâmetros de entrada opcionais para esta atividade:
- AssignmentRuleHeader
- MruHeader
- EmailHeader
- CallOptions
- connection
- sessionInfo
- Clique em Selecionar Entradas... e selecione a
variável ou variáveis de entrada para o mapa. Para obter instruções sobre como criar
variáveis, consulte Criando Variáveis.
- Conforme apropriado, mapeie os parâmetros de entrada para a variável
ou as variáveis.
Para obter instruções de mapeamento, consulte Criando um Mapa.
Esta atividade suporta os seguintes parâmetros de
entrada opcionais:
- AssignmentRuleHeader
- EmailHeader
- MruHeader
Os elementos de campo Optional e
nillable possuem o comportamento a seguir:
Mapeie a saída da atividade
Executar Upsert de Objetos
- Na Lista de Verificação, selecione Mapear
Saídas.
O elemento upsertResults é exibido no painel Da Atividade.
- Clique em Selecionar Saídas... e selecione a
variável ou as variáveis de saída para o mapa. Para obter instruções sobre como criar
variáveis, consulte Criando Variáveis.
- Conforme apropriado, mapeie os parâmetros de saída para a variável ou
as variáveis.
Para obter instruções de mapeamento, consulte Criando um Mapa.