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.
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.
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
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
| FlexFields | Proyecto |
|---|---|
ALP_AREAS | Alpura9 |
2. Flujo
3. API
Método: GET
URL: <url_oracle>/fscmRestApi/resources/11.13.18.05/valueSets/<ValueSetName>/child/values
El segmento {ValueSetName} en la URL debe ser reemplazado por el código del juego de valores que deseas consultar.
4. Headers
| Header | Descripción | Valor |
|---|---|---|
Authorization | Credenciales 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ámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
ValueSetName | String (Path) | Identificador único del juego de valores en Oracle Cloud. | ALP_AREAS |
5.2 Parámetros de Búsqueda Opcionales (Query Params)
| Parámetro | Descripción | Ejemplo |
|---|---|---|
q | Filtro de búsqueda estandarizada de Oracle (por ejemplo, filtrar por valor o descripción). | ?q=Value=100 o ?q=EnabledFlag=Y |
limit | Restringe el número de registros devueltos por la API (paginación). | ?limit=50 |
fields | Selecciona ú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'
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": [ ]
}
]
}