Desenvolvimento > Dicionário de dados > Contrato SData 

Esta função permite repertoriar os contratos de trocas de dados utilizados no quadro da norma Sage Data (SData).

Esta norma descreve um protocolo de comunicação que permite de trocar os dados ou de utilizar serviços normalizados entre diferentes aplicações permitindo de simplificar a atualização de colocação em obra de inter operacionável. Ela está utilizada para as trocas entre produtos Sage, mas também para todo o sistema aderente a esta.

O estabelecimento SData disponível sobre o web ao endereço http://sdata.sage.com/ é o estabelecimento de referência sobre este sujeito e contém multi ligações descrevendo esta norma de maneira aprofundada.

A descrição do contrato está contida no bloco texto desta função sob a forma "Esquema de Definição" (Esquema Definição ou XSD). 
As indicações contidas na descrição são de duas naturezas :

  • Standard norma SData.
    A ligação http://interop.sage.com/daisy/sdata/Metadata/TypicalSDataSchema.htm fornece os detalhes da norma,
  • Específico Safe X3.
    O componente "Safe X3 Java Bridge Server" adapta o seu comportamento para tratar os pedidos SDAta. Estas informações lhe são fornecidas através de indicações específicas acrescentadas no esquema.

SEEREFERTTO Ver a ajuda sobre o campo contendo o contrato

A tabela dos contratos é uma tabela sistema. Isso significa que existe unicamente no dossier Enterprise Management. Elas são então comuns a todos os dossiers.

Os contratos SData tendo um código atividade standar não são modificáveis.
Os contratos específicos são identificados por um código atividade começando por "X", "Y" ou "Z". Os campos são modifiicáveis.

Afim de personalizar um contrato, é possível de duplicar um contrato standard e de explorar este contrato no componente "Safe X3 Java Bridge Server".

Pré-requisitos

SEEREFERTTO Consulte a docuemntação de Implementação

Gestão do ecrã

Ecrã de registo

Campos

Os seguintes campos estão presentes neste separador :

Características

Este código permite identificar o contrato SData..

  • Descr. (campo AJCDESZ)

No help linked to this field.

  • Activo (campo ENAFLG)

Esta check box permite de activar ou de desactivar a ficha corrente sem portanto perder o seu conteúdo.

No componente "Safe X3 Java Bridge Server", apenas os contratos activos serão disponíveis.

Este código de actividade permite marcar um desenvolvimento ou parametrização considerada como opcional (está então activado ou desactivado segundo o valor de indicador anexado ao código de actividade), mas igualmente de identificar os acréscimos específicos ou de reagrupar sob um mesmo código significativo um conjunto de elementos do dicionário devendo estar simultaneamente activados para permitir a uma funcionalidade do software de estar em obra.

Um código actividade começando por X, Y ou Z é considerado como específico.

  • Módulo (campo MODULE)

Sélectionnez un module pour le paramétrage.

Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.

  • Modo desenvolvimento (campo AJCDEVMOD)

Cette case permet, lorsqu'elle est cochée, d'activer le mode développeur. Ceci impose alors au serveur Bridge Java de vérifier que le contrat qu'il utilise contient les mêmes informations que celles stockées dans ce contrat.

En général, ce mode est à désactiver dans un environnement de production. En effet, cela permet au composant "Safe X3 Java Bridge Server" de charger le contrat lors de son premier accès et de ne pas vérifier en permanence un changement éventuel.

Esquema

  • campo AJCXSD

Esta zona contém a descrição do contrato sob um formato XSD.
Esta descrição comporta dois tipos de indicações : Aquelas relevando da norma SData e aquelas específicas a X3.

Norme SData

As informações relativas ao standard SData são disponíveis ao endereço seguinte :   http://interop.sage.com/daisy/sdata/Metadata/TypicalSDataSchema.htm.
 

