Skip to main content

Criar e empacotar um kit de dados

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

  • Criar um kit de dados.
  • Empacotar um kit de dados.

Por que usar kits de dados?

Vamos analisar mais aprofundadamente o que são kits de dados e por que eles são utilizados.

Um kit de dados é como um contêiner especial para os componentes do Data Cloud que podem ser colocados em um pacote. O uso de kits de dados simplifica a experiência de empacotamento.

Com os kits de dados, você pode:

  • Reutilizar esquemas com modelos. Se você colocar sua configuração do Data Cloud em um kit de dados, os colaboradores e usuários poderão reutilizar sua configuração com facilidade, implantando o kit de dados na organização deles.
  • Implantar o kit de dados em vários espaços de dados na mesma organização. Depois de instalar o pacote com o kit de dados na sua organização, você poderá escolher em qual espaço de dados dessa organização ele será implantado.
  • Melhorar a flexibilidade. Em vez de alterar os metadados de tempo de execução, os upgrades de pacotes atualizam o modelo, permitindo que os usuários do pacote mantenham elementos inalterados se eles não forem imediatamente necessários.

Existem alguns componentes do Data Cloud que você não deve colocar no seu kit de dados. Para verificar quais componentes podem ser colocados em um kit de dados, consulte a Matriz de prontidão de extensibilidade do Data Cloud. É importante observar que os metadados implantados a partir de um kit de dados não podem ser editados ou excluídos.

Com os kits de dados, os usuários podem desenvolver soluções de ponta a ponta e exaustivas do Data Cloud e implantar metadados de forma seletiva na organização de um cliente.

Criar um kit de dados

A Get Cloudy configurou sua organização Dev Hub, organização de namespace e organização teste. Chegou a hora de criar um kit de dados.

Na organização teste, a equipe da Get Cloudy cria elementos do Data Cloud e adiciona-os a um kit de dados. Este kit de dados atua como um contêiner para os recursos do Data Cloud que a equipe deseja incluir no aplicativo.

Vamos assistir a um vídeo sobre como criar e carregar um kit de dados. 

Presumimos que você seja um desenvolvedor de pacotes com as permissões necessárias para criar e instalar pacotes no Data Cloud. Se não tiver essas permissões, tudo bem. Continue lendo para saber como seu administrador executaria essas etapas em uma organização de produção. Não tente seguir essas etapas no Trailhead Playground. O Data Cloud não está disponível em um Trailhead Playground típico. Antes de começar, verifique se você tem o Data Cloud para organizações teste habilitado, conforme descrito na unidade dois.

  1. Acesse Data Cloud Setup (Configuração do Data Cloud) na sua organização teste.
  2. Na caixa Quick Find (Busca rápida), pesquise e clique em Data Kits (Kits de dados).
  3. Clique em New (Novo).
  4. Dê um nome para o kit de dados, adicione uma descrição opcional e clique em Save (Salvar).
  5. Clique em Add (Adicionar) na seção Data Stream Bundles (Pacotes de fluxos de dados).
  6. Em seguida, selecione o tipo de conector com base na fonte de dados suportada.Janela Add Data Stream Bundles (Adicionar pacotes de fluxo de dados) com três fluxos de dados selecionados. Connector Type (Tipo de conetor) é Salesforce CRM e Bundle Name (Nome do pacote) é KnowledgeBundle.
  7. Adicione o nome de um pacote (sem espaços) e uma descrição opcional.
  8. Selecione os fluxos de dados que você deseja empacotar e clique em Next (Avançar).
  9. Se desejar, adicione um modelo de dados e clique em Save (Salvar).
  10. Se desejar, adicione um insight calculado e clique em Save (Salvar).
  11. Se desejar, adicione mais componentes.

Em seguida, a equipe da Get Cloudy precisa especificar a ordem em que os componentes devem ser implantados, chamada de sequência de publicação.

