Como escolher

No JD Edwards EnterpriseOne existem várias formas de integração. A escolha depende principalmente de três coisas: se a interface é em tempo real ou em lote, se o JDE envia ou recebe os dados, e qual versão do Tools Release você usa. ^{[7] [15]}

Por trás das três perguntas há um princípio que vale para todas as opções: as regras de negócio do JDE moram nas aplicações e nas business functions, não no banco de dados. Toda integração que grava dados precisa passar por essa camada. O que muda de uma opção para outra é a porta de entrada, o protocolo e a latência.

1. Latência. Tempo real significa uma transação por chamada, com resposta em segundos, quase sempre síncrona. Lote significa volumes grandes processados em janelas, com a possibilidade de corrigir e reprocessar o que falhou.
2. Direção. Entrada é quando o JDE recebe dados (um pedido criado por um portal). Saída é quando o JDE envia ou avisa (um pedido aprovado que precisa chegar ao armazém). Algumas opções servem aos dois sentidos.
3. Tools Release. É a versão da base técnica do JDE, independente da versão das aplicações (9.2). O Orchestrator existe no Tools 9.2 e ganha recursos a cada atualização; ambientes em Tools antigos dependem de Business Services ou de conectores. ^[5]

Glossário mínimo

AIS Server

Application Interface Services: servidor que expõe o JDE como serviços REST com JSON.

Orchestrator

Motor que roda no AIS Server e executa orquestrações, sequências de passos desenhadas no Orchestrator Studio.

Tools Release

Versão da camada técnica do JDE (runtime, servidores, ferramentas), atualizada separadamente das aplicações.

UBE

Universal Batch Engine: programa em lote (relatório ou processo), identificado por um R, como R09110Z.

BSFN

Business function: função reutilizável em C ou em NER (Named Event Rules, gerada em C).

MBF

Master business function: BSFN que encapsula uma transação inteira, como o pedido de venda.

Z-file

Tabela de interoperabilidade (interface table) usada como área de espera para lotes.

OMW e UDO

Object Management Workbench controla objetos de desenvolvimento; UDOs (user defined objects) são objetos criados por usuários, como orquestrações.

JDENET

Protocolo interno de comunicação entre os servidores do JDE.

CNC

Configurable Network Computing: a administração técnica do JDE (servidores, pacotes, segurança).

Onde cada opção se encaixa

Uma instalação do JDE tem vários servidores, e cada opção de integração conversa com um deles. O Enterprise Server executa as business functions e os UBEs. O HTML Server (JAS) executa as aplicações web. O AIS Server, o Business Services Server e o Transaction Server são servidores Java em WebLogic (ou WebSphere, em alguns casos), instalados e administrados pelo Server Manager. ^[4]

Para o arquiteto de infraestrutura, cada servidor adicional é uma instância a dimensionar, atualizar, monitorar e proteger. As versões suportadas de WebLogic, Java, sistema operacional e banco são definidas pela matriz de certificações da Oracle para o Tools Release em uso.

Orchestrator e AIS Server

Direção

Entrada e saída

Latência

Tempo real ou agendado

Protocolo

REST / JSON sobre HTTPS

Posição da Oracle

Caminho recomendado

Explicação conceitual e técnica

O AIS Server é um servidor de serviços REST que, configurado junto com o HTML Server, dá acesso a formulários e dados do EnterpriseOne por JSON sobre HTTP. ^[3] O Orchestrator usa o AIS Server como base e processa as orquestrações salvas nele para transformar dados externos em processos de negócio no JDE. ^[1]

Conceitualmente, ele é uma fachada de API: quem chama não precisa saber qual tela, versão ou business function usar. Chama um endpoint com nome de negócio, como CriarPedidoVenda, e a orquestração cuida do resto. Isso separa o contrato da integração da implementação dentro do JDE.

Tecnicamente, uma orquestração é uma sequência de passos chamados service requests: ^[2]

• Form request: executa uma aplicação interativa como um usuário faria, preenchendo campos e apertando botões. As event rules e validações da tela rodam normalmente.
• Data request: consulta tabelas ou business views, com filtros e agregações.
• Business function e report: chama uma BSFN diretamente ou dispara um UBE.
• Custom: executa lógica própria em Groovy ou Java.
• Connector: dá acesso seguro a recursos externos, como um serviço REST, um banco de dados ou uma orquestração de outro sistema JDE. ^[5]
• Message: envia e-mail ou mensagem para o Work Center.

Regras (condições), cross-references e white lists traduzem códigos e decidem o caminho. As notificações avaliam dados do JDE ou de serviços REST externos para detectar situações que pedem atenção, e o agendador embutido executa orquestrações e notificações periodicamente. ^{[5] [6]} Desde o Tools 9.2.4, o Orchestrator Studio é instalado junto com o AIS Server e acessado pela própria URL dele. ^[1]

A grande vantagem é que as regras de negócio das telas do JDE são respeitadas: um form request sobre o P4210 passa pelas mesmas validações, versões e opções de processamento que um usuário digitando o pedido.

Arquitetura mínima e recomendada

Conhecimentos necessários

Quando é útil

• Portais e e-commerce que criam pedidos, consultam preço, saldo ou status em tempo real.
• iPaaS (Oracle Integration, MuleSoft, Boomi) conectando o JDE a SaaS como CRM, WMS ou transportadoras.
• Aplicativos móveis de aprovação, apontamento de produção ou inspeção.
• IoT: sensores que geram ordens de manutenção ou registram leituras.
• Automação de tarefas repetitivas de digitação, no lugar de robôs de tela.
• Saída: o JDE chamando APIs externas por meio de conectores, ou avisando pessoas com notificações.

Exemplos

Um portal cria um pedido de venda chamando uma orquestração que, por dentro, usa um form request sobre o P4210 com a versão da loja virtual:

# chamada ilustrativa, passando pelo API gateway
POST https://api.empresa.com/jde/v3/orchestrator/ORCH_CriarPedidoVenda
Authorization: Bearer <token>
Content-Type: application/json

{ "Cliente": "4242", "Filial": "M30", "PedidoCliente": "PO-4500123",
  "Itens": [ { "Item": "220", "Quantidade": 5 } ] }

# resposta
{ "NumeroPedido": "12345", "TipoPedido": "SO", "Status": "520" }

• IoT: um sensor de temperatura envia leituras; uma regra na orquestração cria uma ordem de manutenção quando o limite é ultrapassado.
• Notificação: todo dia às 8h, pedidos retidos por crédito acima de um valor geram uma mensagem para o gerente financeiro.
• Saída: ao aprovar um fornecedor, uma orquestração chama por conector a API de um serviço de validação cadastral.

Z-files (tabelas de interoperabilidade)

Direção

Entrada e saída

Latência

Lote (minutos a horas)

Protocolo

Tabela + UBE processador

Posição da Oracle

Padrão para lotes

Explicação conceitual e técnica

As Z-files são o método clássico para cargas em lote. Cada uma é uma interface table com as colunas da tabela de aplicação e mais campos de controle. O nome segue a tabela de origem com o sufixo Z1: a F4211 tem a F4211Z1. Quando a tabela de interface passaria de 250 colunas, cria-se uma tabela adicional com uma letra depois do sufixo, como F4211Z1A. ^[8]

Os campos de controle formam a chave e o estado de cada registro: usuário (EDUS), lote (EDBT), número da transação (EDTN), linha (EDLN), indicador de processado (EDSP), ação (EDTC: A para incluir, C para alterar, D para excluir) e tipo de transação (EDTR). ^[7]

Na entrada, um sistema externo grava na Z-file e depois roda o UBE processador, por exemplo o R09110Z para lançamentos contábeis ou o R4211Z1I para pedidos de venda. O processador lê os registros ainda não processados, chama a master business function com a versão definida nas opções de processamento e grava nas tabelas definitivas. Os registros com erro ficam na Z-file, a mensagem vai para o Work Center, e é possível corrigi-los e reprocessá-los. ^[7]

Também funciona como saída: as opções de processamento da aplicação ou os controles de exportação (P0047) fazem o JDE gravar cada transação na Z-file, com o código de ação, para um sistema externo ler. ^[9] É robusto e aproveita a validação padrão, mas não é tempo real.

Arquitetura mínima e recomendada

Conhecimentos necessários

Quando é útil

• Migrações e cargas iniciais de cadastros e saldos.
• Contabilização de sistemas satélites: folha de pagamento, faturamento externo, despesas de viagem.
• Pedidos de e-commerce ou de força de vendas consolidados em lote.
• Interfaces noturnas de grande volume, em que reprocessar é mais importante do que responder na hora.

Exemplos

A folha de pagamento gera os lançamentos contábeis do mês na F0911Z1 e dispara o R09110Z:

-- ilustrativo: um lançamento de 150,00 (decimais implícitos) em 28/09/2026
INSERT INTO PRODDTA.F0911Z1
  (VNEDUS, VNEDTN, VNEDLN, VNEDBT, VNEDSP, VNEDTC, VNDCT, VNDGJ, VNANI, VNAA, VNLT)
VALUES
  ('INTFOLHA', '000123', 1000, 'FOLHA0926', ' ', 'A', 'JE',
   126271, '100.8150', 15000, 'AA');
-- 126271 = ano 2026 (1 + 26) e dia 271 do ano
-- depois: R09110Z, versão da folha; lotes seguem para aprovação e lançamento

Na saída, uma versão do P4210 configurada para gravar a F4211Z1 permite que um sistema de logística leia cada pedido incluído ou alterado e marque os registros como processados.

Business Services (BSSV)

Direção

Entrada e saída

Latência

Tempo real

Protocolo

SOAP / XML sobre HTTPS

Posição da Oracle

Suportado, perdendo espaço

Explicação conceitual e técnica

Business Services são classes Java desenvolvidas no JDeveloper, controladas no OMW como qualquer objeto do JDE e publicadas como web services num Business Services Server em WebLogic ou WebSphere. ^{[10] [11]}

Um published business service é um objeto do OMW que representa uma classe Java que publica várias operações. ^[10] Ele delega a business services internos, que trabalham com value objects e chamam business functions e acessos a dados pela API de tempo de execução do JDE. A Oracle entrega vários serviços prontos (clientes, fornecedores, itens, pedidos, estoque), e você pode criar os seus.

O caminho inverso também existe: o JDE pode ser consumidor de web services. Uma business function chama um business service consumidor, que chama o serviço externo e devolve a resposta à lógica do JDE.

Ainda é bastante usado, mas vem perdendo espaço para o AIS e o Orchestrator: SOAP é mais pesado, e cada mudança exige ciclo de desenvolvimento Java, build de pacote e deploy no servidor, enquanto uma orquestração se ajusta no Studio.

