# Cápsulas
## O que são Cápsulas?
Cápsulas são um conjunto de componentes configurados que são encapsulados para serem reutilizados na construção de *Pipelines*. Por permitirem modularizar a lógica de negócios, fica mais fácil gerenciar, manter e atualizar partes individuais do sistema, além de diminuir o tempo de construção do *pipeline*.
É como se os componentes disponíveis na plataforma fossem átomos e as Cápsulas são moléculas que agrupam os átomos em tarefas mais complexas para resolver um problema específico.
## Como usar as Cápsulas?
Para usar uma Cápsula, siga estas etapas:
* [Crie uma coleção](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-create-a-capsule-collection)
* [Crie um grupo](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-create-a-capsule-group)
* [Configure uma Cápsula](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-configure-a-capsule)
* [Construa uma Cápsula](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-build-a-capsule)
* [Teste uma Cápsula](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-test-a-capsule)
* [Salve uma Cápsula](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-save-a-capsule)
* [Publique uma Cápsula](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/how-to-use-capsules/how-to-publish-a-capsule)
## Possíveis dúvidas sobre as Cápsulas
Quais são as soluções oferecidas pelas Cápsulas?
A essência das Cápsulas é fornecer ao mercado integrações prontas, testadas e validadas para obter uma melhor conexão interna ou externa de forma documentada. Elas permitem que uma empresa modernize sua TI e que suas empresas parceiras utilizem ofertas com segurança e simplicidade.
Por exemplo, imagine uma empresa onde existem múltiplos fluxos de dados relevantes para todas as áreas – autenticação, solicitações de clientes, consultas de inventário, entre outras. Para estes fluxos de dados é possível criar *pipelines* que distribuem os serviços, mas também é necessário documentar, catalogar e manter o *pipeline* implantado.
Ao fazer os fluxos de qualquer parte de um *pipeline* mais acessíveis, você pode definir metas de negócios mais amplas. É por isso que desenvolvemos esta funcionalidade que reúne fluxos e os torna reutilizáveis e auto documentados, assim como nossos componentes principais. Desta forma, os fluxos tornam-se mais fáceis de utilizar e familiares em toda a sua organização – basta consultar a paleta de componentes.
As Cápsulas contêm os componentes principais da Digibee Integration Platform, o que significa que possuem todas as funcionalidades que esses componentes oferecem.
Quem pode criar Cápsulas?
As Cápsulas podem ser criadas por você, se você tiver as [permissões necessárias](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles), e também pela Digibee e seus parceiros para disponibilização para uso.
Ao criar uma Cápsula, você pode especificar os parâmetros, a documentação, a interface e também as instruções de uso. A liberdade de criar Cápsulas vem com todos esses recursos e a documentação fica no próprio componente.
Posso utilizar Cápsulas no meu ecossistema de parceiros e clientes?
Sim. É possível ter Cápsulas com pronta integração entre o sistema da empresa e seu parceiro. As Cápsulas também podem ser reutilizadas por outros parceiros com casos de uso semelhantes.
Por exemplo, um banco pode utilizar uma Cápsula para microcrédito com os sistemas POS (*Point of Sale*) de diferentes redes de farmácias.
As Cápsulas são seguras para compartilhar meus dados confidenciais?
Sim. A Digibee Integration Platform possui uma variedade de recursos para proteger seus dados em tráfego e armazenados quando somos responsáveis por eles.
Como as Cápsulas estão incorporadas ao *Pipeline* de uma organização, elas são executadas isoladamente, mesmo dentro da sua própria organização. Além disso, as Cápsulas funcionam em ambiente compartilhado e nunca individualmente.
As Cápsulas são compatíveis com as necessidades de informação do meu legado?
Sim. As Cápsulas consistem nos componentes *core* da Digibee Integration Platform usados nos *pipelines*, e portanto têm todas as funcionalidades que esses componentes oferecem.
As Cápsulas auxiliam na migração de sistemas para nuvem?
Sim. Quando acontece a migração para a nuvem, é muito importante ter estratégias de convivência com os *on-premises*. Por exemplo, ao incorporar Cápsulas nesta estratégia, é possível desenvolver soluções que registem dados *on-premises*, na nuvem ou ambos.
Além disso, a Digibee Integration Platform possui uma ampla gama de Cápsulas disponíveis para soluções nativas em nuvem.
A Digibee Integration Platform fornece suporte para expandir meu sistema de negócios com Cápsulas?
Sim. A Digibee Integration Platform conta com uma equipe de Delivery especializada em Cápsulas que apoia todos os clientes na criação e desenvolvimento de projetos para qualquer empresa, incluindo a criação de Cápsulas públicas (criadas a pedido da empresa).
Qual o limite de uso de Cápsulas em meus pipelines?
A plataforma não estabelece limites quantitativos sobre os componentes que podem ser utilizados no *pipeline*, sejam eles componentes principais ou Cápsulas. Porém, o *pipeline* possui limites, como número de execuções simultâneas, tempo limite e capacidade controlada na implantação quando SMALL, MEDIUM ou LARGE é selecionado.
Por que é necessário informar um contrato de saída nas Cápsulas?
Como as Cápsulas são componentes reutilizáveis em *pipelines*, usamos o contrato de saída da especificação JSON Schema para garantir que *pipelines* tenham clareza e segurança nas informações de resposta. Além disso, o contrato de saída também oferece suporte à automação de versionamento das Cápsulas.
Como eu sei quais Cápsulas foram criadas pela Digibee?
As Cápsulas criadas pela Digibee são marcadas com um selo de certificação (ícone de *checkmark*). Veja abaixo como identificá-las:
As Cápsulas podem ser publicadas para outros clientes?
Não. As Cápsulas possuem um conjunto de permissões gerenciadas pela Digibee. Essas permissões determinam quais usuários podem tornar uma Cápsula pública.
Os parceiros clientes podem publicar Cápsulas públicas?
Não. Esta configuração ainda não está disponível, mas está em análise para possibilidades futuras.
Cápsulas com a mesma funcionalidade sendo utilizadas por diferentes clientes ficam restritas?
Sim. As Cápsulas são restritas à empresa específica que as utiliza.
Como funciona o processo de atualização das Cápsulas em meus Pipelines?
A Digibee Integration Platform nunca faz alterações diretas na estrutura ou informações de *pipelines* implantados. Portanto, o uso de Cápsulas funciona com [versionamento](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/capsules-versioning).
Ao adicionar uma Cápsula ao *pipeline*, você a vincula à versão “*Major*” ou “*Minor*” da Cápsula. A versão "*Fix*" não está vinculada porque o *pipeline* sempre obtém automaticamente a versão "*Fix*" mais recente quando uma nova implantação é feita ou quando o [Painel de execução](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/canvas/execution-panel) é executado na tela do *pipeline*.
Conforme mencionado na[ documentação de versionamento de Cápsulas](https://docs.digibee.com/documentation/developer-guide/pt-br/development-cycle/build-overview/capsulas/capsules-versioning), a versão "*Fix*" só é alterada se a alteração não afetar o *pipeline*. *Pipelines* não são afetados ou atualizados por versões "*Major*" ou "*Minor*" de uma Cápsula que faz parte de sua compilação. Para utilizar esta Cápsula, um Analista de Integração responsável pelo *Pipeline* deverá aplicá-la manualmente.
Como posso controlar o acesso às Cápsulas na minha organização?
Você pode usar um conjunto de permissões que permitem controlar funções específicas para gerenciar totalmente o ciclo de vida de suas Cápsulas. Leia mais na [documentação de Papéis](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles).
Por que não posso usar os componentes Object Store, Digibee Storage e Relationship dentro de uma Cápsula?
Esses componentes são recursos nativos do seu domínio. Portanto, eles são automaticamente autorizados para o contexto controlado da região. Como uma Cápsula pode ser criada para uso por outros domínios, não é possível autorizar o acesso aos dados desses componentes dentro da Cápsula.