Adicionar propriedades personalizadas aos ativos do Gerenciamento de correspondência

Visão geral

Você pode personalizar a interface de usuário do Gerenciamento de correspondência e apresentar aos usuários um conjunto personalizado de propriedades e guias. Essa personalização inclui a adição de campos/propriedades e guias personalizados a tipos/letras de ativos específicos ou a todos os tipos de ativos e letras.

Adicionar propriedades personalizadas aos ativos do Gerenciamento de correspondência

Os seguintes cenários mostram como você pode adicionar propriedades/guias aos ativos e letras do Gerenciamento de correspondência:

  • Adicionar uma propriedade comum a todos os tipos de ativos
  • Adicionar uma guia comum a todos os tipos de ativos
  • Adicionar propriedades personalizadas a tipos de ativos específicos

Ao ajustar as propriedades, os caminhos e os valores nesses cenários, é possível adicionar propriedades e guias personalizadas a um conjunto diferente de ativos de acordo com suas necessidades.

Cenário: Adicionar um campo comum (propriedade) a todos os tipos de ativos

Este cenário mostra como você pode adicionar uma propriedade personalizada a todos os tipos de ativos (fragmentos de texto, lista, condição e layout) e as letras. Usando esse cenário, você pode adicionar uma propriedade, Localização de recipient, a todos os ativos e letras. A propriedade Location of recipient ajuda a identificar a área geográfica do delivery de um ativo ou letra relevante.

OBSERVAÇÃO

Se você já tiver adicionado uma propriedade personalizada, os start de propriedade aparecerão na página de criação do ativo. Para ocultar essa propriedade, consulte Mostrar/Ocultar propriedades personalizadas nas páginas Criação de ativos e Propriedades.

Propriedade personalizada adicionada a todos os tipos de ativos

Complete as etapas a seguir para adicionar uma propriedade personalizada a todos os tipos de ativos e letras:

  1. Vá para https://'[server]:[port]'/[ContextPath]/crx/de e faça logon como Administrador.

  2. Na pasta apps, crie uma pasta chamada css com caminho/estrutura semelhante à pasta css (localizada na pasta ccrui) usando as seguintes etapas:

    1. Clique com o botão direito do mouse na pasta de itens no seguinte caminho e selecione Nó de sobreposição:

      /libs/fd/cm/ma/gui/content/cmmetadataproperties/commonproperties/col1/items

      Nó Sobreposição

    2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

      Caminho: /libs/fd/cm/ma/gui/content/cmmetadataproperties/common properties/col1/items

      Localização: /apps/

      Corresponder tipos de nós: selecionados

      Nó Sobreposição

    3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

    4. Clique em Salvar tudo.

  3. Na pasta de itens recém-criados, adicione um nó para a propriedade personalizada em todo o ativo (Exemplo: GeoLocation) usando as seguintes etapas:

    1. Clique com o botão direito do mouse na pasta de itens e selecione Criar > Criar nó.

      Criar nó no CRX

    2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

      Nome: GeoLocation (ou o nome que você deseja atribuir a essa propriedade)

      Tipo: nt:unstructed

      Criar nó: GeoLocation

    3. Clique no novo nó que você criou (aqui GeoLocation). O CRX exibe as propriedades do nó.

    4. Adicione as seguintes propriedades ao nó (aqui GeoLocation):

      Nome Tipo Valor
      fieldLabel Sequência de caracteres O nome que você deseja dar ao campo/propriedade. (Aqui: Localização dos recipient)
      name Sequência de caracteres ./extendedproperties/GeoLocation (Mantenha o valor igual ao nome do campo que você criou no nó de itens)
      renderReadOnly Booleano verdadeiro
      sling:resourceType Sequência de caracteres granite/ui/components/coral/foundation/form/textfield
    5. Clique em Salvar tudo.

  4. Para visualização da personalização, passe o mouse sobre um ativo (texto, lista, condição ou fragmento de layout) ou letra, clique em Propriedades da Visualização e clique em Editar. O novo campo (Localização dos recipient) é exibido na guia Básico nas propriedades do ativo/carta.

    OBSERVAÇÃO

    Talvez seja necessário limpar o cache do navegador antes que sua personalização apareça na interface do usuário.

    Propriedade personalizada adicionada a todos os ativos

    OBSERVAÇÃO

    As propriedades comuns de todos os ativos adicionados são exibidas na guia básica das propriedades do ativo. Por padrão, as propriedades comuns adicionadas para todos os ativos aparecem na página de propriedades, bem como na página de criação de ativos. Para ocultar as propriedades comuns, é necessário .

