Skip to main content
La página Schema Registry guarda los esquemas que los workflows usan para validar y mapear datos. Los workflows validan payloads XML contra esquemas XSD. Los documentos OpenAPI describen las operaciones de API externa que los workflows llaman.

​
Acceso a la página Schema Registry

Para abrir la página Schema Registry, haz clic en Schema Registry en el menú del lado izquierdo de la página Flowker. La página tiene dos pestañas:
  • XSD: los esquemas XSD.
  • External APIs: los documentos OpenAPI.
Para ver los esquemas de una pestaña, necesitas el permiso list en el recurso xsd-schemas para XSD o en el recurso openapi-schemas para External APIs. Para subir un esquema, necesitas create en el mismo recurso. Para eliminar un esquema, necesitas delete.

​
Pestaña XSD

La pestaña XSD lista tus esquemas XSD, con las siguientes columnas:
  • Name: el nombre del esquema.
  • Version: la versión del esquema.
  • Imports: la cantidad de esquemas que este esquema importa.
  • Content Hash: el inicio del hash del contenido del archivo.
  • Used by: la cantidad de configuraciones de proveedor y de workflows que hacen referencia al esquema.
  • Created At: la fecha de subida.
  • Actions: menú de acciones.

​
Pestaña External APIs

La pestaña External APIs lista tus documentos OpenAPI, con las siguientes columnas:
  • Name: el nombre del documento.
  • Version: la versión del documento.
  • OpenAPI Version: la versión de OpenAPI del documento.
  • Operations: la cantidad de operaciones del documento.
  • Used by: la cantidad de configuraciones de proveedor y de workflows que hacen referencia al documento.
  • Created At: la fecha de subida.
  • Actions: menú de acciones.

​
Subir un esquema XSD

1
En la pestaña XSD, haz clic en Upload.
2
Se abre el formulario Upload XSD Schema. Completa los campos:
  • Name: el nombre del esquema (por ejemplo, pain.001.001.09).
  • Version: la versión del esquema.
  • Imports (opcional): los nombres de los esquemas que este esquema importa, separados por comas.
  • XSD File: un archivo .xsd de 1 MiB como máximo.
3
Haz clic en Upload.

​
Subir un documento OpenAPI

1
En la pestaña External APIs, haz clic en Upload.
2
Se abre el formulario Upload OpenAPI Schema. Completa los campos:
  • Name: el nombre del documento (por ejemplo, orders-api).
  • Version: la versión del documento.
  • OpenAPI File: un archivo .json, .yaml o .yml de 8 MiB como máximo.
3
Haz clic en Upload.
Para llamar a las operaciones de un documento subido desde un workflow, consulta Conectar tu propia API.

​
Ver un esquema

Haz clic en el nombre del esquema o selecciona Details en el menú de acciones (). Se abre el panel Schema Details. No puedes editar un esquema en este panel. Para un esquema XSD, el panel muestra el Target Namespace y los Imports. Para un documento OpenAPI, muestra la OpenAPI Version y una tabla con las operaciones del documento, con su Path y su Method. La sección Used by lista las configuraciones de proveedor y los workflows que hacen referencia al esquema. Cada uno muestra su estado: Active o Disabled.

​
Eliminar un esquema

1
Haz clic en los tres puntos () en la columna Actions y selecciona Delete.
2
La Console verifica qué configuraciones de proveedor y workflows hacen referencia al esquema. El siguiente diálogo depende del resultado:
  • Ninguna referencia: se abre un diálogo de confirmación. Haz clic en Confirm.
  • Solo referencias que no están activas: el diálogo Delete schema anyway? las lista. Después de eliminar el esquema, apuntan a un esquema que no existe. Haz clic en Delete anyway.
  • Una o más referencias activas: el diálogo Schema in use las lista, y no puedes eliminar el esquema. Desactiva las referencias activas o apúntalas a otro esquema, y luego vuelve a intentarlo.

​
Páginas relacionadas

Agregar un proveedor

Conectar tu propia API