#----------------------------------------------------------------------
#
# copa v: 20181126-2.1.2
#
# Schema supporting virtual navigational interfaces across LDAP 
# directories based on attributes that use the COPA coding.
#
# More information: http://www.rediris.es/ldap/copa/
#
# RedIRIS 2003-2018
# 
#----------------------------------------------------------------------
#
# Changelog
#
# 20181126 - 2.1.2
#          - Changed the copaRelatedAttr attribute example, from 
#            copaRelated, which has already been removed, to copaCode
#
# 20110519 - 2.1.1
#          - Changed from ISO-8859-1 to UTF-8
#
# 20070511 - 2.1.0 
#          - Added attribute copaExternalCode 
#          - Added objectClass copaLinkageIdentifier
#          - Changed copaCodeAttr, copaPrintAttr, copaRelatedAttr 
#            and copaCodeResourceAttr matching rules and syntax. Now:
#              EQUALITY caseIgnoreIA5Match
#              SUBSTR caseIgnoreIA5SubstringsMatch
#              SYNTAX 1.3.6.1.4.1.1466.115.121.1.26
#
# 20060324 - 2.0.1
#          - Added attribute copaAreaCode and removed SINGLE-VALUE to
#            attribute copaCode. Also, removed attribute copaRelated
#          - Added attribute copaDefVvNav
#          - Replaced copaNav with copaVvNav
#          - Modified copaVirtualViewNav. Now may contain copaDefVvNav
#            and copaVvNav
#
# 20060227 - 2.0.0
#          - Updated COPA schema to version 2
#          - Deleted copaN, ...
#
# 20030514 - 1.0.2
#          - Add SINGLE-VALUE to attributes copaN, copaCodeAttr, and 
#            copaPrintAttr
#          - Change numericStringMatch to numericStringSubstringsMatch 
#            in copaN
#
#----------------------------------------------------------------------

objectIdentifier RedIRIS 1.3.6.1.4.1.7547

objectIdentifier copa RedIRIS:4.4
objectIdentifier copaObjectClass copa:1
objectIdentifier copaAttributeType copa:2

#
# copaVvNav
#
# Descrip: Atributo que indica DN de vistas virtuales por los que se
#          realizará la navegación
#
# English: Defines DN of virtual views the navigational interface will
#          be based on
#
# Ejemplo: copaVvNav: idnc=recurso,dc=rediris,dc=es
#
attributetype ( copaAttributeType:1
    NAME 'copaVvNav'
    DESC 'Defines DN of virtual views the navigational interface will be based on'
    SUP distinguishedName )

#
# copaDefVvNav
#
# Descrip: Atributo que indica el DN de la vista virtual por defecto 
#          por la que se realizará la navegación
#
# English: Defines DN of default virtual view the navigational 
#          interface will be based on
#
# Ejemplo: copaDefVvNav: idnc=recurso2,dc=rediris,dc=es
#
attributetype ( copaAttributeType:2
    NAME 'copaDefVvNav' 
    DESC 'Defines DN of default virtual view the navigational interface will be based on'
    EQUALITY distinguishedNameMatch
    SINGLE-VALUE
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 )

#
# copaClassifBase
#
# Descrip: Indica el DN a partir del cual se encuentra la 
#          clasificación que se va a usar
#
# English: Defines the DN where the classification can be found
#
# Ejemplo: copaClassifBase: idnc=areas,idnc=classif,dc=rediris,dc=es
#          copaClassifBase: idnc=network,idnc=classif,c=rediris,dc=es
#
attributetype ( copaAttributeType:3 
    NAME 'copaClassifBase'
    DESC 'Defines the DN where classifications can be found'
    SUP distinguishedName )

#
# copaCodeAttr
#
# Descrip: Indica el nombre del atributo que almacenará los
#          códigos copa
#
# English: Defines the attribute holding the copa codes
#
# Ejemplo: copaCodeAttr: catreMainCode
#
attributetype ( copaAttributeType:4 
    NAME 'copaCodeAttr'
    DESC 'Defines the attribute holding the copa codes'
    EQUALITY caseIgnoreIA5Match
    SUBSTR caseIgnoreIA5SubstringsMatch
    SINGLE-VALUE 
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.26 )

