Todos los productos
Search

Este producto

    DataWorks:Probar, publicar y usar una función

    Centro de documentos

    DataWorks:Probar, publicar y usar una función

    Última actualización: Sep 04, 2026

    En DataService Studio, puede probar, publicar y utilizar funciones como filtros para procesar solicitudes y respuestas de API.

    Requisitos previos

    Asegúrese de haber creado y guardado la función. Para obtener más información, consulte Manage functions.

    Limitaciones

    Solo el propietario del espacio de trabajo y los usuarios de RAM con el rol de Workspace Administrator, Develop u O&M pueden probar funciones. Para obtener más información, consulte Add a workspace member and manage role permissions.

    Paso 1: Probar la función

    1. Vaya a la página de Data Services.

      1. Inicie sesión en la consola de DataWorks. En la región objetivo, haga clic en Data Analysis and Service > DataService Studio en el panel de navegación izquierdo. Seleccione un espacio de trabajo de la lista desplegable y haga clic en Go to DataService Studio.

      2. En la página de Service Development, dentro de la lista de funciones, haga doble clic en la función que se encuentra en desarrollo.

    2. En la página de edición de la función, haga clic en Test en la barra de herramientas superior.

      ## --- AviatorScript ---
## $0: the default name of the input param.
## Expressions must be separated by the semicolon ";".
## Example 1:
## $0.a: Get the attribute "a" from the input param "$0".
## $0.b[index]: Get the index of the array "b" from the input param "$0". The index cannot be an expression or a variable.
## Example 2:
## Input: {"keyA":[1,2],"keyB":"value"}
## Function: $0.keyA[0]=3; $0.keyB="new_value"; return $0;
## Output: {"keyA":[3,2],"keyB":"new_value"}

    3. En el cuadro de diálogo Function Test, introduzca los parámetros y haga clic en Confirm.

      Puede consultar el estado de ejecución en la pestaña Run Results en la parte inferior. Si la prueba falla, revise el mensaje de error, modifique la función y vuelva a probarla.

    Paso 2: Publicar la función

    Una vez que la función pase la prueba, publíquela para que esté disponible para su uso.

    1. En la página de Service Development, dentro de la lista de funciones, haga doble clic en la función que pasó la prueba.

    2. En la barra de herramientas superior, haga clic en Submission.

    3. En la página de edición de la función, haga clic en Version en el panel de navegación derecho. Busque la versión con el estado Can Be Published y haga clic en Publish en la columna Actions.

      Nota

      Después de publicar la función, puede hacer clic en Version en el panel de navegación derecho de la página de edición de la función para consultar el historial de publicaciones. A continuación, podrá ver los Version Details o hacer clic en Roll Back.

    Paso 3: Usar la función

    Casos de uso

    • Como prefiltro de API, una función preprocesa los parámetros de solicitud durante una llamada.

    • Como posfiltro de API, una función procesa y transforma la respuesta de la API.

    Limitaciones

    • El prefiltro y el posfiltro de una API deben utilizar el mismo tipo de función. Ambos deben ser funciones Aviator o ambos deben ser funciones Python.

    • La función de Python se encuentra en proceso de actualización. No se admite la creación, clonación ni publicación de nuevas funciones Python.

    Uso como filtro de API

    1. En la página de Service Development, expanda Workflow > API.

    2. Haga doble clic en la API para abrir su página de edición.

    3. En el panel de navegación derecho, haga clic en Filter.

      Seleccione la casilla de verificación Use Pre-filter o Use Post-filter. El Function Type tiene como valor predeterminado Aviator Function. En la lista desplegable del prefiltro o posfiltro, seleccione una o más funciones. Si agrega varias funciones, estas se ejecutarán en el orden en que se añadieron.

      Nota

      • Un filtro consta de una o más funciones que preprocesan los parámetros de solicitud de la API o posprocesan los resultados de la consulta.

      • Si no encuentra la función objetivo en la lista desplegable, asegúrese de que la función esté publicada. También puede crear y publicar una nueva función. Para obtener más información, consulte Publish the function.

    4. Haga clic en Preview Responses Returned by API Operation para comprobar la salida del filtro.