Compartilhar via

Configurar o formulário de lista

Você pode configurar o formulário de lista em uma lista ou biblioteca com cabeçalho, rodapé e corpo de formulário personalizados com uma ou mais seções com campos em cada uma dessas seções. A configuração do formulário não altera os dados no arquivo ou item de lista. Ela só altera a forma como eles são exibidos para os usuários que navegam pela lista ou biblioteca. Qualquer pessoa que possa criar e gerir vistas numa lista pode utilizar a configuração do formulário para configurar o formulário com cabeçalho, rodapé e corpo com secções.

Para configurar um formulário, você usará os formatadores JSON com os quais você já está familiarizado ao Formatar uma coluna ou uma exibição em uma lista ou biblioteca. A configuração do formulário permite que determinados elementos e atributos predefinidos criem o cabeçalho, rodapé e corpo personalizados com uma ou mais secções.

Introdução

Para configurar o formulário em uma lista ou biblioteca:

  1. Vá para a lista ou biblioteca para a qual você deseja configurar o formulário.

  2. Se você estiver em uma lista:

    • Abra um item para exibir os detalhes do item no formulário de exibição.

  3. Se você estiver em uma biblioteca de documentos:

    • Selecione um arquivo.
    • Selecionar ...
    • Selecionar mais
    • Selecionar propriedades

  4. Na parte superior do formulário, expanda o ícone Editar Formulário e, em seguida, selecione Configurar layout

    Configurar formulário de lista

  5. No painel Formatar, você pode optar por aplicar formatação aos seguintes seções de formulário:

    • Cabeçalho
    • Corpo
    • Rodapé

Configurar cabeçalho personalizado

  1. Para aplicar a formatação ao cabeçalho, selecione Cabeçalho na lista suspensa Aplicar formatação.

  2. Cole seu formatador de cabeçalho personalizado na área de entrada de texto JSON.

    Observação

    A configuração de formulário permite que determinados elementos e atributos pré-definidos criem o cabeçalho personalizado.

  3. Abaixo está um exemplo de um cabeçalho e JSON:

    Cabeçalho do formulário de lista personalizado 

    {
  "elmType": "div",
  "attributes": {
    "class": "ms-borderColor-neutralTertiary"
  },
  "style": {
    "width": "99%",
    "border-top-width": "0px",
    "border-bottom-width": "1px",
    "border-left-width": "0px",
    "border-right-width": "0px",
    "border-style": "solid",
    "margin-bottom": "16px"
  },
  "children": [
    {
      "elmType": "div",
      "style": {
        "display": "flex",
        "box-sizing": "border-box",
        "align-items": "center"
      },
      "children": [
        {
          "elmType": "div",
          "attributes": {
            "iconName": "Group",
            "class": "ms-fontSize-42 ms-fontWeight-regular ms-fontColor-themePrimary",
            "title": "Details"
          },
          "style": {
            "flex": "none",
            "padding": "0px",
            "padding-left": "0px",
            "height": "36px"
          }
        }
      ]
    },
    {
      "elmType": "div",
      "attributes": {
        "class": "ms-fontColor-neutralSecondary ms-fontWeight-bold ms-fontSize-24"
      },
      "style": {
        "box-sizing": "border-box",
        "width": "100%",
        "text-align": "left",
        "padding": "21px 12px",
        "overflow": "hidden"
      },
      "children": [
        {
          "elmType": "div",
          "txtContent": "='Contact details for ' + [$Title]"
        }
      ]
    }
  ]
}

  4. Para visualizar suas alterações, clique no botão pré-visualização.

  5. Para salvar suas alterações, clique no botão Salvar.

  6. Feche e abra o formulário novamente para exibir o cabeçalho personalizado.

  1. Para aplicar a formatação ao rodapé, no painel Formatar, selecione Rodapé na lista suspensa Aplicar formatação.

  2. Cole o formatador de rodapé personalizado na área de entrada de texto JSON.

    Observação

    A configuração de formulário permite que determinados elementos e atributos pré-definidos criem o rodapé personalizado.

  3. Abaixo está um exemplo de um rodapé e JSON personalizado:

    Rodapé do formulário de lista personalizado 

    {
    "elmType": "div",
    "style": {
        "width": "100%",
        "text-align": "left",
        "overflow": "hidden",
        "border-top-width": "1px"
    },
    "children": [
        {
            "elmType": "div",
            "style": {
                "width": "100%",
                "padding-top": "10px",
                "height": "24px"
            },
            "children": [
                {
                    "elmType": "a",
                    "txtContent": "='Contact Details for ' + [$Title]",
                    "attributes": {
                        "target": "_blank",
                        "href": "='https://aka.ms/contacts?email=' + [$Email]",
                        "class": "ms-fontColor-themePrimary ms-borderColor-themePrimary ms-fontWeight-semibold ms-fontSize-m ms-fontColor-neutralSecondary–hover ms-bgColor-themeLight–hover"
                    }
                }
            ]
        }
    ]
}

  4. Para visualizar suas alterações, clique no botão pré-visualização.

  5. Para salvar suas alterações, clique no botão Salvar.

  6. Feche e abra o formulário novamente para exibir o rodapé personalizado.