#
# copaPrintAttr
#
# Descrip: Indica el nombre del atributo que que contiene el valor
#          que debe mostrarse en pantalla para el área en cuestión
#
# English: Defines the attribute holding the value to be shown by
#          the navigational interface
#
# Ejemplo: copaPrintAttr: areaName
#
attributetype ( copaAttributeType:5
    NAME 'copaPrintAttr'
    DESC 'Defines the attribute holding the value to be shown by the navigational interface'
    SUP copaCodeAttr )

#
# copaRelatedAttr
#
# Descrip: Indica el nombre del atributo que contiene las referencias
#          a otras áreas relacionadas
#
# English: Defines the attribute holding related areas
#
# Ejemplo: copaRelatedAttr: copaRelated
#
attributetype ( copaAttributeType:6
    NAME 'copaRelatedAttr'
    DESC 'Defines the attribute holding related areas'
    SUP copaCodeAttr )

#
# copaPrefix
#
# Descrip: Especifica el prefijo de la URN COPA que se usará en una 
#          vista virtual. Estará definido con el siguiente formato: 
#
#          <prefijo basico>:virtualview:<nombre>:<version>
#
# English: Defines the URN prefix that a virtual view will use. 
#          It's defined like this:
#
#          <basic prefix>:virtualview:<name>:<version>
#
# Ejemplo: copaPrefix: urn:mace:rediris.es:classif:catre:20051110-1.8
#
attributetype ( copaAttributeType:7
    NAME 'copaPrefix' 
    DESC 'Defines the URN prefix that a virtual view will use'
    EQUALITY caseIgnoreMatch
    SUBSTR caseIgnoreSubstringsMatch
    SINGLE-VALUE
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )

#
# copaAreaObjectClassName
#
# Descrip: Especifica la lista de objectClass que tendrán como mínimo
#          los elementos de una clasificación
#
# English: Defines the minimum list of objectClass for elements of a
#          classification 
#
# Ejemplo: copaAreaObjectClass: catreArea
#
attributetype ( copaAttributeType:8
    NAME 'copaAreaObjectClassName' 
    DESC 'Defines the minimum list of objectClass for elements of a classification'
    EQUALITY caseIgnoreMatch
    SUBSTR caseIgnoreSubstringsMatch
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )

#
# copaName
#
# Descrip: Atributo genérico para establecer el nombre de una
#          clasificación o área COPA
#
# English: Generic attribute which defines the name of a 
#          classification or a COPA area
#
# Ejemplo: copaName: Clasificación CATRE
# Ejemplo: copaName: Anatomía Humana
#
attributetype ( copaAttributeType:9 
    NAME 'copaName'
    DESC 'Generic attribute which defines the name of a classification or a COPA area'
    EQUALITY caseIgnoreMatch
    SUBSTR caseIgnoreSubstringsMatch
    SINGLE-VALUE
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )

#
# copaCode
#
# Descrip: Atributo genérico para indicar las áreas relacionadas
#          de un elemento basado en clasificación COPA. Estará 
#          definido mediante una URN con el siguiente formato: 
#
#          <prefijo de la URN COPA>:<codigo COPA>
#
# English: Generic attribute for defining the related area of a
#          COPA element. It's defined like this:
#
#          <COPA URN prefix>:<COPA code>
#
# Ejemplo: copaCode: urn:mace:rediris.es:virtualview:catre:20051110-1.0.8:a1b1c2
#
attributetype ( copaAttributeType:10
    NAME 'copaCode'
    DESC 'Generic attribute for saving a COPA code'
    EQUALITY caseIgnoreMatch
    SUBSTR caseIgnoreSubstringsMatch
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )

#
# copaAreaCode
#
# Descrip: Atributo genérico para albergar el código COPA (sin el 
#          prefijo URN) de un área de una clasificación.
#
# English: Generic attribute for saving a COPA area code (without 
#          COPA URN prefix)
#
# Ejemplo: copaAreaCode: a1b1
#
attributetype ( copaAttributeType:11
    NAME 'copaAreaCode'
    DESC 'Generic attribute for saving a COPA code'
    EQUALITY caseIgnoreMatch
    SUBSTR caseIgnoreSubstringsMatch
    SINGLE-VALUE
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )

