Gerenciamento de pacotes

Visualize, baixe e gerencie pacotes de automação e suas versões no Orchestrator.

Download de uma versão do pacote

1. Under Packages, select the desired tab depending on your package type. In the grid, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Select More Actions > Download package for the corresponding package version you want to download. The package is downloaded to the default location configured in your browser, in the .nupkg format. From here, you can upload it to another Orchestrator instance.
   Observação:

   O botão Baixar é habilitado apenas se você usar um feed local e tiver permissões Exibir em Pacotes.

Carregar manualmente pacotes para o Orchestrator

Por padrão, o limite máximo de tamanho do pacote é 300 MB.

Observação:

Para carregar manualmente um pacote com tags, você precisa da permissão de Criar em Tags. Se você não tiver a permissão de Criar em Tags, o pacote será carregado sem tags.

1. Em Pacotes, selecione a aba desejada, dependendo do seu tipo de pacote e, em seguida, selecione o botão Carregar . . A janela Adicionar pacote é exibida.
2. Select Browse and select the packages (with the .nupkg extension) you want to upload to Orchestrator.
3. Selecione Eu gostaria de ver quais processos podem ser atualizados para exibir todos os processos que usam uma versão anterior do pacote que está sendo carregado.
4. Select Upload. Orchestrator automatically determines the package Enter and displays the uploaded package in the corresponding grid under Tenant > Packages. If you selected the I would like to see which processes can be upgraded option, the Upgrade multiple processes window is displayed, showing a list of the processes that can be upgraded to a newer package version.

Figura 1. Atualização de vários processos

5. Use the checkboxes to select which processes to upgrade and Select Upgrade. The selected processes are updated to the new package version, and the window closes. Only the package version is updated. If you want to customize the process parameters or entry points, edit the process.

Excluir pacotes

Um pacote pode ser excluído apenas do Orchestrator se todas as versões tiverem sido excluídas. As versões do pacote podem ser excluídas se estiverem inativas, ou seja, não implantadas em um processo.

1. Under Packages, select the desired tab depending on your package Enter and locate your package in the list. From the More Actions menu for the package, select View Versions. The Package Versions window is displayed.

Figura 2. Versões do pacote

2. Select one or more versions and Select Remove. Alternatively, Select More actions > Delete for the package version you want to delete. The selected package versions are removed.
3. Select Remove All Inactive to delete all inactive versions of the selected process. If a package version is part of a process (it is active), it is NOT going to be deleted. If all the versions are inactive, they are all deleted.

Exibição de notas de versão para uma versão do pacote

1. Under Packages, select the desired tab depending on your package type. In the list, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Na guia Versões, você pode ver todas as versões do pacote selecionado.
3. Para a versão desejada, selecione Mais ações > Mostrar notas de versão. A janela Notas de versão é exibida, permitindo que você consulte a nota adicionada no Studio para a respectiva versão.

In addition to that, you can see the note added in Studio, as well as the Windows applications used by the respective package version, displayed in alphabetical order. If the package uses applications that cannot be identified, an Unknown apps entry is displayed, suffixed by the number of unidentified apps, in parentheses.

Se nenhum aplicativo puder ser recuperado, uma mensagem de Nenhum aplicativo poderá ser recuperado para esta mensagem de pacote será exibida. Isso provavelmente ocorreu devido a um dos seguintes motivos:

• Sua versão do Studio é mais antiga que 2023.2.
• Sua versão do Studio é 2023.2, mas existe uma regra de governança em vigor, impedindo que essas informações sejam registradas.
• Seu pacote foi enviado de um feed externo. Somente pacotes de feeds internos podem fornecer essas informações.
• O pacote não usa nenhum aplicativo.

Esses detalhes também são exibidos na janela do processo para seu pacote subjacente.

Figura 3. Detalhes do pacote

Observe que você também tem a opção de baixar manualmente as versões do pacote a partir da janela Notas de versão. O processo é semelhante ao download das versões da guia Versões.

Exibição de notas de versão para todas as versões do pacote

1. Under Packages, select the desired tab depending on your package type. In the package list, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Selecione a aba Log de alterações. Você pode marcar todas as versões do pacote da biblioteca e, para cada uma, a nota de versão correspondente contendo informações relacionadas ao que mudou entre as versões.

