Ações Personalizadas

Introdução

A funcionalidade Ações Personalizadas permite aos utilizadores criar e aplicar scripts de automatização personalizados com Python e IA para melhorar o fluxo de trabalho do projeto. Estas ações personalizadas podem ser associadas a vários objetos do seu projeto, como Blocks, Valis e requisitos, e também podem tirar partido das capacidades de Python e da IA.

Como posso criar Ações Personalizadas?

Os utilizadores podem criar ações personalizadas de forma simples no módulo de scripting do Requirements & Systems Portal, tirando partido tanto das capacidades de scripting como das funções de IA. Com esta funcionalidade, os utilizadores podem escrever facilmente código Python na ação personalizada do módulo de scripting e executar ações específicas, recorrendo ao endpoint de IA vali-assistant para gerar os resultados pretendidos através de prompts ou scripts Python.

Assim que um novo script Python com a ação personalizada for criado no módulo de scripting, o utilizador pode criar uma ação personalizada na opção “General” (1) nas definições do script. Os utilizadores têm de fornecer a informação do tipo de objeto (2) e a descrição, bem como preencher as “Display settings” (3), ou seja, o nome apresentado e a posição da ação personalizada.

Criação de uma “Custom Action” dentro de um script - secção Settings no módulo de scripting para a Custom Action.
Caso o script personalizado seja criado para executar um fluxo de trabalho personalizado no módulo System Design, o utilizador tem de escolher “Placement” como Blocks.

Se o utilizador criar um script de ação personalizada e não fornecer as “Display Settings”, a ação personalizada não ficará acessível no menu dos três pontos do objeto (por exemplo, Requirement). Cada utilizador tem de criar as Display Settings a partir do script para conseguir mostrar a “custom action” nos módulos.

Se o utilizador tiver, no mínimo, acesso “Read only” ao script, pode criar a ação personalizada.

O utilizador também pode partilhar a ação personalizada com qualquer utilizador ou grupo dentro da implementação através da opção “Share with” por baixo das display settings (ver Figura Share Custom Action).

image-20240409-115928.pngPartilhar ação personalizada - Partilha de ações personalizadas com outros utilizadores no mesmo projeto.

A visão geral das Custom Actions está acessível no menu "Settings" (1), permitindo aos utilizadores ver a variedade de ações personalizadas (2) criadas por outros. Os utilizadores podem adicionar ou remover estas ações das respetivas display settings e personalizar o seu acesso às ações personalizadas (3).

Definições de Custom Actions - Aqui o utilizador pode definir diferentes propriedades de uma ação personalizada, como por exemplo se é apresentada, uma descrição, o nome, etc.

Exemplos de fluxos de trabalho com Custom Actions:

Example 1: Converter o identificador dos requisitos de maiúsculas para minúsculas


Para demonstrar este exemplo, já adicionámos o script Python aos modelos de script dentro do módulo. O script converte o identificador de maiúsculas para minúsculas. Um vídeo curto mostra como pode criar este script, a respetiva ação personalizada e como utilizá-lo em Requirements.

Renomeie os seus identificadores - Converter o identificador dos requisitos de maiúsculas para minúsculas

O script foi adicionado como modelo no módulo de scripting. Ao criar um script, pode selecionar “Custom actions” e depois selecionar os modelos existentes para reutilizar também o código no seu fluxo de trabalho personalizado.

Certifique-se de que adapta as informações cruciais dentro do script ao seu caso.

 

Example 2: Traduzir os requisitos de um idioma para outro utilizando as Custom Actions em combinação com IA

Recorrendo à IA do ValiAssistant, pode submeter facilmente um conjunto de requisitos e instruir o vali-assistant, através de um prompt, a traduzi-los para qualquer idioma suportado à sua escolha.

Custom Action Translate - Utilize as Custom Actions e a capacidade de IA para, por exemplo, traduzir o texto dos seus requisitos para outro idioma.

Alguns outros casos de utilização que podem ser realizados com as ações personalizadas

  • Verificação da qualidade de um requisito

  • Criar e adicionar vários valis ao Block através de Block Types

  • Verificar se os requisitos de alto nível são bons e, inversamente, verificar se os requisitos de baixo nível não são vagos.

  • Sugerir tipo de requisito

  • Editar em massa o texto/formatação dos requisitos. Ex.: substituir “must” por “shall”, etc.

  • Criar um resumo dos requisitos, etc.

Acesso às Custom Actions

Estas ações personalizadas criadas pelos utilizadores podem depois ser convenientemente guardadas para acesso universal, permitindo que sejam facilmente associadas a uma variedade de objetos, incluindo requisitos, Blocks e Valis no Requirements & Systems Portal. Isto significa que, quando um utilizador comum precisar de executar uma ação personalizada, pode simplesmente escolhê-la no menu "Actions" do objeto (requisitos, Blocks ou Valis), eliminando a necessidade de navegar até ao módulo de scripting ou a um Dashboard para a executar.

Acesso às Custom Actions - Aceder às ações personalizadas através da coluna “Actions” e do “ValiAssistant“.

As ações personalizadas para o módulo System Design podem ser acedidas de forma semelhante. No entanto, o utilizador tem de estar na vista de lista de “Blocks”

Aceder à ação personalizada no módulo System Design

 

AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Conteúdo