Feldhilfe (AJCXSD)

Dieser Bereich enthält die Kontraktbeschreibung im XSD-Format.
Diese Beschreibung enthält zwei Angabetypen: die aus der SData-Norm stammenden und die X3-spezifischen.

SData-Norm

Die Standard-SData-Informationen sind über die folgende Adresse zugänglich:   http://interop.sage.com/daisy/sdata/Metadata/TypicalSDataSchema.htm.
 

Spezifische Safe X3-Angaben

• Tag Schema.
  Angabe NameSpace (serp) von Safe X3 verwendet, um die spezifischen Informationen im Schema zu identifizieren.
  xmlns:serp="http://schemas.sage.com/sdata/serp/2010"
  
• Tag Import.
  Mit diesem Tag kann man andere XSD-Beschreibungen, die für die Verwendung des vorhandenen Kontrakts wichtig sind, angeben.
• serp:conName="xxxxxx".
  Dieses Attribut ermöglicht die Angabe des Safe X3-Codes des importierten Kontrakts. Im Rahmen des CRM-Kontraktes handelt es sich hier um die Angabe des 'gemeinsamen' Kontraktnamens in Sage X3, der die Beschreibung der Ressourcen enthält, die allen Kontrakten gemein sind und für den CRM-Kontrakt wichtig sind.
  
• Tag complexTypemit einem Attribut Nameder Form xxxx--type.
  Dieser Tag gehört zum Standard SData und beschreibt die Struktur einer Ressource.
  Diesem Tag können die Safe X3-spezifischen Attribute hinzugefügt werden:
• serp:trtCode="STRGC1TRAACO".
  Dieses Attribut ermöglicht die Angabe des Safe X3 Verarbeitungscodes, der die Verwaltung der Ressourcen-Zugriffe berücksichtigt: CRUDT-Arbeitsgänge (Create (Erstellen), Read (Lesen), Update (Aktualisieren), Delete (Löschen), Template (Entwurf)),
• serp:stcResCode="GC1TRAACO".
  Dieses Attribut ermöglicht die Angabe des Codes der Safe X3-Struktur, die die Ressource berücksichtigt,
• serp:stcClobMaxSize="12".
  Dieses Attribut ermöglicht die Angabe der maximalen clob-Größe, die die Verwaltung des Datenaustauschs zwischen dem Safe X3-Server und der Komponente "Safe X3 Java Bridge Server" ermöglicht.
   
• Tag complexTypemit einem Attribut Nameder Form xxxx--list.
  Dieser Tag gehört zum Standard SData und beschreibt den Collection-Zugriff einer Ressource.
  Diesem Tag können die Safe X3-spezifischen Attribute hinzugefügt werden:
• serp:trtCode="STRGCTTRAACO".
  Dieses Attribut ermöglicht die Angabe des Safe X3 Verarbeitungscodes, der die Verwaltung des Collection-Zugriffs berücksichtigt (Query),
• serp:stcColCode="GCTTRAACO".
  Dieses Attribut ermöglicht die Angabe des Codes der Safe X3-Struktur, die die Collection einer Ressource berücksichtigt,
• serp:stcClobMaxSize="12".
  Dieses Attribut ermöglicht die Angabe der maximalen clob-Größe, die die Verwaltung des Datenaustauschs zwischen dem Safe X3-Server und der Komponente "Safe X3 Java Bridge Server" ermöglicht.
• serp:maxQueryEntries="50".
  Dieses Attribut ermöglicht die Angabe der Maximalanzahl an über eine Abfrage zurückgegebenen Ressourcen.
  Durch diese Grenze kann vermieden werden, dass der Server zu oft aufgerufen wird. Der Client kann auf die folgenden Daten zugreifen, in dem er die Seiten nummeriert oder Suchkriterien vorgibt,
• serp:linkingQueryEntries="1000".
  Dieses Attribut ermöglicht die Angabe der Maximalzahl an über ein Linking-Programm zurückgegebenen Ressourcen.
  Dieses Attribut wird nur intern bei der Erstellung der Linking-Funktion verwendet.
   
• Tag Element in einem Tag complexType enthalten.
  Dieser Tag gehört zum SData-Standard und ermöglicht die Definition der Informationen, die zu einer SData-Ressource gehören.
  Jedes Element kann ein finales Element (Rubrik) oder ein andere Ressourcen betreffendes Element (Beziehung vom Typ Referenz, untergeordnet, Zuordnung) sein.
  
• Abfragenverwaltung - Filter.
  In einer Abfrage kann man die durch das Attribut canFilter="true" signalisierten Elemente verwenden.  
  
• Referenz- oder Zuordnungsbeziehungen
  Der Filter kann aus technischen Gründen nur eine einzige Ressourcenrubrik tragen.
  
  Beispiel: im CRM-Kontrakt: Die Struktur GC1TRAACO enthält das Feld BPCINV, das mit der Ressource invoiceTradingAccount verknüpft ist, die eine Referenzbeziehung hat.
  
  In diesem Fall enthält der Kontrakt:
• in der Beschreibung der Hauptressource und auf dem Element, das die Beziehung beschreibt, das Attribut Filter="byReference".
  Dieses Feld gibt die Benutzungsbeschränkung der in einer Abfrage eingeschlossenen Ressource an (Hinweis: nur zu Informationszwecken),
• in der Beschreibung der Hauptressource und auf dem einzigen Element. serp:reference="true".
  Dieses Attribut gibt die Rubrik an, die für eine Abfrage auf dieser eingeschlossenen Ressource verwendet werden kann.
  
• Abfrageverwaltung - von einer Eigenschaft erhaltene Collection.
  Sie werden verwendet, wenn die Anzahl der Daten unbekannt ist und die Seitennummerierungsmechanismen einer klassischen Query benötigt.
  Diese Abfragen sind möglich, wenn das Attribut canGet="true" auf dem Element positioniert ist, das die Zuordnungsbeziehung besitzt.
  
  Dies ist der Fall für Aufträge eines Kunden: 
     /tradingAccount('DIS001')/salesOrders.
   Man kann dieses Ergebnis auch über eine klassische Query erhalten
     /salesOrders=where tradingAccount.refrerence eq 'DIS001.
  
  Beispiel:Die Struktur GC1TRAACO enthält das Feld QCTORDER, das mit der Ressource salesOrders verknüpft ist, die eine Zuordnungsbeziehung hat.
   In der Anwendungsstruktur verwenden die Felder in diesem Fall die Codestruktur ASDCOLBV1.
  
  Auf Kontraktebene müssen auf dem die Zuordnungsbeziehung beschreibenden Element die Verarbeitung und die Unterprogramme, die diese Anfragen verarbeiten, angegeben werden:
• serp:trtQueryProperty - Verarbeitung,
• serp:spgQueryProperty -Unterprogramm.
  
• Tag Aufzählung.
• serp:Wert="99"
  Dieses Attribut ermöglicht die Erstellung einer automatischen Entsprechung zwischen dem Aufzählungswert SData (eine Zeichenkette) und dem im Safe X3-Rahmen verwendeten Wert (Positionsnummer des lokalen Menüs, das die Aufzählung verwaltet).