Cenário: Adicionar valores e lista suspensa personalizados a uma propriedade/campo personalizado

Este cenário mostra como você pode adicionar uma propriedade personalizada a todos os tipos de ativos e adicionar valores suspensos a ela.

  1. Clique com o botão direito do mouse na pasta de itens no seguinte caminho e selecione Nó de sobreposição:

    /libs/fd/cm/ma/gui/content/cmmetadataproperties/commonproperties/col1/items

  2. No nó de sobreposição recém-criado (/apps/fd/cm/ma/gui/content/cmmetadataproperties/common%20properties/col1/items?lang=pt-BR)
    Crie um nó para cada uma das propriedades (campos) para as quais você precisa criar uma lista suspensa (aqui geographicallocation) do tipo nt:unstructed.

  3. Adicione as seguintes propriedades ao nó (aqui geographicallocation) e clique em Salvar tudo:

    Nome Tipo Valor
    fieldLabel Sequência de caracteres O nome que você deseja dar ao campo/propriedade. (Aqui: geograficamente)
    name Sequência de caracteres ./extendedproperties/geographicallocation (Mantenha o valor igual ao nome do campo que você criou no nó itens)
    renderReadOnly Booleano verdadeiro
    sling:resourceType Sequência de caracteres granite/ui/componentes/coral/fundação/formulário/select
  4. Em nó de propriedade (aqui geographicallocation), adicione um novo nó com o nome items. No nó items, adicione um nó cada para os valores no menu suspenso. Como prática recomendada, adicione o primeiro nó como em branco para servir como valor padrão do menu suspenso e uma opção para o usuário não especificar nenhum valor para o campo. Para adicionar várias opções/valores suspensos, repita as seguintes etapas:

    1. Clique com o botão direito do mouse no nó da propriedade (aqui geographicallocation) e selecione Criar > Criar nó.

    2. Digite o nome do campo como item1, retenha o tipo como nt:unstructed e clique em OK.

    3. Adicione as seguintes propriedades ao nó recém-criado (aqui item1) e clique em Salvar tudo:

      Nome Tipo Valor
      texto Sequência de caracteres Esse é o valor da opção suspensa que está visível para o usuário. Mantenha-o em branco para o valor em branco (padrão) ou insira o valor, como International ou Within US.
      valor Sequência de caracteres Valor armazenado no CRXDE para o texto. Digite qualquer palavra-chave exclusiva.

      customizationdropdownvaluescrxde

    O menu suspenso personalizado aparece como o seguinte nas propriedades do ativo:

    drop-down_customization

    Cenário: Guia Comum para todos os tipos de ativos

    Este cenário mostra como você pode adicionar uma guia personalizada, Recipient, a todos os tipos de ativos (fragmentos de texto, lista, condição e layout) e as letras. A guia Recipient é onde você pode planejar colocar todas as suas propriedades personalizadas relevantes para os recipient.

    Guia personalizada adicionada para todos os tipos de ativos

    Usando o procedimento a seguir, é possível adicionar uma guia com um campo a todos os ativos:

    1. Vá para https://'[server]:[port]'/[ContextPath]/crx/de e faça logon como Administrador.

    2. Na pasta apps, crie uma pasta chamada cmmetadataproperties com caminho/estrutura semelhante à pasta cmmetadataproperties (localizada na pasta de conteúdo) usando as seguintes etapas:

      1. Clique com o botão direito do mouse na pasta cmmetadataproperties no seguinte caminho e selecione Nó de sobreposição:

        /libs/fd/cm/ma/gui/content/cmmetadataproperties

        Nó Sobreposição

      2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

        Caminho: /libs/fd/cm/ma/gui/content/cmmetadatapropriedades

        Localização: /apps/

        Corresponder tipos de nós: selecionados

      3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

        Estrutura da pasta de sobreposição criada no CRX

        Clique em Salvar tudo.

    3. Na pasta cmmetadataproperties, adicione um nó para criar uma guia personalizada para todos os ativos (Exemplo: commontab) utilizando as seguintes etapas:

      1. Clique com o botão direito do mouse na pasta cmmetadataproperties e selecione Criar > Criar nó.

        Criar nó

      2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

        Nome: commontab (ou o nome que você deseja atribuir a essa propriedade)

        Tipo: nt:unstructed

      3. Clique no novo nó que você criou (aqui commontab). O CRX exibe as propriedades do nó.

      4. Adicione as seguintes propriedades ao nó (aqui commontab):

        Nome Tipo Valor
        jcr:title Sequência de caracteres O nome que você deseja dar à coluna. (Aqui: Recipient)
        sling:resourceType Sequência de caracteres granite/ui/componentes/coral/fundação/container
        1. Clique em Salvar tudo.
      5. Para o nó de guia criado na última etapa (aqui commontab), crie um nó chamado item usando a seguinte etapa:

        1. Clique com o botão direito do mouse no nó relevante (aqui commontab) e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: itens

          Tipo: nt:unstructed

        3. Clique em Salvar tudo:

      6. No nó de itens criado na etapa anterior (em commontab), adicione um nó para criar uma coluna (aqui Coluna1) na guia personalizada (commontab) usando as seguintes etapas (para adicionar mais colunas, repita essa etapa):

        1. Clique com o botão direito do mouse no nó de itens e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: Coluna1 (ou o nome que você deseja dar ao nó - esse nome não aparece na Interface do usuário.)

          Tipo: nt:unstructed

        3. Adicione a seguinte propriedade ao nó (Coluna1 Aqui) e clique em Salvar tudo:

          Nome Tipo Valor
          sling:resourceType Sequência de caracteres granite/ui/componentes/coral/fundação/container
      7. No nó criado na etapa anterior (aqui Coluna1), adicione um nó chamado itens usando as seguintes etapas:

        1. Clique com o botão direito do mouse no nó (aqui Coluna1) e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: itens

          Tipo: nt:unstructed

        3. Clique em Salvar tudo.

      8. Para criar um campo na guia personalizada (aqui Recipient), adicione um nó (aqui Geogravação). Essa propriedade corresponde à coluna criada. Use as seguintes etapas para criar o campo (para criar mais campos/nós, repita essas etapas.):

        1. Clique com o botão direito do mouse no nó de itens e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: GeographicLocation (ou outro nome para a propriedade do campo)

          Tipo: nt:unstructed

        3. Adicione as seguintes propriedades ao nó de campo (aqui GeographicLocation) e clique em Salvar tudo.

          Nome Tipo Valor
          fieldLabel Sequência de caracteres Localização dos recipient (ou o nome que deseja fornecer ao campo).
          name Sequência de caracteres ./extendedproperties/GeographicLocation
          renderReadOnly Booleano verdadeiro
          sling:resourceType Sequência de caracteres /libs/granite/ui/components/coral/foundation/form/textfield
      9. Para adicionar essa guia para Cartas, crie uma pasta de sobreposição com caminho/estrutura semelhante à seguinte pasta de itens no seguinte caminho:

        /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/letter/items/tabs/items

        Para criar uma sobreposição para letras ou um ativo diferente, use o seguinte caminho substituindo [assettype] por texto, condição, lista, dicionário de dados ou fragmento:

        /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[assettype]/items/tabs/items

        1. Clique com o botão direito do mouse na pasta de itens no seguinte caminho e selecione Nó de sobreposição:

          /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/letter/items/tabs/items

        2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

          Caminho: /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/letter/items/tabs/items

          Localização: /apps/

          Corresponder tipos de nós: selecionados

        3. Clique em OK. A pasta é criada. Clique em Salvar tudo.

      10. Na pasta de itens recém-criados, adicione um nó para a guia personalizada no ativo (aqui mytab - esse nome não aparece na Interface do usuário) usando as seguintes etapas:

        1. Clique com o botão direito do mouse na pasta de itens e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: mytab (ou o nome que você deseja atribuir a essa propriedade)

          Tipo: nt:unstructed

        3. Clique no novo nó que você criou (aqui mytab). O CRX exibe as propriedades do nó.

        4. Adicione as duas propriedades a seguir ao nó (aqui guia personalizada):

          Nome Tipo Valor
          path
          Sequência de caracteres fd/cm/ma/gui/content/cmmetadataproperties/commontab
          sling:resourceType Sequência de caracteres granite/ui/componentes/coral/fundação/include
        5. Clique em Salvar tudo.

      11. Para visualização da personalização, passe o mouse sobre o ativo relevante (aqui uma letra), clique em Propriedades da Visualização e em Editar. A nova guia (Recipient) e o campo (Localização dos Recipient) são exibidos na interface do usuário.

        OBSERVAÇÃO

        Talvez seja necessário limpar o cache do navegador antes que sua personalização apareça na interface do usuário.

        Guia personalizada adicionada a letras

      Cenário: Adicionar propriedades personalizadas para tipos de ativos específicos

      Este cenário mostra como você pode adicionar uma propriedade a um tipo de ativo específico, como um campo para todos os ativos de texto. Usando esse processo, você pode adicionar propriedades a um dos seguintes:

      • Texto
      • Condição
      • Lista
      • Fragmento do layout
      • Dicionários de dados
      • Carta

      Por exemplo, somente para os ativos de texto, você deseja adicionar uma propriedade, Localização de recipient, para identificar a área geográfica à qual um ativo é relevante. Propriedade personalizada adicionada a um ativo

      Para adicionar uma propriedade a um tipo de ativo, conclua as seguintes etapas:

      1. Vá para https://'[server]:[port]'/[ContextPath]/crx/de e faça logon como Administrador.

      2. Para criar uma guia em um tipo de ativo (como Texto), crie a seguinte estrutura de pastas na pasta de aplicativos:

        /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[AssetType]/items/tabs/items

        [AssetType] = texto, condição, lista, letra, dicionário de dados ou fragmento

        Veja a seguir as etapas para criar esta estrutura de pastas:

        1. Clique com o botão direito do mouse na pasta de itens no seguinte caminho e selecione Nó de sobreposição:

          /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[AssetType]/items/tabs/items

          Por exemplo, se você deseja criar uma propriedade para ativos de texto, selecione a seguinte pasta:

          /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/text/items/tabs/items

          Nó Sobreposição

        2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

          Caminho: /libs/fd/cm/ma/gui/content/cmmetadataproperties/[AssetType]/items/tabs/items

          Localização: /apps/

          Corresponder tipos de nós: selecionados

        3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

          Clique em Salvar tudo.

      3. Na pasta de itens recém-criados, adicione um nó para a guia personalizada no ativo (Exemplo: customtab) usando as seguintes etapas:

        1. Clique com o botão direito do mouse na pasta de itens e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome:guia personalizada (ou o nome que você deseja atribuir a essa propriedade)

          Tipo: nt:unstructed

        3. Clique no novo nó que você criou (aqui, guia personalizada). O CRX exibe as propriedades do nó.

        4. Adicione as duas propriedades a seguir ao nó (aqui guia personalizada):

          Nome Tipo Valor
          sling:resourceType Sequência de caracteres granito/ui/componentes/coral/fundação/container
          jcr:title Sequência de caracteres O nome do campo na interface do usuário (aqui, guia Minha)
        5. Clique em Salvar tudo.

      4. No nó criado na etapa anterior (aqui customtab), adicione um nó chamado itens usando as seguintes etapas:

        1. Clique com o botão direito do mouse no nó (aqui, guia personalizada) e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: itens

          Tipo: nt:unstructed

        3. Clique em Salvar tudo.

      5. No nó de itens que você criou na etapa anterior (em customtab), adicione um nó para criar uma coluna (aqui Column1) na guia personalizada usando as seguintes etapas (para adicionar mais colunas, repita essa etapa):

        1. Clique com o botão direito do mouse no nó de itens e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: Coluna1 (ou o nome que você deseja dar ao nó)

          Tipo: nt:unstructed

        3. Adicione a seguinte propriedade ao nó (Coluna1 Aqui) e clique em Salvar Tudo.

          Nome Tipo Valor
          sling:resourceType Sequência de caracteres granite/ui/componentes/coral/fundação/container
      6. Para cada coluna criada (conforme especificado na etapa anterior - aqui Coluna1), crie um nó chamado item usando as seguintes etapas:

        1. Clique com o botão direito do mouse no nó de coluna relevante (aqui Coluna1) e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: itens

          Tipo: nt:unstructed

        3. Clique em Salvar tudo:

      7. Para cada uma das colunas criadas, crie um nó sob o nó de itens para criar um campo na nova guia na Interface do usuário. Repita essa etapa para criar mais campos na coluna:

        1. Clique com o botão direito do mouse no nó relevante (aqui, itens em Coluna1) e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: um nome de sua escolha (aqui GeoLocation)

          Tipo: nt:unstructed

        3. Adicione as seguintes propriedades ao nó e clique em Salvar tudo.

          Nome Tipo Valor
          fieldLabel Sequência de caracteres Localização dos recipient (ou o nome que deseja fornecer ao campo).
          name Sequência de caracteres ./extendedproperties/GeoLocation
          renderReadOnly Booleano verdadeiro
          sling:resourceType Sequência de caracteres granito/ui/componentes/coral/fundação/formulário/textfield
      8. Para visualização da personalização, passe o mouse sobre o ativo relevante (aqui um texto), clique em Propriedades da Visualização e em Editar. A nova guia e o campo (Localização dos Recipient) são exibidos na interface do usuário.

        OBSERVAÇÃO

        Talvez seja necessário limpar o cache do navegador antes que sua personalização apareça na interface do usuário.

        Propriedade personalizada adicionada a um ativo específico

      Exibir propriedades personalizadas na Página de criação de ativos

      Por padrão, as propriedades personalizadas adicionadas às novas guias estão visíveis somente na página de propriedades e não na página de criação de ativos, já que a página de criação de ativos não tem layout de guia. Para exibir as propriedades personalizadas na página de criação de ativos junto com outras propriedades, é necessário fazer o seguinte:

      1. Clique com o botão direito do mouse na pasta de itens no seguinte caminho e selecione Nó de sobreposição:

        /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items

      2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores, para letra. Para outros tipos de ativos, o caminho é fornecido na tabela a seguir:

        Caminho: /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/properties/items/letterproperties/items

        Localização: /apps/

        Corresponder tipos de nós: selecionados

        Dependendo do tipo de ativo, o caminho deve ser o seguinte:

        Tipo de ativo/documento Caminho a ser adicionado
        Texto /libs/fd/cm/ma/gui/content/createasset/createtext/jcr:content/body/items/form/items/textWizard/items/editproperties/items/tab1/items
        Lista /libs/fd/cm/ma/gui/content/createasset/createlist/jcr:content/body/items/form/items/listWizard/items/editproperties/items/tabs/tab1/items
        Condição /libs/fd/cm/ma/gui/content/createasset/createcondition/jcr:content/body/items/form/items/conditionWizard/items/editproperties/items/tab/items/tab1/items
        Fragmento /libs/fd/cm/ma/gui/content/createasset/createfragment/jcr:content/body/items/form/items/fragmentWizard/items/properties/items/tab2/items/tab1/items
        Carta /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/letterproperties/items
      3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

      4. No nó de itens de sobreposição que você criou, crie um nó com o nome col4 (ou qualquer outro nome) e clique em Salvar tudo.

        Por exemplo, a seguir está o nó de sobreposição criado para letras.

        /apps/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items

      5. Adicione as seguintes propriedades ao nó recém-criado (aqui col4) e clique em Salvar tudo:

      Nome Tipo Valor
      path Sequência de caracteres

      Esse caminho é o ponteiro para a coluna criada em:

      • Para a guia comum para todos os tipos de ativos: /apps/fd/cm/ma/gui/content/cmmetadataproperties/commontab/items/col1
      • Para propriedades diferentes para tipos de ativos diferentes: /apps/fd/cm/ma/gui/content/cmmetadataproperties/properties/items/tabs/items/customtab/items/col1
      sling:resourceType Sequência de caracteres granite/ui/componentes/coral/fundação/include

      customfieldappearance inmainproperties

      Propriedade personalizada, Idioma, que aparece na interface do usuário para criar uma carta

      Personalize a visualização de lista para mostrar as propriedades personalizadas

      Depois de adicionar uma propriedade personalizada aos ativos do Gerenciamento de correspondência, é necessário fazer outras alterações no CRX/DE para garantir que a propriedade personalizada seja exibida na interface do usuário do Gerenciamento de correspondência.

      Complete as etapas a seguir para exibir a propriedade personalizada na interface do usuário da lista de ativos do Gerenciamento de Correspondência:

      1. Vá para https://'[server]:[port]'/[ContextPath]/crx/de e faça logon como Administrador.

      2. Crie a seguinte estrutura de pastas na pasta de aplicativos:

        /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/lists/columns

        Veja a seguir as etapas para criar esta estrutura de pastas:

        1. Clique com o botão direito do mouse na pasta de colunas no seguinte caminho e selecione Nó de sobreposição:

          /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/lists/columns

        2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

          Caminho: /libs/fd/cm/ma/gui/content/cmassets/jcr:content/visualização/lista/columns

          Localização: /apps/

          Corresponder tipos de nós: selecionados

        3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

          Clique em Salvar tudo.

      3. Para cada uma das propriedades criadas, crie um nó sob o nó colunas para criar uma coluna na Interface do usuário. Repita esta etapa para criar mais colunas na interface do usuário:

        1. Clique com o botão direito do mouse no nó relevante (colunas) e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: um nome de sua escolha (aqui GeograficaLocation)

          Tipo: nt:unstructed

        3. Adicione as seguintes propriedades ao nó e clique em Salvar tudo.

          Nome Tipo Valor
          jcr:primaryType Nome

          nt:unstructured

          jcr:title Sequência de caracteres

          LocalizaçãoGeográfica

          Esse valor aparece como o cabeçalho da coluna na interface do usuário.

          classificável Booleano

          verdadeiro

          Um valor true significa que o usuário pode classificar os valores nesta coluna.

      4. Crie a seguinte estrutura de pastas na pasta de aplicativos:

        /libs/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage

        Veja a seguir as etapas para criar esta estrutura de pastas:

        1. Clique com o botão direito do mouse na pasta de colunas no seguinte caminho e selecione Nó de sobreposição:

          /libs/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage

        2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

          Caminho: /libs/fd/cm/ma/gui/components/admin/child pagerenderer/child listpage

          Localização: /apps/

          Corresponder tipos de nós: selecionados

        3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

          Clique em Salvar tudo.

      5. Copie o arquivo child listpage.jsp do seguinte local:

        /libs/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/childlistpage.jsp

        Cole o arquivo no seguinte local:

        /apps//fd/cm/ma/gui/components/admin/child pagerenderer/child listpage/.

      6. Abra o arquivo child listpage.jsp (/apps/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/childlistpage.jsp?lang=pt-BR) e faça as seguintes alterações:

        1. Adicione o seguinte à linha 19 do arquivo (após a declaração de direitos autorais).

          <%@page import="java.util.Map"%>
          
        2. Adicione o seguinte código de uma função que obtém valor para cada propriedade personalizada ao final do arquivo:

          <%!
              private String getCustomPropertyValue(Map<String, Object> extendedProperties, String propertyName) {
          
                  String propertyValue = "";
                  if (extendedProperties.containsKey(propertyName)) {
                      propertyValue = (String) extendedProperties.get(propertyName);
                  }
          
                  return propertyValue;
              }
          %>
          
        3. Adicione o seguinte antes de iniciar a tag <tr> (<tr <%= atrs.build() %>>):

          <%
              String GeoLocation = "";
              if (asset != null) {
                      Map<String, Object> extendedProperties = asset.getExtendedProperties();
                      if (extendedProperties != null) {
                          GeoLocation = getCustomPropertyValue(extendedProperties,"GeoLocation");
                      }
              }
          %>
          

          No código, GeoLocation é o valor definido na propriedade name ao criar o nó/campo personalizado. Ao criar um nó/campo personalizado, você especificou o nome da propriedade com ./extendedproperties/ prefixo: ./extendedproperties/GeoLocation. No código, o prefixo não é obrigatório.

        4. Para exibir a nova propriedade na interface do usuário, adicione uma tag TD como segue antes da tag de fechamento tr (</tr>):

          <td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(geographicalLocation) %>"><%= xssAPI.encodeForHTML(geographicalLocation) %></td>
          

          Para adicionar mais colunas, repita as etapas 6.3 e 6.4.

        5. Clique em Salvar tudo.

      7. Para visualização de sua personalização, abra a visualização de lista de fragmentos de documento ou letras nas quais você adicionou a propriedade personalizada.

        A coluna da interface do usuário e a propriedade adicionada neste procedimento são exibidas para todos os tipos de ativos. No entanto, os valores nessas propriedades podem ser inseridos e exibidos somente para os tipos de ativos para os quais você adicionou originalmente a propriedade personalizada.

        Por exemplo, usando o Cenário: Adicionar propriedades personalizadas para tipos de ativos específicos que você adiciona uma propriedade personalizada a ativos de texto, você pode inserir propriedades personalizadas somente em ativos de texto. No entanto, se você exibir essa propriedade personalizada na interface do usuário, a coluna será exibida para todos os tipos de ativos.

        custompropertyinlistview

      8. (Opcional) Por padrão, a nova coluna aparece como a última coluna na interface do usuário. Para fazer com que a coluna apareça em uma posição específica, adicione a seguinte propriedade ao nó da coluna:

      Nome Tipo Valor
      sling:orderBefore Sequência de caracteres

      O nome do nó da coluna no caminho "/libs/fd/cm/ma/gui/content/cmassets/jcr:content/visualiza%C3%A7%C3%A3o/lista/columns?lang=pt-BR" antes da qual a coluna personalizada precisa aparecer na interface do usuário.

      Aqui, se você quiser que a coluna Localização geográfica apareça antes (à esquerda de) da coluna Versão, adicione o nó propriedade sling:orderBefore ao GeoLocation no caminho ""/apps/fd/cm/ma/gui/content/cmassets/jcr:content/visualiza%C3%A7%C3%A3o/lista/columns/GeoLocation?lang=pt-BR" e defina o valor da propriedade como version.

      Quando você adiciona a propriedade sling:orderBefore para especificar o local da coluna, também é necessário atualizar a ordem da tag <td> correspondente especificada na etapa 6.4 deste procedimento. Por exemplo, nesse caso, é necessário garantir que a tag <td> de Localização Geográfica seja colocada antes da tag <td> da coluna Versão:

      <td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(geographicalLocation) %>"><%= xssAPI.encodeForHTML(geographicalLocation) %></td>
      <td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(version) %>"><%= xssAPI.encodeForHTML(version) %></td>
      

      Habilitar pesquisa para propriedades personalizadas

      Por padrão, a pesquisa de texto completo não inclui propriedades personalizadas que você adiciona à interface do usuário usando o CRX/DE.

      Para incluir as propriedades personalizadas na pesquisa, é necessário permitir a indexação de propriedades personalizadas.

      Para permitir a indexação de propriedades personalizadas, conclua as seguintes etapas:

      1. Vá para https://'[server]:[port]'/[ContextPath]/crx/de e faça logon como Administrador.

      2. Vá para /oak:index/cmLucenee adicione um nó chamado agregação sob ele.

        1. Clique com o botão direito do mouse na pasta cmLucene e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: agregações

          Tipo: nt:unstructed

        3. Clique em Salvar tudo.

      3. Na pasta recém-criada do agregação, adicione um nó cm:resource. E em cm:resource, adicione um nó chamado include0.

        1. Clique com o botão direito do mouse na pasta agregação e selecione Criar > Criar nó. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: cm:recurso

          Tipo: nt:unstructed

        2. Clique com o botão direito do mouse na pasta cm:resource e selecione Criar > Criar nó. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: include0

          Tipo: nt:unstructed

        3. Clique no novo nó que você criou (aqui inclua0). O CRX exibe as propriedades do nó.

        4. Adicione a seguinte propriedade ao nó (aqui inclua0):

          Nome Tipo Valor
          caminho Sequência de caracteres ExtendedProperties
        5. Clique em Salvar tudo.

      4. Vá para as propriedades no seguinte local e adicione um local de nó abaixo dele: /oak:index/cmLucene/indexRules/cm:resource/properties

        Repita essa etapa para cada uma das propriedades personalizadas que deseja adicionar à pesquisa.

        1. Clique com o botão direito do mouse na pasta de propriedades e selecione Criar > Criar nó.

        2. Verifique se a caixa de diálogo Criar nó tem os seguintes valores e clique em OK:

          Nome: local (ou o nome da propriedade personalizada que você deseja adicionar à pesquisa)

          Tipo: nt:unstructed

        3. Clique no novo nó que você criou (aqui, local). O CRX exibe as propriedades do nó.

        4. Adicione as seguintes propriedades ao nó (aqui local):

          Nome Tipo Valor
          analisado Sequência de caracteres verdadeiro
          name Sequência de caracteres ExtendedProperties/location (ou o nome da propriedade que deseja adicionar à pesquisa)
          propertyIndex Booleano verdadeiro
          useInSuggest Booleano verdadeiro
        5. Clique em Salvar tudo.

      5. Agora você pode usar valores de propriedade personalizados em uma pesquisa de texto completo para localizar ativos relevantes.

      OBSERVAÇÃO

      Se você ainda não conseguir pesquisar, isso pode ocorrer devido a um problema de indexação. Para reindexar, vá para o nó a seguir e altere o valor da propriedade "re-index" para true:

      /oak:index/cmLucene" e alterar o valor da propriedade

      Alterar a visualização padrão da página de pesquisa

      1. Vá para https://'[server]:[port]'/[ContextPath]/crx/de e faça logon como Administrador.

      2. Na pasta apps, crie uma pasta chamada lista com caminho/estrutura semelhante à pasta lista localizada em /libs/granite/ui/content/shell/omnisearch/search/singleresults/visualização:

        1. Clique com o botão direito do mouse na pasta de itens no seguinte caminho e selecione Nó de sobreposição:

          /libs/granite/ui/content/shell/omnisearch/searchresults/singleresults/views/list

        2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

          Caminho: /libs/granite/ui/content/shell/omnisearch/search/results/singleresults/visualização/lista

          Localização: /apps/

          Corresponder tipos de nós: selecionados

        3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

        4. Clique em Salvar tudo.

      3. No nó recém-criado, lista, adicione a seguinte propriedade e clique em Salvar tudo:

        Nome Tipo Valor
        sling:orderBefore
        Sequência de caracteres cartão
      4. A personalização mostra os resultados da pesquisa na visualização da Lista para todos os consoles, incluindo Forms e Documentos, Ativos e Sites.

      Alterar a visualização padrão da página de ativos

      OBSERVAÇÃO

      Essas etapas alteram a visualização padrão de todos os consoles, como Forms e Documentos, Ativos e Sites.

      1. Vá para https://'[server]:[port]'/[ContextPath]/crx/de e faça logon como Administrador.

      2. Na pasta apps, crie uma pasta chamada lista com caminho/estrutura semelhante à pasta de lista localizada em:

        /libs/fd/cm/ma/gui/content/cmassets/jcr:content/visualização/

        1. Clique com o botão direito do mouse na pasta de itens no seguinte caminho e selecione Nó de sobreposição:

          /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/list

        2. Certifique-se de que a caixa de diálogo Sobrepor nó tenha os seguintes valores:

          Caminho: /libs/fd/cm/ma/gui/content/cmassets/jcr:content/visualização/lista

          Localização: /apps/

          Corresponder tipos de nós: selecionados

        3. Clique em OK. A estrutura de pastas é criada na pasta de aplicativos.

        4. Clique em Salvar tudo.

      3. No nó recém-criado, lista, adicione a seguinte propriedade e clique em Salvar tudo:

        Nome Tipo Valor
        sling:orderBefore
        Sequência de caracteres cartão
      4. Limpe os cookies do navegador ou use o modo de incognito do navegador para visualização dos ativos. A página de ativos, por padrão, aparece no layout do cartão.

      Mostrar/ocultar propriedades personalizadas nas páginas Criação de ativos e Propriedades

      Para mostrar ou ocultar as propriedades personalizadas, conclua as seguintes etapas:

      1. No nó de propriedade personalizada, como geographicallocation, crie um novo nó com o nome "granite:rendercondition" do tipo "nt:unstructed".

      2. Adicione a seguinte propriedade ao nó e clique em Salvar tudo:

        Nome Tipo Valor
        sling:resourceType
        Sequência de caracteres fd/cm/ma/gui/components/admin/assetsproperties/custompropertyconfig
      3. Para ocultar essa propriedade na página de criação do ativo, adicione a seguinte propriedade a ela e clique em Salvar tudo:

        Nome Tipo Valor
        hideOnCreate
        Booleano verdadeiro
      4. Para ocultar a propriedade personalizada na página de propriedades dos ativos, adicione a seguinte propriedade a ela e clique em Salvar tudo:

        Nome Tipo Valor
        hideOnEdit
        Booleano verdadeiro

        Para exibir os valores novamente, redefina os valores da propriedade para false ou exclua as entradas da propriedade.

Nesta página