Arquitetura mínima e recomendada

Conhecimentos necessários

Quando é útil

• Integrações SOAP já existentes e estáveis.
• Middleware SOA (Oracle SOA Suite, service bus) que espera contratos WSDL.
• Lógica complexa em Java que não cabe bem num script Groovy.
• Ambientes sem AIS Server. Em projetos novos, prefira o Orchestrator e planeje a migração dos BSSV existentes.

Exemplos

<!-- ilustrativo: chamada ao serviço de pedidos de venda (JP420000) -->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Header>
    <wsse:Security> … usuário e token … </wsse:Security>
  </soapenv:Header>
  <soapenv:Body>
    <processSalesOrder>
      <header> <customer>4242</customer> <businessUnit>M30</businessUnit> </header>
      <detail> <item>220</item> <quantity>5</quantity> </detail>
    </processSalesOrder>
  </soapenv:Body>
</soapenv:Envelope>

Outro caso comum: um middleware SOA que já orquestra vários ERPs chama os serviços publicados de cliente e de item para manter cadastros sincronizados.

Real-Time Events (RTE)

Direção

Saída

Latência

Tempo real, assíncrono

Protocolo

XML sobre JMS, MQ ou HTTP

Posição da Oracle

Suportado

Explicação conceitual e técnica

Um real-time event é uma notificação de saída para um sistema terceiro de que uma transação de negócio ocorreu no JDE. ^[12] O modelo é publicar e assinar: o JDE publica o evento uma vez, e cada assinante recebe a sua cópia.

Tecnicamente, as business functions das transações geram o evento em XML (por exemplo, RTSOOUT para pedidos de venda). Os kernels de eventos do Enterprise Server passam o evento ao Transaction Server, que usa filas e tópicos JMS para garantir a entrega e roteia a informação para as filas de cada assinante com assinatura ativa. ^[12] Os transportes incluem JMS, MQ Series e conectores, e os assinantes são cadastrados no P90702A. ^[14]

Há três famílias de eventos: Z events, gerados a partir das Z-files de saída; real-time events, gerados pelas business functions no momento da transação; e XAPI, em que o JDE envia uma requisição e espera a resposta do sistema externo. ^[13] O destino pode ser uma fila JMS ou MQ, um web service via BSSV ou o Orchestrator, e nos Tools recentes as notificações do Orchestrator são uma alternativa mais simples para muitos casos.

Arquitetura mínima e recomendada

Conhecimentos necessários

Quando é útil

• CRM, WMS ou e-commerce precisam saber na hora que um pedido foi criado, alterado ou faturado.
• Sincronizar cadastros mestres (clientes, fornecedores, itens) com um MDM.
• Alimentar um data lake ou uma plataforma de streaming com as transações.
• Disparar workflows externos sem consultas periódicas ao banco.

Exemplos

<!-- ilustrativo: evento de pedido de venda entregue na fila do assinante -->
<jdeResponse type="realTimeEvent" environment="PD920">
  <event>
    <header> <eventName>RTSOOUT</eventName> <user>VENDAS01</user> </header>
    <detail> <orderNumber>12345</orderNumber> <orderType>SO</orderType> … </detail>
  </event>
</jdeResponse>

Um WMS assina o evento de pedido e, a cada pedido liberado, recebe a mensagem e cria a onda de separação, sem consultar o JDE.

UBEs customizados e Table Conversions

Direção

Entrada e saída

Latência

Lote

Protocolo

Arquivo texto, CSV, layout fixo

Posição da Oracle

Ferramenta padrão do JDE

Explicação conceitual e técnica

UBEs customizados e Table Conversions servem para leitura ou gravação de arquivos texto ou CSV, geração de flat files e conversões entre tabelas. Um UBE pode ler um arquivo, chamar as business functions de edição e gravar os dados. ^{[15] [23] [24]}

A Table Conversion é um tipo de programa em lote feito para mover e transformar dados: de tabela para tabela, de arquivo para tabela ou de tabela para arquivo, com mapeamento de colunas e event rules. O UBE escrito no Report Design Aid dá mais controle: lê o arquivo linha a linha, interpreta registros de cabeçalho, detalhe e trailer, chama business functions e gera um relatório de conferência.

Um padrão robusto é combinar as opções: o UBE ou a Table Conversion apenas converte o arquivo para a Z-file, e o processador padrão faz a validação e a gravação. Assim a regra de negócio continua com a Oracle, e o código customizado fica só com o layout.

É comum em interfaces bancárias (no Brasil, os layouts CNAB de remessa e retorno) e em arquivos fiscais ou de parceiros que não usam EDI.

Arquitetura mínima e recomendada

Conhecimentos necessários

Quando é útil

• Remessa de pagamentos e cobrança, retorno bancário e extratos.
• Arquivos para órgãos fiscais ou para sistemas de terceiros com layout fixo.
• Clientes e fornecedores que trocam planilhas CSV em vez de EDI.
• Exportações para sistemas legados que só leem arquivos.

Exemplos

// ilustrativo: lógica de um UBE que lê o retorno bancário
Para cada linha do arquivo
   Se tipo de registro = "3" e segmento = "T"
      extrair nosso número, valor pago e data de crédito
      localizar a fatura em aberto (F03B11)
      chamar a business function de recebimento
      Se erro: gravar a linha na tabela de rejeitados
Fim
imprimir o resumo: linhas lidas, baixadas, rejeitadas, total

Na saída, um UBE agendado gera todo dia útil o arquivo de remessa de pagamentos aprovados, que o MFT envia ao banco já criptografado.

Business functions (BSFN em C ou NER)

Direção

Principalmente entrada

Latência

Depende de quem chama

Protocolo

Chamada interna do JDE

Posição da Oracle

Bloco de construção

Explicação conceitual e técnica

Business functions podem ser escritas em C ou em NER (Named Event Rules, que o JDE converte em C). As master business functions encapsulam uma transação inteira e seguem um ciclo: BeginDoc valida o cabeçalho e abre o cache, EditLine valida cada linha, EditDoc confere o documento e EndDoc obtém os next numbers e grava tudo. Para pedidos de venda, a família é F4211FSBeginDoc, F4211FSEditLine, F4211FSEditDoc e F4211FSEndDoc. ^{[21] [22]}

Até o EndDoc, os dados ficam no cache do JDE, o que permite validar o documento inteiro antes de gravar. O artigo Cache no JD Edwards explica esse mecanismo em detalhe. ^[20]

Normalmente as BSFNs são acionadas a partir de um UBE, do BSSV ou do Orchestrator, e não isoladamente por um sistema externo: elas precisam de um contexto de execução do JDE (usuário, ambiente, transação), que o programa hospedeiro fornece.

Arquitetura mínima e recomendada

Conhecimentos necessários

Quando é útil

• Dentro de um UBE customizado que lê arquivo e precisa gravar uma transação.
• Num passo de orquestração quando o form request não é adequado, por desempenho ou por uma tela complexa.
• Na implementação de business services.

Exemplos

// ilustrativo: criação de um pedido de venda num UBE
F4211FSBeginDoc   (modo = incluir, versão P4210 = "ZJDE0001", cliente, filial) → número de job
Para cada linha
   F4211FSEditLine (número de job, item, quantidade, preço)
F4211FSEditDoc    (número de job)
F4211FSEndDoc     (número de job) → número do pedido gravado
Se erro em qualquer passo: F4211ClearWorkFiles e registrar a falha

EDI

Direção

Entrada e saída

Latência

Lote, em ciclos curtos

Protocolo

X12 ou EDIFACT via tradutor

Posição da Oracle

Padrão para B2B

Explicação conceitual e técnica

O módulo Data Interface for Electronic Data Interchange (sistema 47) é a interface entre os dados do JDE e o software tradutor. ^[17] O tradutor, externo ao JDE, converte as mensagens padronizadas (X12, EDIFACT) em arquivos planos e vice-versa; o JDE lê e grava as tabelas F47xxx.

Na entrada de um pedido do cliente (850), o tradutor grava o cabeçalho na F47011 e as linhas na F47012; o R47011 lê essas tabelas, valida e cria o pedido de venda nas F4201 e F4211. ^[18] Como as F47 são uma área de espera, é possível inspecionar e corrigir os dados antes de eles virarem um pedido real. Na saída, o R47042 extrai as faturas para as tabelas de saída (F47046 e F47047), que o tradutor converte em 810.

O EDI é indicado para troca de documentos padronizados com clientes e fornecedores, geralmente junto com um tradutor EDI e um canal de comunicação (VAN ou AS2).

Arquitetura mínima e recomendada

Conhecimentos necessários

Quando é útil

• Varejo, distribuição, automotivo e grandes clientes que exigem EDI.
• Alto volume de pedidos, avisos de embarque e faturas com o mesmo parceiro.
• Quando o padrão do documento é imposto pelo parceiro e não negociável.

Exemplos

ISA*00*…~                            (envelope)
ST*850*0001~
BEG*00*SA*PO4500123**20260928~     pedido do cliente → F47011
PO1*1*10*EA*12.50**BP*ITEM220~    linha → F47012
CTT*1~
SE*5*0001~
depois: R47011 cria o pedido de venda; o tradutor devolve o 997 ao cliente

Conectores legados

Direção

Entrada e saída

Latência

Tempo real

Protocolo

JDENET, XML, Java, COM

Posição da Oracle

Não usar em projetos novos

Explicação conceitual e técnica

Os conectores legados incluem: ^{[16] [15]}

• XML CallObject, XMLList, XMLTrans e XML Dispatch: documentos XML enviados ao Enterprise Server para chamar business functions, buscar listas ou gravar transações.
• Dynamic Java Connector: aplicações Java chamam business functions dinamicamente, com bibliotecas do JDE no lado cliente.
• COM Connector: integração com Visual Basic e VC++ por meio do modelo COM da Microsoft.
• XPI: integração com o Oracle Fusion Middleware de gerações anteriores.

Ainda existem em ambientes antigos, mas não são recomendados para projetos novos: acoplam o cliente ao protocolo interno JDENET e às bibliotecas de um Tools Release específico, não trazem os mecanismos atuais de segurança e são difíceis de monitorar.

Arquitetura mínima e recomendada

Conhecimentos necessários

Java, COM ou XML, conforme o conector; o protocolo JDENET; as business functions chamadas. Para a migração: Orchestrator e desenho de APIs REST.

Quando é útil

Apenas para manter integrações existentes enquanto a migração não acontece. Cada chamada inventariada costuma virar uma orquestração com o mesmo contrato de negócio.

Exemplos

