Skip to main content

Modificación de Valores en FlexFields

Oracle Fusion Cloud Common Applications permite modificar y actualizar parcialmente los atributos de un valor existente dentro de un Value Set específico mediante una petición PATCH.

Esta opción puede utilizarse para:

  • Actualizar descripciones de FlexFields forma dinámica ante cambios.
  • Habilitar o deshabilitar temporalmente áreas operativas cambiando la bandera de estado.
  • Configurar o ajustar rangos de fechas de vigencia para el uso de los valores del catálogo.
info

Este proceso se utiliza para la modificación y actualización parcial (PATCH) de registros existentes dentro de la estructura de Value Sets de Oracle Cloud.

Documentación Oficial de Oracle

Para comprender la jerarquía de Value Sets y recursos REST de Oracle Application Common Feature, puedes consultar la guía de Oracle REST APIs: https://docs.oracle.com/en/cloud/saas/supply-chain-and-manufacturing/25c/fasrp/op-processworkorders-processworkordersuniqid-child-processworkorderdff-workorderid-patch.html

Requisito de autorización y seguridad

Para realizar modificaciones sobre los Value Sets de Oracle Applications, el usuario de la integración requiere permisos de edición/escritura sobre configuraciones de Application Toolkit o Application Core (como el rol de Integration Specialist o roles de administración de catálogos FND).

De lo contrario, la API responderá con un error de autorización 401 Unauthorized o 403 Forbidden.


1. FlexFields en Proyectos​

FlexFieldsProyecto
ALP_AREASAlpura9

2. Flujo​


3. API​

Método: PATCH

URL: <url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/<ValueSetName>/child/values/<ValueId>

Parámetros de Ruta (Path Parameters)
  • <ValueSetName>: Debe reemplazarse por el código del juego de valores que contiene el registro.
  • <ValueId>: Identificador numérico único de Oracle (por ejemplo, 374027) asignado al valor que se desea modificar.

4. Headers​

HeaderDescripciónValor
Content-TypeIndica que la información enviada en el cuerpo está en formato JSON.application/json
AuthorizationCredenciales de autenticación HTTP Basic para Oracle Fusion Cloud.Basic <usuario:contraseña>

5. Columnas de entrada (Request)​

Al tratarse de una petición de tipo PATCH, se envía un cuerpo de datos (body) que contiene únicamente los campos específicos que se desean actualizar o modificar dentro del registro seleccionado.


5.1 Parámetros de Ruta (Obligatorios)​

ParámetroTipoDescripciónEjemplo
ValueSetNameString (Path)Identificador único del juego de valores en Oracle Cloud.ALP_AREAS
ValueIdNumber (Path)ID interno único generado por Oracle para el valor específico.374027

5.2 Datos de la Solicitud de Modificación (JSON Body)​

CampoDescripciónEjemplo
DescriptionNueva descripción o glosa que se le asignará al área de negocio.MQ989
EnabledFlagBandera para habilitar (Y) o inhabilitar (N) el registro.Y
StartDateActiveFecha de inicio de vigencia del registro (Formato YYYY-MM-DD).null
EndDateActiveFecha de fin de vigencia del registro (Formato YYYY-MM-DD).null

6. Ejemplo de Solicitud​

A continuación se muestra el ejemplo de consumo mediante cURL para realizar la actualización del registro de área con ID 374027 (omitiendo cabeceras dinámicas de Akamai para asegurar la permanencia de la documentación):

curl --location --request PATCH '<url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/ALP_AREAS/child/values/374027' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic MTU0OTYxMjpDaG9jb3ZhaW5pbGxhMTk=' \
--data '{
"Description": "MQ989",
"EnabledFlag": "Y",
"StartDateActive": null,
"EndDateActive": null
}'
Nota:

Antes de ejecutar el comando curl, se debe reemplazar el valor <url_oracle> por el host de la instancia de Oracle Cloud deseada (DEV, UAT o PROD), según el ambiente en el que se requiera realizar la operación.

Verifique que la URL corresponda al ambiente correcto y que las credenciales utilizadas en el encabezado Authorization tengan los permisos necesarios para crear o actualizar valores en el juego de valores ALP_AREAS.


7. Ejemplo de Respuesta​

{
"ValueId": 374027,
"IndependentValue": null,
"IndependentValueNumber": null,
"IndependentValueDate": null,
"IndependentValueTimestamp": null,
"Value": "MQ989\t",
"ValueNumber": null,
"ValueDate": null,
"ValueTimestamp": null,
"TranslatedValue": null,
"Description": "MQ989",
"EnabledFlag": "Y",
"StartDateActive": null,
"EndDateActive": null,
"SortOrder": null,
"SummaryFlag": null,
"DetailPostingAllowed": null,
"DetailBudgetingAllowed": null,
"AccountType": null,
"ControlAccount": null,
"ReconciliationFlag": null,
"FinancialCategory": null,
"ExternalDataSource": null,
"CreationDate": "2025-06-13T17:15:37.403+00:00",
"CreatedBy": "ORA_EDEN.REYES",
"LastUpdateDate": "2026-10-27T16:52:24+00:00",
"LastUpdatedBy": "1549612",
"links": [ ]
}