Figura 4. Log de alterações para versões de pacotes

Observe que você também tem a opção de baixar manualmente as versões do pacote da guia Alterar log. O processo é semelhante ao download das versões da guia Versões.

Exibição dos argumentos de um pacote

1. Under Packages, select the desired tab depending on your package type. Select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Select More Actions > Show Arguments for the desired package version. The input and output parameters of the selected package version are displayed.

Observe que você não pode editar os valores dos parâmetros nesse nível, apenas nos níveis do processo, trabalhos e gatilhos.

Visualização de processos de pacote

Você pode ver os processos associados a um pacote clicando em Ver processos nos seguintes lugares:

• No menu contextual do pacote desejado no nível do tenant - isso exibe os processos associados a todas as versões desse pacote.
• No menu contextual de uma versão do pacote no nível do tenant - isso exibe os processos associados à versão específica do pacote que você selecionou.

Ambas as opções acima exibem a janela Processos do pacote, que lista as pastas nas quais esse processo está incluído.

Você só pode ver as pastas às quais você tem acesso, independentemente de quaisquer outras pastas nas quais esse processo possa ser incluído. A opção de Edição está disponível apenas para pastas às quais você também tem acesso de edição.

Como adicionar tags a pacotes

É possível aplicar tags a um pacote no momento do projeto no Studio. Para saber como adicionar tags a pacotes, consulte Sobre a publicação de projetos de automação no guia do Studio.

Não é possível alterar as tags de um pacote a partir do Orchestrator. As tags são específicas para cada versão de pacote. Na página Pacotes no Orchestrator, você pode ver as tags específicas da versão mais recente do pacote, independentemente de ela estar ativa ou não.

Como remover tags de pacotes

É possível remover tags de um pacote durante o projeto no Studio. Para saber como remover tags de pacotes, consulte Sobre a publicação de projetos de automação no guia do Studio.

Não é possível alterar as tags de um pacote a partir do Orchestrator. As tags são específicas para cada versão de pacote. Na página Pacotes no Orchestrator, você pode ver as tags específicas da versão mais recente do pacote, independentemente de ela estar ativa ou não.

Comparar pacotes e fluxos de trabalho

Você pode ver as diferenças entre quaisquer duas versões selecionadas de um pacote, sabendo o que foi alterado: arquivos .xaml adicionados, modificados ou excluídos, alterações em pastas ou na lista de dependências. Você também pode comparar as duas versões selecionadas dos arquivo .xaml do fluxo de trabalho das duas versões selecionadas, apresentadas graficamente lado a lado. Essa funcionalidade permite que os gerentes do Orchestrator vejam o que mudou nos pacotes e fluxos de trabalho sem exigir acesso ao Studio.

1. Em Pacotes, selecione a aba desejada, dependendo do seu tipo de pacote, então selecione Explorar pacote ao lado de um pacote. A janela Explorar pacote é exibida, dando acesso a todas as versões do pacote selecionado. Observe que a opção Explorar pacote está disponível apenas nas grades Automações e Automações de teste.
2. Select the Compare button above the list of package versions to toggle the compare mode. A checkbox appears in front of each package version.
3. Marque as caixas correspondentes às versões do pacote que você deseja comparar. Você só pode comparar duas versões do pacote de cada vez.

Ou então, você pode comparar o mesmo arquivo .xaml correspondente a duas versões do pacote. Para fazer isso, expanda um pacote de cada vez e selecione o arquivo do fluxo de trabalho.

4. Select the Compare button below the list of package versions. This button is activated after you select two checkboxes. The Comparing window is displayed, containing a list of results with the newest selected version's workflow files, along with the project author, and description. The workflow file set as Main in Studio is marked accordingly, and the project dependencies are displayed under the Dependencies section.

Ou então, se você optou por comparar os arquivos de fluxos de trabalho na etapa anterior, os dois fluxos de trabalho serão exibidos lado a lado, com a versão mais antiga do arquivo à esquerda.