<!-- ilustrativo: XML CallObject; repare na senha em texto dentro do documento -->
<jdeRequest type="callmethod" user="INTEGRA" pwd="********" environment="PD920">
  <callMethod name="GetEffectiveAddress" app="Integracao">
    <params> <param name="mnAddressNumber">4242</param> </params>
  </callMethod>
</jdeRequest>

Acesso direto ao banco (SQL)

Direção

Leitura

Latência

Imediata

Protocolo

SQL / JDBC / ODBC

Posição

Ler sim, gravar não

Explicação conceitual e técnica

Gravar direto no banco é tecnicamente possível, mas é desaconselhado. Um INSERT ou UPDATE ignora tudo o que a aplicação faz: validações contra o dicionário de dados e as UDCs, next numbers (F0002), tabelas relacionadas (compromissos de estoque na F41021, saldos contábeis na F0902), campos de auditoria (usuário, programa, data e hora), workflow e a segurança do JDE. O resultado costuma ser saldo que não fecha, número duplicado e registro órfão. A exceção é a própria Z-file, que foi feita para receber dados de fora.

Para leitura (relatórios, BI, views), é aceitável, desde que se respeitem as convenções do JDE:

• Datas julianas no formato CYYDDD: 126271 é o dia 271 de 2026, 28/09/2026.
• Decimais implícitos: valores são gravados como inteiros, com as casas definidas no dicionário de dados ou pela moeda. ^[25]
• UDCs: códigos precisam ser traduzidos pela F0005.
• Campos alinhados: a filial (MCU) tem 12 posições alinhadas à direita.
• A segurança por linha e por coluna do JDE não se aplica a quem lê o banco.

Arquitetura mínima e recomendada

Conhecimentos necessários

SQL, modelo de dados do JDE (tabelas, business views, dicionário de dados), datas julianas, decimais implícitos e UDCs; do lado do DBA, réplicas e permissões. Para relatórios dentro do próprio JDE, o One View Reporting é uma alternativa que respeita a segurança do sistema. ^[26]

Quando é útil

• Data warehouse, data lake e painéis de BI.
• Consultas analíticas pesadas que não devem rodar dentro do JDE.
• Conferências e auditorias pontuais.

Exemplos

-- Oracle Database: linhas de pedido com data convertida
SELECT SDDOCO AS pedido,
       SDDCTO AS tipo,
       TRIM(SDLITM) AS item,
       TO_DATE(TO_CHAR(SDTRDJ + 1900000), 'YYYYDDD') AS data_pedido,
       SDAEXP / 100 AS valor   -- 2 casas implícitas, conforme a moeda
FROM   PRODDTA.F4211
WHERE  SDNXTR < '999';           -- linhas ainda não encerradas

Comparativo, segurança e governança

Segurança em todas as opções

• Identidade: um usuário de serviço por integração, sem acesso interativo, com role mínima no Security Workbench; credenciais em cofre, nunca em scripts ou XML. ^[27]
• Transporte: TLS em tudo (AIS, BSSV, Transaction Server, SFTP, AS2); o JDENET fica restrito à rede dos servidores.
• Perímetro: API gateway ou proxy reverso, WAF, limite de requisições e lista de origens; servidores do JDE em zona interna.
• Dados: mínimo de dados pessoais em Z-files e arquivos, purge periódico, criptografia de arquivos em repouso e mascaramento em réplicas, em linha com a LGPD.
• Auditoria: campos de auditoria do JDE preenchidos com o usuário da integração, logs correlacionados e registro de quem aprovou cada orquestração.

Governança

• Catálogo de interfaces: dono de negócio, dono técnico, método, volume, SLA e procedimento de erro de cada integração.
• Fila de erros com responsável: Work Center, rejeitados de UBE e filas mortas precisam de alguém que olhe todo dia.
• Regressão: cada atualização de Tools, ESU ou versão pode mudar uma regra; as integrações entram no plano de testes.
• Custo total: além de licenças e servidores, conte as pessoas que operam e corrigem as interfaces.

Resumo

Para integrações novas e em tempo real, use o Orchestrator/AIS. Para volumes grandes em lote, as Z-files com os processadores padrão são o caminho mais seguro. Para avisar sistemas externos sobre eventos, use o RTE ou as notificações do Orchestrator.

Revisão rápida

Referências

1. Oracle, “JD Edwards EnterpriseOne Tools Orchestrator Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eotos/orchestrator-guide.pdf.
2. Oracle, “Understanding the Orchestrator Studio and Orchestrations”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eotos/understanding-the-orchestrator-studio-and-orchestrations.html.
3. Oracle, “JD Edwards EnterpriseOne Tools Application Interface Services Server Reference Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoiis/application-interface-services-server-reference-guide.pdf.
4. Oracle, “JD Edwards EnterpriseOne Tools System Overview Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eoihs/system-overview-guide.pdf.
5. Oracle, “Orchestrator and Notification Enhancements, Learn JD Edwards EnterpriseOne”, acesso em 28/09/2026, docs.oracle.com/cd/E84502_01/learnjde/orchestrator-enhancements.html.
6. Oracle, “REST API for JD Edwards EnterpriseOne AIS Server: Start All Scheduled Notifications and Orchestrations v2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v2-scheduler-start-post.html.
7. Oracle, “JD Edwards EnterpriseOne Applications Interoperability Fundamentals Implementation Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoaai/interoperability-fundamentals-implementation-guide.pdf.
8. Oracle, “Structuring Interface Tables, Interoperability Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/structuring-interface-tables.html.
9. Oracle, “Outbound Transactions, Interoperability Fundamentals”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoaai/outbound-transactions-2.html.
10. Oracle, “JD Edwards EnterpriseOne Tools Business Services Development Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotde/toc.htm.
11. Oracle, “Introduction to JD Edwards EnterpriseOne Business Services”, acesso em 28/09/2026, docs.oracle.com/cd/E16582_01/doc.91/e38040/intro_to_bssvs.htm.
12. Oracle, “Overview of Transaction Server, System Overview Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eoihs/overview-of-transaction-server.html.
13. Oracle, “Events, Interoperability Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/events.html.
14. Oracle, “E1: OUTBND: Getting Started with Transaction Server (Doc ID 1156395.1)”, My Oracle Support, requer login, support.oracle.com/knowledge/JD%20Edwards%20EnterpriseOne/1156395_1.html.
15. Oracle, “JD Edwards EnterpriseOne Tools Interoperability Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/interoperability-guide.pdf.
16. Oracle, “JD Edwards EnterpriseOne Tools Connectors Overview”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotcn/jd-edwards-enterpriseone-tools-connectors-overview.html.
17. Oracle, “JD Edwards EnterpriseOne Applications Data Interface for Electronic Data Interchange Implementation Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/supply-chain-manufacturing/9.2/eoadi/data-interface-for-electronic-data-interchange-implementation-guide.pdf.
18. Oracle, “E1: 47: EDI 850 Inbound Purchase Orders (850/ORDERS) FAQ (Doc ID 1595999.1)”, My Oracle Support, requer login, support.oracle.com/knowledge/JD%20Edwards%20EnterpriseOne/1595999_1.html.
19. Oracle, “JD Edwards EnterpriseOne Interoperability 9.2.x, índice dos guias”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/guides.html.
20. Giovani Perotto Mesquita, “Cache no JD Edwards”, JDECache.html.
21. Oracle, “JD Edwards EnterpriseOne Tools APIs and Business Functions Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotbf/apis-and-business-functions-guide.pdf.
22. Oracle, “Business Function Event Rules, APIs and Business Functions Guide”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotbf/business-function-event-rules.html.
23. Oracle, “JD Edwards EnterpriseOne Tools Table Conversion Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eottc/table-conversion-guide.pdf.
24. Oracle, “JD Edwards EnterpriseOne Tools Report Design Aid Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/reporting-analytics/9.2.x/eotrd/report-design-aid-guide.pdf.
25. Oracle, “JD Edwards EnterpriseOne Tools Data Dictionary Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotdd/data-dictionary-guide.pdf.
26. Oracle, “JD Edwards EnterpriseOne Applications One View Reporting User Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/reporting-analytics/9.2.x/eoaov/one-view-reporting-user-guide.pdf.
27. Oracle, “JD Edwards EnterpriseOne Tools Security Administration Guide 9.2”, acesso em 28/09/2026, docs.oracle.com/en/applications/jd-edwards/administration/9.2.x/eotsc/security-administration-guide.pdf.

How to choose

JD Edwards EnterpriseOne offers several ways to integrate. The choice depends mainly on three things: whether the interface is real time or batch, whether JDE sends or receives the data, and which Tools Release you run. ^{[7] [15]}

Behind those three questions sits a principle that applies to every option: JDE business rules live in the applications and in the business functions, not in the database. Every integration that writes data must go through that layer. What changes from one option to another is the entry point, the protocol and the latency.

1. Latency. Real time means one transaction per call, with an answer in seconds, almost always synchronous. Batch means large volumes processed in windows, with the ability to fix and reprocess what failed.
2. Direction. Inbound is when JDE receives data (an order created by a portal). Outbound is when JDE sends or notifies (an approved order that must reach the warehouse). Some options serve both directions.
3. Tools Release. This is the version of the JDE technical foundation, independent of the application release (9.2). The Orchestrator exists in Tools 9.2 and gains features with every update; environments on older Tools depend on Business Services or connectors. ^[5]

Minimal glossary

AIS Server

Application Interface Services: the server that exposes JDE as REST services with JSON.

Orchestrator

Engine running on the AIS Server that executes orchestrations, sequences of steps designed in the Orchestrator Studio.

Tools Release

Version of the JDE technical layer (runtime, servers, tools), updated separately from the applications.

UBE

Universal Batch Engine: a batch program (report or process), identified by an R, such as R09110Z.

BSFN

Business function: a reusable function in C or NER (Named Event Rules, generated into C).

MBF

Master business function: a BSFN that wraps a whole transaction, such as the sales order.

Z-file

Interoperability table (interface table) used as a staging area for batches.

OMW and UDO

Object Management Workbench controls development objects; UDOs (user defined objects) are objects created by users, such as orchestrations.

JDENET

Internal communication protocol between the JDE servers.

CNC

Configurable Network Computing: the technical administration of JDE (servers, packages, security).

Where each option fits

A JDE installation has several servers, and each integration option talks to one of them. The Enterprise Server runs business functions and UBEs. The HTML Server (JAS) runs the web applications. The AIS Server, the Business Services Server and the Transaction Server are Java servers on WebLogic (or WebSphere, in some cases), installed and managed with Server Manager. ^[4]

For the infrastructure architect, each additional server is an instance to size, patch, monitor and protect. The supported versions of WebLogic, Java, operating system and database are defined by Oracle's certification matrix for the Tools Release in use.

