Guia do ISVforce - developerforce.comdeveloperforce.com/guides/pt/BR/isvforce/isvforce.pdf ·...

226
Version 29.0: Winter 14 Guia do ISVforce © Copyright 20002013 salesforce.com, inc. Todos os direitos reservados. Salesforce.com é uma marca registrada da salesforce.com, inc., assim como outros nomes e marcas. Outras marcas que aparecem neste documento podem ser marcas comerciais de seus respectivos proprietários.

Transcript of Guia do ISVforce - developerforce.comdeveloperforce.com/guides/pt/BR/isvforce/isvforce.pdf ·...

  • Version 29.0: Winter 14

    Guia do ISVforce

    Copyright 20002013 salesforce.com, inc. Todos os direitos reservados. Salesforce.com uma marca registrada da salesforce.com, inc.,assim como outros nomes e marcas. Outras marcas que aparecem neste documento podem ser marcas comerciais de seus respectivos

    proprietrios.

  • Contedo

    Captulo 1: Introduo.........................................................................................................................1Funes no ciclo de vida do aplicativo.......................................................................................................................................2

    Captulo 2: ISVforce Incio rpido........................................................................................................3Tutorial n 1: Inscrio..............................................................................................................................................................4

    Etapa 1: Inscreva-se para o Programa de parceiro.........................................................................................................4Etapa 2: Gerar ambientes de desenvolvimento e de teste..............................................................................................5Etapa 3: Obtenha uma Business Org............................................................................................................................5Etapa 4: Edite sua listagem do editor............................................................................................................................6Resumo da inscrio......................................................................................................................................................7

    Tutorial #2: Desenvolvimento de seu aplicativo........................................................................................................................7Etapa 1: Criar um aplicativo..........................................................................................................................................7Etapa 2: Empacote seu aplicativo..................................................................................................................................9Etapa 3: Atribuir um namespace...................................................................................................................................9Etapa 4: Carregar uma verso beta................................................................................................................................9Etapa 5: Instalar e testar a verso beta.........................................................................................................................10Resumo do desenvolvimento.......................................................................................................................................11

    Tutorial #3: Publicao e licenciamento..................................................................................................................................11Etapa 1: Carregamento para o AppExchange.............................................................................................................11Etapa 2: Crie sua listagem de aplicativos.....................................................................................................................12Etapa 3: Complete sua listagem..................................................................................................................................12Etapa 4: Instale o LMA...............................................................................................................................................13Etapa 5: Licenciamento e gerenciamento de aplicativo...............................................................................................14Resumo de publicao e licenciamento........................................................................................................................14

    Tutorial n 4: Atualizao de seu aplicativo.............................................................................................................................14Etapa 1: Criando uma Organizao de correes........................................................................................................15Etapa 2: Desenvolvimento de uma correo................................................................................................................16Etapa 3: Carregando a correo...................................................................................................................................16Etapa 4: Instalar e atualizar automaticamente uma correo.......................................................................................17Resumo da atualizao de seu aplicativo......................................................................................................................17

    Captulo 3: Arquitetura e desenvolvimento do aplicativo......................................................................19Entendendo pacotes gerenciados e no gerenciados................................................................................................................20

    Planejando o lanamento de pacotes gerenciados........................................................................................................20Componentes disponveis........................................................................................................................................................21

    Editando componentes e atributos aps a instalao...................................................................................................25Componentes adicionados automaticamente a pacotes...............................................................................................30

    Comportamento especial dos componentes nos pacotes..........................................................................................................32Componentes protegidos.............................................................................................................................................41

    Consideraes sobre a arquitetura para Group Edition e Professional Edition.......................................................................41Recursos disponveis na Group Edition e na Professional Edition..............................................................................42Limites para Group Edition e Professional Edition....................................................................................................43Controle de acesso na Group Edition e na Professional Edition.................................................................................43

    Version 29.0 | Sumrio | i

  • Usando o Apex na Group Edition e na Professional Edition......................................................................................44Acesso API na Group Edition e na Professional Edition.........................................................................................44

    Acessando a API REST na Group Edition e na Professional Edition............................................................45Projetando seu aplicativo para oferecer suporte a mltiplas edies.............................................................................46

    Suporte a vrias edies usando um pacote de extenso...................................................................................46Suporte a vrias edies usando o Apex dinmico...........................................................................................47

    Os cenrios do projeto de amostra para as Group Edition e Professional Edition......................................................47Noes bsicas sobre dependncias..........................................................................................................................................48Criando aplicativos em pacote com o Chatter ........................................................................................................................49Correspondendo aparncia do Salesforce..............................................................................................................................50Desenvolvendo documentao de aplicativo............................................................................................................................50Criao de configuraes de perfil personalizadas...................................................................................................................51Sobre conjuntos de permisses e configuraes do perfil.........................................................................................................52Viso geral de aplicativos conectados.......................................................................................................................................54

    Criando um Aplicativo conectado...............................................................................................................................54Editando, empacotando ou excluindo um aplicativo conectado..................................................................................57Instalando um Aplicativo conectado............................................................................................................................58Exibindo detalhes de aplicativo conectado...................................................................................................................58Gerenciando um aplicativo conectado.........................................................................................................................59Editando um Aplicativo conectado..............................................................................................................................59Monitoramento de uso de um Aplicativo conectado...................................................................................................60Desinstalando um Aplicativo conectado......................................................................................................................61

    Sobre o WSDL do parceiro.....................................................................................................................................................61Trabalhando com servios externos.........................................................................................................................................62

    Provisionamento de servios externos..........................................................................................................................62Protegendo sua propriedade intelectual...................................................................................................................................63Hub de ambiente.....................................................................................................................................................................63

    Configurando o Hub de ambiente...............................................................................................................................64Configurando Meu domnio para o Hub de ambiente................................................................................................66Prticas recomendadas para o Hub de ambiente..........................................................................................................67Conectando uma organizao ao Hub de ambiente.....................................................................................................67Exibindo os detalhes de um membro do Hub de ambiente.........................................................................................68Editando os detalhes de um membro do Hub de ambiente.........................................................................................70Criando uma nova organizao a partir do Hub de ambiente......................................................................................70Ativando login nico no Hub de ambiente..................................................................................................................71Desativando login nico no Hub de ambiente.............................................................................................................72Mapeando usurios para login nico no Hub de ambiente..........................................................................................72

    Captulo 4: Empacotamento e teste do seu aplicativo............................................................................74Registrando um prefixo de namespace....................................................................................................................................75O que so as verses beta de pacotes gerenciados?...................................................................................................................75Criando e carregando um pacote beta.....................................................................................................................................76Sobre os ambientes de desenvolvimento e teste do parceiro....................................................................................................77Como se inscrever para ambientes de teste..............................................................................................................................77Instalando um pacote...............................................................................................................................................................77

    Version 29.0 | Sumrio | ii

  • Disponibilidade do componente depois da implantao..............................................................................................79Configurando pacotes instalados.................................................................................................................................79Resoluo de problemas de instalao..........................................................................................................................81

    Desinstalando um pacote.........................................................................................................................................................82Instalando pacotes gerenciados usando a API.........................................................................................................................83Criando e carregando um pacote gerenciado...........................................................................................................................84Sobre verses do pacote...........................................................................................................................................................85Executando o Apex em instalao/atualizao de pacotes.......................................................................................................86Executando o Apex na desinstalao de pacotes......................................................................................................................89

    Captulo 5: Passando pela anlise de segurana....................................................................................92Sobre a anlise de segurana....................................................................................................................................................93Etapas da anlise de segurana................................................................................................................................................93O Questionrio de anlise de segurana..................................................................................................................................95Criar uma AppExchange Publishing Organization.................................................................................................................96Alterar sua AppExchange Publishing Organization................................................................................................................97Atualizar a verso do pacote em sua listagem do AppExchange..............................................................................................97Envio de um aplicativo mvel para anlise de segurana.........................................................................................................98Envio de um pacote de extenso para anlise de segurana.....................................................................................................99Recursos na anlise de segurana.............................................................................................................................................99Perguntas frequentes sobre a anlise de segurana...................................................................................................................99

    Quanto tempo leva a anlise de segurana? Com que frequncia ela necessria?....................................................100H alguma taxa?.........................................................................................................................................................101Por que preciso testar meu aplicativo antes da anlise se a equipe de segurana vai test-lo de qualquer forma?.......101Posso enviar meu aplicativo antes de conclu-lo para que eu possa realizar o processo de anlise de segurana

    antecipadamente?.................................................................................................................................................101Por que a equipe de anlise precisa testar a parte X ou Y da minha oferta?...............................................................102Preciso corrigir todos os problemas relatados pela equipe da anlise de segurana?...................................................102Por que a equipe da anlise de segurana no pode me enviar cada ocorrncia de cada descoberta da minha

    anlise?.................................................................................................................................................................103Se eu atualizar meu aplicativo, preciso pagar novamente a taxa da anlise de segurana para que ele seja revisto?.....103Quando eu criar um novo pacote gerenciado (efetivamente uma atualizao do meu primeiro aplicativo), precisarei

    pagar novamente a taxa para que a segurana dele seja analisada?........................................................................103Por que preciso fazer anlises de segurana peridicas?.............................................................................................104Compreendo que solues analisadas podem funcionar com organizaes da PE e GE. Como isso funciona?........104

    Captulo 6: Publicando seu aplicativo................................................................................................105O que o AppExchange?......................................................................................................................................................106

    Vendendo no AppExchange......................................................................................................................................106Como o AppExchange funciona?..............................................................................................................................106Quem pode usar o AppExchange?.............................................................................................................................107

    Gerenciando suas organizaes do Salesforce........................................................................................................................107Publicando seu aplicativo ou servio......................................................................................................................................108

    Publicao de um aplicativo no AppExchange..........................................................................................................108Criando ou editando seu perfil do fornecedor............................................................................................................108

    Version 29.0 | Sumrio | iii

  • Criando ou editando uma listagem........................................................................................................................................109Incluso da marca em seu aplicativo......................................................................................................................................117Enviando sua listagem para aprovao...................................................................................................................................117Registrando seu pacote e escolhendo configuraes de licena..............................................................................................119Notificaes por email...........................................................................................................................................................119Usando o Checkout do AppExchange..................................................................................................................................120Perguntas frequentes do AppExchange Checkout................................................................................................................121Trabalhando com leads do AppExchange.............................................................................................................................123Relatrios analticos para editores..........................................................................................................................................125

    Relatrio Instalaes (Adquirir agora).......................................................................................................................127Relatrio de leads.......................................................................................................................................................127Relatrio de recursos e promoes.............................................................................................................................127Relatrio de test drives, demonstraes e telas...........................................................................................................128Saiba mais, vdeos e relatrio de telas........................................................................................................................128

    Perguntas frequentes sobre o AppExchange..........................................................................................................................129

    Captulo 7: Gerenciando licenas e fornecendo suporte administrativo................................................135Viso geral do Aplicativo de gerenciamento de licena (LMA)............................................................................................136

    Entendendo o gerenciamento de licenas..................................................................................................................136Diagrama de relacionamentos de entidades...............................................................................................................136Terminologia do LMA..............................................................................................................................................137

    Instalao do LMA...............................................................................................................................................................138Configurao do LMA..........................................................................................................................................................139Associao de um pacote ao seu LMO..................................................................................................................................140

    Padres de licena......................................................................................................................................................141Utilizao do LMA...............................................................................................................................................................141

    Sobre Leads...............................................................................................................................................................142Sobre pacotes.............................................................................................................................................................142

    Detalhes do pacote.........................................................................................................................................142Editando os proprietrios do pacote..............................................................................................................143Editando o gerenciador de lead para um pacote............................................................................................144

    Sobre verses do pacote.............................................................................................................................................144Detalhes da verso do pacote.........................................................................................................................145

    Sobre licenas............................................................................................................................................................145Detalhes da licena........................................................................................................................................146Editando os proprietrios de licena..............................................................................................................147Editando licenas...........................................................................................................................................148

    Integrao com vendas e marketing.......................................................................................................................................149Prticas recomendadas...........................................................................................................................................................150Perguntas frequentes sobre o Aplicativo de Gerenciamento de Licena................................................................................151Soluo de problemas............................................................................................................................................................151

    Captulo 8: Fornecendo uma avaliao gratuita do seu aplicativo.........................................................153Por que usar Trialforce?.........................................................................................................................................................154Viso geral do Trialforce.......................................................................................................................................................154

    Version 29.0 | Sumrio | iv

  • Configurando o Trialforce.....................................................................................................................................................155Vinculao de um pacote sua AppExchange Publishing Organization...................................................................156Vinculao de um pacote sua Organizao de gerenciamento de licenas...............................................................156Solicitando uma Organizao de gerenciamento do Trialforce.................................................................................157Configurando a marca personalizada para o Trialforce..............................................................................................158

    Criando e-mails com marca...........................................................................................................................158Criando uma pgina de login marcada...........................................................................................................159

    Criando uma Organizao de origem do Trialforce..................................................................................................160Vinculando uma Organizao de origem do Trialforce APO.................................................................................160Criando um modelo Trialforce..................................................................................................................................161Avaliando um modelo do Trialforce..........................................................................................................................162

    Fornecendo uma avaliao gratuita no AppExchange...........................................................................................................162Proporcionando uma avaliao gratuita do AppExchange usando o Trialforce.........................................................162Configurando um test drive no AppExchange..........................................................................................................163Proporcionando uma avaliao gratuita do AppExchange com seu aplicativo instalado............................................164

    Fornecendo uma avaliao gratuita no seu website................................................................................................................164Solicitando um formulrio de inscrio para o Trialforce..........................................................................................164Vinculando um modelo do Trialforce ao formulrio de inscrio..............................................................................165Personalizao do formulrio de registro HTML......................................................................................................165Fornecendo novas organizaes de avaliao.............................................................................................................166

    Modificando a avaliao para uma atualizao......................................................................................................................167Prticas recomendadas do Trialforce.....................................................................................................................................167Criando inscries usando a API...........................................................................................................................................167

    Solicitao de inscrio..............................................................................................................................................168Incio da solicitao de inscrio................................................................................................................................174Criando uma solicitao de inscrio.........................................................................................................................174Exibindo detalhes da solicitao de inscrio.............................................................................................................175Adicionando campos personalizados a solicitaes de inscrio................................................................................176Executando relatrios em solicitaes de inscrio....................................................................................................176Usando acionadores com solicitaes de inscrio.....................................................................................................177Criando inscries de proxy para acesso API e ao OAuth......................................................................................177

    Perguntas frequentes do Trialforce........................................................................................................................................179

    Captulo 9: Dando suporte aos seus assinantes...................................................................................181Guia Suporte (Support).........................................................................................................................................................182Console de suporte do assinante............................................................................................................................................182

    Exibindo detalhes do assinante..................................................................................................................................183Solicitando acesso de login........................................................................................................................................183Efetuando login s organizaes do assinante............................................................................................................184

    Prticas recomendadas...................................................................................................................................184Soluo de problemas em organizaes de assinantes................................................................................................184

    Captulo 10: Atualizando seu aplicativo.............................................................................................185Criando e carregando correes.............................................................................................................................................187Trabalhando com verses de correo...................................................................................................................................188

    Version 29.0 | Sumrio | v

  • Controle de verses do cdigo Apex......................................................................................................................................189Efeitos da depreciao do Apex para os assinantes....................................................................................................190

    Captulo 11: Atualizao automtica..................................................................................................192Sobre atualizaes automticas..............................................................................................................................................193Prticas recomendadas para a atualizao automtica............................................................................................................194Atribuindo acesso a novos componentes e campos................................................................................................................195Exemplo de script de ps-instalao para uma atualizao automtica.................................................................................195Conhea as limitaes da atualizao automtica..................................................................................................................197Agendando upgrades automticos.........................................................................................................................................197Exibindo detalhes do upgrade automtico.............................................................................................................................198Exibindo o histrico de atualizaes de uma organizao.....................................................................................................200

    Apndices........................................................................................................................................201

    Apndice A: Desenvolvendo e distribuindo pacotes no gerenciados..........................................201

    Apndice B: Comparao da licena de usurio do ISVforce.......................................................205

    Apndice C: Comparao de licena do usurio OEM...............................................................208

    Glossrio.........................................................................................................................................212

    ndice..............................................................................................................................................215

    Version 29.0 | Sumrio | vi

  • Captulo 1

    Introduo

    O ISVforce Guide (Guia do ISVforce) foi elaborado considerando fornecedoresde software independentes (ISV) que desejam criar e vender aplicativos criados

    Tpicos:

    Funes no ciclo de vida do aplicativo na plataforma do Force.com. Este guia est organizado segundo seguintescaptulos:

    Incio rpido Comece aqui a adquirir e configurar todos os ambientesnecessrios para criar e vender aplicativos.

    Arquitetura e desenvolvimento do aplicativo Antes de comear odesenvolvimento, importante saber como todas as peas se encaixam. Estecaptulo cobre as decises relacionadas arquitetura a serem consideradasantes do desenvolvimento.

    Empacotamento e teste do seu aplicativo Este captulo tambm cobreas especificidades acerca do desenvolvimento e teste de aplicativosempacotados.

    Passando pela anlise de segurana Saiba mais sobre as prticasrecomendadas de segurana e plano para uma anlise de segurana.

    Publicando seu aplicativo Liste seu aplicativo no marketplace doAppExchange.

    Gerenciando licenas e fornecendo suporte administrativo Use oAplicativo de gerenciamento de licena para gerenciar as licenas e aplicativosde seu cliente.

    Trialforce Crie uma avaliao gratuita para ajudar a vender seu aplicativopara clientes que no so cliente Salesforce.

    Dando suporte aos seus assinantes D suporte tcnico aos seus clientespara a instalao e uso de seu aplicativo.

    Atualizao Quando est na hora de fazer a atualizao de seu aplicativoempacotado, voc pode fazer atualizaes automticas de correessecundrias ou criar verses mais significativas.

  • Funes no ciclo de vida do aplicativoEste guia cobre todo o ciclo de vida do aplicativo de um pacote, de forma que alguns dos tpicos podem no ser relevantespara voc. A lista a seguir tem as sugestes de tpico por funo.

    Uma arquitetura de aplicativo

    A arquitetura do aplicativo determina o escopo do aplicativo e as estruturas internas que o suportam. Os arquitetosprecisam saber detalhes sobre a plataforma do Force.com subjacente que determinar no apenas o uso do aplicativo,mais quais edies ele suporta, como est instalado, configurado e atualizado. Os arquitetos precisam estar familiarizadoscom todo este guia, mas especialmente com os seguintes captulos: Arquitetura e desenvolvimento do aplicativo na pgina 19

    Passando pela anlise de segurana na pgina 92

    Um desenvolvedor cria, empacota e carrega um aplicativo

    Um desenvolvedor, ou frequentemente uma equipe de desenvolvedores, cria um aplicativo, o empacota e o carrega parao AppExchange. Os desenvolvedores tambm atualizam o aplicativo com correes de erro e novos recursos. Comodesenvolvedor, seria desejvel ver os seguintes captulos: Arquitetura e desenvolvimento do aplicativo na pgina 19

    Empacotamento e teste do seu aplicativo na pgina 74

    Desenvolvendo documentao de aplicativo na pgina 50

    Atualizando seu aplicativo na pgina 185

    Um editor distribui, vende e oferece suporte ao aplicativo

    O editor de um aplicativo a pessoa ou empresa que possui um perfil e uma ou mais listagens para o aplicativo noAppExchange. As listas do editor contm um link para um aplicativo carregado para o AppExchange, ou para um sitede terceiros. Os editores tambm definem as configuraes padro da licena. Como editor, seria desejvel ver os seguintescaptulos: Publicando seu aplicativo na pgina 105

    Fornecendo uma avaliao gratuita do seu aplicativo na pgina 153

    Dando suporte aos seus assinantes na pgina 181

    Um administrador instala o aplicativo

    Um administrador, ou admin, faz o download de seu aplicativo do AppExchange e instala-o na sua organizao. Osadministradores tambm podem personalizar o aplicativo para ajustar ainda mais s suas necessidades comerciais. Vejao tpico a seguir para saber como os administradores iro interagir com seu aplicativo. Instalando um pacote na pgina 77

    Version 29.0 | Funes no ciclo de vida do aplicativo | 2Introduo

  • Captulo 2

    ISVforce Incio rpido

    Este incio rpido foi criado para conduzi-lo pelo ciclo de vida do aplicativo omais rapidamente possvel. Aps a concluso, voc ter tudo que voc precisapara desenvolver e publicar um aplicativo empacotado.

    Tpicos:

    Tutorial n 1: Inscrio Tutorial #2: Desenvolvimento de seu

    aplicativo Nota: Voc deve ser um parceiro ISVforce/OEM para concluir todasas etapas desse incio rpido, pois ele cobre alguns recursos que somenteesto disponveis para parceiros qualificados.

    Tutorial #3: Publicao elicenciamento

    Tutorial n 4: Atualizao de seuaplicativo Como este incio rpido est organizado?

    Este incio rpido esto quebrado em quatro tutoriais, o que destinam-se a serlidos na ordem. Como algumas etapas exibem uma resposta de e-mailautomtica, o tempo para concluir as etapas pode variar. Entretanto, voc podeparar em qualquer etapa e recomear do ponto em que parou.

    O tutorial n 1 conduz voc pelo processo de inscrio para o Programa deParceiro ISV do Salesforce pelas formas de conseguir tudo o que precisa dasorganizaes (ambientes)..

    O tutorial n 2 o conduz na criao de um aplicativo Hello World simples. O tutorial n 3 ajuda voc a publicar e gerenciar seu aplicativo. O tutorial n 4 explica como atualizar seu aplicativo para verses importantes

    e secundrias.

    Tell Me More....No final de cada etapa existe uma seo opcional Conte-me mais. Se voc gostarde fazer coisas rapidamente, prossiga para a prxima etapa. Entretanto, se voc do tipo que gosta de ir mais lentamente, h vrias informaes teis aqui.

    Para uma lista de termos teis, veja o Glossrio na pgina 212. Para saber mais sobre o Force.com para acessar um conjunto cheio de

    recursos, visite o Developer Force em http://developer.force.com. Para uma introduo tranquila ao desenvolvimento do Force.com, consulte

    o Livro de exerccios do Force.com em http://developer.force.com/workbook.

    http://developer.force.comhttp://developer.force.com/workbook

  • Tutorial n 1: InscrioNeste tutorial, voc rene todas partes que precisa desenvolver, vender e para as quais precisa oferecer suporte em seus aplicativos.Tudo tem incio quando voc se inscreve para o Programa de Parceiro AppExchange. Isto dar acesso ao Portal do Parceiro,onde voc pode obter as organizaes de desenvolvimento e teste (ambientes ), e criar casos para outros recursos a seremhabilitados. O primeiro caso que voc registrar para a organizao de CRM que voc usa para gerenciamento da publicao,licenciamento e eventuais vendas de seu aplicativo. Embora voc no precise daquela organizao de imediato, mais fciltirar essas tarefas adminitrativas do caminho agora.

    Se voc j estiver familiarizado com o Salesforce, voc sabe que uma organizao uma nuvem em torno de si mesma. Se vocfor novo para o Salesforce, poder pensar em uma organizao como um ambiente separado em que voc pode desenvolver,testar ou publicar seu aplicativo.

    Figura 1: Organizaes (ambientes) so nuvens

    Etapa 1: Inscreva-se para o Programa de parceiroA primeira etapa inscrever-se no Programa de parceiro do AppExchange.

    1. Em seu navegador, acesse www.salesforce.com/partners e clique em Aderir agora (Join Now).2. Selecione a primeira caixa de seleo: Crie e comercialize aplicativos comerciais usando as tecnologias do salesforce.com

    (Fornecedor de software independente Parceiro ISV).3. Preencha os campos sobre voc e sua empresa.4. Na rea de perguntas adicionais, clique nas caixas suspensas e selecione a resposta apropriada.5. Insira as palavras Captcha exibidas e clique em Enviar registro (Submit Registration).6. Em um momento voc receber um e-mail com seu nome de usurio e senha temporria. Clique no link para o portal de

    parceiro (https://sites.secure.force.com/partners/PP2PartnerLoginPage) e faa o login.7. Aceite os termos de uso e, em seguida, descarte as pop-ups que aparecerem.8. Marque a pgina como favorita, voc a usar muito.

    Parabns, agora voc faz parte do Programa de Parceiro ISV do Salesforce!

    Version 29.0 | Tutorial n 1: Inscrio | 4ISVforce Incio rpido

    http://www.salesforce.com/partnershttps://sites.secure.force.com/partners/PP2PartnerLoginPage

  • Etapa 2: Gerar ambientes de desenvolvimento e de testePara criar e vender aplicativos na plataforma do Force.com, voc precisa de diferentes ambientes para diferentes tarefas.Chamamos estes ambientes de organizaes. fcil obter as organizaes necessrias por meio do Portal do parceiro. A primeiraorganizao que voc precisa a organizao Partner Developer Edition, que onde voc faz seu desenvolvimento e, no final,empacota seu aplicativo. Se voc j tem uma organizao da Developer Edition, voc tambm deve se inscrever na PartnerDeveloper Edition, porque isso permite mais armazenamento de dados, licenas e usurios.

    1. Voc deve estar conectado ao Portal do parceiro. Se no estiver, clique em seu favorito e faa login agora.2. No Portal de parceiros, na seo Links rpidos (Quick Links), clique em Criar uma organizao de teste (Create a Test

    Org).

    Figura 2: Crie uma org

    3. Na caixa suspensa Edio (Edition) e selecione Partner Developer Edition. Para simplificar, vamos nos referir a isso comosua dev org daqui em diante.

    4. Marque a caixa de seleo para aceitar os termos e clique em Enviar (Submit). Em alguns momentos, voc receber ume-mail com um link para login.

    5. Enquanto voc aguarda este e-mail, pode economizar tempo gerando outras organizaes que precisar. Depois disso, vocfar inscrio para uma organizao de teste, que usada para testar o aplicativo desenvolvido. Na rea Links rpidos (QuickLinks), clique em Criar uma organizao de teste (Create a Test Org) novamente, mas, dessa vez, escolhaEnterprise/Platform Edition. Para simplificar, vamos nos referir a isso como sua test org daqui em diante.

    6. Em breve, voc receber e-mails que solicitaro que voc faa login e altere sua senha para suas orgs dev e test. Clique nolink, altere sua senha e crie uma pergunta e resposta de segurana para a senha.

    Quero saber mais...Talvez voc tenha percebido que h alguns tipos diferentes de test orgs para as quais possvel se inscrever. As edies diferentesdo Salesforce tm recursos diferentes e, se voc planeja distribuir seu aplicativo para outras edies diferentes, pode ser importantetestar seu aplicativo e certificar-se de que ele funciona em cada uma delas. Isso est alm do escopo deste incio rpido. Paraobter mais informaes, consulte Consideraes de arquitetura para a Group Edition e a Professional Edition na pgina 41.

    Etapa 3: Obtenha uma Business OrgNa etapa anterior, voc obteve organizaes especificamente para desenvolvimento e teste. Para publicar seu aplicativo egerenciar suas licenas de aplicativo, voc precisar de uma organizao especificamente projetada para esta finalidade. Nestaetapa, voc registra um caso no Portal de parceiro para ter a ISV CRM Edition provisionada para voc. Pense nisso como suabusiness org, j que ela ser usada para publicar e gerenciar as vendas e distribuio de seu aplicativo.

    Nota: Este recurso est disponvel para parceiros elegveis. Para obter mais informaes sobre o Programa de parceiros,incluindo os requisitos de elegibilidade, visite-nos em www.salesforce.com/partners.

    1. No portal do parceiro, na seo Links rpidos (Quick Links), clique em Criar um caso (Create a Case).

    Version 29.0 | Etapa 2: Gerar ambientes de desenvolvimentoe de teste | 5

    ISVforce Incio rpido

    http://www.salesforce.com/partners

  • Figura 3: Criar um caso

    2. Na seo Categoria (Category), escolha a primeira opo.3. Na primeira caixa de categoria, selecione AppExchange e Listagens de servio (Service Listings).4. Na segunda caixa de categoria, selecione Solicitar CRM para o parceiro (Request CRM for Partner).5. Na caixa suspensa Razo (Reason), selecione Solicitao da administrao (Administration Request).6. Na caixa suspensa Severidade (Severity), selecione Alta (High).7. Em Assunto (Subject), insira Need ISV CRM.8. No campo Descrio (Description), informe se voc tem uma organizao existente ou se precisa de uma nova. Se voc j

    tem uma organizao do Salesforce existente, pode fornecer a ID da organizao no campo Descrio (Description) e duaslicenas CRM adicionais sero adicionadas sua organizao. Se voc no tem uma organizao existente, ns forneceremosuma nova para voc. Em qualquer situao, no esquea de inserir seu endereo comercial e, em seguida, clique em Salvar(Save).

    Figura 4: Crie um caso no Portal do parceiro

    9. Em breve voc receber outro e-mail, solicitando que voc faa login e altere sua senha. Faa isso e marque a pgina comofavorito, assim como fez anteriormente.

    Quero saber mais... Sua organizao de business pode ter muitos nomes. s vezes, ela pode ser citada como sua AppExchange Publishing

    Organization (APO), sua Organizao de gerenciamento de licenas (LMO) ou sua CRM ISV Edition. Ela todas essascoisas ao mesmo tempo, ento mais fcil simplesmente pensar nela como sua business org.

    Pode levar de 24h a 48h para que seu caso seja fechado. Voc pode olhar no status de seus casos no Portal do parceiroclicando em Meus casos (My Cases) no menu Links rpidos (Quick Links).

    Etapa 4: Edite sua listagem do editorNesta etapa, voc faz login no AppExchange e fornece informaes sobre sua empresa.

    Version 29.0 | Etapa 4: Edite sua listagem do editor | 6ISVforce Incio rpido

  • 1. Voc ainda deve se conectar sua business org. No canto superior direito, clique em Adicionar (Add) AppExchangeAplicativos (Apps).

    2. No canto superior direito, clique em Login ou registro (Login or Register).3. Na pgina de login, use seu nome de usurio e senha para sua business org.4. Clique na guia Publicao (Publishing).5. Clique em Perfil do seu provedor (Your Provider Profile).6. Preencha as informaes no Perfil do provedor e, em seguida, clique em Salvar (Save).

    Resumo da inscrioNeste primeiro tutorial, voc est inscrito no Programa de parceiro e em todas as organizaes para as quais voc precisadesenvolver, testar e vender seus aplicativos. Vamos analisar os itens em que voc se inscreveu e a finalidade de cada um deles.

    Programa de parceiro ISV

    O Programa de parceiro proporciona acesso ao Portal do parceiro, onde voc pode criar organizaes, registrar casos eencontrar informaes gerais sobre o Programa de parceiro.

    Partner Developer Edition

    Tambm conhecido como sua dev org, o lugar em que voc desenvolve seus aplicativos e, no final das contas, o empacotapara distribuio.

    Organizao de teste EE

    Tambm conhecida como sua test org, onde voc instala e testa seu aplicativo, exatamente como um cliente far.

    Organizao ISV do CRM

    Tambm conhecida como sua business org, esta organizao usada para publicao, licenciamento e gerenciamento deseu aplicativo a partir da perspectiva de negcios. Para ajudar a gerenciar sua licena, voc instalou o Aplicativo degerenciamento de licena (LMA) em sua business org.

    Tutorial #2: Desenvolvimento de seu aplicativoNeste tutorial, voc criar um aplicativo Hello World muito simples. Ele no far muita coisa, mas o suficiente para entenderonde o desenvolvimento acontece no ciclo de vida de um aplicativo empacotado.

    Etapa 1: Criar um aplicativoNesta etapa, voc vai criar um aplicativo que contm uma pgina e uma guia para exibir a pgina.

    1. Em seu navegador, conecte-se organizao da Partner Developer Edition. A partir de agora, ns a chamaremos de suadev org.

    2. Em Configurao, clique em Desenvolver > Pginas.3. Na lista Visualforce, clique em Novo (New).4. No campo Rtulo (Label) insira Greeting.5. Na rea de marcao do Visualforce, substitua o contedo da tag por Hello World.

    Version 29.0 | Resumo da inscrio | 7ISVforce Incio rpido

  • Figura 5: Pgina do editor do Visualforce

    6. Clique em Salvar.

    Agora voc associar a pgina com uma guia.

    1. No menu da barra lateral, clique em Criar (Create) > Guias (Tabs).2. Na lista da guia Visualforce, clique em Novo (New).3. No assistente da guia do novo Visualforce, clique na caixa suspensa e selecione a pgina Hello World que acabou de criar.4. Na guia Rtulo (Label) , insira Hello.5. Clique no campo Estilo de guia (Tab Style) e selecione qualquer cone para representar sua guia.6. Clique em Avanar (Next); em seguida, clique em Avanar (Next) novamente e em Salvar (Save) na pgina final.

    Agora, voc vai criar um novo aplicativo que contm sua guia e pgina.

    1. No menu da barra lateral, clique em Criar (Create) > Aplicativos (Apps).2. Clique em Novo.3. No campo Rtulo do aplicativo (App Label), insira sua Hello World e clique em Avanar (Next) e em Avanar (Next)

    novamente na pgina seguinte.4. Na pgina Selecionar as guias (Choose the Tabs), role para a parte inferior da lista Guias disponveis (Available Tabs),

    localize a guia Hello e adicione-a lista Guias selecionadas (Selected Tabs). Clique em Avanar.5. Marque a caixa de seleo Visvel (Visible) para tornar este aplicativo visvel e, em seguida, clique em Salvar (Save).

    Tell Me More....Parece que voc acabou de criar uma pgina em um continer dentro de outro continer. E voc est prestes a colocar tudoisso em outro continer! O que acontece com todos esses contineres e o que eles fazem?

    Uma guia um continer para coisas que voc deseja exibir na mesma pgina, como um grfico, uma tabela ou uma pginado Visualforce criada por voc.

    Um aplicativo um continer de guias que aparecem umas ao lado das outras. Quando voc cria um aplicativo, ele ficadisponvel no selecionador de aplicativos no canto superior direito da tela.

    Um pacote um continer para coisas que voc carrega no AppExchange. Normalmente, um pacote contm um aplicativoque seus clientes podem instalar em suas organizaes, mas voc tambm pode carregar pacotes que ampliam aplicativosexistentes. Voc no criou um pacote ainda, voc far isso na prxima etapa.

    Version 29.0 | Etapa 1: Criar um aplicativo | 8ISVforce Incio rpido

  • Etapa 2: Empacote seu aplicativoNesta etapa, voc empacotar seu aplicativo para que ele seja distribudo no AppExchange. Um pacote simplesmente umcontiner para componentes. Neste caso, seu aplicativo, guia e pgina.

    1. No menu da barra lateral, clique em Criar > pacotes (Create Packages) e, em seguida, clique em Novo (New).2. No campo Nome do pacote (Package Name), insira Hello World e, em seguida, clique em Salvar (Save).3. Na pgina Detalhe do pacote (Package Detail), clique em Adicionar componentes (Add Components).4. Selecione seu aplicativo de Hello World e, em seguida, clique em Adicionar ao pacote (Add to Package).

    Tell Me More....Quando voc clicou em Adicionar ao pacote (Add to Package), notou que sua guia Ol (Hello) e a pgina de Saudao(Greeting) foram automaticamente adicionadas ao pacote? Quando voc cria um pacote, a estrutura detecta automaticamentecomponentes dependentes e adiciona-os ao pacote.

    Etapa 3: Atribuir um namespaceNesta etapa voc escolher um identificador nico chamado namespace. O namespace diferencia seus componentes de outroscomponentes e permite que voc faa coisas como atualizar o aplicativo depois que ele tenha sido instalado. Escolhacuidadosamente seu namespace, pois ele no poder ser alterado posteriormente.

    1. In the sidebar menu, click Create > Packages.2. Na lista Configuraes do desenvolvedor (Developer Settings), clique em Editar (Edit) e, na pagina seguinte, clique em

    Continuar (Continue).3. No campo Prefixo de namespace (Namespace Prefix), insira um ID alfanumrico com 1 a 15 caracteres e, em seguida,

    clique em Verificar disponibilidade (Check Availability). Repita esta etapa at que voc tenha um namespace exclusivo.4. No campo Pacote a ser gerenciado (Package to be managed), selecione seu pacote Hello World e clique

    em Revisar suas selees (Review Your Selections).5. Revise as informaes na pgina e clique em Salvar (Save).

    Tell Me More....No cdigo subjacente, seu namespace est anexado como prefixo a todos os componentes empacotados em sua "dev org". Istopermite que seu pacote e seus contedos sejam diferenciados dos de outros desenvolvedores, e garante o controle exclusivo detodos os componentes empacotados.

    Etapa 4: Carregar uma verso betaAntes de carregar uma verso de produo de seu aplicativo, uma prtica comum carregar uma verso beta para teste.

    1. In the sidebar menu, click Create > Packages.2. Na pgina Pacotes (Packages), clique em sue pacote Hello World e, em seguida, clique em Carregar (Upload).3. Na pgina Carregar pacote (Upload Package), insira um nome e um nmero de verso.4. Em Tipo de verso (Release Type), certifique-se de selecionar Gerenciado Beta (Managed Beta).5. Scroll to the bottom and click Upload. Talvez leve algum tempo at que o upload seja concludo.

    Parabns, voc carregou um aplicativo para o AppExchange! Seu aplicativo no est disponvel para o pblico, mas voc podeacess-lo por meio de um link de instalao. Voc far isso na prxima etapa.

    Version 29.0 | Etapa 2: Empacote seu aplicativo | 9ISVforce Incio rpido

  • Tell Me More....Uma verso beta tem, como finalidade nica, o teste. Portanto, uma verso beta somente pode ser instalada em uma DeveloperEdition do test org, ou sandbox (falaremos sobre isso mais adiante). A seguir, voc instalar a verso beta no test org, criadona Etapa 2: Gerar ambientes de desenvolvimento e de teste.

    Etapa 5: Instalar e testar a verso betaInstalar a verso beta fcil, basta clicar no link e fornecer o nome de usurio e senha usados para seu "test org".

    1. Clique agora na URL de instalao.

    Figura 6: Link da URL de instalao

    2. Na pgina de login, insira o nome de usurio e senha de sua "test org".3. On the Package Installation Details page, click Continue.4. Clique em Avanar.5. Na pgina Nvel de segurana (Security Level), clique em Conceder acesso a todos os usurios (Grant access to all users)

    e clique em Avanar (Next).6. Clique em Instalar.7. Depois de concluda a instalao, voc poder selecionar seu aplicativo no selecionador de aplicativos no canto superior

    direito.

    Figura 7: Aplicativo Hello World

    8. Voc deve consultar sua guia Hello e o texto de saudao na sua pgina.

    Figura 8: Guia e pgina Hello World

    Version 29.0 | Etapa 5: Instalar e testar a verso beta | 10ISVforce Incio rpido

  • Neste ponto voc normalmente testaria o aplicativo e verificaria se ele funciona como projetado. Seu aplicativo instala e exibeo que voc deseja. Ento, vamos prosseguir.

    Tell Me More....Os pacotes beta tambm so instalados em sandboxes. Uma sandbox uma replicao da organizao de seu cliente que permiteque ele desenvolva, teste ou instale aplicativos e verifique as alteraes que deseja confirmar. Nenhuma das organizaes paraas quais voc se inscreveu neste livro de exerccios tem uma sandbox, mas se voc tem uma sandbox em outra organizao edeseja instalar seu aplicativo nela, voc deve substituir a parte inicial da URL instalao por http://test.salesforce.com.

    Resumo do desenvolvimentoParabns, voc acabou de concluir uma parte importante do ciclo de vida do desenvolvimento de software! Alteraes adicionaisao seu aplicativo seguiro o mesmo procedimento:

    1. Modifique o aplicativo existente em sua "dev org"2. Empacote o aplicativo.3. Carregue como um pacote beta.4. Instale a verso beta em uma "test org"5. Teste o aplicativo instalado.

    Tutorial #3: Publicao e licenciamentoImagine que voc passou por alguns ciclos de desenvolvimento com sua verso beta e est pronto para publicar um aplicativopblico. A prxima etapa carregar um aplicativo em produo, ou o que chamamos de verso gerenciada-liberada de seuaplicativo. Ento, possvel criar uma listagem para que outras pessoas possam encontrar seu aplicativo e saber o que ele faz.Finalmente, preciso conectar seu aplicativo sua "business org" para que voc possa gerenciar as licenas para as pessoas queinstalarem seu aplicativo.

    Etapa 1: Carregamento para o AppExchangeEsta etapa parecer familiar, ela semelhante ao carregamento de uma verso beta.

    1. Se voc acompanhou estas instrues sem interrupes, provavelmente ainda deve estar conectado sua "test org". V emfrente e conecte-se agora sua "dev org".

    2. Observe que, no canto superior direito, existe um link que diz: Desenvolvimento do Hello World, verso 1.0 (DevelopingHello World, version 1.0). Clique no link para ir diretamente para a pgina Detalhe do pacote (Package Detail).

    Figura 9: Developing Hello World, version 1.0

    3. Na pgina Detalhe do pacote (Package Detail), clique em Carregar (Upload).4. Em Tipo de verso (Release Type), selecione Gerenciado Liberado (Managed Released).5. Scroll to the bottom and click Upload.

    Version 29.0 | Resumo do desenvolvimento | 11ISVforce Incio rpido

  • 6. Clique em OK na janela pop-up.

    Etapa 2: Crie sua listagem de aplicativosNesta etapa, voc ir editar sua listagem de aplicativos e conectar sua "business org" ao seu aplicativo.

    1. Depois de carregar o pacote, voc ver um link para publicar no AppExchange, clique nele.

    Figura 10: Publique no AppExchange

    2. Ser apresentada uma caixa de dilogo para login. Dessa vez, use seu nome de usurio e senha para sua "business org".3. Leia e concorde com os termos e condies e, em seguida, clique em Eu concordo (I Agree).4. A primeira pergunta se voc j listou no AppExchange. Voc fez isso no Tutorial n 1: Inscrio, Etapa 4: Edite sua

    listagem do editor na pgina 6, ento, selecione Sim (Yes) e em seguida, clique em Continuar (Continue).5. Click Link New Organization.6. Voc ser solicitado a informar seu nome de usurio e senha. Insira os valores para sua "dev org".7. Click the Publishing tab.8. Clique em Criar nova lista (Create New Listing).9. Na janela pop-up, insira um Ttulo da listagem do Aplicativo Hello World por . preciso

    adicionar seu nome porque o ttulo da listagem deve ser exclusivo e ns no podemos ter ningum listando aplicativos HelloWorld genricos.

    10. Selecione o boto de seleo para Aplicativo (App) e, em seguida, clique em Enviar (Submit).11. Preencha os campos obrigatrios na pgina Informaes bsicas (Basic Information).12. Clique em Salvar.

    Sua listagem est ativa, mas ainda h algumas coisas a serem feitas, inclusive preencher as guias na parte superior. Isso serfeito na prxima etapa.

    Tell Me More....No fique preocupado demais em fazer com que sua listagem seja perfeita, ela ainda no pblica e voc poder alter-la aqualquer momento.

    Etapa 3: Complete sua listagemExistem outras guias na parte superior: Oferta (Offering), Viso geral (Overview), Especificaes (Specs), Suporte (Support),Contedo carregado (Uploaded Content) e Leads. preciso preencher os campos obrigatrios nestas guias antes que sualistagem esteja completa.

    1. Clique em Oferta (Offering).2. Para vincular seu aplicativo, clique em Alterar Pacotes (Change Packages).3. Selecione seu aplicativo e mova-o para a lista Selecionado (Selected), e clique em OK.

    Version 29.0 | Etapa 2: Crie sua listagem de aplicativos | 12ISVforce Incio rpido

  • 4. Na caixa suspensa com o rtulo Selecione a verso mais recente do seu aplicativo (Select thelatest version of your application), selecione seu aplicativo.

    5. Clique em Salvar.6. Clique na guia Viso geral (Overview).7. Selecione Livre (Free).8. Preencha o campo Descrio completa (Full Description) e clique em Salvar (Save).9. Clique na guia Especificaes (Specs).10. Clique em Alterar edies (Change Editions).11. Na janela pop-up, mova todas as edies para a lista Selecionado (Selected) e clique em Enviar (Submit).

    Nota: A pgina Visualforce criada est disponvel em todas as edies, mas isso nem sempre acontece com outrosrecursos. Antes de desenvolver um aplicativo completo, voc deve levar em considerao seu pblico-alvo e saberqual edio eles possuem. Para obter mais informaes sobre as edies e os recursos compatveis, consulte:Architectural Considerations for Group and Professional Editions na pgina 41

    12. Clique em Alterar idiomas (Change Languages).13. Selecione o idioma em que voc desenvolveu o aplicativo (provavelmente ingls) e, sem seguida, clique em Enviar (Submit).14. Clique em Salvar.

    As outras guias no tm nenhum campo obrigatrio. Deixe-os em branco por enquanto. possvel retornar e alterarposteriormente tudo aquilo que voc fez at agora.

    Etapa 4: Instale o LMAO Aplicativo de gerenciamento de licenas (LMA) ajuda voc a gerenciar as vendas, licenciamento e suporte de seu aplicativo.Para instalar o LMA, voc precisar registrar um caso no Portal do parceiro. Depois que seu caso estiver resolvido, instale oLMA em sua organizao de negcios.

    Nota: Este recurso est disponvel para parceiros elegveis. Para obter mais informaes sobre o Programa de parceiros,incluindo os requisitos de elegibilidade, visite-nos em www.salesforce.com/partners.

    1. Clique no link LMA no e-mail que voc recebeu.2. Voc pode ler o anncio do aplicativo e, em seguida, clicar em Adquirir agora (Get It Now).3. Na janela pop-up, selecione Em minha produo (In my production) Salesforce.4. Leia e aceite os termos e condies e, em seguida, clique em Instalar (Install).5. Confirme sua senha e clique em Enviar (Submit).6. Na pgina Detalhes de instalao do pacote (Package Installation Details), clique em Continuar (Continue).7. Clique em Avanar (Next), Avanar (Next) e Instalar (Install).8. Clique em Implantar agora (Deploy Now) e, na pgina seguida, clique em Implantar (Deploy).9. Clique no canto superior direito e ver que tem um novo aplicativo instalado.

    Version 29.0 | Etapa 4: Instale o LMA | 13ISVforce Incio rpido

    http://www.salesforce.com/partners

  • Figura 11: Aplicativo de gerenciamento de licenas

    Voc no usar o LMA imediatamente, primeiro, voc precisa desenvolver um aplicativo e public-lo. Voc far isso a seguir.

    Etapa 5: Licenciamento e gerenciamento de aplicativoNesta etapa voc conectar seu aplicativo ao Aplicativo de gerenciamento de licena (LMA) em sua "business org".

    1. Click the Publishing tab.2. Ao lado do pacote que voc carregou, clique em Gerenciar licenas (Manage Licenses).3. Click Register.4. Clique em Atribuir (somente uma vez) (Assign (One-Time Only)).5. Insira as credenciais de login de sua "business org" e clique em Enviar (Submit).6. Clique em Salvar.

    Pode levar at 30 minutos para que seu aplicativo se conecte ao LMA. Faa uma pausa, voc merece!

    Resumo de publicao e licenciamentoNeste tutorial, voc carregou seu aplicativo gerenciado-liberado para o AppExchange e criou uma listagem para seu aplicativo.Voc tambm instalou o Aplicativo de gerenciamento de licena e o vinculou a seu aplicativo. Voc pode usar o LMA tantopara gerenciar e renovar licenas quanto para definir configuraes de licenas padro. Por exemplo, voc pode licenciar seuaplicativo como uma avaliao gratuita que expira depois de um nmero de dias especificado. Para obter mais informaes,consulte Gerenciando licenas fornecendo suporte administrativo na pgina 135.

    Agora mesmo, seu aplicativo tem uma listagem privada no AppExchange que voc pode compartilhar com clientes potenciais,mas o pblico no o v, a menos que tenha o link. Antes que voc possa listar o aplicativo publicamente, precisar passar pelaanlise de segurana, mas esse tema est alm do escopo deste incio rpido. Para obter mais informaes, consulte Etapas daanlise de segurana na pgina 93.

    Tutorial n 4: Atualizao de seu aplicativoSe voc est familiarizado com o Salesforce, j sabe que fornecemos verses de correo semanais para corrigir erros e, algumasvezes por ano, distribumos uma verso mais significativa a fim de introduzir novos recursos. Como um ISV, voc pode fazera mesma coisa, distribuindo uma verso de correo para corrigir erros e uma verso mais significativa para novos recursos.

    Para novos recursos, o processo o mesmo que voc j experimentou anteriormente. Voc comea pela modificao de seuaplicativo, empacota-o, carrega uma verso beta, testa a verso beta e, depois, carrega uma verso gerenciada-liberada. Asverses mais significativas incrementam a verso para o prximo nmero inteiro, de 1.0 para 2.0, por exemplo, e as verses

    Version 29.0 | Etapa 5: Licenciamento e gerenciamento deaplicativo | 14

    ISVforce Incio rpido

  • menos significativas para o primeiro nmero aps o ponto, de 1.0 para 1.1. No existem regras rgidas sobre o que constituiuma verso mais ou menos significativa. Isso fica por sua conta.

    Para as correes de erros, o processo um pouco diferente. Voc comea criando uma "patch org", um ambiente especialque tem funcionalidade limitada e que somente pode ser usado para desenvolver uma correo de um pacote especfico.Depois de carregar sua correo, voc ter a opo de distribuir automaticamente a correo para seus clientes, de formaque eles obtenham as correes para seus erros na prxima vez que fizerem login. As verses menos significativas incrementamo nmero de verso para o segundo decimal, ou seja, de 1.0 para 1.0.1, por exemplo.

    As verses mais ou menos significativas devem ser instaladas pelos clientes (extradas). Entretanto, possvel instalarautomaticamente verses de correo diretamente nas organizaes do cliente. Este recurso est disponvel somente paraparceiros registrados do ISVforce/OEM. Para obter mais informaes sobre o Programa de parceiros, incluindo os requisitosde elegibilidade, visite-nos em www.salesforce.com/partners.

    Como o processo de desenvolvimento de uma verso mais significativa j familiar, vamos fazer uma verso de correo edistribu-la de forma automtica para nossos clientes.

    Etapa 1: Criando uma Organizao de correesPara criar uma correo, voc precisa gerar uma nova organizao de desenvolvimento de correes.

    Para criar uma verso de correo:

    1. Em Configurao, clique em Criar > Pacotes.2. Clique no nome do seu pacote gerenciado.3. Clique na guia Organizao de correes e, em seguida, clique em Novo.4. Selecione a verso do pacote para a qual voc deseja criar uma correo na lista suspensa Corrigindo a verso principal. O

    tipo de lanamento deve ser Gerenciado - Lanado.5. Digite um Nome de usurio para fazer login na organizao de correo.6. Digite um Endereo de email associado ao seu login.7. Clique em Salvar.

    Nota: Se voc perder as informaes de login, clique em Redefinir na pgina de detalhes do pacote em Organizaode desenvolvimento de correes para redefinir o login para sua organizao de desenvolvimento de correes.

    Em um instante, voc receber um e-mail com suas credenciais de login. Depois que estiver conectado e tiver alterado suasenha, prossiga para a prxima etapa.

    Tell Me More....O desenvolvimento em uma organizao de desenvolvimento de correo limitado. Segue uma lista de advertncias:

    Novos componentes do pacote no podem ser adicionados. Componentes existentes do pacote no podem ser excludos. Os controles de acesso da API e Apex dinmicos no podem ser alterados para o pacote. Nenhuma depreciao de nenhum cdigo do Apex. Nenhum relacionamento novo de classe do Apex, como extends, pode ser adicionado. Nenhum modificador novo de acesso do Apex, como virtual ou global, pode ser adicionado. Nenhum servio da Web novo pode ser adicionado. Nenhuma dependncia de novo recurso pode ser adicionada.

    Version 29.0 | Etapa 1: Criando uma Organizao decorrees | 15

    ISVforce Incio rpido

    http://www.salesforce.com/partners

  • Etapa 2: Desenvolvimento de uma correoEstamos fazendo uma simples alterao em seu aplicativo. Em vez de exibir somente um Hello World, voc adicionar a datade hoje.

    1. In your patch org, from Setup, click Create > Packages and click your Hello World package.2. Na lista de Componentes do pacote (Package Components), clique em sua pgina Saudao (Greeting).3. Clique em Editar.4. Logo aps a tag de fechamento, insira o seguinte:


    5. Clique em Salvar.6. Para ver o resultado, clique na guia Ol (Hello) e voc poder observar que o horrio e a data de hoje sero exibidos.

    Figura 12: Exibir a data e a hora

    Isto tudo o que voc precisa fazer nesta correo. Vamos prosseguir.

    Tell Me More....A funo !NOW retorna a data em um formato padro. Existem muitas funes integradas e maneiras de formatar a sada. Paraobter mais informaes, consulte o Visualforce Developer's Guide (Guia do desenvolvedor do Visualforce).

    Etapa 3: Carregando a correoNormalmente, a prxima etapa carregar uma correo beta e instal-la em uma organizao de teste. Como isto muitosemelhante Etapa 4: Carregar uma verso beta e Etapa 5: Instalar e testar a verso beta, que voc concluiu no Tutorial n2: Desenvolvimento de seu aplicativo, no obrigaremos voc a fazer isso novamente.

    1. In your patch org, from Setup, click Create > Packages and click your Hello World package.2. Na pgina Pacote de upload, clique em Upload.3. Insira um nome de verso, como por exemplo a data de hoje.4. Observe que o nmeroCorreo do Nmero da verso aumentou.5. Selecione Gerenciado Liberado (Managed Released).

    Version 29.0 | Etapa 2: Desenvolvimento de uma correo | 16ISVforce Incio rpido

    http://www.salesforce.com/us/developer/docs/pages/index.htm

  • 6. Como opo, insira e confirme a senha para compartilhar o pacote de modo privado com algum que tenha a senha. Noinsira uma senha se voc quiser tornar o pacote disponvel a qualquer pessoa no AppExchange e compartilhar o seu pacotepublicamente.

    7. O Salesforce seleciona automaticamente os requisitos que encontra. Alm disso, selecione qualquer outro componentenecessrio das sees Requisitos do pacote e Requisitos do objeto para notificar instaladores sobre requisitospara esse pacote.

    8. Clique em Carregar.

    Parabns, voc carregou uma verso de correo. preciso compartilhar esta correo com outras pessoas, e voc far isso aseguir.

    Etapa 4: Instalar e atualizar automaticamente uma correoExistem duas maneiras de entregar uma correo: voc pode fazer com seus clientes a instalem ou distribu-la automaticamentea eles. A distribuio automtica de atualizaes ocorre na prxima vez que seu cliente se conectar. Vamos tentar fazer isso.

    1. Conecte-se sua "dev org".2. No canto superior direito, clique em Desenvolvimento do Hello World, verso 1.0 (Developing Hello World, version

    1.0).

    Figura 13: Developing Hello World, version 1.0

    3. Na pgina Detalhe do pacote (Package Detail), clique em Upgrades automticos (Push Upgrades).4. Clique em Agendar upgrades automticos.5. Na lista suspensa Verso de correo (Patch Version), selecione a verso de correo a ser atualizada automaticamente.6. No campo Data de incio agendada (Scheduled Start Date), insira a data de hoje.7. Na seo Selecionar organizaes de destino (Select Target Organizations), selecione sua "test org".8. Clique em Agendar.

    E pronto! Voc distribuiu uma verso de correo para seus assinantes de forma que eles obtenham as atualizaesautomaticamente. Voc deve se certificar de que seus clientes receberam a correo para garantir que ela foi instalada comsucesso.

    Tell Me More....As verses beta no so elegveis para atualizaes automticas. Voc deve desinstalar uma verso beta e depois instalar umanova.

    Resumo da atualizao de seu aplicativoNeste tutorial voc aprendeu a atualizar seu aplicativo em uma "patch org" e a distribuir atualizaes automticas para seusclientes. Voc comeou criando uma "patch org" especfica para uma verso de pacote liberada. Depois, voc modificou seuaplicativo, carregou-o e programou a distribuio de atualizao automtica para seus clientes.

    Version 29.0 | Etapa 4: Instalar e atualizar automaticamenteuma correo | 17

    ISVforce Incio rpido

  • Parabns, voc terminou! Ou acabou de comear? possvel modificar seu aplicativo para ser qualquer coisa que voc queiraque ele seja, ou criar uma nova "dev org" no Portal do parceiro e criar outro aplicativo. possvel usar as mesmas "sales org"e "test org" e tudo mais que voc tenha configurado para publicar e gerenciar muitos aplicativos. Voc est a caminho do sucessocom o ISVforce!

    Version 29.0 | Resumo da atualizao de seu aplicativo | 18ISVforce Incio rpido

  • Captulo 3

    Arquitetura e desenvolvimento do aplicativo

    Esta seo contm conceitos importantes e decises relacionadas arquiteturaa serem consideradas antes de iniciar o desenvolvimento, como:

    Tpicos:

    Entendendo pacotes gerenciados eno gerenciados Componentes disponveis

    Limites para Group Edition e Professional Edition Componentes disponveis Comportamento especial dos

    componentes nos pacotes Protegendo sua propriedade intelectual

    Noes bsicas sobre dependncias Consideraes sobre a arquitetura

    para Group Edition e ProfessionalEdition Links relacionados

    Consideraes sobre a arquitetura para Group Edition e Professional Edition Noes bsicas sobre dependncias Criando aplicativos em pacote com o

    Chatter Correspondendo aparncia do

    Salesforce Desenvolvendo documentao de

    aplicativo Criao de configuraes de perfil

    personalizadas Sobre conjuntos de permisses e

    configuraes do perfil Viso geral de aplicativos conectados Sobre o WSDL do parceiro Trabalhando com servios externos Protegendo sua propriedade

    intelectual Hub de ambiente

  • Entendendo pacotes gerenciados e no gerenciadosOs pacotes vm em duas formas no gerenciados e gerenciados:

    Pacotes no gerenciados

    Pacotes no gerenciados geralmente so usados para distribuir projetos de cdigo fonte aberto ou modelos de aplicativoa fim de fornecer aos desenvolvedores as ferramentas bsicas para um aplicativo. Quando os componentes so instaladosde um pacote no gerenciado, os componentes podem ser editados na organizao em que esto instalados. O desenvolvedorque criou e carregou o pacote no gerenciado no tem controle sobre os componentes instalados e no pode alter-losnem atualiz-los. Os pacotes no gerenciados no devem ser usados para migrar componentes de um sandbox para aorganizao de produo. Em vez disso, use Conjuntos de alteraes.

    Pacotes gerenciados

    Geralmente, os pacotes gerenciados so usados pelos parceiros do salesforce.com para distribuir e vender aplicativos paraclientes. Esses pacotes devem ser criados a partir de uma organizao da Edio Developer. Usando o AppExchange eo LMA (License Management Application), os desenvolvedores podem vender e gerenciar licenas baseadas no usuriopara o aplicativo. Pacotes gerenciados tambm so totalmente atualizveis. Para garantir upgrades perfeitos, determinadasalteraes destrutivas, como a remoo de objetos ou campos, no podem ser executadas.

    Os pacotes gerenciados tambm oferecem os seguintes benefcios: Proteo propriedade intelectual do Apex

    Suporte integrado para controle de verso para componentes acessveis da API

    Capacidade de dividir e corrigir uma verso anterior

    Capacidade de enviar perfeitamente atualizaes de correo para assinantes

    Nomenclatura exclusiva de todos os componentes para garantir instalaes sem conflito

    As definies a seguir ilustram esses conceitos:

    Componentes

    O componente parte integrante de um pacote. Define um item, como um objeto personalizado ou campo personalizado.Voc pode combinar componentes em um pacote para produzir recursos ou aplicativos poderosos. Em um pacote nogerenciado, os componentes no podem sofrer upgrade. Em um pacote gerenciado, alguns componentes podem seratualizados, enquanto outros, no.

    Atributos

    O atributo um campo em um componente, como o nome de um modelo de email ou a caixa de seleo Permitirrelatrios em um objeto personalizado. Em um componente no atualizvel de um pacote no gerenciado ougerenciado, os atributos so editveis pelo desenvolvedor (quem criou o pacote) e pelo assinante (quem instalou o pacote).Em um componente passvel de upgrade em um pacote gerenciado, alguns atributos podem ser editados pelo desenvolvedor,outros podem ser editados pelo assinante e ainda outros ficam bloqueados, o que significa que eles no podem ser editadosnem pelo desenvolvedor nem pelo assinante.

    Planejando o lanamento de pacotes gerenciadosO lanamento de um pacote do AppExchange semelhante ao de qualquer outro programa quanto ao desenvolvimento desoftware. Convm implant-lo em iteraes para garantir que cada componente funcione conforme planejado. Pode at mesmohaver testadores beta que tenham se oferecido para instalar uma verso anterior de seu pacote e fornecer comentrios.

    Depois que voc o pacote, publicando-o no AppExchange, qualquer pessoa poder instal-lo. Portanto, planeje o lanamentocom cuidado. Revise os estados definidos a seguir para se familiarizar com o processo de lanamento. O Salesforce aplica

    Version 29.0 | Entendendo pacotes gerenciados e nogerenciados | 20

    Arquitetura e desenvolvimento do aplicativo

  • automaticamente o estado adequado a seu pacote e componentes dependendo das configuraes de carregamento escolhidase da fase em que est no processo de lanamento.

    DescrioEstado

    O pacote no foi convertido em um pacote gerenciado ou o componente no foiadicionado a um pacote gerenciado. Observe que um componente no estado

    No gerenciado (Unmanaged)

    Gerenciado - Beta (Managed - Beta) pode se tornar No gerenciado(Unmanaged) se for removido de um pacote gerenciado. Todos os pacotes so nogerenciados a menos que indicado de outra forma por um dos seguintes conesgerenciados.

    O pacote ou o componente foi criado na organizao atual do Salesforce e gerenciado, mas no foi lanado por um destes motivos:

    Gerenciado - Beta (Managed - Beta)

    No foi carregado.

    Foi carregado com a opo Gerenciado - Beta (Managed - Beta)selecionada. Essa opo impede que ele seja publicado e se torne publicamentedisponvel no AppExchange. O desenvolvedor ainda poder editar qualquercomponente, mas o instalador provavelmente no, dependendo dos componentesincludos.

    O pacote ou o componente foi criado na organizao atual do Salesforce e gerenciado. Ele tambm foi carregado com a opo Gerenciado - Beta

    Gerenciado - Lanado (Managed -Released)

    selecionada, indicando que ele pode ser publicado no AppExchange e se tornarpublicamente disponvel. Observe que, depois que um pacote passar para esse estado,algumas propriedades dos componentes no podero mais ser editadas pelodesenvolvedor e pelo instalador.

    Esse tipo de lanamento considerado uma verso principal.

    Para fornecer uma pequena atualizao a um pacote gerenciado, considere criaruma verso de correo em vez de uma nova verso. Uma verso de correo permite

    Correo (Patch)

    que um desenvolvedor altere a funcionalidade de componentes existentes em umpacote gerenciado, assegurando que inscritos no vejam alteraes visveis no pacote.

    Esse tipo de lanamento considerado uma verso da correo.

    O pacote ou o componente foi instalado a partir de outra organizao do Salesforce,mas gerenciado.

    Gerenciado - Instalado (Managed -Installed)

    Um desenvolvedor pode decidir refinar a funcionalidade de um pacote gerenciado com o passar do tempo conforme os requisitosso desenvolvidos. Nesse processo, o editor pode projetar novamente alguns dos componentes no pacote gerenciado. Osdesenvolvedores no podem excluir alguns componentes em um pacote Gerenciado - Lanado, mas podem recusar umcomponente de uma verso posterior do pacote para que novos assinantes no recebam o componente. Enquanto isso, ocomponente continua funcionando para assinantes e integraes da API existentes.

    Componentes disponveisNem todos os componentes podem ser empacotados para distribuio. Se voc criar um aplicativo que usa componentes queno so empacotveis, seus assinantes tero que criar e configurar esses componentes aps instalar seu aplicativo. Se a facilidadeda instalao for uma preocupao importante para seus assinantes, preocupe-se com os componentes empacotveis enquantodesenvolve.

    Version 29.0 | Componentes disponveis | 21Arquitetura e desenvolvimento do aplicativo

  • A tabela a seguir mostra os componentes disponveis em um pacote gerenciado e se eles podem ser atualizados ou excludos.As sees a seguir descrevem as colunas da tabela e seus valores.

    Atualizvel

    Alguns componentes so atualizados para uma verso mais recente quando um pacote atualizado. No: O componente no atualizado. Sim: O componente atualizado.

    Pode ser excludo pelo assinante

    O assinante ou instalador de um pacote pode excluir o componente. No: O assinante no pode excluir o componente. Sim: O assinante pode excluir o componente.

    Pode ser excludo pelo desenvolvedor

    Um desenvolvedor pode excluir alguns componentes depois da atualizao do pacote para Gerenciado - Lanado. Oscomponentes excludos no so removidos da organizao do assinante durante a atualizao do pacote. O atributoProtegvel contm mais detalhes sobre a excluso de componentes. No: O desenvolvedor no pode excluir um componente Gerenciado - Lanado. Sim: O desenvolvedor pode excluir um componente Gerenciado - Lanado.

    Protegvel

    Os desenvolvedores podem marcar determinados componentes como protegidos. Componentes protegidos no podemser vinculados ou fazerem referncia a componentes criados na organizao do assinante. O desenvolvedor pode excluirum componente protegido em uma verso futura sem se preocupar com falha nas instalaes. Mas assim que o componentefor marcado como desprotegido e lanado globalmente, o desenvolvedor no poder exclu-lo. Quando o assinanteatualiza para a verso do pacote com o componente excludo, ele removido da organizao do assinante. No: O componente no pode ser marcado como protegido. Sim: O componente pode ser marcado como protegido.

    Proteo de IP

    Determinados componentes incluem automaticamente proteo de propriedade intelectual, como o cdigo ofuscante doApex. As nicas excees so os mtodos do Apex declarados como globais, o que significa que as assinaturas do cdigopodem ser visualizadas pelo assinante. As informaes nos componentes includos em um pacote e publicados devemser visveis para usurios no AppExchange. Tenha cuidado ao adicionar seu cdigo ou qualquer outro componente quevoc no possa esconder em um aplicativo a um s-control personalizado, frmula ou pgina do Visualforce. No: O componente no suporta proteo de propriedade intelectual. Sim: O componente suporta proteo de propriedade intelectual.

    Proteo de IPProtegvelPode ser excludopelo desenvolvedor

    Pode ser excludopelo assinante

    AtualizvelComponente

    NoNoNoNoSimAo

    NoNoSimSimNoInstantneoanaltico

    SimNoSim (caso noesteja definido paraacesso global)

    NoSimClasse do Apex

    Version 29.0 | Componentes disponveis | 22Arquitetura e desenvolvimento do aplicativo

  • Proteo de IPProtegvelPode ser excludopelo desenvolvedor

    Pode ser excludopelo assinante

    AtualizvelComponente

    NoNoNoNoSimMotivo decompartilhamentodo Apex

    NoNoSimSimNoReclculo docompartilhamentodo Apex

    SimNoSim (caso noesteja definido paraacesso global)

    NoSimAcionador do Apex

    NoNoSimSimNoAplicativo

    NoNoNoNoSimTipo de artigo

    NoNoNoSimNoCall Center

    NoNoSimNoSimLayout compacto

    NoNoSimSimSimAplicativoconectado

    NoNo, exceto linkspersonalizados

    Sim, caso protegidoNoSimBoto ou linkpersonalizado

    (somente para ahome page)

    NoNoSimSimSimCampopersonalizado

    NoSimSim, caso protegidoNoSimRtulopersonalizado

    NoNoNoNoSimObjetopersonalizado

    NoNoNoNoSimTipo de relatriopersonalizado

    SimNoNoNoSimConfiguraopersonalizada

    NoNoSimSimNoPainel

    NoNoSimSimNoDocumento

    NoNoSimSimNoModelo de email

    NoNoNoNoSimConjunto decampos

    NoNoNoNoSimPgina flexvel

    NoNoNoSimSimFluxo

    NoNoSimSimNoPasta

    Version 29.0 | Componentes disponveis | 23Arquitetura e desenvolvimento do aplicativo

  • Proteo de IPProtegvelPode ser excludopelo desenvolvedor

    Pode ser excludopelo assinante

    AtualizvelComponente

    NoNoNoNoSimComponente dahome page

    NoNoSimSimNoLayout de homepage

    NoNoSimSimNoPapel timbrado

    NoNoSimSimNoModo de exibiode lista

    NoNoSimSimNoLayout de pgina

    NoNoNoNoSimConjunto depermisses

    NoNoNoNoSimTipo de registro

    NoNoSimSimNoConfigurao dosite remoto

    NoNoSimSimNoRelatrio

    NoNoNoNoSimS-control

    NoNoNoNoSimRecurso esttico

    NoNoSimSimSimTab

    NoNoNoNoSimTraduo

    NoNoNoNoSimRegra de validao

    SimNoSim (se definidopara acessopublic)

    NoSimComponente doVisualforce

    NoNoNoNoSimPgina doVisualforce

    NoSimSim, caso protegidoNoSimAlerta de email defluxo de trabalho

    NoSimSim, caso protegidoNoSimAtualizao decampo do fluxo detrabalho

    NoSimSim, caso protegidoNoSimMensag