Configurar um estado vazio

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Configure um estado vazio para informar aos usuários que uma página não contém dados no momento. Adicione uma imagem, texto e botões para personalizar o estado vazio e melhorar a experiência do usuário.

    Antes de Iniciar

    Seja criando um estado vazio padrão ou específico, os itens a seguir podem ser necessários se você planeja exibir uma imagem ou botão:

    • Uma imagem da tabela Anexos [sys_attachment].
    • Ações de botão definidas da tabela Função [sys_sg_button]. Para obter mais informações, consulte Configurar um botão inteligente.

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Esta tarefa explica como configurar um estado vazio padrão usado em todas as telas. Para obter informações sobre como personalizar estados vazios para telas específicas, consulte os seguintes tópicos:

    Procedimento

    1. Crie um cartão, que é o receptculo onde você define elementos de estado vazios e seus atributos.
      1. Na IU baseada na Web, insira sys_sg_view_config.list no navegador de filtros.
      2. Selecione Novo para criar um cartão.
      3. No formulário, preencha os campos.
        Tabela 1. Formulário de cartão
        Campo Valor
        Nome Título do cartão.
        Aplicação Aplicativo com escopo associado a este registro. Este campo é padronizado para o aplicativo atual.
        Descrição Descrição opcional do cartão.
        Ativo Opção para habilitar a exibição da configuração do cartão no estado vazio. Para esta configuração, selecione esta opção.
        Tabela Nenhuma tabela é necessária para este cartão.
        Modelo de cartão O valor deve ser Modelo de estado vazio padrão.
      4. Clique com o botão direito do mouse no cabeçalho e selecione Salvar.
    2. Selecione um elemento para adicionar ao cartão.
      1. No formulário Elementos de cartão, selecione Novo.
      2. No formulário, preencha os campos.
        Tabela 2. Formulário Elementos de cartão
        Campo Valor
        Nome Um título para o elemento do cartão.
        Cartão Este campo é definido automaticamente com o nome do novo cartão.
        Aplicação Aplicativo com escopo associado a este registro. Este campo é padronizado para o aplicativo atual.
      3. No campo Exibir slot de modelo, selecione o ícone de pesquisa de referência ( ícone de pesquisa de referência) e selecione um slot de modelo para adicionar ao elemento do cartão.
        Nome do elemento Descrição
        es-image-slot-1 O elemento de imagem do estado vazio. Você pode usar apenas uma imagem.
        es-text-slot-1 O elemento de cabeçalho da mensagem, que é exibido em negrito.
        es-text-slot-2 O elemento do corpo da mensagem que é exibido em uma fonte sem negrito.
        e-botão-slot-1 O elemento do botão superior do estado vazio.
        e-botão-slot-2 O elemento do botão do meio do estado vazio.
        e-botão-slot-3 O elemento do botão inferior do estado vazio.
      4. Clique com o botão direito do mouse no cabeçalho e selecione Salvar.
    3. Configure atributos para a imagem, o texto ou o elemento de botão que você adicionou ao cartão.
      ElementoAção
      Imagem
      1. No formulário Atributos de elemento de cartão, selecione Novo.
      2. Defina os seguintes valores:
        • Nome: use o ícone de pesquisa de referência e selecione ImageURL.
        • Descrição: descrição opcional do elemento.
        • Valor: cole o sys_id da imagem da tabela Anexos [sys_attachment].
          Nota:
          Para localizar o sys_id de um elemento, clique com o botão direito do mouse no nome do elemento e selecione Copiar sys_id.
      3. Selecione Enviar.
      Texto
      1. No formulário Atributos de elemento de cartão, selecione Novo.
      2. Defina os seguintes valores:
        • Nome: use o ícone de pesquisa de referência e selecione TextValue.
        • Descrição: descrição opcional do elemento.
        • Valor convertido: insira o texto do botão. Este texto será traduzido se ocorrer uma tradução da IU.
      3. Selecione Enviar.
      Botão
      Nota:
      Os elementos de botão exigem a configuração dos atributos TextValue e Botão.
      1. No formulário Atributos de elemento de cartão, selecione Novo.
      2. Defina os seguintes valores:
        • Nome: use o ícone de pesquisa de referência e selecione TextValue.
        • Descrição: descrição opcional do elemento.
        • Valor convertido: insira o texto do botão. Este texto será traduzido se ocorrer uma tradução da IU.
      3. Selecione Enviar.
      4. No formulário Atributos de elemento de cartão, selecione Novo.
      5. Defina os seguintes valores:
        • Nome: use o ícone de pesquisa de referência e selecione Botão.
        • Descrição: descrição opcional do elemento.
        • Valor: cole o sys_id da imagem da tabela Função [sys_sg_button].
          Nota:
          Para localizar o sys_id de um elemento, clique com o botão direito do mouse no nome do elemento e selecione Copiar sys_id.
      6. Selecione Enviar.

      Os elementos de botão também podem incluir os seguintes atributos opcionais: BackgroundColor, EdgeColore TextColor. Você pode definir cores diferentes das configurações padrão para um botão fornecendo um nome de cor de tema (por exemplo, primária) ou um valor de cor RGB (por exemplo, #8a8a8a).

    4. Opcional: Adicione outro elemento de cartão e atributos adicionais. Repita a Etapa 2 e a Etapa 3.
    5. Anexe o cartão ao estado vazio.
      1. Na IU baseada na Web, insira sys_sg_empty_state.list no navegador de filtros para abrir uma lista de estados vazios.
      2. Selecione Novo para criar um estado vazio.
      3. No formulário, preencha os campos.
        Tabela 3. Formulário de estados vazios
        Campo Valor
        Nome Título do registro de estado vazio. O estado vazio padrão ou um estado vazio específico da tela.
        Aplicação Aplicativo com escopo associado a este registro. Este campo é padronizado para o aplicativo atual.
        Descrição Descrição do estado vazio.
        Cartão O registro do cartão que você criou.
        Ativo Opção para habilitar a exibição do estado vazio.
      4. Selecione Enviar.

    Resultado

    Um estado vazio é exibido em qualquer tela que não contenha dados.