Orchestrator and AIS Server

Direction

Inbound and outbound

Latency

Real time or scheduled

Protocol

REST / JSON over HTTPS

Oracle's position

Recommended path

Conceptual and technical explanation

The AIS Server is a REST services server that, configured with the HTML Server, gives access to EnterpriseOne forms and data through JSON over HTTP. ^[3] The Orchestrator uses the AIS Server as its foundation and processes the orchestrations saved there to turn external data into business processes in JDE. ^[1]

Conceptually, it is an API façade: the caller does not need to know which screen, version or business function to use. It calls an endpoint with a business name, such as CreateSalesOrder, and the orchestration handles the rest. This separates the integration contract from the implementation inside JDE.

Technically, an orchestration is a sequence of steps called service requests: ^[2]

• Form request: runs an interactive application as a user would, filling in fields and pressing buttons. The screen's event rules and validations run as usual.
• Data request: queries tables or business views, with filters and aggregations.
• Business function and report: calls a BSFN directly or launches a UBE.
• Custom: runs your own logic in Groovy or Java.
• Connector: gives secure access to external resources, such as a REST service, a database or an orchestration on another JDE system. ^[5]
• Message: sends an email or a Work Center message.

Rules (conditions), cross-references and white lists translate codes and decide the path. Notifications assess JDE data or external REST services to detect conditions that need attention, and the built-in scheduler runs orchestrations and notifications periodically. ^{[5] [6]} Since Tools 9.2.4, the Orchestrator Studio is deployed together with the AIS Server and reached through its own URL. ^[1]

The big advantage is that the business rules of the JDE screens are honoured: a form request on P4210 goes through the same validations, versions and processing options as a user keying the order.

Minimum and recommended architecture

Required knowledge

When it is useful

• Portals and e-commerce that create orders or check price, stock or status in real time.
• iPaaS (Oracle Integration, MuleSoft, Boomi) connecting JDE to SaaS such as CRM, WMS or carriers.
• Mobile apps for approvals, production reporting or inspections.
• IoT: sensors that create maintenance orders or record readings.
• Automating repetitive data entry, instead of screen robots.
• Outbound: JDE calling external APIs through connectors, or alerting people with notifications.

Examples

A portal creates a sales order by calling an orchestration that, inside, uses a form request on P4210 with the web-store version:

# illustrative call, through the API gateway
POST https://api.company.com/jde/v3/orchestrator/ORCH_CreateSalesOrder
Authorization: Bearer <token>
Content-Type: application/json

{ "Customer": "4242", "BranchPlant": "M30", "CustomerPO": "PO-4500123",
  "Lines": [ { "Item": "220", "Quantity": 5 } ] }

# response
{ "OrderNumber": "12345", "OrderType": "SO", "Status": "520" }

• IoT: a temperature sensor sends readings; a rule in the orchestration creates a maintenance order when the limit is exceeded.
• Notification: every day at 8 a.m., orders on credit hold above a threshold send a message to the finance manager.
• Outbound: when a supplier is approved, an orchestration calls a registration-check API through a connector.

Z-files (interoperability tables)

Direction

Inbound and outbound

Latency

Batch (minutes to hours)

Protocol

Table + processor UBE

Oracle's position

Standard for batches

Conceptual and technical explanation

Z-files are the classic method for batch loads. Each is an interface table with the columns of the application table plus control fields. The name follows the source table with the Z1 suffix: F4211 has F4211Z1. When the interface table would exceed 250 columns, an additional table is created with a letter after the suffix, such as F4211Z1A. ^[8]

The control fields form the key and the state of each record: user (EDUS), batch (EDBT), transaction number (EDTN), line (EDLN), processed flag (EDSP), action (EDTC: A to add, C to change, D to delete) and transaction type (EDTR). ^[7]

Inbound, an external system writes to the Z-file and then runs the processor UBE, for example R09110Z for journal entries or R4211Z1I for sales orders. The processor reads the unprocessed records, calls the master business function with the version set in the processing options and writes to the final tables. Records in error stay in the Z-file, the message goes to the Work Center, and they can be fixed and reprocessed. ^[7]

It also works outbound: the application's processing options or the data export controls (P0047) make JDE write each transaction to the Z-file, with its action code, for an external system to read. ^[9] It is robust and reuses the standard validation, but it is not real time.

Minimum and recommended architecture

Required knowledge

When it is useful

• Migrations and initial loads of master data and balances.
• Accounting from satellite systems: payroll, external billing, travel expenses.
• E-commerce or sales-force orders consolidated in batches.
• High-volume overnight interfaces, where reprocessing matters more than an immediate answer.

Examples

Payroll writes the month's journal entries to F0911Z1 and triggers R09110Z:

-- illustrative: one entry of 150.00 (implied decimals) on 28/09/2026
INSERT INTO PRODDTA.F0911Z1
  (VNEDUS, VNEDTN, VNEDLN, VNEDBT, VNEDSP, VNEDTC, VNDCT, VNDGJ, VNANI, VNAA, VNLT)
VALUES
  ('INTPAYROL', '000123', 1000, 'PAY0926', ' ', 'A', 'JE',
   126271, '100.8150', 15000, 'AA');
-- 126271 = year 2026 (1 + 26) and day 271 of the year
-- then: R09110Z, payroll version; batches go on to approval and posting

Outbound, a P4210 version set up to write F4211Z1 lets a logistics system read each added or changed order and flag the records as processed.

Business Services (BSSV)

Direction

Inbound and outbound

Latency

Real time

Protocol

SOAP / XML over HTTPS

Oracle's position

Supported, losing ground

Conceptual and technical explanation

Business Services are Java classes developed in JDeveloper, controlled in OMW like any other JDE object and published as web services on a Business Services Server running WebLogic or WebSphere. ^{[10] [11]}

A published business service is an OMW object that represents one Java class publishing several operations. ^[10] It delegates to internal business services, which work with value objects and call business functions and data access through the JDE runtime API. Oracle delivers many ready-made services (customers, suppliers, items, orders, inventory), and you can build your own.

The reverse path exists too: JDE can be a consumer of web services. A business function calls a consumer business service, which calls the external service and returns the answer to the JDE logic.

It is still widely used, but it is losing ground to AIS and the Orchestrator: SOAP is heavier, and each change requires a Java development cycle, a package build and a deployment to the server, while an orchestration is adjusted in the Studio.

Minimum and recommended architecture

Required knowledge

When it is useful

• Existing, stable SOAP integrations.
• SOA middleware (Oracle SOA Suite, service bus) that expects WSDL contracts.
• Complex Java logic that does not fit well in a Groovy script.
• Environments without an AIS Server. For new projects, prefer the Orchestrator and plan the migration of existing BSSVs.

Examples

<!-- illustrative: call to the sales order service (JP420000) -->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Header>
    <wsse:Security> … user and token … </wsse:Security>
  </soapenv:Header>
  <soapenv:Body>
    <processSalesOrder>
      <header> <customer>4242</customer> <businessUnit>M30</businessUnit> </header>
      <detail> <item>220</item> <quantity>5</quantity> </detail>
    </processSalesOrder>
  </soapenv:Body>
</soapenv:Envelope>

Another common case: a SOA middleware that already orchestrates several ERPs calls the published customer and item services to keep master data in sync.

Real-Time Events (RTE)

Direction

Outbound

Latency

Real time, asynchronous

Protocol

XML over JMS, MQ or HTTP

Oracle's position

Supported

Conceptual and technical explanation

A real-time event is an outbound notification to a third-party system that a business transaction has occurred in JDE. ^[12] The model is publish and subscribe: JDE publishes the event once, and each subscriber receives its own copy.

Technically, the transaction business functions raise the event in XML (for example, RTSOOUT for sales orders). The Enterprise Server event kernels pass the event to the Transaction Server, which uses JMS queues and topics to guarantee delivery and routes the information to the queues of each subscriber with an active subscription. ^[12] Transports include JMS, MQ Series and connectors, and subscribers are registered in P90702A. ^[14]

There are three families of events: Z events, produced from the outbound Z-files; real-time events, raised by business functions at transaction time; and XAPI, where JDE sends a request and waits for the external system's reply. ^[13] The target can be a JMS or MQ queue, a web service through BSSV or the Orchestrator, and on recent Tools the Orchestrator notifications are a simpler alternative for many cases.

Minimum and recommended architecture

Required knowledge

When it is useful

• CRM, WMS or e-commerce must know at once that an order was created, changed or invoiced.
• Synchronising master data (customers, suppliers, items) with an MDM.
• Feeding a data lake or a streaming platform with the transactions.
• Triggering external workflows without polling the database.

Examples

<!-- illustrative: sales order event delivered to the subscriber's queue -->
<jdeResponse type="realTimeEvent" environment="PD920">
  <event>
    <header> <eventName>RTSOOUT</eventName> <user>SALES01</user> </header>
    <detail> <orderNumber>12345</orderNumber> <orderType>SO</orderType> … </detail>
  </event>
</jdeResponse>

A WMS subscribes to the order event and, for every released order, receives the message and creates the picking wave, without querying JDE.

Custom UBEs and Table Conversions

Direction

Inbound and outbound

Latency

Batch

Protocol

Text file, CSV, fixed layout

Oracle's position

Standard JDE tool

Conceptual and technical explanation

Custom UBEs and Table Conversions are used to read or write text or CSV files, produce flat files and convert between tables. A UBE can read a file, call the edit business functions and write the data. ^{[15] [23] [24]}

A Table Conversion is a kind of batch program built to move and transform data: table to table, file to table or table to file, with column mapping and event rules. A UBE written in Report Design Aid gives more control: it reads the file line by line, interprets header, detail and trailer records, calls business functions and prints an audit report.

A robust pattern combines the options: the UBE or Table Conversion only converts the file into the Z-file, and the standard processor does the validation and the write. The business rule stays with Oracle, and the custom code only deals with the layout.

It is common in bank interfaces (in Brazil, the CNAB remittance and return layouts) and in tax files or files from partners that do not use EDI.

Minimum and recommended architecture

Required knowledge

When it is useful

• Payment and collection remittances, bank return files and statements.
• Files for tax authorities or third-party systems with a fixed layout.
• Customers and suppliers that exchange CSV spreadsheets instead of EDI.
• Exports to legacy systems that only read files.

Examples

// illustrative: logic of a UBE that reads the bank return file
For each line of the file
   If record type = "3" and segment = "T"
      extract bank reference, amount paid and credit date
      find the open invoice (F03B11)
      call the receipt business function
      If error: write the line to the rejected table
End
print the summary: lines read, applied, rejected, total

