Configurar Integração do Processo entre o Oracle Integration e o Oracle Content Management
Para que você ou qualquer usuário possa acessar os recursos de documento e conversa, um administrador deve configurar definições no Oracle Content Management e no Oracle Integration.
Somente um usuário com privilégios de administrador pode estabelecer uma conexão entre os dois serviços.
Para aplicativos de Processo que foram criados antes da configuração da conexão com o Oracle Content Management, os recursos de documento e conversas são desativados por padrão. Os desenvolvedores podem ativar manualmente esses recursos em seus aplicativos existentes.
Requisitos de acesso para uma integração bem-sucedida
Observe estes requisitos de acesso para uma integração bem-sucedida:
-
O usuário do Oracle Content Management configurado no Oracle Integration deve ter acesso total à pasta (ou seja, a pasta do documento de entrada) configurada no Oracle Content Management para poder iniciar um processo.
-
Para um processo iniciado pela pasta (ou seja, um processo com um evento Início da Pasta), o usuário do Oracle Content Management configurado no Oracle Integration deve ter acesso do gerente à pasta para acessar sua pasta no Oracle Integration. Por exemplo, o acesso do gerente é necessário para ver a pasta na página Detalhes da Tarefa e na página Rastreamento do Processo, para acessar a pasta ao incorporar componentes da IU do Processo em um aplicativo externo ou ver a pasta no aplicativo Process Mobile.
-
Para ver um processo na lista de processos de uma pasta e poder iniciar uma instância do processo quando um novo documento chegar, o usuário do Oracle Integration configurado no Oracle Content Management deverá receber a atribuição de iniciador do processo.
Usar Documentos ou Anexos em um Aplicativo de Processo
O Oracle Integration inclui automaticamente a funcionalidade padrão de anexo de arquivos em seus aplicativos de processo. É possível carregar arquivos e anexá-los a um processo. Ao usar o Oracle Content Management com o Oracle Integration, você também obtém a funcionalidade documentos, que permite fazer upload de arquivos, organizar arquivos em pastas, gerenciar o acesso a cada pasta e até mesmo iniciar um processo fazendo upload de um documento. Além disso, cada aplicativo de processo tem a opção de usar documentos ou anexos.
Você controla se um processo usa documentos ou anexos no nível do aplicativo. Os documentos são ativados por padrão. A configuração está no painel Informações do aplicativo.
Descrição da ilustração enable-docs-app-level-cb.png
Um aplicativo que tem a Integração de Documentos ativada pode usar documentos (e somente documentos). Um aplicativo que tem Integração de Documentos desativado pode usar apenas anexos. Basicamente, desativando documentos para um aplicativo, você ativa anexos para esse aplicativo.
Lembre-se de que a configuração se aplica ao aplicativo. Você pode usar documentos ou anexos em um aplicativo, mas não ambos.
Para anexos, certifique-se de que a opção Ocultar Anexos esteja desmarcada na tela Personalização da IU. Se a opção Ocultar Anexos estiver selecionada, você não poderá ver anexos nos detalhes da tarefa e nos formulários iniciais.
Se você usar APIs REST para interagir com o Oracle Integration, certifique-se de usar a API apropriada, dependendo de seu aplicativo de processo usar documentos ou anexos:
-
Para documentos, certifique-se de usar as APIs REST /folders.
-
Para anexos, certifique-se de usar as APIs REST /anexos.
Se você usar a API errada, o aplicativo retornará uma mensagem de erro ou terminará em nenhuma operação.
Observe que se você não conseguir ver anexos nos detalhes da tarefa, verifique as opções na tela Personalização da IU. Certifique-se de que a caixa de seleção Ocultar Anexos esteja desmarcada para ver os anexos.
Configurar Definições do Oracle Integration no Oracle Content Management
Ative o Oracle Integration para documentos no Oracle Content Management.
- Acesse o Oracle Content Management como administrador.
- No menu Administração, escolha Integrações.
- Em Aplicativos, selecione Oracle Integration para ativar o serviço e, em seguida, defina estes valores:
- URL de Serviço: o URL do serviço REST que os usuários podem acessar em seus aplicativos, terminando com bpm/api/4.0/processes (por exemplo, https://servicename/bpm/api/4.0/processes).
- Usuário do Serviço: Digite o endereço de e-mail do usuário proprietário do processo a ser usado no Oracle Content Management.
- Senha do Serviço: Digite a senha do usuário.
Quando uma etapa de tarefa é concluída, o arquivo pode ser gerenciado de acordo com o processo definido. Para um documento de entrada, um usuário pode executar ações com base na função atribuída para esse documento: Colaborador, Downloader ou Visualizador.
Quando o Oracle Content Management inicia um processo, o seguinte payload é enviado para iniciar o processo:
{
"operation":"startEvent",
"processDefId":"testing~LoanApplicationProcessing!1.0~LoanApplicationProcessing"
"params": {
"id": "abc123",
"name": "document name",
"startedBy": "user id",
"type": "d",
"role": "role that should be used to generate subsequent applinks",
"version": "version"
}
}Como desenvolvedor, você precisa estar ciente dos seguintes requisitos para o processo desenvolvido:
- Ele precisa ser um processo que use um evento Início de Documento do Oracle Content Management.
- Ao implantar o processo, você precisa compartilhá-lo com o usuário especificado para ativar a integração para que o usuário tenha os direitos de acionar o processo,
- Para o usuário que fez upload do arquivo para mostrar como o usuário que iniciou a tarefa, o processo deve usar o valor passado no campo startedby como o nome de exibição do iniciador.
Configurar Definições de Documentos no Oracle Integration
Como administrador, você também deve configurar a conexão entre o Oracle Integration e o Oracle Content Management. É necessário especificar informações como o URL e as credenciais de acesso para o Oracle Content Management.