CMS para Portal de serviços transição

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 6 min. de leitura
  • Seu CMS pode incluir formulários complexos e personalizações que não são renderizados conforme o esperado em Portal de serviços. Use este guia para entender a melhor forma de modificar sua implementação de CMS e Catálogo de serviços para adoção de Portal de serviços e para entender como uma conversão pode afetar os usuários.

    Se você está considerando fazer a transição do CMS para Portal de serviços, certifique-se de entender o impacto da mudança para um ambiente móvel. Revise o script e a migração do GlideForm do cliente móvel (formulário g).

    Nota:
    Para obter informações sobre como redirecionar usuários do CMS para Portal de serviços, consulte o artigo Como redirecionar automaticamente usuários que navegam para qualquer página do CMS para o Portal de serviços [KB0722455] na Base de conhecimento do Now Support.

    Nível de suporte e ações de transição

    componente CMS

    Suporte Portal de serviços

    Possíveis ações de transição
    Pesquisas de dados

    O componente do lado do cliente de uma pesquisa de dados não é compatível com Portal de serviços. No entanto, a pesquisa de dados é aplicada na plataforma quando um registro é enviado ou atualizado em Portal de serviços.

    Embora as pesquisas de dados não sejam aplicadas no Portal de serviços, o registro é atualizado conforme o esperado na IU da plataforma quando enviado ou atualizado no Portal de serviços. Se o seu CMS for usado somente por solicitantes, essa limitação pode não afetar sua implementação.

    Blocos de conteúdo

    Como os blocos de conteúdo usam Jelly, eles não são compatíveis com Portal de serviços

    .

    No Portal de serviços, os blocos de conteúdo são substituídos por widgets. Widgets são componentes altamente personalizáveis que podem consultar dados de registro, exibir e atualizar registros e coletar entradas do usuário.

    Os widgets do sistema de base geralmente cobrem a maioria dos casos de uso. Assim como você adiciona blocos de conteúdo a uma página no seu CMS, você pode adicionar widgets a uma página usando o Portal de serviços Designer.

    Macros de IU

    Como as Macros de IU usam Jelly, elas não são compatíveis com Portal de serviços.

    • Em Portal de serviços, você pode usar widgets em vez de Macros de IU. Os widgets do sistema base geralmente cobrem a maioria dos casos de uso, mas para soluções personalizadas, você pode desenvolver novos widgets usando o AngularJS.
    • Se a sua implementação incluir Macros de IU em formulários Catálogo de serviços que fazem referência a outros campos ou variáveis no formulário, você pode incorporar o widget dentro de uma variável Catálogo de serviços. Saiba mais: Substitua um script de formulário Catálogo de serviços por um widget.
    Ações de IU

    Todas as ações de IU do lado do servidor são compatíveis com Portal de serviços, embora as operações setRedirectURL() sejam ignoradas porque os formulários Portal de serviços lidam com o redirecionamento de uma maneira diferente da plataforma.

    O widget de formulário ignora todas as ações de IU marcadas como Cliente.

    • Refatore todas as ações de IU para remover operações setRedirectURL().
    • Verifique se as ações de IU não estão marcadas como cliente.
    Client scripts de catálogo

    Somente as opções de tipo de IU Móvel/Portal de serviços e Todos são compatíveis. O tipo de IU Desktop não é compatível com Portal de serviços. Para obter uma lista de APIs compatíveis, consulte Portal de serviços e client scripts.

    Nota:
    Chamadas JavaScript síncronas não são compatíveis com Portal de serviços e devem ser substituídas por chamadas assíncronas. Por exemplo, o método getXMLWait() da classe GlideAjax não é compatível com Portal de serviços. Em vez disso, use um dos seguintes métodos assíncronos compatíveis:
    • getXML (retorno de chamada da função)
    • getXMLAnswer(retorno de chamada da função)

    Para obter informações adicionais sobre o GlideAjax, consulte GlideAjax.

    Para entender o impacto da atualização do seu CMS para funcionar em um ambiente móvel, revise o script e a migração do GlideForm (formulário g) do cliente móvel.

    • Atualize seus scripts para remover APIs de cliente incompatíveis.
    • Verifique se o Tipo de IU do script está definido como Móvel/Portal de serviços ou Todos.
    Políticas de IU

    As políticas de IU com script só podem usar APIs compatíveis com Portal de serviços. Para obter uma lista de APIs compatíveis, consulte Portal de serviços e client scripts.

    Atualize seus scripts para remover APIs de cliente incompatíveis.

    Variáveis do Catálogo de serviços

    Catálogo de serviços variáveis são compatíveis com Portal de serviços com as seguintes exceções:

    • Macros de IU e tipos de variáveis de páginas de IU não são compatíveis.
    • Scripts de validação para variáveis não são compatíveis. Os tipos de validação compatíveis incluem:
      • O campo obrigatório no formulário de variável.
      • Variáveis somente leitura.
      • Todos os campos na guia Disponibilidade do formulário de variável.
    • O tamanho de variável padrão não é compatível.
    • Não há suporte para expandir e recolher o texto de ajuda. Em vez disso, os campos Texto de ajuda e Instruções definidos na guia Anotações no formulário de variável são sempre expandidos. O marcador da Ajuda não é exibido.
    • A variável List Collector é exibida como uma lista de seleção em vez de um slushbucket no Portal de serviços.
    • Se estiver incorporando um widget em um formulário de item do catálogo, você poderá usar o tipo de variável Macro de IU. Saiba mais: Substitua um script de formulário Catálogo de serviços por um widget.
    • Se estiver usando variáveis com anotações, certifique-se de testar os itens do catálogo em Portal de serviços para garantir que o texto de ajuda seja exibido conforme o esperado.
    Guias de pedidos

    Guias de pedido em Portal de serviços usam o widget Guia de pedido.

    Guias de pedido grandes podem causar problemas de desempenho no Portal de serviços. Se você tiver guias de pedido grandes, poderá:

    Produtores de registro

    Produtores de registro são usados em Portal de serviços com as seguintes diferenças:

    • A ordem de classificação dos itens do catálogo nos produtores de registro não é respeitada.
    • Os valores de data não respeitam o fuso horário quando o produtor de registro envia um registro.

    Certifique-se de testar todos os produtores de registro usados em Portal de serviços para garantir que eles se comportem conforme o esperado.

    Cenários de login e redirecionamentos

    No CMS, você usou a inclusão de script CMSEntryPage para definir cenários de login. Em vez disso, Portal de serviços usa a inclusão de script SPEntryPage e as propriedades do sistema relacionadas para definir cenários de login. Redirecionamentos não são compatíveis com Portal de serviços.

    Em Portal de serviços, defina o comportamento de login modificando a inclusão de script SPEntryPage e definindo as propriedades do sistema.

    Para obter mais informações, consulte Single Sign-on, logins e redirecionamentos de URL.

    Catálogo de serviços formulários

    Catálogo de serviços formulários como itens do catálogo e produtores de registro são renderizados em widgets em um layout de duas colunas. Formulários complexos podem não ser exibidos conforme o esperado.

    • Somente as configurações de contêiner de nível superior são respeitadas. Se houver outros contêineres no contêiner de nível superior, eles serão renderizados como uma única coluna. Se houver divisões de contêiner ou contêineres aninhados nesses contêineres adicionais, eles serão renderizados como uma única coluna. Um contêiner de nível superior não é secundário de nenhum outro contêiner.
    • Pode haver no máximo duas colunas em Portal de serviços. Se a sua implementação incluir formulários com mais de duas colunas, os campos serão reorganizados em duas colunas em Portal de serviços.
    • Conjuntos de variáveis são tratados como contêineres. Todas as regras listadas anteriormente se aplicam a conjuntos de variáveis, bem como a todos os contêineres dentro deles.
    • O tamanho de variável padrão não é compatível com Portal de serviços.
    Carrinho

    O Portal de serviços inclui um widget de carrinho de compras do sistema de base.

    Use o widget Carrinho de compras.