Informatica PowerExchange for Salesforce (Versão HotFix 4) Guia do Usuário do PowerCenter

Transcrição

1 Informatica PowerExchange for Salesforce (Versão HotFix 4) Guia do Usuário do PowerCenter

2 Informatica PowerExchange for Salesforce Guia do Usuário do PowerCenter Versão HotFix 4 Fevereiro 2014 Copyright (c) Informatica Corporation. Todos os direitos reservados. Este software e a respectiva documentação contêm informações de propriedade da Informatica Corporation. Eles são fornecidos sob um contrato de licença que contém restrições quanto a seu uso e divulgação, e são protegidos por leis de copyright. A engenharia reversa do software é proibida. Não está permitida de forma alguma a reprodução ou a transmissão de qualquer parte deste documento (seja por meio eletrônico, fotocópia, gravação ou quaisquer outros) sem o consentimento prévio da Informatica Corporation. Este Software pode estar protegido por patentes dos EUA e/ou internacionais e outras patentes pendentes. O uso, duplicação ou divulgação do Software pelo Governo dos Estados Unidos estão sujeitos às restrições estipuladas no contrato de licença de software aplicável e como estabelecido em DFARS (a) e (a) (1995), DFARS (1)(ii) (OCT 1988), FAR (a) (1995), FAR ou FAR (ALT III), conforme aplicável. As informações contidas neste produto ou documentação estão sujeitas a alteração sem aviso prévio. Informe-nos por escrito caso encontre quaisquer problemas neste produto ou documentação. Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging and Informatica Master Data Management são marcas comerciais ou marcas registradas da Informatica Corporation nos Estados Unidos e em jurisdisdições pelo mundo. Todos os outros nomes de outras companhias e produtos podem ser nomes ou marcas comerciais de seus respectivos proprietários. Partes desta documentação e/ou software estão sujeitas a direitos autorais de terceiros, incluindo sem limitação: Copyright DataDirect Technologies. Todos os direitos reservados. Copyright Sun Microsystems. Todos os direitos reservados. Copyright RSA Security Inc. Todos os direitos reservados. Copyright Ordinal Technology Corp. Todos os direitos reservados. Copyright Aandacht c.v. Todos os direitos reservados. Copyright Genivia, Inc. Todos os direitos reservados. Copyright Isomorphic Software. Todos os direitos reservados. Copyright Meta Integration Technology, Inc. Todos os direitos reservados. Copyright Intalio. Todos os direitos reservados. Copyright Oracle. Todos os direitos reservados. Copyright Adobe Systems Incorporated. Todos os direitos reservados. Copyright DataArt, Inc. Todos os direitos reservados. Copyright ComponentSource. Todos os direitos reservados. Copyright Microsoft Corporation. Todos os direitos reservados. Copyright Rogue Wave Software, Inc. Todos os direitos reservados. Copyright Teradata Corporation. Todos os direitos reservados. Copyright Yahoo! Inc. Todos os direitos reservados. Copyright Glyph & Cog, LLC. Todos os direitos reservados. Copyright Thinkmap, Inc. Todos os direitos reservados. Copyright Clearpace Software Limited. Todos os direitos reservados. Copyright Information Builders, Inc. Todos os direitos reservados. Copyright OSS Nokalva, Inc. Todos os direitos reservados. Copyright Edifecs, Inc. Todos os direitos reservados. Copyright Cleo Communications, Inc. Todos os direitos reservados. Copyright International Organization for Standardization Todos os direitos reservados. Copyright ej-technologies GmbH. Todos os direitos reservados. Copyright Jaspersoft Corporation. Todos os direitos reservados. Copyright é International Business Machines Corporation. Todos os direitos reservados. Copyright yworks GmbH. Todos os direitos reservados. Copyright Lucent Technologies. Todos os direitos reservados. Copyright (C) University of Toronto. Todos os direitos reservados. Copyright Daniel Veillard. Todos os direitos reservados. Copyright Unicode, Inc. Copyright IBM Corp. Todos os direitos reservados. Copyright MicroQuill Software Publishing, Inc. Todos os direitos reservados. Copyright PassMark Software Pty Ltd. Todos os direitos reservados. Copyright LogiXML, Inc. Todos os direitos reservados. Copyright Lorenzi Davide, todos os direitos reservados. Copyright Red Hat, Inc. Todos os direitos reservados. Copyright The Board of Trustees of the Leland Stanford Junior University. Todos os direitos reservados. Copyright EMC Corporation. Todos os direitos reservados. Copyright Flexera Software. Todos os direitos reservados. Copyright Jinfonet Software. Todos os direitos reservados. Copyright Apple Inc. Todos os direitos reservados. Copyright Telerik Inc. Todos os direitos reservados. Copyright BEA Systems. Todos os direitos reservados. Copyright PDFlib GmbH. Todos os direitos reservados. Copyright Orientation in Objects GmbH. Todos os direitos reservados. Copyright Tanuki Software, Ltd. All rights reserved. Copyright Ricebridge. Todos os direitos reservados. Copyright Sencha, Inc. All rights reserved. Este produto inclui software desenvolvido pela Apache Software Foundation ( e/ou outros softwares licenciados nas várias versões da Licença Apache (a "Licença"). Você pode obter uma cópia dessas Licenças em A menos que exigido pela legislação aplicável ou concordado por escrito, o software distribuído em conformidade com estas Licenças é fornecido "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA OU CONDIÇÃO DE QUALQUER TIPO, seja expressa ou implícita. Consulte as Licenças para conhecer as limitações e as permissões que regulam o idioma específico de acordo com as Licenças. Este produto inclui software desenvolvido pela Mozilla ( direitos autorais de software de The JBoss Group, LLC; todos os direitos reservados; direitos autorais de software de Bruno Lowagie e Paulo Soares e outros produtos de software licenciados sob a Licença Pública GNU Lesser General Public License Agreement, que pode ser encontrada em Os materiais são fornecidos gratuitamente pela Informatica, no estado em que se encontram, sem garantia de qualquer tipo, explícita nem implícita, incluindo, mas não limitando-se, as garantias implicadas de comerciabilidade e adequação a um determinado propósito. O produto inclui software ACE(TM) e TAO(TM) com copyright de Douglas C. Schmidt e seu grupo de pesquisa na Washington University, University of California, Irvine e Vanderbilt University, Copyright ( ) , todos os direitos reservados. Este produto inclui o software desenvolvido pelo OpenSSL Project para ser usado no kit de ferramentas OpenSSL (copyright The OpenSSL Project. Todos os direitos reservados) e a redistribuição deste software está sujeita aos termos disponíveis em e Este produto inclui o software Curl com o Copyright , Daniel Stenberg, <daniel@haxx.se>. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em É permitido usar, copiar, modificar e distribuir este software com qualquer objetivo, com ou sem taxa, desde que a nota de direitos autorais acima e esta nota de permissão apareçam em todas as cópias. O produto inclui direitos autorais de software ( ) MetaStuff, Ltd. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em O produto inclui o copyright de software , The Dojo Foundation. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui o software ICU com o copyright International Business Machines Corporation e outros. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui o copyright de software Per Bothner. Todos os direitos reservados. O direito de usar tais materiais é estabelecido na licença que pode ser encontrada em Este produto inclui o software OSSP UUID com Copyright 2002 Ralf S. Engelschall, Copyright 2002 e OSSP Project Copyright 2002 Cable & Wireless Deutschland. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui software desenvolvido pela Boost ( ou sob a licença de software Boost. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui direitos autorais de software University of Cambridge. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em

3 Este produto inclui o copyright de software 2007 The Eclipse Foundation. Todos os direitos reservados. As permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em e em Este produto inclui softwares licenciados de acordo com os termos disponíveis em License, license.html, asm.ow2.org/license.html, httpunit.sourceforge.net/doc/ license.html, license.html, license-agreement; /copyright-software ; forge.ow2.org/projects/javaservice/, license.html; protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; current/doc/mitk5license.html. e Este produto inclui software licenciado de acordo com a Academic Free License ( a Common Development and Distribution License ( a Common Public License ( a Sun Binary Code License Agreement Supplemental License Terms, a BSD License ( a nova BSD License ( licenses/bsd-3-clause), a MIT License ( a Artistic License ( e a Initial Developer s Public License Version 1.0 ( Este produto inclui copyright do software Joe WaInes, XStream Committers. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui software desenvolvido pelo Indiana University Extreme! Lab. Para obter mais informações, visite Este produto inclui software Copyright 2013 Frank Balluffi e Markus Moeller. Todos os direitos reservados. As permissões e limitações relativas a este software estão sujeitas aos termos da licença MIT. Este Software é protegido pelos Números de Patentes dos EUA 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775; 6,640,226; 6,789,096; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110; 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121; 7,584,422; 7,676,516; 7,720,842; 7,721,270; 7,774,791; 8,065,266; 8,150,803; 8,166,048; 8,166,071; 8,200,622; 8,224,873; 8,271,477; 8,327,419; 8,386,435; 8,392,460; 8,453,159; 8,458,230; e RE44,478, Patentes internacionais e outras Patentes Pendentes. ISENÇÃO DE RESPONSABILIDADE: a Informatica Corporation fornece esta documentação no estado em que se encontra, sem garantia de qualquer tipo, expressa ou implícita, incluindo, mas não limitando-se, as garantias implícitas de não infração, comercialização ou uso para um determinado propósito. A Informatica Corporation não garante que este software ou documentação esteja sem erros. As informações fornecidas neste software ou documentação podem incluir imprecisões técnicas ou erros tipográficos. As informações deste software e documentação estão sujeitas a alterações a qualquer momento sem aviso prévio. AVISOS Este produto da Informatica (o "Software") traz determinados drivers (os "drivers da DataDirect") da DataDirect Technologies, uma empresa em funcionamento da Progress Software Corporation ("DataDirect"), que estão sujeitos aos seguintes termos e condições: 1. OS DRIVERS DA DATADIRECT SÃO FORNECIDOS NO ESTADO EM QUE SE ENCONTRAM, SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO LIMITANDO-SE, AS GARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA E NÃO INFRAÇÃO. 2. EM NENHUM CASO, A DATADIRECT OU SEUS FORNECEDORES TERCEIRIZADOS SERÃO RESPONSÁVEIS, EM RELAÇÃO AO CLIENTE FINAL, POR QUAISQUER DANOS DIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS, CONSEQUENCIAIS OU DEMAIS QUE POSSAM ADVIR DO USO DE DRIVERS ODBC, SENDO OU NÃO ANTERIORMENTE INFORMADOS DAS POSSIBILIDADES DE TAIS DANOS. ESTAS LIMITAÇÕES SE APLICAM A TODAS AS CAUSAS DE AÇÃO, INCLUINDO, SEM LIMITAÇÕES, QUEBRA DE CONTRATO, QUEBRA DE GARANTIA, NEGLIGÊNCIA, RESPONSABILIDADE RIGOROSA, DETURPAÇÃO E OUTROS ATOS ILÍCITOS. Parte Número: PWX-SFU HF4-0001

4 Conteúdo Prefácio.... iv Recursos da Informatica.... iv Portal My Support da Informatica.... iv Documentação da Informatica.... iv Site da Informatica.... iv Biblioteca de Recursos da Informatica.... v Base de Dados de Conhecimento da Informatica.... v Canal de Suporte da Informatica no YouTube.... v Informatica Marketplace.... v Informatica Velocity.... v Suporte Global a Clientes da Informatica.... v Capítulo 1: Compreendendo o PowerExchange for Salesforce Visão geral do capítulo Compreendendo o PowerExchange for Salesforce Integração entre o PowerCenter e o Salesforce Integração entre o Designer e o Salesforce Integração do Serviço de Integração do PowerCenter e do Salesforce Capítulo 2: Instalação e Configuração Visão Geral de Instalação e Configuração Pré-requisitos Instalando e Configurando o PowerExchange for Salesforce Atualizando o PowerExchange for Salesforce Registro de Plug-in Opções de Proxy HTTP Configurando Opções de Proxy HTTP para o Cliente do PowerCenter Configurando Opções de Proxy HTTP para o Serviço de Integração do PowerCenter Desinstalando o PowerExchange for Salesforce Informações da Versão Novos Recursos Comportamento Alterado Capítulo 3: Origens e Destinos do Salesforce Visão Geral de Origens e Destinos do Salesforce Importando Campos de Objetos Salesforce Relacionados Regras e Diretrizes para a Importação de Campos de Objetos Salesforce Relacionados Origens do Salesforce Fusos Horários para Origens do Salesforce Conversão de Tempo de Origens do Salesforce Destinos do Salesforce Sumário i

5 Fusos Horários para Destinos do Salesforce Determinando Possíveis Estratégias de Atualização para um Destino do Salesforce Regras e Diretrizes para a Estratégia de Atualização de Destino do Salesforce Importando uma Definição de Origem ou Destino do Salesforce Capítulo 4: Transformação de Pesquisa do Salesforce Visão Geral da Transformação de Pesquisa do Salesforce Componentes de Pesquisa do Salesforce Portas de Pesquisa do Salesforce Portas de Pesquisa Portas de Passagem Porta LKP_FILTER Porta LKP_MATCHIDX Consulta de Pesquisa do Salesforce Criando uma Transformação de Pesquisa do Salesforce Capítulo 5: Transformação de Mesclagem do Salesforce Visão Geral da Transformação de Mesclagem do Salesforce Exemplo de transformação de Mesclagem do Salesforce Componentes de Mesclagem do Salesforce Portas de Mesclagem do Salesforce Portas de Atributos de Objeto Salesforce Portas de Entrada ID e SlaveID Portas de Saída MergedID, MergedSlaveID1 e MergedSlaveID Regras e Diretrizes para a Transformação de Mesclagem do Salesforce Criando uma Transformação de Mesclagem do Salesforce Capítulo 6: Transformação de Lista de Seleção do Salesforce Visão Geral da Transformação de Lista de Seleção do Salesforce Componentes de Lista de Seleção do Salesforce Portas de Lista de Seleção do Salesforce Regras e Diretrizes para a Transformação de Lista de Seleção do Salesforce Criando uma Transformação de Lista de Seleção do Salesforce Capítulo 7: Sessões e Fluxos de Trabalho do Salesforce Visão Geral de Sessões e Fluxos de Trabalho do Salesforce Conexões com o Salesforce Configurando uma Conexão do Salesforce Configurando uma Sessão com uma Origem do Salesforce Filtrando Dados de Origem Capturando Registros Excluídos e do Arquivo Morto do Salesforce Capturando Dados Alterados Sessões Contínuas do CDC ii Sumário

6 Período de Tempo Baseado em Sessões do CDC Usando o Registro de Data/Hora SystemModstamp ou LastModifiedDate para Change Data Capture Configurando uma Sessão com um Destino do Salesforce Configurando a Operação de Destino de Upsert Configurando o Tamanho Máximo de Lote Manipulando Valores Nulos em Operações de Atualização e Upsert Log de Detalhes da Sessão do PowerExchange for Salesforce Substituir um ID Externo por um idlookup para Upserts Configurando uma Sessão de API em Massa Monitorando uma Sessão de API em Massa Configurando um Tipo de Carregamento de Sessão de API em Massa Arquivos de Sucesso e de Erros de API em Massa Exclusões Forçadas com a API em Massa Configurando uma Sessão para Obter Desempenho Ideal Ajustando o Tamanho de Buffer do DTM Modificando a Precisão de Campos de String Apêndice A: Referência de Tipo de Dados Visão Geral de Referência de Tipo de Dados Salesforce e Tipos de Dados de Transformação Apêndice B: Glossário Índice Sumário iii

7 Prefácio O PowerExchange for Salesforce, no manual Guia do Usuário do PowerCenter, fornece informações para criar mapeamentos do Salesforce, extrair dados de objetos Salesforce e carregar dados em objetos Salesforce. Ele foi escrito para os desenvolvedores responsáveis pela extração de dados de objetos Salesforce e pelo carregamento de dados em objetos Salesforce. Este guia pressupõe que você conheça conceitos de serviços da Web, conceitos de bancos de dados relacionais, o PowerCenter e o Salesforce. Também é necessário estar familiarizado com os requisitos de interface de outros aplicativos de apoio. Para obter informações adicionais sobre problemas relacionados do Salesforce, consulte a documentação do Salesforce. Recursos da Informatica Portal My Support da Informatica Como cliente da Informatica, você pode acessar o Portal My Support da Informatica em O site contém informações sobre produtos, informações sobre grupos de usuários, boletins informativos, acesso ao sistema de gerenciamento de casos de suporte a clientes da Informatica (ATLAS), à Biblioteca de Recursos da Informatica, à Base de Dados de Conhecimento da Informatica, à Documentação de Produtos da Informatica e à comunidade de usuários da Informatica. Documentação da Informatica A equipe de Documentação da Informatica se esforça ao máximo para criar documentações precisas e utilizáveis. Se você tiver dúvidas, comentários ou ideias sobre esta documentação, entre em contato com a equipe de Documentação da Informatica pelo infa_documentation@informatica.com. Nós usaremos seu feedback para melhorar a documentação. Por favor, avise-nos se pudermos entrar em contato com você em relação aos comentários. A equipe de Documentação atualiza a documentação conforme o necessário. Para obter a documentação mais recente do seu produto, navegue para Documentação do Produto no endereço Site da Informatica Você pode acessar o site corporativo da Informatica no endereçohttp:// O site contém informações sobre a Informatica, seu histórico, eventos futuros e escritórios de vendas. Você também vai iv

8 encontrar informações sobre parceiros e produtos. A área de serviços do site inclui informações importantes sobre suporte técnico, treinamento e educação, bem como serviços de implementação. Biblioteca de Recursos da Informatica Na qualidade de cliente da Informatica, você pode acessar a Biblioteca de Recursos da Informatica no endereço A Biblioteca de Recursos é uma coletânea de recursos que o ajuda a aprender mais sobre os produtos e recursos da Informatica. Ela inclui artigos e demonstrações interativas que apresentam soluções a problemas comuns, comparam recursos e comportamentos e o orienta na execução de tarefas específicas no mundo real. Base de Dados de Conhecimento da Informatica Na qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento da Informatica no endereço Use a Base de Dados de Conhecimento para pesquisar soluções documentadas a problemas técnicos conhecidos sobre produtos da Informatica. Você também pode encontrar respostas a perguntas frequentes, white papers e dicas técnicas. Se você tiver dúvidas, comentários ou ideias sobre a Base de Dados de Conhecimento, entre em contato com a equipe da Base de Dados de Conhecimento da Informatica pelo KB_Feedback@informatica.com. Canal de Suporte da Informatica no YouTube Você pode acessar o canal de Suporte da Informatica no YouTube O canal de Suporte da Informatica no YouTube inclui vídeos sobre soluções que orientam você na execução de tarefas específicas. Em caso de dúvidas, comentários ou ideias sobre o canal de Suporte da Informatica no YouTube, entre em contato com a equipe de Suporte do YouTube por em supportvideos@informatica.com ou envie um tweet Informatica Marketplace O Informatica Marketplace é um fórum em que desenvolvedores e parceiros podem compartilhar soluções para aumentar, ampliar ou aprimorar implementações da integração de dados. Ao tirar proveito de qualquer uma das centenas de soluções disponíveis no Marketplace, você pode melhorar sua produtividade e agilizar o tempo de implementação em seu projeto. Você pode acessar o Informatica Marketplace através do link Informatica Velocity Você pode acessar o Informatica Velocity em Desenvolvido a partir da experiências reais em centenas de projetos de gerenciamento de dados, o Informatica Velocity representa o conhecimento coletivo de nossos consultores que trabalharam com organizações no mundo inteiro para planejar, desenvolver, implantar e manter soluções bem-sucedidas de Gerenciamento de Dados. Se você tiver dúvidas, comentários ou ideias sobre o Informatica Velocity, entre em contato com o Informatica Professional Services em ips@informatica.com. Suporte Global a Clientes da Informatica Você pode entrar em contato com o Centro de Suporte a Clientes por telefone ou pelo Suporte Online. O Suporte Online requer um nome de usuário e uma senha. Você pode solicitar um nome de usuário e uma senha no endereço Prefácio v

9 Os números de telefone para o Suporte Global a Clientes da Informatica estão disponíveis no site da Informatica em vi Prefácio

10 C A P Í T U L O 1 Compreendendo o PowerExchange for Salesforce Este capítulo inclui os seguintes tópicos: Visão geral do capítulo Compreendendo o PowerExchange for Salesforce, 1 Integração entre o PowerCenter e o Salesforce, 2 Visão geral do capítulo Compreendendo o PowerExchange for Salesforce O PowerExchange for Salesforce integra o PowerCenter ao Salesforce para extrair dados de origens do Salesforce e gravar dados em destinos do Salesforce. As origens e os destinos do Salesforce representam objetos no modelo de objeto Salesforce. Os objetos Salesforce são tabelas que correspondem a guias e outros elementos da interface do usuário no site do Salesforce. Por exemplo, o objeto de Conta contém as informações que aparecem em campos na guia Conta do Salesforce. Você pode exibir, criar, atualizar e excluir dados em objetos Salesforce. O PowerExchange for Salesforce usa o modelo de segurança do Salesforce para aplicar controles de acesso a dados. Sua capacidade de acessar dados depende da organização do Salesforce, ou org, associada ao logon de usuário que você usa ao se conectar ao Salesforce. Ela também depende dos privilégios de usuário e das permissões no nível de campo e linha associadas ao logon. Você especifica o usuário e a senha de logon do Salesforce em um objeto de conexão de aplicativo que cria no Workflow Manager ou ao importar um objeto Salesforce para o Designer. O PowerExchange for Salesforce usa a API do Salesforce para aplicar diretivas de acesso existentes e não impõe restrições de acesso a dados adicionais. O PowerExchange for Salesforce fornece os seguintes benefícios: Migração e integração de dados. Integre dados de diversas fontes de dados, inclusive outros aplicativos, aos dados do Salesforce. Além disso, use o PowerCenter para migrar dados de várias fontes de dados para o Salesforce. Análise de dados. Use a capacidade de qualidade de dados interna do PowerCenter para analisar e avaliar dados do Salesforce. Acesso à funcionalidade do Salesforce por meio do PowerCenter. Obtenha acesso total aos objetos Salesforce como origens e destinos no PowerCenter. 1

11 Integração entre o PowerCenter e o Salesforce O PowerExchange for Salesforce integra o Salesforce ao Designer para que você possa importar objetos Salesforce para o PowerCenter e usá-los em mapeamentos. Ele integra o Salesforce ao Serviço de Integração do PowerCenter para que você possa executar fluxos de trabalho que extraem, transformam e carregam dados do Salesforce. O PowerExchange for Salesforce usa SSL (Secure Sockets Layer) para criptografar todos os dados que passam pela Internet. Ele usa a criptografia SSL de 128 bits. O PowerExchange for Salesforce também usa a criptografia de 128 bits antes de armazenar IDs de usuário, senhas e IDs de sessão no repositório ou em localizações de armazenamento temporário. Integração entre o Designer e o Salesforce Use o Designer para importar objetos Salesforce como definições de origem ou destino do Salesforce ou como transformações de Pesquisa, Mesclagem ou Lista de Seleção do Salesforce. Você pode então usar esses objetos em mapeamentos para a integração sem problemas entre o PowerCenter e o Salesforce. Você pode importar objetos Salesforce personalizados e padrão. Os tipos de objetos padrão são objetos empacotados dentro do Salesforce, como Conta AccountPartner, Evento, Oportunidade e Produto. Os tipos de objeto personalizados ampliam os dados do Salesforce para uma organização, definindo entidades de dados que são exclusivas para a organização. Os administradores do Salesforce podem definir campos personalizados para objetos padrão e personalizados. O Designer usa uma conexão de logon do Salesforce para o serviço do Salesforce. Em seguida, ele gera uma lista de objetos que estão disponíveis para importação. Integração do Serviço de Integração do PowerCenter e do Salesforce O Serviço de Integração do PowerCenter conecta-se ao Salesforce para extrair, transformar e carregar dados do Salesforce. O Serviço de Integração do PowerCenter usa uma chamada de logon do Salesforce para autenticação no serviço do Salesforce. Você pode especificar que o servidor de logon deve usar um ambiente de produção ou um ambiente especial de teste e desenvolvimento chamado Salesforce Sandbox. Um objeto de conexão armazena o ID de usuário do Salesforce, a senha e as informações de URL de ponto final para a conexão em tempo de execução. Cada origem ou destino do Salesforce em um mapeamento faz referência a um objeto de conexão de aplicativo do Salesforce. Você pode usar várias conexões de aplicativo do Salesforce em um mapeamento para acessar diferentes conjuntos de dados do Salesforce para as origens e os destinos. O Serviço de Integração do PowerCenter usa o mecanismo de segurança do Salesforce para autenticar os usuários e gerenciar as sessões. A API do Salesforce executa a autenticação de ID de usuário e senha no início de uma sessão em tempo de execução. No tempo de execução da sessão, o Serviço de Integração do PowerCenter gera uma consulta SOQL com base nas definições de origem do Salesforce e nas projeções de campos no mapeamento. A linguagem SOQL é derivada do SQL. A API do Salesforce executa a validação de sintaxe do SOQL no tempo de execução. O Serviço de Integração do PowerCenter usa a API do Salesforce para ler e gravar em objetos Salesforce. Ao ler uma quantidade significativa de dados do Salesforce, o Serviço de Integração do PowerCenter divide os dados em segmentos menores. O PowerExchange for Salesforce envia solicitações sequenciais para subconjuntos de um conjunto de resultados de consulta até que todo o conjunto tenha sido recuperado. 2 Capítulo 1: Compreendendo o PowerExchange for Salesforce

12 O Serviço de Integração do PowerCenter usa o protocolo SOAP para transmitir dados entre o Serviço de Integração do PowerCenter e o serviço do Salesforce. Para aumentar o desempenho, o Serviço de Integração do PowerCenter usa a compactação HTTP para reduzir o tamanho dos pacotes SOAP que são enviados pela Internet. Quando o Serviço de Integração do PowerCenter grava os dados no Salesforce, ele converte os tipos de dados do PowerCenter em tipos de dados do Salesforce. Páginas de Código O Salesforce processa caracteres UTF-8. O Serviço de Integração do PowerCenter manipula dados do Salesforce com base nos seguintes modos de movimentação de dados: ASCII. Quando o Serviço de Integração do PowerCenter é executado no modo ASCII, ele não executa nenhuma validação de página de código ou conversão de dados. Você poderá obter dados inconsistentes ou truncados se o Serviço de Integração do PowerCenter for executado no modo ASCII, mas processar dados de caracteres não ASCII ao gravar em um destino do Salesforce. Unicode. Quando o Serviço de Integração do PowerCenter é executado no modo Unicode, ele converte dados do conjunto de caracteres de origem em UCS-2, processa-os e converte os dados UCS-2 no conjunto de caracteres da página de código de destino antes de carregar os dados. Se uma sessão gravar em um destino do Salesforce, o Serviço de Integração do PowerCenter converterá os dados UCS-2 no conjunto de caracteres UTF-8. Integração entre o PowerCenter e o Salesforce 3

13 C A P Í T U L O 2 Instalação e Configuração Este capítulo inclui os seguintes tópicos: Visão Geral de Instalação e Configuração, 4 Registro de Plug-in, 5 Opções de Proxy HTTP, 5 Desinstalando o PowerExchange for Salesforce, 7 Informações da Versão, 7 Visão Geral de Instalação e Configuração Este capítulo oferece informações sobre como atualizar, instalar e configurar o PowerExchange for Salesforce. Pré-requisitos Antes de atualizar ou instalar o PowerExchange for Salesforce, instale ou atualize o PowerCenter na máquina que executa o Serviço de Integração. Instalando e Configurando o PowerExchange for Salesforce Para instalar e configurar o PowerExchange for Salesforce, execute as seguintes etapas: 1. Registre o plug-in. 2. Configure as opções de proxy HTTP. Configure as opções de proxy HTTP para o Cliente do PowerCenter e o Serviço de Integração do PowerCenter. Após instalar e configurar o PowerExchange for Salesforce, você pode criar conexões para acessar o Salesforce. Crie objetos de conexão no Workflow Manager para que o Serviço de Integração do PowerCenter possa se conectar ao Salesforce. Atualizando o PowerExchange for Salesforce Ao atualizar o PowerExchange for Salesforce, execute as seguintes tarefas: 1. Atualize o registro do plug-in. 2. Concluir tarefas de pós-atualização. 4

14 Registro de Plug-in Após instalar o PowerExchange for Salesforce, registre o plug-in no repositório. Se você estiver atualizando de uma versão anterior, atualize o registro do plug-in ao registrá-lo. Um plug-in é um arquivo XML que define a funcionalidade do PowerExchange for Salesforce. Para registrar o plug-in, o repositório deve ser executado em modo exclusivo. Use o Informatica Administrator ou o comando pmrep RegisterPlugin para registrar o plug-in. O arquivo de plug-in do PowerExchange for Salesforce é pmsfdc.xml. Quando você instala o componente do Repositório, o instalador copia o pmsfdc.xml para o seguinte diretório: <PowerCenter Installation Directory>/server/bin/native Nota: Se você não tiver os privilégios corretos para registrar o plug-in, entre em contato com o usuário que gerencia o Serviço de Repositório do PowerCenter. Opções de Proxy HTTP Se você estiver instalando o PowerExchange for Salesforce e sua organização usar um servidor proxy para acessar a Internet, será preciso definir as configurações de autenticação de servidor proxy HTTP. Configure as opções de proxy HTTP para os seguintes componentes do PowerCenter: Cliente do PowerCenter Serviço de Integração do PowerCenter Se você estiver atualizando o PowerExchange for Salesforce, verifique se as configurações das opções de proxy HTTP para cada componente estão corretas. Configurando Opções de Proxy HTTP para o Cliente do PowerCenter Você configura as opções de proxy HTTP para o Cliente do PowerCenter em um arquivo de texto chamado pmsfdc.ini. O arquivo está localizado no seguinte diretório: <PowerCenter Installation Directory>\client\bin\ Para configurar as opções de proxy HTTP para o Cliente do PowerCenter: 1. Use um editor de texto para criar um novo arquivo de texto e salve-o como "pmsfdc.ini" no seguinte diretório: <PowerCenter Installation Directory>\client\bin\ Ou então, no diretório <Diretório de Instalação do PowerCenter>\client\bin, use um editor de texto para editar o arquivo pmsfdc.ini. Registro de Plug-in 5

15 2. Configure os seguintes parâmetros no arquivo de texto e especifique os valores apropriados para cada parâmetro: Parâmetro Necessário/ Opcional Descrição ProxyHost Necessário Nome do host de proxy. ProxyPort Necessário O número da porta do proxy. ProxyUser Necessário Nome de usuário para a conta de proxy. ProxyPassword Necessário Senha para a conta de proxy. Criptografada Opcional Use quando a senha do proxy for criptografada. A senha do proxy deve ser criptografada usando o programa de linha de comando do PowerCenter, pmpasswd. Use uma das seguintes opções: - DEFAULT. Use para uma senha criptografada usando o tipo de criptografia CRYPT_DATA. - SYSTEM. Use para uma senha criptografada usando o tipo de criptografia CRYPT_SYSTEM. Obrigatório se a senha do proxy for criptografada. Por exemplo: ProxyHost=d informatica.com ProxyPort=8082 ProxyUser=admin ProxyPassword=password123 Usando uma Senha de Proxy Criptografada Ao configurar opções de proxy HTTP para o Cliente do PowerCenter, você pode usar uma senha de conta de proxy criptografada para aprimorar a segurança. Para usar uma senha criptografada, execute as seguintes tarefas: 1. Criptografe a senha da conta de proxy do PowerCenter usando o programa de linha de comando do PowerCenter, pmpasswd. Você pode localizar pmpasswd no seguinte diretório na máquina do Serviço de Integração do PowerCenter: <InformaticaInstallationDir>/server/bin Ao criptografar a senha, você pode usar o tipo de criptografia CRYPT_DATA ou CRYPT_SYSTEM. 2. Use a senha criptografada como a senha de proxy no arquivo pmsfdc.ini. 3. Adicione o parâmetro Criptografado ao arquivo pmsfdc.ini e configure o parâmetro da seguinte forma: Use DEFAULT para senhas criptografadas com o tipo de criptografia CRYPT_DATA. Use SYSTEM para senhas criptografadas com o tipo de criptografia CRYPT_SYSTEM. 6 Capítulo 2: Instalação e Configuração

16 Configurando Opções de Proxy HTTP para o Serviço de Integração do PowerCenter Se a sua organização usa um servidor proxy para acessar a Internet, você deve definir as configurações de autenticação de servidor proxy HTTP para o Serviço de Integração do PowerCenter. Para configurar as opções de proxy HTTP para o Serviço de Integração do PowerCenter: 1. Abra a ferramenta Administrator. 2. Clique na guia Administração e, em seguida, selecione o Serviço de Integração do PowerCenter. 3. Clique na guia Propriedades. 4. Clique em Editar na seção Propriedades de Proxy HTTP. 5. Configure as propriedades descritas na seguinte tabela: Propriedade Host do servidor proxy HTTP HttpProxyPort HttpProxyUser HttpProxyPassword HttpProxyDomain Descrição Nome do servidor proxy HTTP. Número de porta do servidor proxy HTTP. Nome de usuário autenticado para o servidor proxy HTTP. Senha para usuário autenticado. Domínio para autenticação. Desinstalando o PowerExchange for Salesforce É possível desinstalar o PowerExchange for Salesforce ao desinstalar o PowerCenter. Para obter mais informações sobre a desinstalação do PowerCenter, consulte o Guia de Instalação do PowerCenter. Informações da Versão O PowerExchange for Salesforce inclui novos recursos e comportamento alterado. Novos Recursos O PowerExchange for Salesforce inclui novos recursos. Deslocamento de Intervalo de Liberação do CDC Nas versões e HotFix 3, você pode configurar um deslocamento de intervalo de liberação do CDC para capturar dados em tempo real, que são enviados dentro do limite de tempo do CDC, mas não são confirmados pelo Salesforce dentro do limite de tempo. Desinstalando o PowerExchange for Salesforce 7

17 Prefixo para Nomes de Arquivos de Log de Sucesso e de Erros Vigorando a partir da versão HotFix 1, você pode adicionar um prefixo a nomes de arquivos de log de sucesso e de erros. Senha de Conta de Proxy HTTP Criptografada Vigorando a partir da versão 9.5.0, você pode usar uma senha de conta de proxy HTTP criptografada. Use o programa da linha de comando do PowerCenter, pmpasswd, para criptografar a senha. Definir Campos como NULL com a API em Massa Vigorando a partir da versão HotFix 3, você pode configurar uma sessão de API em Massa para substituir valores no destino por valores nulos da origem. Use a propriedade da sessão existente Definir Campos como NULL ao configurar uma sessão de API em Massa. Logs de Sucesso e de Erros de API em Massa Vigorando a partir da versão HotFix 2, você pode gerar logs de sucesso e de erros separadamente para sessões de API em Massa. Ao monitorar uma sessão de API em massa, você pode usar a propriedade da sessão Usar Arquivo de Sucesso SFDC para gerar um arquivo de sucesso e a propriedade da sessão Usar Arquivo de Erro SFDC para gerar um arquivo de erro. Truncar Dados de Overflow para Destinos do Salesforce Vigorando a partir da versão 9.1.0, você pode configurar uma sessão para que o Salesforce execute o truncamento de dados de destino de overflow e grave dados truncados em um destino do Salesforce. Por padrão, o Serviço de Integração do PowerCenter grava dados de overflow para o arquivo de erros da sessão. Servidores Proxy HTTP de Autenticação Forçada Vigorando a partir da versão 9.1.0, o PowerExchange for Salesforce oferece suporte a servidores proxy HTTP de autenticação forçada. Sessões de API em Massa do Salesforce Vigorando a partir da versão 9.0.1, você pode usar a API em Massa do Salesforce para carregar dados em massa em um destino do Salesforce. A API em Massa do Salesforce pode inserir, atualizar e excluir registros e realizar o upsert deles. Em uma sessão de API em Massa, você pode executar carregamentos paralelos ou seriais, registrar informações sobre o processamento em lotes no log da sessão e criar logs sucesso e de erros. Por padrão, o PowerExchange for Salesforce usa a API padrão do Salesforce. Exibindo Logs de Sessão no Nível de Registro Vigorando a partir da versão , o Serviço de Integração do PowerCenter gera logs no nível de registro para cada sessão que grava em um destino do Salesforce. O Serviço de Integração do PowerCenter gera os seguintes tipos de logs: Log de sucesso. O log de sucesso contém uma entrada para cada registro que é inserido, atualizado, excluído ou submetido a upsert com sucesso. Cada entrada contém os valores carregados para todos os campos do registro. Use este arquivo para entender quais dados são carregados no destino do Salesforce. 8 Capítulo 2: Instalação e Configuração

18 Log de erros. O log de erros contém uma entrada para cada erro de dados. Cada entrada de log contém os valores para todos os campos do registro e a mensagem de erro. Use este arquivo para entender por que os registros não foram carregados no destino do Salesforce. Nota: Os logs da sessão do PowerExchange for Salesforce são diferentes dos logs da sessão do PowerCenter. Os logs da sessão do PowerExchange for Salesforce contêm detalhes no nível de registro que são específicos de sessões com destinos do Salesforce. Você também pode usar os logs da sessão do PowerCenter para exibir informações sobre as tarefas realizadas pelo Serviço de Integração do PowerCenter, erros gerais de sessão, o resumo de carregamento e as estatísticas de transformação da sessão. Você pode configurar se o Serviço de Integração do PowerCenter gera os logs de sucesso e erros e os diretórios em que os logs são armazenados. Capturando Registros Excluídos e do Arquivo Morto do Salesforce Vigorando a partir da versão , o Serviço de Integração do PowerCenter pode capturar registros excluídos e do arquivo morto de um objeto de origem do Salesforce. Por padrão, mapeamentos não capturam registros excluídos ou do arquivo morto. Suportando Contas do Salesforce Professional Edition Vigorando a partir da versão , o Serviço de Integração do PowerCenter pode extrair dados de contas do Salesforce Professional edition e carregar dados nelas. Mesclando Registros Duplicados do Salesforce Vigorando a partir da versão , o PowerExchange for Salesforce contém a transformação de Mesclagem do Salesforce. Use a transformação de Mesclagem do Salesforce para mesclar registros duplicados em um único registro. Validando Valores de Lista de Seleção do Salesforce Vigorando a partir da versão , o PowerExchange for Salesforce contém a transformação de Lista de Seleção do Salesforce. Use a transformação de Lista de Seleção do Salesforce para recuperar valores de lista de seleção do Salesforce e armazená-los no repositório do PowerCenter. Use os valores de lista de seleção para validar os valores que são carregados em um destino do Salesforce. Comportamento Alterado O PowerExchange for Salesforce inclui comportamento alterado. Versão da API do Salesforce Em vigor a partir da versão HotFix 1, o PowerExchange para Salesforce usa a versão 27.0 da API do Salesforce. Use a URL de serviço do Salesforce para configurar conexões ao Salesforce. Para usar a versão mais recente da API do Salesforce, crie uma nova conexão de aplicativo ou atualize a URL de serviço em uma conexão de aplicativo existente. A versão 27.0 da URL de serviço do Salesforce é: Informações da Versão 9

19 Se a nova versão de um objeto Salesforce tem uma estrutura diferente da versão anterior do objeto, reimporte o objeto Salesforce. Após reimportar o objeto, analise o mapeamento associado para determinar se você precisa atualizar o mapeamento. A tabela a seguir mostra os URLs de serviço padrão para versões anteriores do PowerExchange for Salesforce: Versão do PowerExchange for Salesforce URL de Serviço do Salesforce HotFix HotFix 3, HotFix HotFix , HotFix HotFix 1, HotFix 2 e e , e Gerando Arquivos de Sucesso e de Erros de API em Massa Vigorando a partir da versão HotFix 2, logs de sucesso e de erros não são mais gerados por padrão quando você monitora uma sessão de API em Massa. Para gerar logs de sucesso e de erros para sessões de API em Massa, selecione as propriedades da sessão Usar Arquivo de Sucesso SFDC ou Usar Arquivo de Erro SFDC e selecione a propriedade da sessão Monitorar Trabalho em Massa Até Que Todos os Lotes Sejam Processados para monitorar a sessão. Anteriormente, logs de sucesso e erros eram gerados por padrão quando você monitorava uma sessão de API em Massa, e não era possível gerar os logs separadamente. Convertendo Dados de Hora Vigorando a partir da versão 9.0.1, o PowerExchange for Salesforce ajustará a data ao converter o tipo de dados de transformação de Date/Time do PowerCenter no tipo de dados de hora do Salesforce. Anteriormente, ao configurar um mapeamento para gravar no tipo de dados de hora do Salesforce, você precisava ajustar o tipo de dados de transformação de Date/Time. Os mapeamentos existentes são não afetados por essa alteração. 10 Capítulo 2: Instalação e Configuração

20 Especificando o campo de ID para uma Operação de Upsert Vigorando a partir da versão HotFix5, você pode especificar o campo de ID a ser usado para uma operação de upsert em um destino do Salesforce. Anteriormente, quando você configurava uma sessão para realizar o upsert de registros em um destino do Salesforce, e o destino do Salesforce tinha vários campos de ID externo ou idlookup, o Serviço de Integração do PowerCenter usava o primeiro campo de ID externo ou idlookup para identificar os registros de destino existentes. Atualizando o Plug-in de Repositório Vigorando a partir da versão 8.6.1, você deve atualizar o plug-in do repositório. TÓPICOS RELACIONADOS: Atualizando o Plug-in de Repositório na página 11 Configurando Datas para Change Data Capture Vigorando a partir da versão 8.6.1, você pode usar o campo SystemModstamp ou LastModifiedDate para uma sessão de captura de dados alterados com base em período de tempo. O padrão é LastModifiedDate. Quando você atualizar para a versão 8.6.1, as sessões existentes continuarão a usar o campo LastModifiedDate. Para melhorar o desempenho da sessão, configure as sessões para usar o campo SystemModstamp. O Salesforce indexa o campo SystemModstamp, não o campo LastModifiedDate. Anteriormente, todas as sessões usavam o campo LastModifiedDate. Realizando Upsert de Registros com Base em um Campo idlookup do Salesforce Vigorando a partir da versão 8.6.1, você pode usar os campos de ID externo ou idlookup do Salesforce para realizar o upsert de registros em um objeto Salesforce. Anteriormente, você precisava usar o ID externo para realizar o upsert de registros. Informações da Versão 11

21 Convertendo Tipos de Dados Vigorando a partir da versão 8.6.1, o PowerExchange for Salesforce dá suporte às seguintes conversões de tipos de dados: Tipo de Dados do Salesforce Intervalo e Descrição Tipo de Dados do PowerCenter Intervalo e Descrição String criptografada Campos de texto criptografado contêm qualquer combinação de letras, números ou símbolos que são armazenados em formato criptografado. String 1 a caracteres hora Valores de hora. Date/Time Precisão de 1 a 28 dígitos, escala de 0 a 28. O Serviço de Integração do PowerCenter adiciona a data atual à hora durante a conversão do tipo de dados de hora do Salesforce no tipo de dados de transformação de Date/Time. Anteriormente, o PowerExchange for Salesforce não dava suporte aos tipos de dados encryptedstring ou Hora do Salesforce. Manipulando Valores Nulos em Operações de Atualização e Upsert Vigorando a partir da versão , você pode configurar o Serviço de Integração do PowerCenter para substituir valores existentes em um registro do Salesforce por valores nulos de uma origem durante uma operação de atualização ou upsert. Por padrão, o Serviço de Integração do PowerCenter não substitui valores existentes por valores nulos. Anteriormente, o Serviço de Integração do PowerCenter substituía valores existentes por valores nulos por padrão. Quando você atualiza, todas as sessões não são configuradas para substituir valores existentes por valores nulos. Para atualizar o valor existente com valores nulos, configure a propriedade da sessão Definir Campos como NULL. Realizando Upsert de Registros de Objetos Relacionados Vigorando a partir da versão , o Serviço de Integração do PowerCenter pode realizar o upsert de registros de mais de dois objetos relacionados em um objeto de destino do Salesforce. Anteriormente, você podia realizar o upsert de registros de um ou dois objetos relacionados. 12 Capítulo 2: Instalação e Configuração