Outbound, a scheduled UBE builds the approved-payments remittance file every business day, and the MFT sends it to the bank already encrypted.

Business functions (BSFN in C or NER)

Direction

Mainly inbound

Latency

Depends on the caller

Protocol

Internal JDE call

Oracle's position

Building block

Conceptual and technical explanation

Business functions can be written in C or in NER (Named Event Rules, which JDE converts into C). Master business functions wrap a whole transaction and follow a cycle: BeginDoc validates the header and opens the cache, EditLine validates each line, EditDoc checks the document and EndDoc gets the next numbers and writes everything. For sales orders, the family is F4211FSBeginDoc, F4211FSEditLine, F4211FSEditDoc and F4211FSEndDoc. ^{[21] [22]}

Until EndDoc, the data stays in the JDE cache, which allows the whole document to be validated before anything is written. The article Caching in JD Edwards explains this mechanism in detail. ^[20]

BSFNs are normally triggered from a UBE, BSSV or the Orchestrator, not called on their own by an external system: they need a JDE execution context (user, environment, transaction), which the host program provides.

Minimum and recommended architecture

Required knowledge

When it is useful

• Inside a custom UBE that reads a file and must write a transaction.
• In an orchestration step when a form request is not suitable, for performance or because of a complex screen.
• In the implementation of business services.

Examples

// illustrative: creating a sales order in a UBE
F4211FSBeginDoc   (mode = add, P4210 version = "ZJDE0001", customer, branch) → job number
For each line
   F4211FSEditLine (job number, item, quantity, price)
F4211FSEditDoc    (job number)
F4211FSEndDoc     (job number) → order number written
If any step fails: F4211ClearWorkFiles and log the failure

EDI

Direction

Inbound and outbound

Latency

Batch, in short cycles

Protocol

X12 or EDIFACT through a translator

Oracle's position

Standard for B2B

Conceptual and technical explanation

The Data Interface for Electronic Data Interchange module (system 47) is the interface between JDE data and the translator software. ^[17] The translator, outside JDE, turns standard messages (X12, EDIFACT) into flat files and back; JDE reads and writes the F47xxx tables.

For an inbound customer order (850), the translator writes the header to F47011 and the lines to F47012; R47011 reads these tables, validates them and creates the sales order in F4201 and F4211. ^[18] Because the F47 tables are a staging area, the data can be inspected and fixed before it becomes a real order. Outbound, R47042 extracts invoices to the outbound tables (F47046 and F47047), which the translator turns into an 810.

EDI is the right fit for exchanging standardised documents with customers and suppliers, usually with an EDI translator and a communication channel (VAN or AS2).

Minimum and recommended architecture

Required knowledge

When it is useful

• Retail, distribution, automotive and large customers that require EDI.
• High volumes of orders, shipping notices and invoices with the same partner.
• When the document standard is imposed by the partner and not negotiable.

Examples

ISA*00*…~                            (envelope)
ST*850*0001~
BEG*00*SA*PO4500123**20260928~     customer order → F47011
PO1*1*10*EA*12.50**BP*ITEM220~    line → F47012
CTT*1~
SE*5*0001~
then: R47011 creates the sales order; the translator returns the 997 to the customer

Legacy connectors

Direction

Inbound and outbound

Latency

Real time

Protocol

JDENET, XML, Java, COM

Oracle's position

Not for new projects

Conceptual and technical explanation

Legacy connectors include: ^{[16] [15]}

• XML CallObject, XMLList, XMLTrans and XML Dispatch: XML documents sent to the Enterprise Server to call business functions, fetch lists or write transactions.
• Dynamic Java Connector: Java applications call business functions dynamically, with JDE libraries on the client side.
• COM Connector: integration with Visual Basic and VC++ through Microsoft's COM model.
• XPI: integration with earlier generations of Oracle Fusion Middleware.

They still exist in older environments but are not recommended for new projects: they couple the client to the internal JDENET protocol and to the libraries of a specific Tools Release, lack today's security mechanisms and are hard to monitor.

Minimum and recommended architecture

Required knowledge

Java, COM or XML, depending on the connector; the JDENET protocol; the business functions being called. For the migration: Orchestrator and REST API design.

When it is useful

Only to keep existing integrations running until the migration happens. Each inventoried call usually becomes an orchestration with the same business contract.

Examples

<!-- illustrative: XML CallObject; note the password in clear text inside the document -->
<jdeRequest type="callmethod" user="INTEGRA" pwd="********" environment="PD920">
  <callMethod name="GetEffectiveAddress" app="Integration">
    <params> <param name="mnAddressNumber">4242</param> </params>
  </callMethod>
</jdeRequest>

Direct database access (SQL)

Direction

Read

Latency

Immediate

Protocol

SQL / JDBC / ODBC

Position

Read yes, write no

Conceptual and technical explanation

Writing directly to the database is technically possible, but it is discouraged. An INSERT or UPDATE skips everything the application does: edits against the data dictionary and UDCs, next numbers (F0002), related tables (inventory commitments in F41021, account balances in F0902), audit fields (user, program, date and time), workflow and JDE security. The usual result is balances that do not tie, duplicate numbers and orphan records. The exception is the Z-file itself, which was designed to receive data from outside.

For reading (reports, BI, views) it is acceptable, as long as JDE conventions are respected:

• Julian dates in CYYDDD format: 126271 is day 271 of 2026, 28/09/2026.
• Implied decimals: values are stored as integers, with the decimal places defined in the data dictionary or by the currency. ^[25]
• UDCs: codes must be translated through F0005.
• Justified fields: the business unit (MCU) has 12 right-justified positions.
• JDE row and column security does not apply to whoever reads the database.

Minimum and recommended architecture

Required knowledge

SQL, the JDE data model (tables, business views, data dictionary), Julian dates, implied decimals and UDCs; on the DBA side, replicas and permissions. For reporting inside JDE itself, One View Reporting is an alternative that respects system security. ^[26]

When it is useful

• Data warehouse, data lake and BI dashboards.
• Heavy analytical queries that should not run inside JDE.
• One-off checks and audits.

Examples

-- Oracle Database: order lines with the date converted
SELECT SDDOCO AS order_no,
       SDDCTO AS order_type,
       TRIM(SDLITM) AS item,
       TO_DATE(TO_CHAR(SDTRDJ + 1900000), 'YYYYDDD') AS order_date,
       SDAEXP / 100 AS amount   -- 2 implied decimals, depending on the currency
FROM   PRODDTA.F4211
WHERE  SDNXTR < '999';             -- lines not yet closed

Comparison, security and governance

Security across all options

• Identity: one service user per integration, with no interactive access and a least-privilege role in Security Workbench; credentials in a vault, never in scripts or XML. ^[27]
• Transport: TLS everywhere (AIS, BSSV, Transaction Server, SFTP, AS2); JDENET stays within the server network.
• Perimeter: API gateway or reverse proxy, WAF, rate limiting and a list of allowed sources; JDE servers in an internal zone.
• Data: as little personal data as possible in Z-files and files, periodic purge, encryption of files at rest and masking in replicas, in line with GDPR and LGPD.
• Audit: JDE audit fields filled with the integration user, correlated logs and a record of who approved each orchestration.

Governance

• Interface catalogue: business owner, technical owner, method, volume, SLA and error procedure for each integration.
• Error queue with an owner: Work Center, UBE rejects and dead-letter queues need someone to look at them every day.
• Regression: every Tools update, ESU or version change can alter a rule; integrations belong in the test plan.
• Total cost: besides licences and servers, count the people who run and fix the interfaces.

Summary

For new, real-time integrations, use the Orchestrator/AIS. For large batch volumes, Z-files with the standard processors are the safest path. To notify external systems about events, use RTE or Orchestrator notifications.

Quick review

References

1. Oracle, “JD Edwards EnterpriseOne Tools Orchestrator Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eotos/orchestrator-guide.pdf.
2. Oracle, “Understanding the Orchestrator Studio and Orchestrations”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eotos/understanding-the-orchestrator-studio-and-orchestrations.html.
3. Oracle, “JD Edwards EnterpriseOne Tools Application Interface Services Server Reference Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoiis/application-interface-services-server-reference-guide.pdf.
4. Oracle, “JD Edwards EnterpriseOne Tools System Overview Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eoihs/system-overview-guide.pdf.
5. Oracle, “Orchestrator and Notification Enhancements, Learn JD Edwards EnterpriseOne”, accessed on 28/09/2026, docs.oracle.com/cd/E84502_01/learnjde/orchestrator-enhancements.html.
6. Oracle, “REST API for JD Edwards EnterpriseOne AIS Server: Start All Scheduled Notifications and Orchestrations v2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v2-scheduler-start-post.html.
7. Oracle, “JD Edwards EnterpriseOne Applications Interoperability Fundamentals Implementation Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoaai/interoperability-fundamentals-implementation-guide.pdf.
8. Oracle, “Structuring Interface Tables, Interoperability Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/structuring-interface-tables.html.
9. Oracle, “Outbound Transactions, Interoperability Fundamentals”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoaai/outbound-transactions-2.html.
10. Oracle, “JD Edwards EnterpriseOne Tools Business Services Development Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotde/toc.htm.
11. Oracle, “Introduction to JD Edwards EnterpriseOne Business Services”, accessed on 28/09/2026, docs.oracle.com/cd/E16582_01/doc.91/e38040/intro_to_bssvs.htm.
12. Oracle, “Overview of Transaction Server, System Overview Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eoihs/overview-of-transaction-server.html.
13. Oracle, “Events, Interoperability Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/events.html.
14. Oracle, “E1: OUTBND: Getting Started with Transaction Server (Doc ID 1156395.1)”, My Oracle Support, login required, support.oracle.com/knowledge/JD%20Edwards%20EnterpriseOne/1156395_1.html.
15. Oracle, “JD Edwards EnterpriseOne Tools Interoperability Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/interoperability-guide.pdf.
16. Oracle, “JD Edwards EnterpriseOne Tools Connectors Overview”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotcn/jd-edwards-enterpriseone-tools-connectors-overview.html.
17. Oracle, “JD Edwards EnterpriseOne Applications Data Interface for Electronic Data Interchange Implementation Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/supply-chain-manufacturing/9.2/eoadi/data-interface-for-electronic-data-interchange-implementation-guide.pdf.
18. Oracle, “E1: 47: EDI 850 Inbound Purchase Orders (850/ORDERS) FAQ (Doc ID 1595999.1)”, My Oracle Support, login required, support.oracle.com/knowledge/JD%20Edwards%20EnterpriseOne/1595999_1.html.
19. Oracle, “JD Edwards EnterpriseOne Interoperability 9.2.x, guide index”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/guides.html.
20. Giovani Perotto Mesquita, “Caching in JD Edwards”, JDECache.html.
21. Oracle, “JD Edwards EnterpriseOne Tools APIs and Business Functions Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotbf/apis-and-business-functions-guide.pdf.
22. Oracle, “Business Function Event Rules, APIs and Business Functions Guide”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotbf/business-function-event-rules.html.
23. Oracle, “JD Edwards EnterpriseOne Tools Table Conversion Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eottc/table-conversion-guide.pdf.
24. Oracle, “JD Edwards EnterpriseOne Tools Report Design Aid Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/reporting-analytics/9.2.x/eotrd/report-design-aid-guide.pdf.
25. Oracle, “JD Edwards EnterpriseOne Tools Data Dictionary Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotdd/data-dictionary-guide.pdf.
26. Oracle, “JD Edwards EnterpriseOne Applications One View Reporting User Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/reporting-analytics/9.2.x/eoaov/one-view-reporting-user-guide.pdf.
27. Oracle, “JD Edwards EnterpriseOne Tools Security Administration Guide 9.2”, accessed on 28/09/2026, docs.oracle.com/en/applications/jd-edwards/administration/9.2.x/eotsc/security-administration-guide.pdf.

