test

Guía del usuario de Service Registry 3.1

Publicación de objetos

    El proceso de publicación de objetos en Registry consta de tres pasos:

  1. Cree el objeto.

  2. Agregue datos u otros objetos y guárdelos en la memoria sin publicarlos en Registry.

  3. Publique el objeto en Registry.

Puede publicar objetos en Registry si ha creado una cuenta de usuario e iniciado sesión. Para crear una cuenta de usuario, siga las instrucciones que aparecen en Creación de una cuenta de usuario.

La primera tarea que se indica a continuación describe los pasos que deberá seguir para crear un objeto nuevo. En las secciones siguientes se describen los pasos adicionales necesarios para publicar tipos particulares de objetos.

Es posible crear y publicar cualquier objeto enumerado en la Tabla 2–2, con las siguientes excepciones:

En esta sección se describen las tareas siguientes:

ProcedurePara crear y publicar un nuevo objeto de Registry

  1. En la ficha Tareas del área de menú de la izquierda, haga clic en Crear un nuevo objeto de Registry.

  2. En el área Objetos de Registry, elija un tipo de objeto en la lista desplegable y haga clic en Agregar.

    En el área Detalles aparecerá un formulario de datos.

  3. Escriba un nombre en el campo Nombre.

  4. (Opcional) Escriba una descripción en el campo Descripción.

  5. (Opcional) Escriba un comentario en el campo Comentario sobre la versión.

  6. (Opcional) Sustituya los valores de Identificador único e Identificador lógico único por otros identificadores que usted elija.

    Cada identificador debe ser un URN válido y debe ser único en la instalación de Registry.

  7. Introduzca datos en los campos específicos del tipo de objeto.

  8. Haga clic en Guardar para guardar el objeto en la memoria.

    Nota –

    Asegúrese de guardar los cambios realizados en todas las áreas de la ficha correspondientes al objeto antes de pasar a otra ficha. Si no guarda el trabajo, se perderá.

  9. (Opcional) Use las fichas del formulario Detalles (Details) para agregar y guardar los objetos que haya creado.

  10. Haga clic en Aplicar (Apply) para publicar el objeto en Registry.

    Aparecerá un mensaje de estado que muestra si la aplicación se ha efectuado correctamente.

Pasos siguientes

Antes o después de la publicación del objeto, puede editarlo agregándole los objetos que haya creado. La Tabla 2–4 enumera los objetos que se pueden agregar. En los siguientes apartados se describe cómo se agregan estos objetos.

ProcedurePara crear y publicar un objeto de consulta adhoc (AdhocQuery)

Un objeto de consulta adhoc (AdhocQuery) representa una consulta ad hoc expresada en una sintaxis de consulta. Lo objetos de consulta adhoc (AdhocQuery) se utilizan para el descubrimiento de objetos de Registry. La finalidad de los objetos de consulta adhoc (AdhocQuery) es similar al concepto de procedimientos almacenados en las bases de datos relacionales. Por ejemplo, todas las consultas predefinidas en el panel Buscar son objetos de consulta adhoc (AdhocQuery).

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Consulta adhoc (AdhocQuery).

  2. (Opcional) Seleccione un tipo de consulta en el cuadro combinado Tipo de consulta.

    El tipo de consulta predeterminado es Consulta SQL. Otros tipos de consulta admitidos son XQuery y la consulta de filtro ebXML.

  3. Escriba el texto de la consulta en el campo Cadena de consulta.

    En las consultas SQL, utilice pares de comillas simples para encerrar los elementos que normalmente se encierran de este modo. Estos elementos son normalmente literales y marcadores de los parámetros de las subconsultas. Por ejemplo, especifique un marcador de parámetro en una subconsulta de la siguiente forma:

    (SELECT id FROM ClassificationNode WHERE path LIKE ''$objectTypePath'')

    Especifique un literal o un marcador de parámetro de la siguiente forma:

    ... AND (ro.id = s.parent AND s.name_ = 
''urn:oasis:names:tc:ebxml-regrep:profile:ws:wsdl:nameSpacesUsed''
  AND s.value LIKE ''$nameSpacePattern'')

  4. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

ProcedurePara crear y publicar un objeto de nodo de clasificación (ClassificationNode)