#
# copaCodeResourceAttr
#
# Descrip: Indica el nombre del atributo que contiene el código COPA 
#          de un recurso sujeto a una vista virtual
#
# English: Defines the attribute holding the COPA code of a resource 
#          related to a virtual view
#
# Ejemplo: copaCodeResourceAttr: copaCode
#
attributetype ( copaAttributeType:12
    NAME 'copaCodeResourceAttr'
    DESC 'Defines the attribute holding the COPA code of a resource related to a virtual view'
    SUP copaCodeAttr )

#
# copaExternalCode
#
# Descrip: Atributo genérico para indicar las relaciones entre un área
#          y objetos externos. Está definido mediante una URN con 
#          el siguiente formato:
#
#          <prefijo de la URN>:<codigo>
#
# English: Generic attribute for defining relations between an area
#          and external objects. It's defined like this:
#
#          <URN prefix>:<code>
#
# Ejemplo: copaExternalCode: urn:mace:rediris.es:uma.es:app:nomina:2346
#
attributetype ( copaAttributeType:13
    NAME 'copaExternalCode'
    DESC 'Generic attribute for saving an external code'
    EQUALITY caseIgnoreMatch
    SUBSTR caseIgnoreSubstringsMatch
    SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )


#----------------------------------------------------------------------
# Object classes
#----------------------------------------------------------------------

#
# copaVirtualViewNav
#
# Descrip: Objeto para definir la vistas virtuales disponibles para
#          navegar por un directorio LDAP basado en códigos COPA
#
# English: Defines available virtual views for navigation inside a
#          LDAP directory by means of COPA codes
#
objectclass ( copaObjectClass:1  
    NAME 'copaVirtualViewNav'
    DESC 'Defines available virtual views for navigation inside a LDAP directory by means of copa codes'
    SUP top 
    AUXILIARY 
    MAY ( copaDefVvNav $ copaVvNav )
 )

#
# copaVirtualViewSpec
#
# Descrip: Objeto para definir las características de una vista 
#          virtual sobre una clasificación basada en códigos en 
#          formato copa
#
# English: Defines the navigational characteristics of a virtual 
#          view based on COPA codes
#
objectclass ( copaObjectClass:2
    NAME 'copaVirtualViewSpec'
    DESC 'Defines the navigational characteristics of a virtual view based on COPA codes'
    SUP top 
    STRUCTURAL
    MUST ( copaClassifBase $ copaPrefix $ copaName $ description $ 
           copaCodeAttr $ copaPrintAttr $ copaAreaObjectClassName $
	   copaCodeResourceAttr )
    MAY ( copaRelatedAttr )
 )

#
# copaArea
#
# Descrip: Objeto genérico para definir las características de un 
#          área de una clasificación basada en códigos en formato COPA
#
# English: Generic object for defining the characteristics of an area 
#          of a classification based on COPA codes
#
objectclass ( copaObjectClass:3
    NAME 'copaArea'
    DESC 'Generic object for defining the characteristics of an area of a classification based on COPA codes'
    SUP top 
    STRUCTURAL
    MUST ( copaAreaCode $ copaName $ description )
    MAY ( copaCode )
 )

#
# copaResource
#
# Descrip: Objeto genérico para definir una relación entre un recurso
#          y un área de una clasificación basada en códigos en formato
#          COPA
#
# English: Generic object for defining the relationship between a 
#          resource and an area of a classificatioon based on COPA 
#          codes
#
objectclass ( copaObjectClass:4
    NAME 'copaResource'
    DESC 'Generic object for defining the relationship between a resource and an area of a classificatioon based on COPA codes'
    SUP top
    AUXILIARY
    MUST ( copaCode )
 )

#
# copaLinkageIdentifier
#
# Descrip: Objeto genérico para definir una relación entre un área 
#          y un objeto externo
#
# English: Generic object for defining the relationship between an 
#          area and an external object
#
objectclass ( copaObjectClass:5
    NAME 'copaLinkageIdentifier'
    DESC 'Generic object for defining the relationship between an area and an external object'
    SUP top
    AUXILIARY
    MAY ( copaExternalCode )
 )

#----------------------------------------------------------------------