Come scegliere

JD Edwards EnterpriseOne offre diverse forme di integrazione. La scelta dipende soprattutto da tre cose: se l'interfaccia è in tempo reale o batch, se JDE invia o riceve i dati e quale Tools Release si usa. ^{[7] [15]}

Dietro le tre domande c'è un principio che vale per tutte le opzioni: le regole di business di JDE stanno nelle applicazioni e nelle business function, non nel database. Ogni integrazione che scrive dati deve passare da quello strato. Da un'opzione all'altra cambiano il punto di ingresso, il protocollo e la latenza.

1. Latenza. Tempo reale significa una transazione per chiamata, con risposta in pochi secondi, quasi sempre sincrona. Batch significa grandi volumi elaborati in finestre, con la possibilità di correggere e rielaborare ciò che è fallito.
2. Direzione. Ingresso è quando JDE riceve dati (un ordine creato da un portale). Uscita è quando JDE invia o avvisa (un ordine approvato che deve arrivare al magazzino). Alcune opzioni servono entrambe le direzioni.
3. Tools Release. È la versione della base tecnica di JDE, indipendente dalla release delle applicazioni (9.2). L'Orchestrator esiste nel Tools 9.2 e si arricchisce a ogni aggiornamento; gli ambienti con Tools datati dipendono dai Business Services o dai connettori. ^[5]

Glossario minimo

AIS Server

Application Interface Services: il server che espone JDE come servizi REST con JSON.

Orchestrator

Motore che gira sull'AIS Server ed esegue orchestrazioni, sequenze di passi progettate nell'Orchestrator Studio.

Tools Release

Versione dello strato tecnico di JDE (runtime, server, strumenti), aggiornata separatamente dalle applicazioni.

UBE

Universal Batch Engine: programma batch (report o processo), identificato da una R, come R09110Z.

BSFN

Business function: funzione riutilizzabile in C o in NER (Named Event Rules, generate in C).

MBF

Master business function: BSFN che incapsula un'intera transazione, come l'ordine di vendita.

Z-file

Tabella di interoperabilità (interface table) usata come area di sosta per i batch.

OMW e UDO

L'Object Management Workbench controlla gli oggetti di sviluppo; gli UDO (user defined object) sono oggetti creati dagli utenti, come le orchestrazioni.

JDENET

Protocollo interno di comunicazione tra i server di JDE.

CNC

Configurable Network Computing: l'amministrazione tecnica di JDE (server, pacchetti, sicurezza).

Dove si colloca ogni opzione

Un'installazione di JDE ha diversi server, e ogni opzione di integrazione dialoga con uno di essi. L'Enterprise Server esegue le business function e gli UBE. L'HTML Server (JAS) esegue le applicazioni web. L'AIS Server, il Business Services Server e il Transaction Server sono server Java su WebLogic (o WebSphere, in alcuni casi), installati e amministrati con il Server Manager. ^[4]

Per l'architetto infrastrutturale, ogni server in più è un'istanza da dimensionare, aggiornare, monitorare e proteggere. Le versioni supportate di WebLogic, Java, sistema operativo e database sono definite dalla matrice di certificazione di Oracle per il Tools Release in uso.

Orchestrator e AIS Server

Direzione

Ingresso e uscita

Latenza

Tempo reale o pianificata

Protocollo

REST / JSON su HTTPS

Posizione di Oracle

Percorso consigliato

Spiegazione concettuale e tecnica

L'AIS Server è un server di servizi REST che, configurato insieme all'HTML Server, dà accesso a form e dati di EnterpriseOne tramite JSON su HTTP. ^[3] L'Orchestrator usa l'AIS Server come base ed elabora le orchestrazioni salvate lì per trasformare dati esterni in processi di business in JDE. ^[1]

Concettualmente è una facciata di API: chi chiama non deve sapere quale videata, versione o business function usare. Chiama un endpoint con un nome di business, come CreaOrdineVendita, e l'orchestrazione fa il resto. Così il contratto dell'integrazione resta separato dall'implementazione dentro JDE.

Tecnicamente, un'orchestrazione è una sequenza di passi chiamati service request: ^[2]

• Form request: esegue un'applicazione interattiva come farebbe un utente, compilando campi e premendo pulsanti. Le event rule e le validazioni della videata girano normalmente.
• Data request: interroga tabelle o business view, con filtri e aggregazioni.
• Business function e report: chiama direttamente una BSFN o avvia un UBE.
• Custom: esegue logica propria in Groovy o Java.
• Connettore: dà accesso sicuro a risorse esterne, come un servizio REST, un database o un'orchestrazione di un altro sistema JDE. ^[5]
• Messaggio: invia un'e-mail o un messaggio al Work Center.

Regole (condizioni), cross-reference e white list traducono i codici e decidono il percorso. Le notifiche valutano dati di JDE o di servizi REST esterni per individuare situazioni che richiedono attenzione, e lo scheduler integrato esegue orchestrazioni e notifiche periodicamente. ^{[5] [6]} Dal Tools 9.2.4 l'Orchestrator Studio viene installato insieme all'AIS Server e si raggiunge dal suo stesso URL. ^[1]

Il grande vantaggio è che le regole di business delle videate di JDE vengono rispettate: un form request sul P4210 passa per le stesse validazioni, versioni e opzioni di elaborazione di un utente che digita l'ordine.

Architettura minima e consigliata

Competenze necessarie

Quando è utile

• Portali ed e-commerce che creano ordini o consultano prezzo, giacenza o stato in tempo reale.
• iPaaS (Oracle Integration, MuleSoft, Boomi) che collegano JDE a SaaS come CRM, WMS o vettori.
• App mobili per approvazioni, dichiarazioni di produzione o ispezioni.
• IoT: sensori che generano ordini di manutenzione o registrano letture.
• Automazione di inserimenti ripetitivi, al posto dei robot di videata.
• Uscita: JDE che chiama API esterne tramite connettori o avvisa le persone con le notifiche.

Esempi

Un portale crea un ordine di vendita chiamando un'orchestrazione che, al suo interno, usa un form request sul P4210 con la versione del negozio online:

# chiamata illustrativa, tramite l'API gateway
POST https://api.azienda.it/jde/v3/orchestrator/ORCH_CreaOrdineVendita
Authorization: Bearer <token>
Content-Type: application/json

{ "Cliente": "4242", "Filiale": "M30", "OrdineCliente": "PO-4500123",
  "Righe": [ { "Articolo": "220", "Quantita": 5 } ] }

# risposta
{ "NumeroOrdine": "12345", "TipoOrdine": "SO", "Stato": "520" }

• IoT: un sensore di temperatura invia letture; una regola nell'orchestrazione crea un ordine di manutenzione quando il limite viene superato.
• Notifica: ogni giorno alle 8, gli ordini bloccati per fido sopra una soglia inviano un messaggio al responsabile finanziario.
• Uscita: all'approvazione di un fornitore, un'orchestrazione chiama tramite connettore l'API di un servizio di verifica anagrafica.

Z-file (tabelle di interoperabilità)

Direzione

Ingresso e uscita

Latenza

Batch (minuti o ore)

Protocollo

Tabella + UBE elaboratore

Posizione di Oracle

Standard per i batch

Spiegazione concettuale e tecnica

Le Z-file sono il metodo classico per i caricamenti batch. Ognuna è una interface table con le colonne della tabella applicativa più alcuni campi di controllo. Il nome segue la tabella d'origine con il suffisso Z1: la F4211 ha la F4211Z1. Quando la tabella di interfaccia supererebbe le 250 colonne, si crea una tabella aggiuntiva con una lettera dopo il suffisso, come F4211Z1A. ^[8]

I campi di controllo formano la chiave e lo stato di ogni record: utente (EDUS), batch (EDBT), numero di transazione (EDTN), riga (EDLN), indicatore di elaborato (EDSP), azione (EDTC: A per aggiungere, C per modificare, D per eliminare) e tipo di transazione (EDTR). ^[7]

In ingresso, un sistema esterno scrive nella Z-file e poi lancia l'UBE elaboratore, per esempio l'R09110Z per le registrazioni contabili o l'R4211Z1I per gli ordini di vendita. L'elaboratore legge i record non ancora elaborati, chiama la master business function con la versione definita nelle opzioni di elaborazione e scrive nelle tabelle definitive. I record in errore restano nella Z-file, il messaggio va nel Work Center e si possono correggere e rielaborare. ^[7]

Funziona anche in uscita: le opzioni di elaborazione dell'applicazione o i controlli di esportazione (P0047) fanno sì che JDE scriva ogni transazione nella Z-file, con il codice azione, perché un sistema esterno la legga. ^[9] È robusto e sfrutta la validazione standard, ma non è in tempo reale.

Architettura minima e consigliata

Competenze necessarie

Quando è utile

• Migrazioni e caricamenti iniziali di anagrafiche e saldi.
• Contabilizzazione da sistemi satellite: paghe, fatturazione esterna, note spese.
• Ordini di e-commerce o della forza vendita consolidati in batch.
• Interfacce notturne ad alto volume, dove rielaborare conta più che rispondere subito.

Esempi

Il sistema paghe scrive le registrazioni contabili del mese nella F0911Z1 e lancia l'R09110Z:

-- illustrativo: una registrazione di 150,00 (decimali impliciti) del 28/09/2026
INSERT INTO PRODDTA.F0911Z1
  (VNEDUS, VNEDTN, VNEDLN, VNEDBT, VNEDSP, VNEDTC, VNDCT, VNDGJ, VNANI, VNAA, VNLT)