Se a sequência de publicação não for definida corretamente, poderão ocorrer falhas na implantação. Por exemplo, se você tentar implantar um insight calculado que depende de um DMO, mas não implantar o DMO antes do insight calculado, ocorrerá uma falha na implantação.

  1. Clique na guia Publishing Sequence (Sequência de publicação) e clique em Edit Sequence (Editar sequência). A ordem da instalação geralmente deve seguir a seguinte sequência: Conectores, Fluxos de dados, Transformações, Insights calculados, DMOs.
  2. Quando o kit de dados estiver pronto, baixe o arquivo package.xml da interface de usuário.
  3. Mova o arquivo package.xml para o diretório do seu projeto.

Criar um pacote gerenciado com um kit de dados

A Get Cloudy criou corretamente o kit de dados. Agora é hora de empacotá-lo!

No projeto Salesforce DX, a equipe da Get Cloudy recupera os metadados de dados consultando o arquivo package.xml que baixou da interface de usuário. Para recuperar os metadados do kit de dados, eles devem estar em uma pasta de projeto independente, separada de outros tipos de metadados, como conjuntos de permissões, objetos personalizados e o Apex.

Em seguida, determine se uma dependência do pacote SSOT do Data Cloud é necessária. O SSOT tem os principais objetos do modelo de dados que alimentam o Data Cloud. Se os DMOs no seu pacote tiverem relacionamentos com o Perfil individual unificado ou outros DMOs com um prefixo ssot__ no nome da API, seu projeto terá uma dependência e você deverá adicionar o seguinte ao seu sfdx-project.json.

{
  "packageDirectories": [
    {
      "versionName": "ver 0.1",
      "versionNumber": "0.1.0.NEXT",
      "path": "data-app",
      "default": false,
      "package": "yourDCPackage",
      "versionDescription": "My data kit extension package",
      "dependencies": [
        {
          "package": "04t5Y0000015oSB"
        }
      ]
    }
  ]
}

Em seguida, crie um pacote gerenciado do Salesforce que aponte para a pasta de metadados do seu kit de dados.

sf package create -n PACKAGE_NAME -t Managed -v DEVHUB_ALIAS -p PATH_TO_DATA_KIT

Quando o pacote gerenciado for criado, ele produzirá uma ID 0ho. Copie essa ID. Em seguida, crie uma versão do pacote gerenciado usando essa ID 0ho.

sf package version create -v DEVHUB_ALIAS -k INSTALLATION_KEY -p 0ho_ID -w 45 -f config/project-scratch-def.json

Esse processo pode levar alguns minutos e retornará uma ID 04t indicando a versão do pacote. A versão do pacote será considerada beta, ou seja, ela só poderá ser instalada em organizações teste. Depois de verificar a funcionalidade do pacote beta, você pode executar sf package version promote -v DEVHUB_ALIAS -p 04t para criar uma versão que possa ser instalada na Developer Edition e nas organizações de produção.

Colaborar

A equipe da Get Cloudy criou e empacotou um kit de dados. Em seguida, eles confirmam as alterações no sistema de controle de versão e enviam as atualizações para o GitHub, a plataforma de hospedagem do repositório, para colaborar com outros desenvolvedores.

Outros desenvolvedores podem baixar o projeto e implantar o kit de dados em uma organização teste para fazer mais alterações. Em seguida, eles repetem o processo. Os novos desenvolvedores adicionam os recursos anteriores e novos a um novo kit de dados, recuperam os metadados do kit de dados para o projeto deles e, em seguida, carregam o projeto novamente na plataforma de hospedagem do repositório.

Recursos

Compartilhe seu feedback do Trailhead usando a Ajuda do Salesforce.

Queremos saber sobre sua experiência com o Trailhead. Agora você pode acessar o novo formulário de feedback, a qualquer momento, no site Ajuda do Salesforce.

Saiba mais Continue compartilhando feedback