Aggiunta di elementi chiave esterna a una tabella predefinita

Una relazione di chiave esterna è una relazione tra una colonna estesa in qualsiasi tabella di database dell'applicazione e la tabella YFS_PERSON_INFO. È possibile creare elementi di chiave esterna per stabilire una relazione tra una colonna estesa e la tabella YFS_PERSON_INFO.

1. Copiare il file <runtime_sandbox>/repository/entity/extensions/Extensions.xml.sample come file <install_dirruntime_sandbox>/extensions/global/entities/your_custom_filename.xml oppure modificare il file XML di estensione esistente.
2. Modificare il file your_custom_filename.xml per aggiungere elementi chiave esterni come mostrato nel seguente esempio per ciascuna tabella che si desidera estendere. Per una descrizione degli attributi XML, consultare la tabella che segue l'esempio.

   <!-- element exposed to create foreign key relationship --> 
   <DBSchema>
    <Entities>
       <Entity TableName="REQUIRED">
        .
        .
         <!-- element exposed to create relationship with PERSON_INFO table -->
            <ForeignKeys>
              <ForeignKey ParentTableName="YFS_PERSON_INFO" 
                XMLName="YFSName1" >
                  <Attribute ColumnName="REQUIRED" 
                   ParentColumnName="PERSON_INFO_KEY" />
                </ForeignKey>
              <ForeignKey ParentTableName="YFS_PERSON_INFO" 
                XMLName="YFSName2" >
                  <Attribute ColumnName="REQUIRED" 
                   ParentColumnName="PERSON_INFO_KEY" />
              </ForeignKey>
              .
              .
            </ForeignKeys>
          .
          .
       </Entity>
      </Entities>
   </DBSchema>

   Attributo	Descrizione
   Ente
   TableName	Il nome della tabella per cui vengono aggiunti gli elementi chiave esterna. Ad esempio, YFS_ITEM.
   Entity/ForeignKeys/ForeignKey
   ParentTableName	Il nome della tabella principale per questo elemento chiave esterna. Nota: questo valore deve essere YFS_PERSON_INFO, che è l'unica tabella che attualmente supporta le relazioni di chiavi esterne.
   NomeXML	È possibile specificare la rappresentazione XML del nome elemento. Deve iniziare con il prefisso dell'entità principale. Ad esempio, se ParentTableName ha come prefisso YFS, l' XMlName deve iniziare con YFS. Per impostazione predefinita viene utilizzato il nome della tabella principale.
   Entity/ForeignKeys/ForeignKey/Attribute
   ColumnName	Specifica il nome colonna esteso dell'entità.
   ParentColumnName	Il nome colonna di YFS_PERSON_INFO che ha una relazione di elemento chiave esterna.

3. Creare una tag ForeignKey per ciascuna relazione di chiave esterna che si desidera aggiungere.
4. Più elementi chiave esterna possono essere correlati alla stessa tabella principale.
5. Estendere i modelli API corrispondenti per includere gli elementi chiave esterna seguendo le istruzioni in Estensione dei modelli API.
6. Creare e distribuire le estensioni.