Header Web
Logo_PHC_Software
Manuais
Objetos Internos

Esta opção permite ao utilizador criar objetos nos ecrãs da aplicação, que pertencem à tabela e que não estão visíveis.
Dos campos que o utilizador dispõe, existe um separador dedicado à criação de atalhos e outro onde o utilizador define o(s) package(s) onde se poderá usufruir do Objeto Interno.
Quando o utilizador acede ao registo em modo de consulta, também poderá interagir com o mesmo.
Ao longo da descrição dos elementos que constituem este ecrã, será apresentado o exemplo de um objeto de interno, visível numa grelha de um ecrã, entre outros exemplos.

Estes objetos podem ser criados por exemplo, nas grelhas e nas opções de procura dos ecrãs. Surgindo desde logo duas questões:
O que são grelhas?
São objetos que mostram o resultado de uma procura, por exemplo, quando é feita uma procura de todos os artigos. Por exemplo, as linhas dos dossiers internos também são consideradas grelhas.
Nota: O objeto de Grelha é do tipo: Webcontrollib.nossogrid.

O que são opções de procura?
São os locais onde se definem as condições de procura de registos.
Caso o utilizador adicione objetos do tipo lógico nas opções de procura, não é possível efetuar a procura tendo em conta este tipo de campos (lógicos).
Nota: O objeto de procura é do tipo: System.web.ui.htmlcontrols.htmltablecell.


Em modo de Introdução/Alteração
Form onde este campo será colocado (nome simples do ecrã sem a extensão .ASPX)

  • Nome do ecrã onde o objeto interno irá aparecer.
    Por exemplo: stvlist

    Inativo
    Quando esta opção está inativa, o objeto não aparece no ecrã onde o utilizador o havia criado.

    Tipo de ação
    Estão disponíveis dois tipos de ação. Os tipos são: Campo e Botão opções avançadas.
     
    Nota
    A opção "Botão opções avançadas" apenas está disponível na gama Enterprise. Está disponível quando o parâmetro "Usa grelha de processamento em servidor" está inativo.
     

Caso escolha o tipo de ação Campo, ficam disponíveis os seguintes campos:

 

Nome do campo na base de dados

Deve indicar neste local qual o campo na base de dados. Entre as várias formas de que o utilizador dispõe para identificar o campo de uma Base de Dados, poderá fazê-lo também através do Dicionário de Dados.
Por exemplo: stock

Expressão do campo ( no caso de ser uma expressão )
Serve para introduzir a expressão sql referente ao campo criado.
Por exemplo: case when st.stock>0 then ´Há Stock´ else ´Esgotado´ end
Nota: Não é possível utilizar Objetos Internos em ecrãs que tenham tabelas de buffer associadas, pois quando o ecrã está em modo introdução está a usar a tabela de buffer (ex: EBI) e quando está em modo de consulta está a usar a tabela que não é de buffer (ex: BI), não sendo assim compatível a expressão com as duas tabelas.

Título do campo
Qual o título que pretende que apareça no ecrã.
Exemplo: Disponibilidade de Stock

Tooltip do campo
Neste campo o utilizador pode colocar um texto que auxilie na utilização em simultâneo, informe qual o objetivo do campo.

Tabela (caso seja diferente da tabela principal)
Neste campo o utilizador pode definir uma tabela secundária, como por exemplo, a tabela "Dossiers Internos - Outros Dados (.bo2)" do ecrã de Dossiers Internos. Assim, o utilizador tem ao seu alcance a utilização dos campos das tabelas complementares na utilização de Objetos Internos.
Apresentam-se as tabelas complementares que se podem utilizar neste campo, bem como os respetivos ecrãs:

Tabelas BO2 e BO3:

Local do ecrã
Serve para introduzir o nome do objeto onde quer que apareça o objeto interno que vai ser criado. Ou seja, local do ecrã onde será adicionado ("Atalho" se este objeto for um atalho).
Exemplo: grid1
 

Número interno da série do documento 