Un objeto de nodo de clasificación (ClassificationNode) representa un objeto de taxonomía que tiene una relación estructural con otros elementos en un esquema de clasificación interno. Es posible crear un objeto de nodo de clasificación (ClassificationNode) y agregarlo después a un esquema de clasificación, pero puede resultar más sencillo utilizar la ficha Conceptos del panel Detalles de Esquema de clasificación (ClassificationScheme) para crear conceptos.

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Nodo de clasificación (ClassificationNode).

  2. Escriba un valor para el objeto de nodo de clasificación (ClassificationNode) en el campo Valor.

    Los campos Esquema de clasificación, ID principal y Ruta aparecen atenuados.

  3. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

ProcedurePara crear y publicar un objeto de esquema de clasificación (ClassificationScheme)

Un objeto de esquema de clasificación (ClassificationScheme) representa una taxonomía utilizada para clasificar objetos. En un esquema de clasificación (ClassificationScheme) interno, todos los elementos de taxonomía se definen en Registry como instancias de concepto (Concepto). En un esquema de clasificación (ClassificationScheme) externo, los valores no se definen en Registry como instancias de concepto (Concepto) sino que se hace referencia a ellos mediante sus representaciones de cadena.

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Esquema de clasificación (ClassificationScheme).

    La casilla de verificación Esquema de clasificación (Classification Scheme) externo está seleccionada para indicar que el esquema no incluye conceptos. Si se agregan conceptos al esquema de clasificación, la casilla de verificación dejará de estar seleccionada.

  2. Seleccione un valor en el cuadro combinado Tipo de valor:

    • Exclusivo. Indica que cada nodo de la taxonomía tiene un código único asignado.

    • Ruta incrustada. Indica que el código único asignado a cada nodo de la taxonomía también codifica su propia ruta.

    • No exclusivo. Indica que los nodos no son exclusivos y que es necesario usar la ruta completa, desde el esquema de clasificación (ClassificationScheme) hasta el nodo correspondiente, para que sea posible identificarlos.

    El valor predeterminado es Exclusivo.

  3. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

ProcedurePara crear y publicar un objeto de vínculo externo (ExternalLink)

Un objeto de vínculo externo (ExternalLink) proporciona un URI para contenido que reside fuera de Registry.

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Vínculo externo (External Link).

    El campo Tipo de objeto contiene el valor Vínculo externo (External Link).

  2. (Opcional) Haga clic en el botón Seleccionar Concepto para Tipo de objeto para seleccionar un tipo de objeto para los datos a los que hace referencia el URI.

    En la ventana Extrinsic Object Classification Node Selector, expanda los nodos hasta que llegue al concepto apropiado dentro del tipo Objeto extrínseco (Extrinsic Object). Al hacer clic en Aceptar, la ventana Tipo de objeto incluirá el tipo que haya seleccionado.

  3. Escriba el URI del vínculo externo en el campo URI externo.

  4. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

    Nota –

    Si aparece un mensaje de error al intentar guardar un objeto de vínculo externo (ExternalLink), significará que es necesario realizar una tarea administrativa. Consulte la sección No es posible crear un vínculo externo ni un enlace de servicio para obtener información detallada al respecto.

ProcedurePara crear y publicar un objeto extrínseco (ExtrinsicObject)

Un objeto extrínseco (ExtrinsicObject) proporciona metadatos que describen contenidos cuyo tipo no se conoce intrínsecamente en Registry y, por tanto, deben describirse mediante atributos adicionales, como el tipo de MIME.

Utilice un objeto extrínseco (ExtrinsicObject) para publicar archivos de varios tipos. Normalmente, se trata de artefactos de servicios Web, tales como archivos WSDL.

ebXML Registry Profile for Web Services es un estándar de OASIS que define el perfil de ebXML Registry para publicación, gestión, gobernabilidad, descubrimiento y reutilización de artefactos de servicios Web. Service Registry implementa este perfil de forma predeterminada. En la práctica, esto significa que cuando se publica un archivo WSDL en Registry como un objeto extrínseco (ExtrinsicObject), Registry crea algunos metadatos estándar para el documento, creando, en realidad, el servicio web definido por el documento. Esta función se denomina Catalogación WSDL.