Configurar corpo personalizado com uma ou mais seções

  1. Para aplicar a formatação ao corpo, no painel Formatar, selecione Corpo no aplicar formatação à lista suspensa.

  2. Cole seu formatador de corpo personalizado na área de entrada de texto JSON.

  3. Ao contrário do cabeçalho e do rodapé, a configuração do corpo só permite a definição de uma ou mais seções e a adição de uma ou mais colunas em cada uma dessas seções.

    • Uma ou mais seções podem ser definidas para um corpo.
    • Cada seção pode fazer referência a uma ou mais colunas na lista ou biblioteca.
    • Uma coluna pode ser referenciada apenas em uma seção.
    • Se uma coluna for referenciada em várias secções, a primeira secção em que a coluna é referenciada terá precedência.
    • Uma coluna não referenciada em qualquer uma das seções será automaticamente referenciada na última seção.
    • Novas colunas adicionadas serão automaticamente referenciadas na última seção.

  4. Abaixo a estrutura JSON para começar a definir seções e fazer referências a colunas nas seções:

    {
  "sections": [
    {
      //give a display name for the section
      "displayname": "",
      "fields": [
        //reference your fields here using their display name
        "Title"
      ]
    },
    {
      //give a display name for the section
      "displayname": "",
      "fields": [
        //reference your fields here using their display name
      ]
    }
  ]
}

  5. Abaixo um exemplo de um corpo personalizado JSON com seções:

    {
  "sections": [
    {
      "displayname": "",
      "fields": [
        "Title"
      ]
    },
    {
      "displayname": "Details",
      "fields": [
        "Department",
        "Email",
        "Country"
      ]
    },
    {
      "displayname": "Application",
      "fields": [
        "Application Id",
        "Approver",
        "Reviewer"
      ]
    }
  ]
}

  6. Depois que o corpo é personalizado com uma ou mais seções, o formulário lista ou biblioteca alternará para um layout de várias colunas.

    Observação

    A configuração do corpo do formulário alternará o layout do formulário de lista ou biblioteca de uma coluna para um layout de várias colunas. Adicionaremos suporte para a configuração do corpo com o layout de uma coluna em uma atualização futura.

    Corpo do formulário de lista personalizado com seções

  7. Para visualizar suas alterações, clique no botão pré-visualização.

  8. Para salvar suas alterações, clique no botão Salvar.

  9. Feche e abra o formulário novamente para exibir o corpo personalizado.

Formatter Personalizado para Campos de Read-Only

Introdução

Listas da Microsoft oferece uma forma avançada de organizar informações e colaborar com a sua equipa. Com o aumento da criação de itens de lista baseados em IA, os utilizadores têm muitas vezes de ver, mas não editar determinados campos, como dados gerados pelo sistema ou detalhes adicionados ao bot. Para satisfazer esta necessidade, é proposta uma nova funcionalidade de formata personalizada para permitir que os campos apareçam como só de leitura em formulários de lista.

Por que Read-Only campos importam

Atualmente, os campos só de leitura estão ocultos de Novo Item e Editar formulários. Isto cria desafios quando os bots de IA ou os processos automatizados criam itens que contêm dados críticos que os utilizadores precisam de ver, mas não modificar. Por exemplo:

  • Um bot cria um pedido de suporte ao cliente com o Título do Problema de Detalhes do Problema, Descrição do Problema.
  • Os utilizadores devem ver estas informações para efetuar ações (por exemplo, enviar um e-mail), mas não podem alterá-las.

O novo formate personalizado resolve este problema ao permitir que estes campos sejam apresentados como só de leitura.

Como funciona o Formatter Personalizado

O formador personalizado introduz uma nova configuração JSON para marcar campos como só de leitura nas vistas de formulário.

Estrutura JSON

{
    "sections": [{}],
    "fieldsettings": [
        {
            "name": "fieldName",
            "readonly": true
        }
    ]
}
  • name: o nome interno do campo.
  • só de leitura: quando definido como verdadeiro, o campo é apresentado como só de leitura.

Comportamento em Vistas de Formulário Diferentes

O formate personalizado garante uma experiência de utilizador consistente:

  • Novo formulário de Item: o campo só de leitura não será apresentado.
  • Editar formulário: o campo é apresentado sem uma caixa de texto editável, semelhante a uma Coluna Calculada.
  • Editar todo o modo: o campo permanece visível e ineditável.

O botão Guardar funciona conforme esperado, sem modificações acidentais nos campos só de leitura.

Caso de Utilização de Exemplo

Imagine um bot CRM a criar pedidos de suporte com detalhes do Problema pré-preenchidos. Com este formato:

  • Título do Problema (só de leitura): os utilizadores podem ver e copiar o Título do Problema, mas não podem modificá-lo.
  • Descrição do Problema (só de leitura): os utilizadores podem ver e copiar a Descrição do Problema, mas não podem modificá-la.
  • Origem do Problema (só de leitura): os utilizadores podem clicar na ligação Origem do problema, mas não podem modificá-la.

imagem