Permite indicar os números internos de séries de documentos de faturação, dossiers internos, recibos c/c e recibos de adiantamento onde, de forma exclusiva, apareceram os objetos de ecrã. Ou seja, com o preenchimento deste campo podemos controlar a visibilidade tendo em conta as séries preenchidas. Se o campo estiver vazio, o objeto de ecrã aparece em todas as séries mas caso coloque uma ou mais séries, apenas irá aparecer nessas séries. Em ecrãs onde não possua a série mencionada o valor é ignorado e por isso não aparece.

Nota
  • O campo Número interno da série do documento apenas está disponível se o objeto for do tipo Campo.
  • Pode colocar mais do que uma série no campo Número interno da série do documento. As séries devem estar separadas por vírgula (“,”).
  • O campo Número interno da série do documento não tem qualquer controlo sobre o valor do campo, portanto, não irá controlar se o utilizador coloca texto ou caracteres especiais no campo.

 

Esta funcionalidade está disponível apenas na nova grelha de processamento em browser, pelo que, caso tenha o parâmetro "Usa grelha de processamento em servidor" ativo, o objeto interno não irá aparecer. Ainda de relembrar que o campo Número interno da série do documento apenas está disponível nos objetos internos se tiver o PHC On ativo.

Informação
O ecrã de Recibos de c/c e Recibos de Adiantamento usam a grelha de processamento em servidor pelo que, não é possível utilizar objetos internos neste ecrã.



Tipo de campo
O tipo de campo pode ser: "Inteiro", "Numérico", "Data", "Memo", "Carater", "Lógico".

Ordem
Define a ordem em que o Objeto Interno será apresentado na grelha.
A aplicação terá determinado comportamento de acordo com o valor indicado no campo:
Nota: Em alguns ecrãs existem colunas que podem não estar visíveis em determinada situação, como o botão de apagar uma linha no ecrã de Faturação. Nestes casos, a ordem das colunas tem em conta a existência das mesmas.

Picture (formato) do campo
Serve para formatar a apresentação do objeto criado.

Só de leitura
Com esta opção ativa o objeto criado é só de leitura, não permitindo a sua alteração.

 

Caso escolha o tipo de ação Botão opções avançadas, ficam disponíveis os seguintes campos:

Título do campo

Qual o título que pretende que apareça na opção do botão.

Por exemplo: Escolher cor e tamanho

 

Função Javascript

Função que é executada quando selecionar o botão (Criado no ecrã "Javascript de Utilizador")

 

Função Javascript Visibilidade

Função que determinada se a opção está ou não visível (Criado no ecrã "Javascript de Utilizador").

 

Classe do Icon

Icon da nova opção.

Por exemplo: fa fa-plus

 

Local do ecrã

Grelha onde se pretende que apareça o botão opções avançadas com a nova opção.

Por exemplo: FiGrid

 

Nota
O botão das opções avançadas na grelha apenas está disponível na nova grelha (Grelha Client side).
 




Se o utilizador pretender criar opções de procura, em qualquer ecrã, poderá fazê-lo através de atalhos.
Por exemplo, imagine-se que quer na página principal da aplicação Suporte intranet web uma procura por número do pedido de assistência. Para tal, deverá nesta página definir qual a Tabela, neste caso seria a tabela PA. O URL de destino da procura (nome do form com a extensão .ASPX) é o caminho para o ecrã que pretende aceder, neste caso seria ../..suporteintranetweb/ass/paform.aspx
Como o atalho que se pretende é na página principal, o nome do ecrã seria: cindex e o nome do campo seria: Nº de PAT (número do PAT).

Se pretender limitar o acesso dos utilizadores ao atalho criado, pode ativar a opção Tem que possuir um determinado acesso à tabela:, indicar qual a tabela e indicar o <%= TopicLink([acesso],[Acessos]) %> que o utilizador deverá ter.




Um objeto interno pode ser criado em diversos ecrãs dos packages que o utilizador quiser, para tal basta clicar na opção pretendida, por exemplo:

 