5. Filtre as diferenças exibidas selecionando uma das opções no canto superior direito da janela:
   • Todas - exibe todas as diferenças entre as versões dos pacotes comparadas ou arquivos de fluxos de trabalho. Isso é selecionado por padrão, exibindo um resumo de todas as diferenças.
   • Adicionados - destaca em verde os arquivos, pastas ou dependências adicionados à versão do pacote, ou os containers, conectores e atividades adicionados aos arquivos de fluxo de trabalho mostrados na janela de Comparação, juntamente com seu número exato.
   • Modificados - realça em amarelo os arquivos, pastas ou dependências que foram alterados dentro da versão do pacote, ou os contêineres, conectores, atividades e propriedades ou valores de propriedades que foram alterados dentro dos arquivos de fluxos de trabalho mostrados na janela Comparando, juntamente com seu número exato.
   • Excluídos - realça em vermelho os arquivos, pastas ou dependências que foram excluídos da versão do pacote, ou os contêineres, conectores e atividades que foram excluídos dos arquivos de fluxos de trabalho mostrados na janela Comparando, juntamente com seu número exato.

Figura 5. Janela de comparação

6. Select the Compare button next to a workflow file from the list of results. The two workflows are displayed side by side, the earliest file version on the left, and with an individual scroll for each workflow. All the changes that happened in the file between the two package versions at the container, connector, or activities level are highlighted and color-coded as follows:
   • Realce em verde para o conteúdo adicionado
   • Realce em amarelo para o conteúdo modificado
   • Realce em vermelho para o conteúdo excluído.

Figura 6. Comparação de fluxogramas

Se só pequenas alterações foram feitas no nível de fluxo de trabalho, como o posicionamento de atividades ou conectores, você será notificado de que a lógica não foi alterada.

7. (For containers only) Double-Select a container activity. The Comparing window displays only the activity within both package versions, for a focused view. If the activity exists in only one of the workflow files, then it is displayed in the corresponding workflow's side. Navigate back from the container to the workflow by clicking the breadcrumb trail.

Figura 7. Comparação de fluxogramas

8. Select any activity to view the changes to its properties. All the changes that happened in the activity between the two package versions are highlighted and color-coded, as mentioned before.

Explorar pacotes

Você pode exibir e explorar a representação gráfica de qualquer arquivo .xaml gráfico que faça parte de uma versão do pacote, como o painel Designer do Studio. Essa funcionalidade possibilita uma cooperação mais tranquila entre desenvolvedores e gerentes do Orchestrator.

Observação:

• Você não pode explorar pacotes compilados usando essa funcionalidade.
• Você pode visualizar pacotes do Studio que são carregados junto com todos os seus .xaml origens (ou seja, a opção Incluir Origens selecionada na Opções de publicação > seção Configurações de compilação ) em sua totalidade no explorador de pacotes. Isso se aplica ao Windows e a projetos multiplataforma. Saiba mais sobre projetos de automação no guia do Studio.

1. Em Pacotes, selecione a aba desejada, dependendo do seu tipo de pacote, então selecione Explorar pacote ao lado de um pacote. A janela Explorar pacote é exibida, dando acesso a todas as versões do pacote selecionado. Observe que a opção Explorar pacote está disponível apenas nas grades Automações e Automações de teste.
2. Selecione uma versão sobre a qual você deseja ver mais. Todos .xaml os arquivos disponíveis no projeto são exibidos, junto com o autor do projeto, a descrição e a data na qual ele foi carregado para o Orchestrator. O arquivo .xaml definido como Principal no Studio é marcado de acordo, e as dependências do projeto são exibidas na seção Dependências.
3. Selecione um arquivo .xaml. O fluxo de trabalho é exibido.
4. Para visualizar todas as variáveis, argumentos ou importações disponíveis no arquivo selecionado, selecione o botão Variáveis, Argumentos ou Importações. O painel correspondente é exibido, semelhante àquele disponível no Studio.

Figura 8. Visualizar todas as variáveis, argumentos ou importações disponíveis em um arquivo selecionado.

5. Double-Select any scope to see a focused view of the workflow.

Figura 9. Fluxo de trabalho

6. Select Expand All to get a better view of a workflow section.
7. Selecione qualquer atividade para visualizar suas propriedades. Observe que você também pode copiar o valor de qualquer propriedade.

Os detalhes estão disponíveis em cada um dos campos, botões e painéis mencionados acima, na página Descrições dos campos.