Criar uma Pasta ou um Documento no Oracle Content and Experience Cloud Usando o Processo no Oracle Integration Cloud

Use o evento Início do Documento para modelar um processo que pode ser iniciado por um documento. Use o evento Início da Pasta para modelar um processo que pode ser iniciado por uma pasta.

Para poder criar um desses processos, você deve ter uma conta do Oracle Content Management e deve configurar uma conexão entre esse serviço e o Oracle Integration.

Ao ativar a integração do Oracle Content Management, você pode definir pastas que serão criadas automaticamente no Oracle Content Management para cada instância do processo, fornecendo uma organização predefinida dos documentos envolvidos. Você também pode substituir o tipo de acesso no nível da tarefa para definir as permissões corretas para a pasta ou documento de uma tarefa específica, com base nas suas necessidades de negócios. Por exemplo, você pode impedir que os usuários exibam um documento classificado ou uma pasta associada a uma tarefa.

Observe estes requisitos de acesso para uma integração bem-sucedida:

• Para poder iniciar um processo, 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 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 acessá-la 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 para 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.

Para criar um processo que possa ser iniciado por um documento ou pasta:

• Defina o Documento de Entrada ou a Pasta de Entrada no Oracle Integration.

• Modele um processo que tenha um evento inicial de documento ou um evento inicial de pasta.

• Personalize sua implementação para mapear o evento inicial com o documento ou pasta de entrada correspondente que você criou. As opções de implementação permitem definir como o documento ou a pasta será exposta aos usuários.

• Opcionalmente, modifique qual função pode acessar o documento ou a pasta no nível da tarefa.

• Configure a pasta no Oracle Content Management para iniciar um processo quando um documento chegar.

Como alternativa, você pode usar a API REST e fornecer todos os valores de entrada.

Definir o Documento ou a Pasta de Entrada

Você pode usar a página Documentos no Oracle Integration (Process Builder) para definir um documento ou pasta de entrada.

Abra o aplicativo de processo que você está modelando e clique em Documentos. A página Documentos lista os documentos de entrada e as pastas de entrada que já foram definidas.

Para criar um novo documento ou pasta de entrada, clique em Novo , selecione o tipo apropriado, informe um nome e selecione a permissão de acesso padrão.

Processos de Modelo que Podem ser Iniciados de Eventos Iniciais de Documento ou Pasta

Você pode modelar um processo no Oracle Integration que pode ser iniciado a partir de um início de documento ou de um evento de início de pasta.

Antes de começar, adicione o evento de início do documento ou da pasta na paleta Elementos. Somente o primeiro evento inicial adicionado a um processo será suportado.

1. Na guia Home do Aplicativo, clique em Processos.
2. Clique em Novo processo para abrir a caixa de diálogo Criar Processo.
3. Selecione Nenhum
4. Informe um nome para o processo, certifique-se de que a caixa de seleção Abrir Imediatamente esteja marcada e clique em Criar.
5. Na Paleta de Elementos, clique em Eventos.
6. Arraste o evento Início do Documento ou o evento Início da Pasta para a tela.
7. Adicione um fluxo de sequência do novo evento de início de documento ou pasta ao evento final.
8. Excluir o evento de início vazio
9. Continue a modificar e definir o processo. Certifique-se de testá-lo e implantá-lo.

Ativar Funções do Usuário para Iniciar um Processo Iniciado por Documento ou Pasta

Você pode ativar determinadas funções de usuário para iniciar um processo iniciado por documento ou pasta no Oracle Integration.

Para permitir que uma função de usuário faça upload de um documento para iniciar um processo:

1. Abra o processo.
2. No painel de nado com o evento de início do documento ou da pasta, clique no nome da atribuição e, em seguida, clique em Editar .
3. No campo Função, selecione Handler Automático.

Personalizar um Processo Iniciado por Documento ou Pasta

Depois de modelar um processo no Oracle Integration, você pode adicionar um documento ou pasta inicial em um processo e personalizá-lo.

Para personalizar um processo iniciado por documento ou iniciado por pasta:

1. No diagrama do processo, clique no evento Início do Documento ou Início da Pasta.
2. Clique em Menu e selecione Abrir Propriedades.
3. Defina como deseja tratar o documento ou a pasta de entrada.

   • Em Local: A seleção desse valor mantém o local do documento como ele está. Se desejar, você pode mapear o documento ou pasta de entrada para um dos documentos ou pastas predefinidos para seu gerenciamento. (Para fazer isso, abra a lista suspensa.)

     Se não houver um documento ou pasta de entrada predefinido adequado para este processo específico, clique em Novo para criar um.

   • Não Gerenciado: O documento ou pasta é ignorado pelo processo atual. O Oracle Integration Cloud não mostrará um documento ou pasta não gerenciado no runtime. Cabe ao modelador do processo tratar o documento ou a pasta de entrada. Por exemplo, se quiser mover a pasta ou o documento de entrada para outro local, você poderá usar uma expressão XPath para obter propriedades, como Id ou Type, e passar as informações da propriedade para um serviço REST.

Configurar uma Pasta

Para definir um processo para iniciar automaticamente quando um documento é carregado em uma pasta, você precisa configurar a pasta no Oracle Content Management.

Para configurar a pasta para iniciar um processo quando um documento chegar:

1. Efetue sign-in no Oracle Content Management.
2. Selecione a pasta.
3. Selecione Propriedades na barra de menus.
4. Ative a configuração Iniciar processo na chegada do documento.
5. Selecione o processo na lista.
6. Clique em Salvar.

A pasta e suas subpastas agora estarão disponíveis para uso na interface do Oracle Integration. Qualquer alteração feita em um arquivo na pasta ou em qualquer novo arquivo carregado na pasta aciona o processo associado à pasta. É possível substituir o processo herdado de uma subpasta, mas você não pode desativar a associação a um processo.

Quando um arquivo é carregado do Oracle Content Management em uma pasta configurada para uso com o Oracle Integration, o arquivo é usado para a tarefa associada a essa pasta. Os usuários no Oracle Integration podem executar qualquer ação nos arquivos, como aprovações. Quando uma etapa de tarefa é concluída, o arquivo pode ser movido ou gerenciado de acordo com o processo definido.

Quando o Oracle Content Management inicia um processo, o payload enviado para iniciar o processo inclui estas informações:

• ID do Documento

• Nome do documento

• ID do usuário que iniciou o processo

• Tipo

• Função (indica a atribuição que deve ser usada para gerar links subsequentes do aplicativo)

• Versão

O exemplo a seguir usa somente o ID do documento e o nome do documento para exibição no formulário no Oracle Integration. Além disso, ele usa o ID do documento quando faz chamadas de API REST para mover ou copiar o arquivo no Oracle Content Management para a pasta de tarefas.

{
   "processDefId":"testing~UserFileApproval!1.0~FormApprovalProcess",
   "operation": "startEvent",
   "params": {
        "id": "D2806600E495B744E66BF3981212FF6185DE89BE6812",
        "type": "d",
        "name": "document-name",
        "startedBy": "user-id",
        "role": "role that should be used to generate subsequent applinks",
        "version": "version"
   }
}

Como desenvolvedor, você deve estar ciente dos seguintes requisitos para o processo desenvolvido:

• O processo deve usar um evento Iniciar do Oracle Content Management.

• Ao implantar o processo, você precisa compartilhá-lo com o usuário especificado para ativar a integração. Caso contrário, o usuário não terá os direitos para 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.

• Se você ativar a integração do processo para uma pasta, será necessário compartilhar essa pasta com a conta do usuário do Oracle Content Management que foi usada para ativar a integração no Oracle Integration.