link criado desta forma aparecerá na aplicação Extranet.

  • - Dossiers Internos (boform - Intranet)
    - Listagem de Dossiers (bolist - Intranet)
    - Encomendas (encform - Extranet)
    Tabelas FT2 e FT3:
    - Documentos de Faturação (ftform - Intranet)
    - Consulta de Documentos de Faturação (clftlist - Intranet)
    - Consulta de Documentos de Faturação (ftlist - Extranet)
    Tabela FO2:
    - Listagem de compras (flfolist - Intranet)
    Tabela STOBS:
    - Artigos e Serviços (sftorm - Intranet)
    - Escolha de Artigos/Serviços (stvlist - Intranet)
    - Escolha de Artigos/Serviços (stlist - Extranet)
  • - Caso seja superior ao nº de colunas mais 1 (um) da grelha, o campo Ordem é ignorado e é acrescentado o objeto no fim da grelha.
    - Caso seja menor ou igual a 0 (zero), o campo Ordem é ignorado e é acrescentado o objeto no fim da grelha.
    - Caso a seja maior do que 0 (zero) e inferior ao nº de colunas existentes na grelha mais um, o objeto é adicionado na coluna definida campo Ordem, considerando que a primeira coluna tem a ordem 1.
  •  
  •  




Em modo de consulta

  • À semelhança do que acontece em todos os ecrãs da aplicação, o utilizador pode usufruir das opções de registo, bem como procurar um registo, alterar e/ou apagar o mesmo.




Exemplos de Objetos internos

Como acrescentar uma coluna com a informação da existência ou não de stock na listagem de artigos?


  • Identificação do ecrã (form): STVLIST
    Nome do campo na base de dados: STOCK
    Expressão do campo ( no caso de ser uma expressão ): case when st.stock>0 then ´Há Stock´ else ´Esgotado´ end
    Título do campo: Disponibilidade de Stock
    Local do ecrã: GRID1
    Ordem: 4
    Tipo de Campo: Caracter
    Só de Leitura: [Ativo]
    Package ativo para Intranet


    Quando o utilizador for introduzir um Dossier (pela Intranet), ao adicionar artigos, através do ecrã "Escolha de Artigos/Serviços" encontrará a seguinte informação, de acordo com o exemplo (na coluna "Disponibilidade de Stock"):
     



    Como criar uma coluna nos dossiers com a informação da família de cada artigo?
    Identificação do ecrã (form): (uma das duas hipóteses)
    BOFORM (para utilizar nos dossiers em CRM Web ou Suporte Intranet Web)
    ENCFORM (para utilizar nos Dossiers, no ecrã de Encomendas)
    Nome do campo na base de dados: FAMILIA
    Título do campo: Família
    Local do ecrã: GRIDBI
    Ordem: 4
    Tipo de Campo: Caracter
    Só de Leitura: [Ativo]
    Package ativo para Intranet e/ou Extranet

    Se o utilizador tiver o objeto interno configurado para usufruir do mesmo, seja através da Intranet ou da extranet, após adicionar os artigos à linda do dossier ou encomenda, respetivamente, poderá visualizar a Família do artigo através da coluna criada com base neste exemplo.
     



    Como acrescentar o campo código postal na procura de contactos?
    Identificação do ecrã (form): EMLIST
    Nome do campo na base de dados: CODPOST
    Título do campo: Código Postal:
    Local do ecrã: OPCOES
    Ordem: 1
    Tipo de Campo: Caracter
    Package ativo para Intranet

    Mediante o exemplo apresentado, quando um utilizador aceder ao ecrã "Listagem de Contactos", poderá procurar um contacto com base no Código Postal.
     












  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  



E ainda:
A aplicação PHC CS Web permite aos utilizadores a possibilidade de criarem objetos internos para os diversos ecrãs da aplicação, que pertencem à tabela mas que não estão visíveis.
Assim, por exemplo, pode criar objetos internos editáveis nas grelhas de artigos para os ecrãs de "Dossiers Internos, "Faturação" e "Compras".
Com esta funcionalidade os utilizadores terão a possibilidade e a facilidade de obterem mais informação do que aquela que é apresentada nas grelhas de referências de produtos.