Manual de Usuario del Subsistema de carga y edición de datos de la Plataforma #PerúCRIS

6.2. Vincular o referenciar ítems a través de su identificador único (UUID)

La Plataforma #PerúCRIS permite vincular ítems con otros que se encuentran en diferentes entidades del sistema. Por ejemplo: una publicación puede ser vinculada con su autor, o un Proyecto con las instituciones encargadas de su ejecución, etc.

Para poder vincular un ítem con los datos de otras entidades del sistema a través de la entrada masiva o en lote de información, es necesario conocer el identificador interno de dicho ítem (UUID) que se encuentra en el ítem a vincular dentro del propio Subsistema de carga y edición de datos de la institución. Cabe precisar que, para que la asociación entre ítems funcione, el ítem a vincular debe haber sido creado previamente y estar aprobado dentro del propio Subsistema de la institución, es decir, debe contar con la etiqueta de “Archivado”.

El UUID de un ítem lo podemos conocer de dos maneras:


Opción 1: A través de la URL del propio ítem.


  1. Ingresar a la Plataforma #PerúCRIS (https://www.perucris.pe/) con su usuario y contraseña, eligiendo el rol de su institución.

  2. Ir a la opción Mi DSpace.

3. Una vez ubicado un ítem, ingresar a él haciendo clic en el botón Ver, aparecerá el UUID en la URL de ese ítem.

Opción 2: Realizando una exportación del ítem:


  1. Seguir los mismos pasos que en la opción anterior.

  2. Dentro del ítem, ir a la sección Opciones y hacer clic en Exportar.

3. Elegir una de las opciones que permitan la exportación en formato XML. Por ejemplo: “institutionXX-perucris-cerif-xml” (donde XX = nombre de la colección donde se encuentra el ítem). En el ejemplo, como se va a exportar un ítem de la colección proyecto, se elige el formato “institutionproject-perucris-cerif-xml.

4. Finalmente, abrir el archivo exportado y encontrará el UUID como ID de ese ítem:

5. También puede utilizar la opción de exportación masiva de ítems de una determinada colección, para ello ver los pasos a seguir en la sección Exportar ítems de una colección en formato XLS para la carga masiva de datos. El UUID de los ítems exportados aparecerá en el archivo XLS generado.

Utilizando este ID (UUID), es posible hacer referencia a otros ítems para crear un vínculo entre ellos. Para ello, en la plantilla utilizada para la entrada masiva de ítems, colocar en el campo correspondiente el valor de dicho campo, seguido por “$$” y el UUID del ítem a vincular. Por ejemplo, en el caso de una publicación a la que se requiere vincular su autor, en el campo correspondiente colocar los datos de la siguiente manera:

Adicionalmente, el valor de dichos campos pueden tener el formato generated::<type>::<value> o referenced::<type>::<value>. La diferencia entre estos dos prefijos es que con "generated" se creará un nuevo ítem si no se encuentra, mientras que con "referenced" no. El comportamiento, por otra parte, es idéntico en el caso de que el ítem relacionado ya existiera.

Por lo tanto, para resumir las diferentes sintaxis por las que, por ejemplo, se puede vincular una publicación con una persona:

Federico García$$a469026b-af3e-4f53-8781-54242a709e48 --> vinculará la publicación con la persona que tenga el uuid “a469026b-af3e-4f53-8781-54242a709e48”, si ya existe; en caso contrario, no creará ningún vínculo.

Fernando García$$referenced::ORCID::0000-0002-1825-0097 --> vinculará la publicación con la persona que tenga el “ORCID = 0000-0002-1825-0097” si ya existe; si no existe esa persona, creará el vínculo una vez que se cree esa persona.

Fernando García$$generated::ORCID::0000-0002-1825-0097 --> vinculará la publicación con la persona que tenga “ORCID = 0000-0002-1825-0097” si ya existe; en caso contrario creará la persona con ese ORCID y la vinculará con la publicación.