Criação de aplicativos de processo personalizados

Antes de iniciar

Configurar

Configure sua instância IBM Process Mining para aplicativos de processo em um ambiente Linux ambiente não conteinerizado. Para obter mais informações, consulte Configuração básica.

Permissões

Verifique se você tem as permissões obrigatórias para acessar e criar aplicativos de processo que um administrador do sistema deve atribuir a você. Para obter mais informações, consulte Processar permissões de aplicativos.

Criação de um cartão de resumo

  1. Na página inicial, clique na caixa Iniciar a partir de um aplicativo de processo.

  2. Clique em Criar aplicativo de processo.

  3. Na seção Cartão de resumo, conclua as etapas a seguir:
    1. Digite o nome do seu aplicativo de processo. Você não pode usar o nome de um aplicativo de processo já existente.
    2. Opcional: forneça uma breve descrição de seu aplicativo de processo.
    3. Selecione se o seu aplicativo deve ser de código fechado ou de código aberto para definir as permissões para os usuários do aplicativo de processo:
      • Alterne a opção para Código aberto se quiser conceder as permissões Usar, Exibir, Exportar e Duplicar aos usuários do aplicativo de processo.
      • Alterne a opção para Fonte fechada se quiser conceder apenas as permissões Usar e Exportar aos usuários do aplicativo de processo.
      Para obter mais informações sobre permissões de aplicativos de processo, consulte Tipos de usuários e permissões em aplicativos de processo personalizados.
  4. Opcional: Personalize o cartão de resumo do seu aplicativo de processo para torná-lo mais característico e distinto de outros aplicativos de processo:
    1. Escolha um ícone.
    2. Adicione alguns destaques de recursos.

  5. Clique em Next para ir para a seção Carregar a lógica do aplicativo de processo.

Carregamento de um arquivo lógico

  1. Carregue seu arquivo de lógica Python. Para saber mais sobre como deve ser a estrutura do arquivo, consulte Criação de arquivos de lógica Python para aplicativos de processo.

  2. Opcional: se quiser que os usuários possam agendar a busca de dados (atualizações de dados incrementais) para o projeto que criarem a partir desse aplicativo de processo, defina a opção Atualizações incrementais de dados podem ser agendadas. Para que isso funcione, o arquivo de lógica Python deve incluir uma função programável para atualizações incrementais dos dados de registro de eventos. Para obter mais informações, consulte Definir a configuração de agenda para as opções de atualização de dados.

    Se a chave estiver definida como Incremental updates to data cannot be scheduled, você só poderá agendar o processo com atualizações de substituição. No entanto, é possível alterar a configuração da agenda posteriormente na seção Process app (Aplicativo de processo ) do Data & Settings (Dados e configurações ). Para saber como acessar essa seção, consulte Aplicativo de processo. Para saber mais sobre as opções de agendamento, consulte Agendamento da obtenção de dados de processo em aplicativos de processo.

  3. Clique em Next para ir para a seção Define user inputs (Definir entradas do usuário ).

Opcional: Definição de entradas de usuário

Você pode permitir que os usuários insiram os dados no seu aplicativo de processo. Isso lhes dá a flexibilidade de selecionar os dados que desejam analisar e transformar em uma fonte de dados válida para um projeto de mineração de processos. É possível configurar as opções de entrada do usuário das seguintes maneiras:

  • Se quiser que seus usuários façam upload de dados em um arquivo, conclua as etapas a seguir:

    1. Defina a opção É necessário que seu usuário carregue um arquivo com seus próprios dados? a Necessário.
    2. Clique em Next para ir para a seção Fornecer orientação ao usuário.

  • Se quiser que os usuários definam parâmetros específicos que o script Python usa para gerar uma fonte de dados de acordo com seus requisitos comerciais, conclua as etapas a seguir:

    1. Clique em Criar entrada personalizada. Você pode adicionar vários campos de entrada personalizados.
    2. Escolha se essa entrada do usuário deve ser obrigatória ou opcional.
    3. Defina o campo Label (Rótulo ), o campo Variable name (Nome da variável ) e os campos Input type (Tipo de entrada) que os usuários do seu aplicativo de processo verão. No campo Variable name (Nome da variável ), insira o nome da variável que o usuário deve inserir com base na lógica do script Python. Por exemplo, Enter the Password.
    4. Opcional: Para instruir os usuários sobre como fazer o upload dos dados, adicione um texto de ajuda.
    5. Clique em Next para ir para a seção Fornecer orientação ao usuário.

    Exemplo : É assim que os usuários de um aplicativo de processo veem as entradas de usuário personalizadas. Neste exemplo, o criador usou uma caixa de seleção e um tipo de entrada de área de texto com algum texto auxiliar. entrada de usuário personalizada no aplicativo

