Exibir, enviar e instalar itens do catálogo
Em qualquer organização, pode haver muitos componentes e modelos distribuídos entre muitos ambientes. O catálogo no Power Platform permite que desenvolvedores e criadores:
- Façam crowdsourcing e encontrem modelos e componentes em sua organização facilmente
- Localizam e instalem a versão mais recente e confiável de um componente
- Introduzam modelos e componentes que agregam valor imediato
Importante
Você precisa de um Ambiente Gerenciado para enviar itens ao catálogo. No entanto, você pode instalar itens de catálogo de qualquer ambiente. Mais informações: Visão geral de Ambientes Gerenciados
Antes de ler este artigo, você deve:
Observação
Os desenvolvedores também podem usar o Power Platform CLI, o SDK do Dataverse para .NET e a API Web do Dataverse para executar as operações descritas aqui. Catálogo no Power Platform para desenvolvedores
Controles de acesso
O catálogo possui um conjunto separado de controles de acesso do Power Platform. Isso significa que os criadores em um determinado ambiente não obtêm automaticamente permissões para publicar e adquirir itens do catálogo. Há quatro funções de acesso:
| Função | Permite ao usuário: |
|---|---|
| Emissor do Catálogo | Enviar itens para o catálogo |
| Consumidor do catálogo | Descobrir e instalar itens do catálogo |
| Aprovador do Catálogo | Aprovar envios para o catálogo. Os aprovadores de catálogo podem ser usuários do departamento central de TI ou da linha de negócios que sua organização deseja capacitar para participar do processo de aprovação. |
| Administrador do catálogo | Administrar o catálogo. |
Qualquer ambiente com um catálogo visualiza essas funções no centro de administração do Power Platform e podem ser atribuídas a grupos ou indivíduos como qualquer outro direito de acesso.
Os administradores do Power Platform e personalizadores do sistema já têm acesso total ao catálogo. No entanto, não atribua essas funções para gerenciar o acesso ao catálogo ao público e, em vez disso, use uma das funções da tabela anterior.
Envio
Soluções não gerenciadas em seu ambiente podem ser publicadas no catálogo. No curso normal de criação de soluções, você pode decidir que o que está criando seria útil como um artefato reutilizável para si mesmo ou para outras pessoas em sua organização.
Navegue até a página de soluções e qualquer solução não gerenciada tem uma nova opção para Publicar no Catálogo nos três pontos verticais ao lado do nome de exibição da solução. Essa opção está desabilitada para qualquer pessoa sem a função Remetente do Catálogo.
Observação
Essa opção não está habilitada para soluções gerenciadas. Não é possível enviar soluções gerenciadas para o catálogo.
Não é possível enviar um aplicativo, fluxo ou outro componente diretamente para o catálogo. Primeiro você deve garantir que ele existe em uma solução não gerenciada. Você pode adicioná-lo a uma solução não gerenciada selecionando Nova solução na parte superior da área Soluções ou selecionando um existente na lista e, em seguida, selecionando Adicionar existente no menu superior da própria solução e adicionando o componente desejado (como um aplicativo ou um fluxo).
Observação
Qualquer criador com a função Remetente do Catálogo em um determinado ambiente poderá publicar. No entanto, depois que uma solução é publicada, um criador precisa fazer parte do grupo de publicação para publicar novamente a mesma solução. Você verá esse erro se não tiver acesso, que pode ser solicitado ao seu administrador.
Quando você seleciona Publicar no Catálogo, há um assistente com quatro etapas:
Etapa 1: adicionar sua solução
Selecione um catálogo: Se você tiver vários catálogos configurados, poderá selecionar em qual catálogo deseja publicar este item.
Selecione item gerenciado ou modelo para seu envio.
- Os itens gerenciados não podem ser editados por outros criadores, seu ambiente compartilha uma única cópia e essa cópia pode ser versionada com atualizações ao longo do tempo. Os criadores podem atualizar suas soluções com suas atualizações.
- Um modelo é uma cópia autônoma que pode ser editada, e os criadores podem ter quantas cópias quiserem e não atualizarão automaticamente as soluções em ambientes quando novas atualizações forem publicadas.
Selecione um componente principal: uma solução pode ter muitos componentes nela. Você pode querer que os criadores abram um componente específico para edição depois de instalá-lo, como abrir o Canvas Studio para seu aplicativo de tela. Defina o componente principal para o que você acha que é o "foco" da solução, caso contrário, defina como Não Especificado e os instaladores passam a usar a própria solução.
Reenviando itens
Se estiver reenviando um item, você receberá uma mensagem de alerta notificando sobre o reenvio. Será solicitado um campo de versão. O último dígito do número da versão é incrementado automaticamente para você. Você pode modificar o número da versão se quiser, mas não defina o número da versão para um número inferior nessa interface. A atualização do número da versão no envio do catálogo também atualiza o número da versão na solução original.
Lembre-se destes pontos ao reenviar itens:
- O reenvio de um modelo substitui o item anterior no catálogo e não afeta nenhuma solução que já esteja usando o item anterior do catálogo. Os criadores que agora instalam o reenvio obtêm a versão mais recente.
- O reenvio de itens gerenciados atualizará o item de catálogo com sua versão mais recente e, na próxima vez que os criadores virem seu item de catálogo em um ambiente em que esse item do catálogo já tenha sido instalado, eles verão um botão Atualizar, que instalará as alterações mais recentes no item gerenciado nesse ambiente e, em seguida, todas as soluções que usam esse item gerenciado também serão atualizadas.
- Não é possível reenviar um item gerenciado como um modelo e vice-versa.
Etapa 2: Informações do catálogo
Insira as seguintes informações:
| Campo | Instruções |
|---|---|
| Title | Renomeie o item, se necessário, antes que ele seja enviado ao catálogo. O padrão é o nome da solução. Não é possível editar o título quando um item gerenciado é enviado. |
| Descrição | Forneça detalhes sobre este item do catálogo. Os criadores leem sua descrição na galeria do catálogo para saber mais sobre ela. |
| Justificativa comercial | Por padrão, seu administrador precisa aprovar todos os envios de catálogo antes de adicioná-los ao catálogo. Esse campo fornece uma justificativa para o envio ao administrador. |
| Trabalha com | Um fluxo que você está criando pode ser destinado a funcionar com aplicativos de tela e aplicativos de modelo, por exemplo. Indique aqui com o que seu item do catálogo pretende trabalhar. |
| Categorias de negócios | Selecione até cinco categorias de negócios que descrevem seu item de catálogo. Os criadores usam essas categorias para pesquisar itens de catálogo que são de seu interesse. |
| Editor | Selecione um editor existente nesse ambiente ou crie um novo editor para conectar-se a esse envio de catálogo. Um criador não pode reenviar um item de catálogo, a menos que faça parte do grupo de publicação que enviou o item pela primeira vez. |
| Autor | Isso é padronizado para o usuário atual, mas você pode alterá-lo, se necessário |
Etapa 3: Informações da solução
Insira as seguintes informações:
| Campo | Instruções |
|---|---|
| Ícone de Solução | Anexe um ícone à sua solução (216 x 216 pixels) para ajudar a identificá-lo na galeria do catálogo |
| imagens do modelo | Anexe algumas capturas de tela ou outros elementos visuais que possam ajudar os criadores a entender mais detalhes sobre este item do catálogo |
| Link de ajuda | Adicione o URL à qualquer documentação de ajuda |
| Link da política de privacidade | Adicione o URL à qualquer documentação da política de privacidade |
| Link dos termos legais | Adicione o URL à qualquer documentação dos termos legais |
Etapa 4: Revisar e concluir
Esta última etapa fornece um resumo de todas as informações fornecidas. Se tudo estiver correto, selecione Enviar para publicar no catálogo. Como mencionado anteriormente, se o catálogo exigir um aprovador antes que o envio possa ser concluído, você precisará aguardar a aprovação. Entre em contato com seu administrador ou aprovador se precisar que o processo seja acelerado.
Aquisição
À medida que os criadores navegam na página Descobrir e encontram itens de catálogo úteis para eles, eles podem adquirir esses artefatos e instalar uma cópia em seu ambiente para começar a usar ou compilar. Selecionar Obter em qualquer modelo ou item gerenciado abre um pop-up de detalhes que contém informações como descrição, links, componentes incluídos, categorias de negócios, capturas de tela expansíveis e muito mais.
Se os detalhes atenderem ao que o criador está procurando, ele poderá selecionar Obter no pop-up de detalhes para iniciar o assistente de aquisição.
Observação
Se o item do catálogo for um item gerenciado e já tiver sido instalado no ambiente, não será possível instalar o item gerenciado novamente, pois o ambiente compartilha esse item gerenciado. Se o item gerenciado já tiver sido instalado em um ambiente e uma atualização tiver sido publicada no item gerenciado, você verá um botão Atualizar em vez de Obter, que atualiza a solução gerenciada compartilhada no ambiente. Se o item gerenciado já tiver sido atualizado e nenhuma nova atualização tiver sido publicada, o botão Atualizar será desabilitado até que uma nova atualização seja publicada.
O assistente de aquisição tem quatro etapas:
Etapa 1: verificar conexões
Esta etapa verifica as conexões da solução para garantir que elas estejam funcionando para você em seu ambiente. Se houver algum problema de conexão, você verá uma notificação de status vermelha e poderá resolvê-la selecionando as reticências (...) ao lado da conexão problemática para atualizá-la.
Etapa 2: variáveis de ambiente
O criador da publicação pode decidir que algumas variáveis de ambiente precisam ser especificadas antes que você possa adquirir a solução. Normalmente, essas variáveis são definidas com algum valor padrão. Se não tiver certeza do que preencher, verifique com o autor do item do catálogo ou nos detalhes da listagem do catálogo, disponíveis nos detalhes do catálogo. Mais informações: Etapa 2: Informações do catálogo
Etapa 3: Configuração
O criador da publicação determinará essa etapa, se desejar que você forneça informações adicionais para usar a solução. Isso pode incluir coisas como: "Em que dias da semana você executa um relatório?". Se nenhuma informação adicional for necessária, esta etapa ficará em branco.
Etapa 4: Resumo
Ao chegar à etapa final, a tela de resumo, você está aguardando a instalação do item do catálogo em seu ambiente. Dependendo da complexidade, isso pode levar de menos de um minuto a vários minutos. Ao concluir, você terá várias opções no menu suspenso, dependendo do que está incluído no item do catálogo e se o autor definir um componente principal. Veja a seguir um exemplo em que um aplicativo de tela é o componente principal do item de catálogo:
Neste exemplo, você pode:
- Editar Aplicativo: abre o aplicativo no Canvas Studio
- Acessar o Aplicativo: leva você para a tela do aplicativo, caso ainda não esteja pronto para editar
- Ir para Soluções: abre o arquivo de solução
Dependendo do que está contido no pacote do item do catálogo, diferentes opções aparecem.
Depois que o item do catálogo for instalado, você poderá encontrá-lo:
- Na lista de Soluções não gerenciadas na página de soluções, se o item do catálogo for um modelo
- Na lista de Soluções gerenciadas na página de soluções, se o item do catálogo for um item gerenciado
Como mencionado anteriormente, os modelos podem ser adquiridos quantas vezes você quiser, cada um como sua própria cópia. O catálogo acrescenta um sufixo ao nome de exibição da solução não gerenciada para distinguir as diferentes cópias. Os itens gerenciados podem ser adquiridos apenas uma vez na lista de soluções gerenciadas e todos os criadores no ambiente compartilham a mesma solução gerenciada. Isso significa que não é possível readquirir um item gerenciado no mesmo ambiente em que ele foi publicado e o botão Atualizar está desabilitado.
Ver também
Catálogo no Power Platform)
Administrar o catálogo
Catálogo no Power Platform para desenvolvedores