Para publicar uno o varios archivos WSDL con dependencia entre sí o de otros archivos (como los archivos XSD), cree un archivo zip que los contenga a todos.

El administrador puede desactivar la función Catalogación WSDL. Consulte la sección Disabling the WSDL Cataloger de Service Registry 3.1 Administration Guide para obtener información detallada.

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Objeto extrínseco (Extrinsic Object) o uno de sus subtipos.

    Por ejemplo, para publicar uno o varios archivos WSDL, seleccione WSDL.

  2. (Opcional) Escriba el tipo de MIME del objeto en el campo Tipo de Mime. El tipo deberá ser uno de los que aparecen en http://www.iana.org/assignments/media-types.

    Si va a cargar un archivo WSDL independiente (un archivo de texto que contenga XML), defina el tipo de MIME en text/xml.

    Si va a cargar un archivo zip que incluye varios WSDL (y, opcionalmente, XSD), defina el tipo de MIME en application/zip.

  3. (Opcional) Seleccione la casilla de verificación "Es opaco" si Registry no puede leer el contenido del objeto (por ejemplo, si está cifrado).

  4. Haga clic en el botón Seleccionar Concepto para Tipo de objeto si necesita seleccionar un tipo de objeto más específico que Objeto extrínseco (ExtrinsicObject).

    En la ventana Extrinsic Object Classification Node Selector, expanda los nodos hasta que llegue al concepto apropiado dentro del tipo Objeto extrínseco (Extrinsic Object). Al hacer clic en Aceptar, la ventana Tipo de objeto incluirá el tipo que haya seleccionado.

  5. Haga clic en el botón Seleccionar archivo de elementos de depósito para localizar el elemento de depósito del objeto extrínseco (ExtrinsicObject).

    1. En la ventana Carga de archivo, escriba la ruta del archivo en el campo de texto o haga clic en Examinar.

    2. Si hace clic en Examinar, utilice la ventana de selección de archivos para navegar hasta el archivo y, a continuación, haga clic en Abrir.

    3. En la ventana Carga de archivo, haga clic en Cargar archivo.

    4. Haga clic en Aceptar (OK).

    Aparecerán los siguientes elementos adicionales en el panel Detalles:

    • El campo Versión del contenido (atenuado)

    • El campo Comentario sobre la versión del contenido, que podrá rellenar

    • El botón Eliminar elemento de depósito

    • El vínculo Ver contenido de elementos de depósito

  6. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

Pasos siguientes

Tras crear un objeto extrínseco (ExtrinsicObject) que hace referencia a un archivo WSDL, podrá buscarlo mediante la Consulta de detección de WSDL. . Además, si utiliza la Consulta básica para buscar objetos extrínsecos (ExtrinsicObject) de tipo WSDL, objetos de servicio (Service) y objetos de enlace de servicio (ServiceBinding), observará que Registry ha creado todos los objetos especificados por los elementos del archivo WSDL:

ProcedurePara crear y publicar un objeto de federación (Federation)

Un objeto de federación (Federation) representa un grupo de registros asociados. Sus únicos atributos son los básicos de un objeto de Registry (RegistryObject). Para crear un objeto de federación (Federation), deberá ser administrador.

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Federación.

  2. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

  3. Agregue registros asociados a la federación según los pasos indicados en la sección Creación de relaciones entre objetos. A continuación se indican los pasos específicos:

    1. Busque la federación, seleccione su casilla de verificación Escoger y haga clic en Marcar.

    2. Busque el registro, seleccione su casilla de verificación Escoger y haga clic en Relacionar.

    3. En el área Crear relación, seleccione la federación como objeto origen. El registro se convertirá en el objeto destino.

    4. Defina el tipo de asociación (AssociationType) como HasFederationMember.

ProcedurePara crear y publicar un objeto de organización (Organization)