Opcional: Fornecimento de orientação ao usuário

Você pode criar guias do usuário para os usuários do seu aplicativo de processo personalizado usando texto, links ou um modelo JSON .

Orientação com texto

Escreva um guia passo a passo ou uma descrição de como usar seu aplicativo.

Orientação com modelo

Crie um guia do usuário para seu aplicativo de processo com um modelo JSON .

Antes de iniciar

Crie um arquivo .zip que contenha um ou ambos os itens a seguir:

  • Se na etapa Definição das entradas do usuário você exigiu que os usuários fizessem upload de um arquivo de dados quando usassem o aplicativo de processo, forneça um script Python que os usuários possam usar para extrair dados brutos de sua fonte. Inclua também alguma documentação técnica ou instruções que descrevam como esse script Python pode ser usado para extrair dados de aplicativos externos.

  • Se na etapa Definição das entradas do usuário você criou entradas personalizadas para os usuários, forneça documentação técnica que descreva como os usuários podem configurar os parâmetros relevantes do log de eventos. Os usuários precisam dele quando usam o aplicativo de processo para criar um projeto por meio da conexão direta com a origem dos dados brutos por meio de uma API REST.

Procedimento

  1. Clique no botão Guidance with template (Orientação com modelo ).

  2. Na seção Upload connector/extractor file (Carregar arquivo do conector/extractor ), carregue o arquivo .zip .

  3. Clique em Exibir modelo JSON e copie e cole o modelo no campo de texto.

  4. Atualize o modelo .JSON com os detalhes do guia que permitirão que os usuários entendam como o aplicativo de processo pode ser usado para criar um projeto.

    O modelo .JSON tem a seguinte aparência:

       {
  "title": "foo",
  "subtitle": "foo",
  "notification": {
    "title": "foo",
    "text": "foo"
  },
  "content": "foo",
  "content_switcher": {
    "show_label": "foo",
    "hide_label": "foo"
  },
  "download_button": {
    "label": "Download foo file"
  },
  "help_links": {
    "Using the app": "https://example.com"
  },
  "faq_title": "FAQs",
  "FAQs": {
    "How? ": "Answer how ",
    "What? ": "Answer what ",
    "Which?": "Answer  which "
  }
}

    O site .JSON que você criar se transformará em uma página de documentação semelhante ao layout a seguir: layout de orientação de modelo de aplicativo de processo personalizado

    Tabela 1: Diretrizes sobre a edição do modelo .JSON .

    Valor Como usá-lo
    notification Use para destacar notas ou avisos importantes relacionados à documentação.
    content Use para adicionar uma breve descrição das etapas necessárias para acessar o arquivo de documentação ou os links. Essa descrição aparece sob o título Como coletar seus dados.
    content_switcher Use para oferecer aos usuários duas opções. Exemplo:
    • Defina o valor de show_label como I already have my data. Se o usuário selecionar essa opção, ele verá apenas o título, o subtítulo e a seção de notificação na interface do usuário do seu aplicativo de processo.
    • Defina o valor de hide_label como Help me gather my data. Se o usuário selecionar essa opção, ele verá o título, o subtítulo e a seção de notificação, bem como a seção How to gather your data com as etapas definidas por você no valor content , o botão Download e a seção FAQs.
    download_button Use para orientar os usuários a baixar o arquivo que você carregou.
    help_links Use para fornecer aos usuários links para outros recursos úteis. Os links aparecem sob o título Documentação de suporte.
    FAQs Use para fornecer aos usuários respostas a perguntas frequentes sobre as etapas.
  5. Clique em Next para ir para a seção Process settings (Configurações do processo ).

Configuração de um projeto

Na seção Configuração do processo, é necessário carregar um arquivo de backup do projeto ou duplicar as configurações de um projeto já existente. Isso é feito para que você possa gerar um novo projeto com o aplicativo de processo usando as colunas de dados mapeados, as configurações do projeto, os filtros e os painéis do arquivo de backup do projeto.

Para carregar um arquivo de backup de projeto, conclua as etapas a seguir:

  1. Selecione a opção Carregar arquivo de backup do processo.

  2. Faça o upload do arquivo de backup do projeto no formato .idp .

  3. Clique em Salvar.

Para duplicar as configurações de um projeto existente, conclua as etapas a seguir:

  1. Selecione a opção Duplicar configurações de um processo.

  2. Selecione um projeto no menu suspenso Localizar um processo .

  3. Clique em Salvar.