Indicações específicas Safe X3

  • Baliza esquema.
    Indicação do NomeSpace (serp) utilizado por "Safe X3" para identificar as informações específicas no esquema.
    xmlns:serp="http://schemas.sage.com/sdata/serp/2010"
  • Baliza importação.
    Esta baliza permite referenciar outras descrições XSD necessária a utilização do presente contrato.
    • serp:conName="xxxxxx".
      Este atributo permite de indicar o código "Safe X3" do contrato importado. No quadro do contrato CRM, trata-se aqui de referenciar o nome do contrato "comum" em Sage X3, que contém a descrição dos recursos comuns a todos os contratos e necessários ao contrato CRM.
  • Baliza complexTypecom um atributo nomeda forma xxxx--tipo.
    Esta baliza pertence ao standard SData e descreve a estrutura de um recurso.
    Sobre esta "tag", os atributos específicos "Safe X3" podem ser acrescentados :
    • serp:trtCode="STRGC1TRAACO".
      Este atributo permite indicar o código do tratamento "Safe X3" que toma em carga a gestão dos acessos ao recurso : operações CRUDT (Criar, Ler, Update, Apagar, Template),
    • serp:stcResCode="GC1TRAACO".
      Este atributo permite de indicar o código da estrutura "Safe X3" Este atributo permite indicar o código da estrutura "Safe X3" que toma em carga o recurso,
    • serp:stcClobMaxSize="12".
      Este atributo permite indicar o tamanho máximo do "clob" permitem gerir a troca dos dados entre o servidor "Safe X3" e o componente "Safe X3 Java Bridge Server".
       
  • Baliza complexTypecom um atributo nomeda forma xxxx--tipo.
    Esta baliza pertence ao standard SData e descreve o acesso a uma coleção de um recurso.
    Sobre esta "tag", os atributos específicos "Safe X3" podem ser acrescentados :
    • serp:trtCode="STRGCTTRAACO".
      Este atributo permite indicar o código do tratamento "Safe X3" que toma em carga a gestão do acesso à coleção (Query),
    • serp:stcColCode="GCTTRAACO".
      Este atributo permite indicar o código da estrutura "Safe X3" que toma em carga a coleção de um recurso,
    • serp:stcClobMaxSize="12".
      Este atributo permite indicar o tamanho máximo do clob permitindo gerir a troca dos dados entre o servidor "Safe X3" e o componente "Safe X3 Java Bridge Server",
    • serp:maxQueryEntries="50".
      Este atributo permite indicar o número máximo de recursos devolvidos por uma interrogação.
      Este limite permite evitar muito solicitar o servidor. O cliente poderá aceder aos dados seguintes por paginação ou em afinando os critérios de pesquisa,
    • serp:linkingQueryEntries="1000".
      Este atributo permite indicar o número máximo de recursos devolvidos pelo programa de linking,
      Este atributo é utilizado unicamente no quadro interno de colocação em obra da função de linking.
       
  • Baliza elementocontido numa baliza "complexType".
    Esta baliza pertence ao standard SData e permite definir as informações pertencendo a um recurso SData.
    Cada elemento pode ser um elemento final (rubrica) ou um elemento afetando outros recursos (relação de tipo de referência, filhos, associação).
    • Gestão das interrogações - Filtro.
      É possível numa interrogação de utilizar os elementos assinalados pelo atributo canFilter="true".
      • Caso das relações referência ou associação
        O filtro não pode levar que sobre uma única rubrica do recurso para razões técnicos.

        Exemplo : no contrato CRM : A estrutura GC1TRAACO contém o campo BPCINV ligado ao recurso fatura "TradingAccount" que tem uma relação de tipo de referência.

        Neste caso, o contrato comporta :
          • na descrição do recurso principal e sobre o elemento descrevendo a relação, o atributo serp:filter="byReference".
            Este atributo indica a restrição de utilização do recurso incluido numa interrogação (Nota : a título de informação unicamente),
          • na descrição do recurso ligado e sobre o elemento único, o atributo: serp:reference="true".
            Este atributo indica a rubrica utilizavel por uma interrogação levando sobre este recurso incluido.
    • Gestão das interrogações - Coleção obtida a partir de uma propriedade.
      Elas são a utilizar quando o número de dados está desconhecido e necessita de ter os mecanismos de paginação de um query clássico.
      Estas interrogações são possiveis se o atributo canGet="true" está posicionado sobre o elemento possuindo a relação de tipo associação.

      Isto é o caso para as encomendas de um cliente : 
         /tradingAccount('DIS001')/salesOrders.
      SEEINFO É também possível de obter este resultado com a ajuda de um query clássico
        /salesOrders=where tradingAccount.refrerence eq 'DIS001.

      Exemplo:A estrutura GC1TRAACO contém o campo QCTORDER ligado ao recurso "salesOrders" que tem uma relação de tipo associação.
      SEEINFO Na estrutura aplicativa, os campos neste caso utilizam o código estrutura ASDCOLBV1.

      Ao nível contrato, falta indicar sobre o elemento descrevendo a relação associação o tratamento e o sub-programa carregados de tratar estes pedidos:
          • serp:trtQueryProperty - tratamento,
          • serp:spgQueryProperty -sub-programa.
  • Baliza enumeração.
    • serp:valor="99"
      Este atributo permite de fazer uma correspondência automática entre o valor de enumeração SData (uma cadeia de caracter) e o valor utilizado no quadro de "Safe X3" (número de linha do menu local gerando a enumeração).

Fechar

 

Listagens

Por defeito, os seguintes listagens estão associados à função :

 PRTSCR : Impressão ecran

Mas pode ser alterado por parametrização.

Botões específicos

Graças ao botão [Cópia], é possível de duplicar um contrato e de o personalizar.

Mensagens de erro

Não existe outra mensagem de erro, para além das mensagens genéricas.

Tabelas consideradas

SEEREFERTTO Consulte a docuemntação de Implementação