VALUES
  ('INTPAGHE', '000123', 1000, 'PAGHE0926', ' ', 'A', 'JE',
   126271, '100.8150', 15000, 'AA');
-- 126271 = anno 2026 (1 + 26) e giorno 271 dell'anno
-- poi: R09110Z, versione delle paghe; i batch passano ad approvazione e contabilizzazione

In uscita, una versione del P4210 configurata per scrivere la F4211Z1 permette a un sistema logistico di leggere ogni ordine aggiunto o modificato e di marcare i record come elaborati.

Business Services (BSSV)

Direzione

Ingresso e uscita

Latenza

Tempo reale

Protocollo

SOAP / XML su HTTPS

Posizione di Oracle

Supportato, in calo

Spiegazione concettuale e tecnica

I Business Services sono classi Java sviluppate in JDeveloper, gestite in OMW come ogni altro oggetto di JDE e pubblicate come web service su un Business Services Server in WebLogic o WebSphere. ^{[10] [11]}

Un published business service è un oggetto OMW che rappresenta una classe Java che pubblica più operazioni. ^[10] Delega a business service interni, che lavorano con value object e chiamano business function e accessi ai dati tramite l'API di runtime di JDE. Oracle fornisce molti servizi pronti (clienti, fornitori, articoli, ordini, magazzino), e se ne possono creare di propri.

Esiste anche il percorso inverso: JDE può essere consumatore di web service. Una business function chiama un business service consumatore, che chiama il servizio esterno e restituisce la risposta alla logica di JDE.

È ancora molto usato, ma sta perdendo terreno rispetto ad AIS e Orchestrator: SOAP è più pesante, e ogni modifica richiede un ciclo di sviluppo Java, la build del pacchetto e il deploy sul server, mentre un'orchestrazione si adatta nello Studio.

Architettura minima e consigliata

Competenze necessarie

Quando è utile

• Integrazioni SOAP già esistenti e stabili.
• Middleware SOA (Oracle SOA Suite, service bus) che si aspetta contratti WSDL.
• Logica complessa in Java che non si adatta bene a uno script Groovy.
• Ambienti senza AIS Server. Nei progetti nuovi preferite l'Orchestrator e pianificate la migrazione dei BSSV esistenti.

Esempi

<!-- illustrativo: chiamata al servizio degli ordini di vendita (JP420000) -->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Header>
    <wsse:Security> … utente e token … </wsse:Security>
  </soapenv:Header>
  <soapenv:Body>
    <processSalesOrder>
      <header> <customer>4242</customer> <businessUnit>M30</businessUnit> </header>
      <detail> <item>220</item> <quantity>5</quantity> </detail>
    </processSalesOrder>
  </soapenv:Body>
</soapenv:Envelope>

Un altro caso comune: un middleware SOA che già orchestra diversi ERP chiama i servizi pubblicati di cliente e articolo per mantenere sincronizzate le anagrafiche.

Real-Time Events (RTE)

Direzione

Uscita

Latenza

Tempo reale, asincrona

Protocollo

XML su JMS, MQ o HTTP

Posizione di Oracle

Supportato

Spiegazione concettuale e tecnica

Un real-time event è una notifica in uscita verso un sistema terzo che una transazione di business è avvenuta in JDE. ^[12] Il modello è publish e subscribe: JDE pubblica l'evento una volta e ogni sottoscrittore riceve la propria copia.

Tecnicamente, le business function delle transazioni generano l'evento in XML (per esempio RTSOOUT per gli ordini di vendita). I kernel degli eventi dell'Enterprise Server passano l'evento al Transaction Server, che usa code e topic JMS per garantire la consegna e instrada l'informazione verso le code di ogni sottoscrittore con una sottoscrizione attiva. ^[12] I trasporti includono JMS, MQ Series e connettori, e i sottoscrittori si registrano nel P90702A. ^[14]

Ci sono tre famiglie di eventi: gli Z event, prodotti a partire dalle Z-file in uscita; i real-time event, generati dalle business function al momento della transazione; e gli XAPI, in cui JDE invia una richiesta e attende la risposta del sistema esterno. ^[13] La destinazione può essere una coda JMS o MQ, un web service tramite BSSV o l'Orchestrator, e nei Tools recenti le notifiche dell'Orchestrator sono un'alternativa più semplice in molti casi.

Architettura minima e consigliata

Competenze necessarie

Quando è utile

• CRM, WMS o e-commerce devono sapere subito che un ordine è stato creato, modificato o fatturato.
• Sincronizzare le anagrafiche (clienti, fornitori, articoli) con un MDM.
• Alimentare un data lake o una piattaforma di streaming con le transazioni.
• Avviare workflow esterni senza interrogare periodicamente il database.

Esempi

<!-- illustrativo: evento di ordine di vendita consegnato nella coda del sottoscrittore -->
<jdeResponse type="realTimeEvent" environment="PD920">
  <event>
    <header> <eventName>RTSOOUT</eventName> <user>VENDITE01</user> </header>
    <detail> <orderNumber>12345</orderNumber> <orderType>SO</orderType> … </detail>
  </event>
</jdeResponse>

Un WMS sottoscrive l'evento dell'ordine e, per ogni ordine rilasciato, riceve il messaggio e crea l'ondata di prelievo, senza interrogare JDE.

UBE personalizzati e Table Conversion

Direzione

Ingresso e uscita

Latenza

Batch

Protocollo

File di testo, CSV, tracciato fisso

Posizione di Oracle

Strumento standard di JDE

Spiegazione concettuale e tecnica

UBE personalizzati e Table Conversion servono a leggere o scrivere file di testo o CSV, a generare flat file e a convertire dati tra tabelle. Un UBE può leggere un file, chiamare le business function di validazione e scrivere i dati. ^{[15] [23] [24]}

La Table Conversion è un tipo di programma batch fatto per spostare e trasformare dati: da tabella a tabella, da file a tabella o da tabella a file, con mappatura delle colonne ed event rule. Un UBE scritto con il Report Design Aid dà più controllo: legge il file riga per riga, interpreta record di testata, dettaglio e coda, chiama business function e stampa un report di controllo.

Un pattern robusto combina le opzioni: l'UBE o la Table Conversion si limita a convertire il file nella Z-file, e l'elaboratore standard fa la validazione e la scrittura. Così la regola di business resta a Oracle e il codice personalizzato si occupa solo del tracciato.

È comune nelle interfacce bancarie (in Brasile, i tracciati CNAB di invio e ritorno; in Italia, i flussi CBI) e nei file fiscali o di partner che non usano l'EDI.

Architettura minima e consigliata

Competenze necessarie

Quando è utile

• Flussi di pagamento e incasso, ritorni bancari ed estratti conto.
• File per le autorità fiscali o per sistemi terzi con tracciato fisso.
• Clienti e fornitori che scambiano fogli CSV invece dell'EDI.
• Esportazioni verso sistemi legacy che leggono solo file.

Esempi

// illustrativo: logica di un UBE che legge il file di ritorno bancario
Per ogni riga del file
   Se tipo record = "3" e segmento = "T"
      estrarre riferimento bancario, importo pagato e data di accredito
      trovare la fattura aperta (F03B11)
      chiamare la business function di incasso
      Se errore: scrivere la riga nella tabella degli scarti
Fine
stampare il riepilogo: righe lette, incassate, scartate, totale

In uscita, un UBE pianificato genera ogni giorno lavorativo il file dei pagamenti approvati, che l'MFT invia alla banca già cifrato.

Business function (BSFN in C o NER)

Direzione

Soprattutto ingresso

Latenza

Dipende da chi chiama

Protocollo

Chiamata interna di JDE

Posizione di Oracle

Mattone di base

Spiegazione concettuale e tecnica

Le business function si possono scrivere in C o in NER (Named Event Rules, che JDE converte in C). Le master business function incapsulano un'intera transazione e seguono un ciclo: BeginDoc valida la testata e apre la cache, EditLine valida ogni riga, EditDoc controlla il documento ed EndDoc ottiene i next number e scrive tutto. Per gli ordini di vendita la famiglia è F4211FSBeginDoc, F4211FSEditLine, F4211FSEditDoc e F4211FSEndDoc. ^{[21] [22]}

Fino all'EndDoc i dati restano nella cache di JDE, il che permette di validare l'intero documento prima di scrivere. L'articolo La cache in JD Edwards spiega questo meccanismo nel dettaglio. ^[20]

Di norma le BSFN vengono avviate da un UBE, dal BSSV o dall'Orchestrator, e non chiamate isolatamente da un sistema esterno: hanno bisogno di un contesto di esecuzione di JDE (utente, ambiente, transazione), fornito dal programma ospite.

Architettura minima e consigliata

Competenze necessarie

Quando è utile

• Dentro un UBE personalizzato che legge un file e deve scrivere una transazione.
• In un passo di orchestrazione quando il form request non è adatto, per prestazioni o per una videata complessa.
• Nell'implementazione dei business service.

Esempi

// illustrativo: creazione di un ordine di vendita in un UBE
F4211FSBeginDoc   (modalità = aggiungi, versione P4210 = "ZJDE0001", cliente, filiale) → job number
Per ogni riga
   F4211FSEditLine (job number, articolo, quantità, prezzo)
F4211FSEditDoc    (job number)
F4211FSEndDoc     (job number) → numero d'ordine registrato
Se un passo fallisce: F4211ClearWorkFiles e registrare l'errore

EDI

Direzione

Ingresso e uscita

Latenza

Batch, a cicli brevi

Protocollo

X12 o EDIFACT tramite traduttore

Posizione di Oracle

Standard per il B2B

Spiegazione concettuale e tecnica

Il modulo Data Interface for Electronic Data Interchange (sistema 47) è l'interfaccia tra i dati di JDE e il software di traduzione. ^[17] Il traduttore, esterno a JDE, converte i messaggi standard (X12, EDIFACT) in file piatti e viceversa; JDE legge e scrive le tabelle F47xxx.

Per un ordine del cliente in ingresso (850), il traduttore scrive la testata nella F47011 e le righe nella F47012; l'R47011 legge queste tabelle, le valida e crea l'ordine di vendita nelle F4201 e F4211. ^[18] Poiché le F47 sono un'area di sosta, i dati si possono ispezionare e correggere prima che diventino un ordine reale. In uscita, l'R47042 estrae le fatture nelle tabelle di uscita (F47046 e F47047), che il traduttore converte in 810.

L'EDI è indicato per lo scambio di documenti standardizzati con clienti e fornitori, di solito insieme a un traduttore EDI e a un canale di comunicazione (VAN o AS2).

Architettura minima e consigliata

Competenze necessarie

Quando è utile

