Skip to main content

Consulta de FlexFields

Oracle Fusion Cloud Common Applications permite consultar y listar los valores de un Value Set específico de forma automatizada mediante una petición GET.

Esta opción puede utilizarse para:

  • Sincronizar FlexFields de Alpura con sistemas periféricos.
  • Validar la existencia de códigos en un juego de valores antes de iniciar procesos transaccionales.
  • Alimentar listas dinámicas de selección en interfaces de usuario o middleware de integración.
info

Este proceso se utiliza exclusivamente para la lectura y consulta (GET) de los valores secundarios o hijos contenidos dentro de la estructura del Value Set de Oracle Cloud.

Documentación Oficial de Oracle

Para comprender mejor la jerarquía de Value Sets y recursos REST de Oracle Application Common Feature, puedes consultar la guía general de Oracle REST APIs: https://docs.oracle.com/en/cloud/saas/applications-common/25c/farca/api-value-sets-values.html

Requisito de autorización y seguridad

Para realizar consultas sobre los Value Sets de Oracle Applications, el usuario de la integración requiere permisos mínimos de lectura sobre configuraciones de Application Toolkit o Application Core (como el rol de Integration Specialist o roles de consulta de catálogo 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: GET

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

Parámetro de Ruta (Path Parameter)

El segmento {ValueSetName} en la URL debe ser reemplazado por el código del juego de valores que deseas consultar.


4. Headers​

HeaderDescripciónValor
AuthorizationCredenciales de autenticación HTTP Basic para Oracle Fusion Cloud.Basic <usuario:contraseña>

5. Parámetros de Entrada (Request)​

Al tratarse de una petición de tipo GET, no se envía un cuerpo de datos (body). Sin embargo, es mandatorio definir el juego de valores objetivo directamente en la ruta de la URL, y opcionalmente puedes complementar la consulta con parámetros de búsqueda para filtrar la respuesta.


5.1 Parámetro de Ruta (Obligatorio)​

ParámetroTipoDescripciónEjemplo
ValueSetNameString (Path)Identificador único del juego de valores en Oracle Cloud.ALP_AREAS

5.2 Parámetros de Búsqueda Opcionales (Query Params)​

ParámetroDescripciónEjemplo
qFiltro de búsqueda estandarizada de Oracle (por ejemplo, filtrar por valor o descripción).?q=Value=100 o ?q=EnabledFlag=Y
limitRestringe el número de registros devueltos por la API (paginación).?limit=50
fieldsSelecciona únicamente los atributos requeridos en la respuesta para reducir el tamaño del payload.?fields=Value;Description

6. Ejemplo de Solicitud​

A continuación se muestra el ejemplo de consumo mediante cURL para realizar el proceso de consulta (omitiendo cabeceras dinámicas de Akamai para mayor claridad y permanencia de la documentación):

curl --location '<url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/ALP_AREAS/child/values' \
--header 'Authorization: Basic c29hOjFudDNyZmEy'
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.


7. Ejemplo de Respuesta​

{
"items": [
{
"ValueId": 371017,
"IndependentValue": null,
"IndependentValueNumber": null,
"IndependentValueDate": null,
"IndependentValueTimestamp": null,
"Value": "AMF_DELICIAS",
"ValueNumber": null,
"ValueDate": null,
"ValueTimestamp": null,
"TranslatedValue": null,
"Description": null,
"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:10:00.683+00:00",
"CreatedBy": "ORA_EDEN.REYES",
"LastUpdateDate": "2025-06-13T17:25:51.729+00:00",
"LastUpdatedBy": "ORA_EDEN.REYES",
"links": [ ]
},
{
"ValueId": 374013,
"IndependentValue": null,
"IndependentValueNumber": null,
"IndependentValueDate": null,
"IndependentValueTimestamp": null,
"Value": "BEBIBLES",
"ValueNumber": null,
"ValueDate": null,
"ValueTimestamp": null,
"TranslatedValue": null,
"Description": null,
"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:10:09.687+00:00",
"CreatedBy": "ORA_EDEN.REYES",
"LastUpdateDate": "2025-06-13T17:25:51.753+00:00",
"LastUpdatedBy": "ORA_EDEN.REYES",
"links": [ ]
},
{
"ValueId": 374014,
"IndependentValue": null,
"IndependentValueNumber": null,
"IndependentValueDate": null,
"IndependentValueTimestamp": null,
"Value": "COPACKING",
"ValueNumber": null,
"ValueDate": null,
"ValueTimestamp": null,
"TranslatedValue": null,
"Description": null,
"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:10:22.598+00:00",
"CreatedBy": "ORA_EDEN.REYES",
"LastUpdateDate": "2025-06-13T17:25:51.758+00:00",
"LastUpdatedBy": "ORA_EDEN.REYES",
"links": [ ]
}
]
}