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.
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.
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
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
| FlexFields | Proyecto |
|---|---|
ALP_AREAS | Alpura9 |
2. Flujo
3. API
Método: PATCH
URL: <url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/<ValueSetName>/child/values/<ValueId>
<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
| Header | Descripción | Valor |
|---|---|---|
Content-Type | Indica que la información enviada en el cuerpo está en formato JSON. | application/json |
Authorization | Credenciales 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ámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
ValueSetName | String (Path) | Identificador único del juego de valores en Oracle Cloud. | ALP_AREAS |
ValueId | Number (Path) | ID interno único generado por Oracle para el valor específico. | 374027 |
5.2 Datos de la Solicitud de Modificación (JSON Body)
| Campo | Descripción | Ejemplo |
|---|---|---|
Description | Nueva descripción o glosa que se le asignará al área de negocio. | MQ989 |
EnabledFlag | Bandera para habilitar (Y) o inhabilitar (N) el registro. | Y |
StartDateActive | Fecha de inicio de vigencia del registro (Formato YYYY-MM-DD). | null |
EndDateActive | Fecha 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
}'
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": [ ]
}