• Grande distribuzione, automotive e grandi clienti che richiedono l'EDI.
• Alti volumi di ordini, avvisi di spedizione e fatture con lo stesso partner.
• Quando lo standard del documento è imposto dal partner e non è negoziabile.

Esempi

ISA*00*…~                            (busta)
ST*850*0001~
BEG*00*SA*PO4500123**20260928~     ordine del cliente → F47011
PO1*1*10*EA*12.50**BP*ITEM220~    riga → F47012
CTT*1~
SE*5*0001~
poi: l'R47011 crea l'ordine di vendita; il traduttore restituisce il 997 al cliente

Connettori legacy

Direzione

Ingresso e uscita

Latenza

Tempo reale

Protocollo

JDENET, XML, Java, COM

Posizione di Oracle

Non per progetti nuovi

Spiegazione concettuale e tecnica

I connettori legacy comprendono: ^{[16] [15]}

• XML CallObject, XMLList, XMLTrans e XML Dispatch: documenti XML inviati all'Enterprise Server per chiamare business function, leggere elenchi o scrivere transazioni.
• Dynamic Java Connector: applicazioni Java chiamano business function in modo dinamico, con librerie di JDE sul lato client.
• COM Connector: integrazione con Visual Basic e VC++ tramite il modello COM di Microsoft.
• XPI: integrazione con generazioni precedenti dell'Oracle Fusion Middleware.

Esistono ancora negli ambienti datati, ma non sono consigliati per i progetti nuovi: legano il client al protocollo interno JDENET e alle librerie di uno specifico Tools Release, mancano dei meccanismi di sicurezza attuali e sono difficili da monitorare.

Architettura minima e consigliata

Competenze necessarie

Java, COM o XML, a seconda del connettore; il protocollo JDENET; le business function chiamate. Per la migrazione: Orchestrator e progettazione di API REST.

Quando è utile

Solo per mantenere le integrazioni esistenti finché la migrazione non avviene. Ogni chiamata censita di solito diventa un'orchestrazione con lo stesso contratto di business.

Esempi

<!-- illustrativo: XML CallObject; notate la password in chiaro nel documento -->
<jdeRequest type="callmethod" user="INTEGRA" pwd="********" environment="PD920">
  <callMethod name="GetEffectiveAddress" app="Integrazione">
    <params> <param name="mnAddressNumber">4242</param> </params>
  </callMethod>
</jdeRequest>

Accesso diretto al database (SQL)

Direzione

Lettura

Latenza

Immediata

Protocollo

SQL / JDBC / ODBC

Posizione

Leggere sì, scrivere no

Spiegazione concettuale e tecnica

Scrivere direttamente nel database è tecnicamente possibile, ma è sconsigliato. Un INSERT o un UPDATE salta tutto ciò che fa l'applicazione: validazioni sul dizionario dati e sulle UDC, next number (F0002), tabelle correlate (impegni di magazzino nella F41021, saldi contabili nella F0902), campi di audit (utente, programma, data e ora), workflow e sicurezza di JDE. Il risultato tipico sono saldi che non quadrano, numeri duplicati e record orfani. L'eccezione è la Z-file stessa, progettata per ricevere dati dall'esterno.

In lettura (report, BI, viste) è accettabile, purché si rispettino le convenzioni di JDE:

• Date giuliane nel formato CYYDDD: 126271 è il giorno 271 del 2026, il 28/09/2026.
• Decimali impliciti: i valori sono salvati come interi, con i decimali definiti nel dizionario dati o dalla valuta. ^[25]
• UDC: i codici vanno tradotti tramite la F0005.
• Campi allineati: la business unit (MCU) ha 12 posizioni allineate a destra.
• La sicurezza per riga e per colonna di JDE non si applica a chi legge il database.

Architettura minima e consigliata

Competenze necessarie

SQL, modello dati di JDE (tabelle, business view, dizionario dati), date giuliane, decimali impliciti e UDC; lato DBA, repliche e permessi. Per la reportistica dentro JDE, One View Reporting è un'alternativa che rispetta la sicurezza del sistema. ^[26]

Quando è utile

• Data warehouse, data lake e cruscotti di BI.
• Interrogazioni analitiche pesanti che non devono girare dentro JDE.
• Verifiche e audit puntuali.

Esempi

-- Oracle Database: righe d'ordine con la data convertita
SELECT SDDOCO AS ordine,
       SDDCTO AS tipo,
       TRIM(SDLITM) AS articolo,
       TO_DATE(TO_CHAR(SDTRDJ + 1900000), 'YYYYDDD') AS data_ordine,
       SDAEXP / 100 AS importo   -- 2 decimali impliciti, secondo la valuta
FROM   PRODDTA.F4211
WHERE  SDNXTR < '999';              -- righe non ancora chiuse

Confronto, sicurezza e governance

Sicurezza in tutte le opzioni

• Identità: un utente di servizio per integrazione, senza accesso interattivo e con ruolo minimo nel Security Workbench; credenziali in un vault, mai in script o XML. ^[27]
• Trasporto: TLS ovunque (AIS, BSSV, Transaction Server, SFTP, AS2); JDENET resta nella rete dei server.
• Perimetro: API gateway o reverse proxy, WAF, limiti di richieste e lista delle origini ammesse; server di JDE in una zona interna.
• Dati: il minimo di dati personali in Z-file e file, purge periodico, cifratura dei file a riposo e mascheramento nelle repliche, in linea con il GDPR.
• Audit: campi di audit di JDE valorizzati con l'utente dell'integrazione, log correlati e traccia di chi ha approvato ogni orchestrazione.

Governance

• Catalogo delle interfacce: responsabile di business, responsabile tecnico, metodo, volume, SLA e procedura di errore di ogni integrazione.
• Coda degli errori con un responsabile: Work Center, scarti degli UBE e code dei messaggi non consegnati richiedono qualcuno che li guardi ogni giorno.
• Regressione: ogni aggiornamento di Tools, ESU o versione può cambiare una regola; le integrazioni fanno parte del piano di test.
• Costo totale: oltre a licenze e server, contate le persone che gestiscono e correggono le interfacce.

Riepilogo

Per integrazioni nuove e in tempo reale, usate l'Orchestrator/AIS. Per grandi volumi in batch, le Z-file con gli elaboratori standard sono la strada più sicura. Per avvisare i sistemi esterni degli eventi, usate gli RTE o le notifiche dell'Orchestrator.

Ripasso veloce

Riferimenti

1. Oracle, “JD Edwards EnterpriseOne Tools Orchestrator Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eotos/orchestrator-guide.pdf.
2. Oracle, “Understanding the Orchestrator Studio and Orchestrations”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eotos/understanding-the-orchestrator-studio-and-orchestrations.html.
3. Oracle, “JD Edwards EnterpriseOne Tools Application Interface Services Server Reference Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoiis/application-interface-services-server-reference-guide.pdf.
4. Oracle, “JD Edwards EnterpriseOne Tools System Overview Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eoihs/system-overview-guide.pdf.
5. Oracle, “Orchestrator and Notification Enhancements, Learn JD Edwards EnterpriseOne”, consultato il 28/09/2026, docs.oracle.com/cd/E84502_01/learnjde/orchestrator-enhancements.html.
6. Oracle, “REST API for JD Edwards EnterpriseOne AIS Server: Start All Scheduled Notifications and Orchestrations v2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/rest-api/op-v2-scheduler-start-post.html.
7. Oracle, “JD Edwards EnterpriseOne Applications Interoperability Fundamentals Implementation Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoaai/interoperability-fundamentals-implementation-guide.pdf.
8. Oracle, “Structuring Interface Tables, Interoperability Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/structuring-interface-tables.html.
9. Oracle, “Outbound Transactions, Interoperability Fundamentals”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eoaai/outbound-transactions-2.html.
10. Oracle, “JD Edwards EnterpriseOne Tools Business Services Development Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotde/toc.htm.
11. Oracle, “Introduction to JD Edwards EnterpriseOne Business Services”, consultato il 28/09/2026, docs.oracle.com/cd/E16582_01/doc.91/e38040/intro_to_bssvs.htm.
12. Oracle, “Overview of Transaction Server, System Overview Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/cross-product/9.2/eoihs/overview-of-transaction-server.html.
13. Oracle, “Events, Interoperability Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/events.html.
14. Oracle, “E1: OUTBND: Getting Started with Transaction Server (Doc ID 1156395.1)”, My Oracle Support, richiede login, support.oracle.com/knowledge/JD%20Edwards%20EnterpriseOne/1156395_1.html.
15. Oracle, “JD Edwards EnterpriseOne Tools Interoperability Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotin/interoperability-guide.pdf.
16. Oracle, “JD Edwards EnterpriseOne Tools Connectors Overview”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/eotcn/jd-edwards-enterpriseone-tools-connectors-overview.html.
17. Oracle, “JD Edwards EnterpriseOne Applications Data Interface for Electronic Data Interchange Implementation Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/supply-chain-manufacturing/9.2/eoadi/data-interface-for-electronic-data-interchange-implementation-guide.pdf.
18. Oracle, “E1: 47: EDI 850 Inbound Purchase Orders (850/ORDERS) FAQ (Doc ID 1595999.1)”, My Oracle Support, richiede login, support.oracle.com/knowledge/JD%20Edwards%20EnterpriseOne/1595999_1.html.
19. Oracle, “JD Edwards EnterpriseOne Interoperability 9.2.x, indice delle guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/interoperability/9.2.x/guides.html.
20. Giovani Perotto Mesquita, “La cache in JD Edwards”, JDECache.html.
21. Oracle, “JD Edwards EnterpriseOne Tools APIs and Business Functions Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotbf/apis-and-business-functions-guide.pdf.
22. Oracle, “Business Function Event Rules, APIs and Business Functions Guide”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotbf/business-function-event-rules.html.
23. Oracle, “JD Edwards EnterpriseOne Tools Table Conversion Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eottc/table-conversion-guide.pdf.
24. Oracle, “JD Edwards EnterpriseOne Tools Report Design Aid Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/reporting-analytics/9.2.x/eotrd/report-design-aid-guide.pdf.
25. Oracle, “JD Edwards EnterpriseOne Tools Data Dictionary Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/development-tools/9.2.x/eotdd/data-dictionary-guide.pdf.
26. Oracle, “JD Edwards EnterpriseOne Applications One View Reporting User Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/reporting-analytics/9.2.x/eoaov/one-view-reporting-user-guide.pdf.
27. Oracle, “JD Edwards EnterpriseOne Tools Security Administration Guide 9.2”, consultato il 28/09/2026, docs.oracle.com/en/applications/jd-edwards/administration/9.2.x/eotsc/security-administration-guide.pdf.