Un objeto de organización (Organization) proporciona información acerca de una organización. Puede tener una organización principal y una o varias organizaciones secundarias. Siempre tiene un objeto de usuario (User) como contacto principal y puede ofrecer servicios mediante la creación de asociaciones entre la organización y uno o varios objetos de servicio (Service).

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Organización.

  2. (Opcional) Introduzca valores en los campos Direcciones postales.

  3. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

    Consulte las secciones siguientes para obtener información detallada sobre la adición de objetos compuestos a un objeto de organización (Organization):

  4. Para agregar un objeto de servicio (Service) a un objeto de organización (Organization), siga los pasos que se indican en la sección Creación de relaciones entre objetos. A continuación se indican los pasos específicos:

    1. Busque la organización, seleccione su casilla de verificación Escoger y haga clic en Marcar.

    2. Busque el servicio, seleccione su casilla de verificación Escoger y haga clic en Relacionar.

    3. En el área Crear relación, seleccione la organización como objeto origen. El servicio se convierte en el objeto de destino.

    4. Defina el tipo de asociación como OffersService.

ProcedurePara crear y publicar un objeto de persona (Person) o usuario ( User)

Un objeto de persona (Person) o usuario (User) proporciona información sobre personas y usuarios registrados en Registry. Ambos tipos de objetos tienen atributos idénticos. Un objeto de usuario (User) está asociado con un objeto de organización (Organization) como contacto principal. Los objetos de usuario ( User) se utilizan también en objetos de evento auditable (AuditableEvent) para identificar al solicitante que envió la solicitud que ha generado el objeto de evento auditable (AuditableEvent ).

El modo recomendado para crear objetos de usuario (User) es a través del Asistente para el registro de usuarios. Utilice Web Console para crear objetos de persona (Person) siempre que desee crear metadatos sobre personas que no accederán por sí mismas a Registry.

Si desea crear varias direcciones postales, varias direcciones de correo electrónico o varios números de teléfono para una misma persona, cree un objeto de usuario (User). Web Console permite agregar direcciones postales, direcciones de correo electrónico y números de teléfono como objetos compuestos para un objeto de usuario (User), pero no para un objeto de persona (Person).

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Persona o Usuario.

  2. Introduzca valores en los campos Nombre de la persona.

    Especifique un valor para, al menos, uno de estos campos.

    No utilice el campo Nombre. Web Console ignora cualquier valor que se introduzca en el campo Nombre de un objeto de persona (Person) o usuario ( User).

  3. Agregue objetos compuestos tal como se describe en las secciones siguientes:

  4. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

ProcedurePara crear y publicar un objeto de Registry

Un objeto de Registry representa un registro. Sus únicos atributos son los básicos de un objeto de Registry (RegistryObject). Para crear un objeto de Registry, deberá ser administrador.

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Registry.

  2. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

Pasos siguientes

Consulte la sección Para crear y publicar un objeto de federación (Federation) para obtener información sobre cómo agregar el registro a una federación.

ProcedurePara crear y publicar un objeto de paquete de Registry (RegistryPackage)

Un objeto de paquete de Registry (RegistryPackage) representa una agrupación lógica de cualquier número de objetos de registro.

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Paquete de Registry (Registry Package).

  2. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

  3. Para agregar objetos al paquete, siga las instrucciones que se indican en Adición de objetos al paquete de Registry.

ProcedurePara crear y publicar un objeto de servicio (Service)

Un objeto de servicio (Service) proporciona información sobre un servicio. Este objeto puede contener uno o varios objetos de enlace de servicio (ServiceBinding), que representan información técnica sobre cómo acceder al servicio.

El modo más común de publicar un objeto de servicio (Service) consiste en publicar un objeto extrínseco (ExtrinsicObject) cuyo contenido consta de uno o varios archivos WSDL. Para obtener más información, consulte Para crear y publicar un objeto extrínseco (ExtrinsicObject) .

  1. Ejecute los pasos del 1–6 que se indican en la sección Para crear y publicar un nuevo objeto de Registry. En el paso 2, seleccione Servicio.

  2. Ejecute los pasos del 8–10 que se indican en la sección Para crear y publicar un nuevo objeto de Registry.

  3. Para agregar objetos de enlace de servicio (ServiceBinding) al servicio, siga las instrucciones que se indican en la sección Adición de un enlace de servicio a un servicio.

  4. Para agregar objetos de enlace de especificación (SpecificationLink) a un objeto de enlace de servicio (ServiceBinding ), siga las instrucciones que se indican en la sección Adición de vínculos de especificaciones a un enlace de servicio.