Show Menu
TÓPICOS×

Working with AEM Forms Repository

Sobre o Serviço de Repositório
O serviço Repositório fornece serviços de gerenciamento e armazenamento de recursos para o AEM Forms. Quando os desenvolvedores criam um aplicativo do AEM Forms , eles podem implantar os ativos no repositório em vez do sistema de arquivos. Os ativos podem incluir qualquer tipo de material de apoio, incluindo formulários XML, formulários PDF (incluindo formulários Acrobat), fragmentos de formulário, imagens, perfis, políticas, arquivos SWF, arquivos DX, esquemas XML, arquivos WSDL e dados de teste.
Por exemplo, considere o seguinte aplicativo de formulários chamado Applications/FormsApplication :
Observe que há um arquivo chamado Loan.xdp localizado em FormsFolder. Para acessar esse design de formulário, especifique o caminho completo (incluindo a versão): Applications/FormsApplication/1.0/FormsFolder/Loan.xdp .
Para obter informações sobre como criar um aplicativo de Forms usando o Workbench, consulte Ajuda do Workbench.
O caminho para um recurso localizado no repositório do AEM Forms é:
Applications/Application-name/Application-version/Folder.../Filename
Os valores a seguir mostram alguns exemplos de valores de URI:
  • Applications/AppraisalReport/1.0/Forms/FullForm.xdp
  • Applications/AnotherApp/1.1/Assets/picture.jpg
  • Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd
Você pode navegar pelo AEM Forms Repository usando um navegador da Web. Para navegar pelo repositório, insira o seguinte URL em um navegador da Web https://[server name]:[server port]/repository . Você pode verificar os resultados de início rápido associados à seção Trabalhar com o repositório de formulários do AEM usando um navegador da Web. Por exemplo, se você adicionar conteúdo ao AEM Forms Repository, poderá ver o conteúdo em um navegador da Web. (Consulte Início rápido (modo SOAP): Gravando um recurso usando a API Java.)
A API do repositório fornece várias operações que podem ser usadas para armazenar e recuperar informações do repositório. Por exemplo, você pode obter uma lista de recursos ou recuperar recursos específicos armazenados no repositório quando um recurso é necessário como parte do processamento de um aplicativo.
A API do repositório não pode ser usada para interagir com o Content Services (obsoleto). Para interagir com o Content Services (obsoleto), use a API de gerenciamento de documentos.
Usando a API de serviço do Repositório, você pode realizar as seguintes tarefas:
Usando a API do repositório, não é possível gerenciar o controle de acesso a recursos, procurar recursos ou especificar relacionamentos de recursos usando um repositório ECM.
Quando um PDF criptografado é gravado no repositório, o recurso de extração de relacionamento automatizado não pode ser usado. Caso contrário, um PDF criptografado pode ser armazenado no repositório e recuperado posteriormente. O recuperador pode optar por descriptografar o PDF após ele ser recuperado do repositório.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Criação de pastas

As pastas (coleções de recursos) são usadas para armazenar objetos (arquivos ou recursos) em agrupamentos organizados. As pastas podem conter recursos e outras pastas, também conhecidas como subpastas. Os recursos só podem ser armazenados em uma pasta por vez.
Os arquivos herdam ACLs (Access Control Lists, listas de controle de acesso) de pastas e subpastas herdam ACLs de suas pastas pai. Portanto, as pastas pai devem existir para que você possa criar pastas secundárias. O IDE permite que você interaja somente com base em pasta por pasta, e não com base em arquivo por arquivo. Não é possível fazer a versão de pastas e não há necessidade de fazê-lo; uma pasta não contém os dados propriamente ditos. Em vez disso, é apenas um contêiner para recursos que contêm dados. A ACL padrão é uma permissão no nível do sistema, o que significa que os usuários devem ter permissões no nível do sistema (ler, gravar, navegar, gerenciar ACLs) até que alguém lhes conceda permissões para uma pasta específica. As ACLs funcionam somente no IDE.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para criar uma pasta, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Crie o cliente de serviço.
  3. Crie a pasta.
  4. Grave a pasta no repositório.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de criar programaticamente uma coleção de recursos, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Criar a pasta
Chame o método do serviço Repositório para criar a coleção de recursos e preencher a coleção de recursos com informações de identificação, incluindo UUID, nome da pasta e descrição.
Gravar a pasta no repositório
Chame o método do serviço Repositório para gravar a coleção de recursos, especificando o URI da pasta de destino.
Consulte também:

Criar pastas usando a API Java

Crie uma pasta usando a API de serviço do Repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos de projeto no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Criar a pasta
    Para criar uma coleção de recursos, primeiro crie um com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean objeto.
    Chame o repositoryInfomodelFactoryBean método do newResourceCollection objeto e passe os seguintes parâmetros:
    • Um identificador com.adobe.repository.infomodel.Id UUID a ser atribuído ao recurso.
    • Um identificador com.adobe.repository.infomodel.Lid UUID a ser atribuído ao recurso.
    • Um java.lang.String que contém o nome da coleção de recursos. Por exemplo, FormsFolder . O método retorna um com.adobe.repository.infomodel.bean.ResourceCollection objeto que representa a nova pasta.
    Defina a descrição da pasta usando o setDescription método e passe o seguinte parâmetro:
    • Uma String que descreve a coleção de recursos. Neste exemplo, "test Folder" é usado .
  4. Gravar a pasta no repositório
    Chame o ResourceRepositoryClient método do objeto e passe o URI da pasta e do writeResource ResourceCollection objeto. Por exemplo, o URI para a pasta pode ser o seguinte valor /Applications/FormsApplication/1.0/ .
    O método retorna uma instância do com.adobe.repository.infomodel.bean.Resource objeto recém-criado. Você pode, por exemplo, recuperar o valor identificador do novo recurso chamando o método do com.adobe.repository.infomodel.bean.Resource objeto getId .
Consulte também:

Criar pastas usando a API de serviço da Web

Crie uma pasta usando a API de serviço do Repositório (serviço da Web):
  1. Incluir arquivos de projeto
    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Repositório usando base64.
    • Consulte o assembly do cliente Microsoft .NET.
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Criar a pasta
    Crie a pasta usando o construtor padrão para a ResourceCollection classe e passe os seguintes parâmetros:
    • Um Id objeto, que é criado chamando o construtor padrão para a Id classe e atribuído ao Resource campo do id objeto.
    • Um Lid objeto, que é criado chamando o construtor padrão para a Lid classe e atribuído ao Resource campo do lid objeto.
    • Uma string contendo o nome da coleção de recursos, que é atribuída ao campo do Resource objeto name . O nome usado neste exemplo é "testfolder" .
    • Uma string que contém a descrição da coleção de recursos, que é atribuída ao campo do Resource objeto description . A descrição usada neste exemplo é "test folder" .
  4. Gravar a pasta no repositório
    Chame o RepositoryServiceService método do writeResource objeto e passe os seguintes parâmetros:
    • O caminho onde a pasta será criada.
    • O ResourceCollection objeto que representa a pasta.
    • Passe null pelos outros dois parâmetros.
Consulte também:

Gravando recursos

Você pode criar recursos em um determinado local no repositório. O tamanho natural do arquivo está sujeito às limitações do banco de dados e ao tempo limite da sessão. Para a configuração padrão, os arquivos estão limitados a 25 MB. Para aumentar ou diminuir o tamanho máximo do arquivo, é necessário alterar a configuração do banco de dados.
Gravar recursos equivale a armazenar dados no repositório. Quando você grava um recurso no repositório, ele se torna acessível a todos os clientes no ecossistema do repositório. Quando você grava recursos, como esquemas XML, arquivos XDP e arquivos XSD, no repositório, o conteúdo é analisado com base no tipo MIME. Se o tipo MIME for suportado, o analisador determinará se há uma relação implícita com outro conteúdo. Por exemplo, se uma folha de estilos em cascata (CSS) tiver um URL relativo que faz referência a um CSS comum, espera-se que você envie o CSS comum também para o repositório. A relação entre os dois recursos é armazenada como uma relação pendente por um período não ajustável de 30 dias. Quando você envia o CSS comum para o repositório dentro do período de 30 dias, a relação é formada.
Quando você cria um recurso, a ACL (lista de controle de acesso) é herdada da pasta pai. A pasta raiz tem permissões no nível do sistema até que um recurso ou pasta inicial seja criado, e nesse ponto o recurso ou a pasta recebe permissões de ACL padrão.
Você pode gravar recursos programaticamente usando a API Java do serviço do Repositório ou a API do serviço da Web.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para gravar um recurso, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço do Repositório.
  3. Especifique o URI do recurso a ser lido.
  4. Leia o recurso.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de ler programaticamente um recurso, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Especificar o URI da pasta de destino para o recurso
Crie uma string contendo o URI do recurso a ser lido. A sintaxe inclui barras, como neste exemplo: "/ path / folder ".
Criar o recurso
Chame o método do serviço Repositório para criar o recurso e preencha o recurso com informações de identificação, incluindo sua UUID, nome do recurso e descrição.
Especificar o conteúdo do recurso
Chame o método do serviço Repositório para criar conteúdo de recurso e armazená-lo no recurso.
Gravar o recurso na pasta de destino
Chame o método do serviço Repositório para gravar o recurso, especificando o URI da pasta de destino.
Consulte também:

Gravar recursos usando a API Java

Grave um recurso usando a API de serviço do Repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Especificar o URI da pasta de destino para o recurso
    Especifique o URI da pasta de destino para o recurso. Nesse caso, como o recurso nomeado testResource será armazenado na pasta chamada testFolder , o URI da pasta será "/testFolder" . O URI é armazenado como um java.lang.String objeto.
  4. Criar o recurso
    Para criar um recurso, é necessário primeiro criar um com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean objeto.
    Chame o RepositoryInfomodelFactoryBean método do newResource objeto, que cria um com.adobe.repository.infomodel.bean.Resource objeto. Neste exemplo, os seguintes parâmetros são fornecidos:
    • Um com.adobe.repository.infomodel.Id objeto, que é criado chamando o construtor padrão para a Id classe.
    • Um com.adobe.repository.infomodel.Lid objeto, que é criado chamando o construtor padrão para a Lid classe.
    • Um arquivo java.lang.String que contém o nome do recurso. Para especificar a descrição do recurso, chame o método do Resource objeto setDescription e passe uma string contendo a descrição. Neste exemplo, a descrição é "test resource" .
  5. Especificar o conteúdo do recurso
    Para criar conteúdo para o recurso, chame o RepositoryInfomodelFactoryBean método do objeto, que retorna um newResourceContent com.adobe.repository.infomodel.bean.ResourceContent objeto. Adicione conteúdo ao ResourceContent objeto. Neste exemplo, isso é feito com as seguintes tarefas:
    • Invocar o método do ResourceContent objeto setDataDocument e transmitir um com.adobe.idp.Document objeto
    • Invocar o método do ResourceContent objeto setSize e transmitir o tamanho em bytes do Document objeto Adicione o conteúdo ao recurso, chamando o Resource método do objeto setContent e transmitindo o ResourceContent objeto. Para obter mais informações, consulte Referência da API de formulários AEM.
  6. Gravar o recurso na pasta de destino
    Chame o ResourceRepositoryClient método do objeto e passe o URI da pasta, bem como o writeResource Resource objeto.
Consulte também:

Gravar recursos usando a API de serviço da Web

Grave um recurso usando a API de serviço do Repositório (serviço da Web):
  1. Incluir arquivos de projeto
    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Repositório usando base64.
    • Consulte o assembly do cliente Microsoft .NET.
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Especificar o URI da pasta de destino para o recurso
    Especifique o URI da pasta de destino para o recurso. Nesse caso, como o recurso nomeado testResource será armazenado na pasta chamada testFolder , o URI da pasta será "/testFolder" . Ao usar um idioma compatível com o Microsoft .NET Framework (por exemplo, C#), armazene o URI em um System.String objeto.
  4. Criar o recurso
    Para criar um recurso, chame o construtor padrão para a Resource classe. Neste exemplo, as seguintes informações são armazenadas no Resource objeto:
    • Um com.adobe.repository.infomodel.Id objeto, que é criado chamando o construtor padrão para a Id classe e atribuído ao Resource campo do id objeto.
    • Um com.adobe.repository.infomodel.Lid objeto, que é criado chamando o construtor padrão para a Lid classe e atribuído ao Resource campo do lid objeto.
    • Uma string contendo o nome do arquivo do recurso, que é atribuído ao campo do Resource objeto name . O nome usado neste exemplo é "testResource" .
    • Uma string que contém a descrição do recurso, que é atribuída ao campo do Resource objeto description . A descrição usada neste exemplo é "test resource" .
  5. Especificar o conteúdo do recurso
    Para criar conteúdo para o recurso, chame o construtor padrão para a ResourceContent classe. Em seguida, adicione conteúdo ao ResourceContent objeto. Neste exemplo, isso é feito com as seguintes tarefas:
    • Atribuir um BLOB objeto que contém um documento ao ResourceContent campo do dataDocument objeto.
    • Atribuindo o tamanho em bytes do BLOB objeto ao ResourceContent campo do size objeto. Adicione o conteúdo ao recurso atribuindo o ResourceContent objeto ao campo do Resource objeto content .
  6. Gravar o recurso na pasta de destino
    Chame o RepositoryServiceService método do objeto e passe o URI da pasta, bem como o writeResource Resource objeto. Passe null pelos outros dois parâmetros.
Consulte também:

Listando recursos

Você pode descobrir recursos ao listar recursos. Uma consulta é executada no repositório para localizar todos os recursos relacionados a uma determinada coleção de recursos.
Depois de organizar seus recursos, você pode inspecionar a estrutura que criou ao ver uma ramificação específica da estrutura, como faria em um sistema operacional.
Os recursos de listagem operam por relacionamento: os recursos são membros de pastas. A associação é representada por uma relação do tipo "membro de". Ao listar recursos em uma determinada pasta, você está consultando os recursos relacionados a uma determinada pasta pelo "membro de" da relação. Os relacionamentos são direcionais: um membro de uma relação tem uma fonte que é membro do destino. A fonte é o recurso; o destino é a pasta pai.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para listar recursos, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Crie o cliente de serviço.
  3. Especifique o caminho da pasta.
  4. Recupere a lista de recursos.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de criar programaticamente uma coleção de recursos, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Especificar o caminho da pasta
Crie uma string contendo o caminho da pasta que contém os recursos. A sintaxe inclui barras, como neste exemplo: "/ path / folder ".
Recuperar a lista de recursos
Chame o método do serviço Repositório para recuperar a lista de recursos, especificando o caminho da pasta de destino.
Consulte também:

Listar recursos usando a API Java

Liste os recursos usando a API de serviço do repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Especificar o caminho da pasta
    Especifique o URI da coleção de recursos a ser consultada. Nesse caso, seu URI é "/testFolder" . O URI é armazenado como um java.lang.String objeto.
  4. Recuperar a lista de recursos
    Chame o método do ResourceRepositoryClient objeto listMembers e passe no URI da pasta.
    O método retorna um conjunto java.util.List de com.adobe.repository.infomodel.bean.Resource objetos que são a origem com.adobe.repository.infomodel.bean.Relation de um tipo Relation.TYPE_MEMBER_OF e têm o URI de coleção de recursos como destino. Você pode iterar por isso List para recuperar cada um dos recursos. Neste exemplo, o nome e a descrição de cada recurso são exibidos.
Consulte também:

Listar recursos usando a API de serviço da Web

Liste os recursos usando a API de serviço do Repositório (serviço da Web):
  1. Incluir arquivos de projeto
    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Repositório.
    • Consulte o assembly do cliente Microsoft .NET.
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Especificar o caminho da pasta
    Especifique uma string contendo o URI da pasta a ser consultada. Nesse caso, seu URI é "/testFolder" . Ao usar um idioma compatível com o Microsoft .NET Framework (por exemplo, C#), armazene o URI em um System.String objeto.
  4. Recuperar a lista de recursos
    Chame o método do RepositoryServiceService objeto listMembers e passe o URI da pasta como o primeiro parâmetro. Passe null pelos outros dois parâmetros.
    O método retorna uma matriz de objetos que podem ser convertidos em Resource objetos. É possível iterar pela matriz de objetos para recuperar cada um dos recursos relacionados. Neste exemplo, o nome e a descrição de cada recurso são exibidos.
Consulte também:

Lendo recursos

Você pode recuperar recursos de um determinado local no repositório para ler o conteúdo e os metadados. O fluxo de trabalho é finalizado pela frente por um formulário de inicialização. O processo tem todas as permissões necessárias para ler o formulário. O sistema recupera o formulário de dados e lê o conteúdo do repositório. O repositório concede acesso ao conteúdo e aos metadados (a capacidade de saber se o recurso existe).
O repositório tem os quatro tipos de permissão a seguir:
  • transversal : permite listar recursos; ou seja, para ler metadados de recursos, mas não conteúdo de recursos
  • deve ler -se: permite ler o conteúdo do recurso
  • gravar : permite gravar conteúdo de recurso
  • gerenciamento de ACLs (listas de controle de acesso) : permite manipular ACLs em recursos
Os usuários só podem executar processos quando tiverem permissão para executar o processo. Os usuários do IDE precisam de permissões de leitura e peregrinação para sincronizar com o repositório. As ACLs se aplicam somente no momento do design, pois o tempo de execução ocorre no contexto do sistema.
Você pode ler os recursos de forma programática usando a API Java do serviço do Repositório ou a API do serviço da Web.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para ler um recurso, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço do Repositório.
  3. Especifique o URI do recurso a ser lido.
  4. Leia o recurso.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de ler programaticamente um recurso, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Especificar o URI do recurso a ser lido
Crie uma string contendo o URI do recurso a ser lido. A sintaxe inclui barras, como neste exemplo: "/ path / resource ".
Ler o recurso
Chame o método de serviço Repositório para ler o recurso, especificando o URI.
Consulte também:

Ler recursos usando a API Java

Leia um recurso usando a API de serviço do Repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Especificar o URI do recurso a ser lido
    Especifique um valor de string que represente o URI do recurso a ser recuperado. Por exemplo, supondo que o recurso seja nomeado testResource , que está localizado em uma pasta chamada testFolder , especifique /testFolder/testResource .
  4. Ler o recurso
    Chame o método do ResourceRepositoryClient objeto readResource e passe o URI do recurso como parâmetro. Esse método retorna uma Resource instância que representa o recurso.
Consulte também:

Lendo recursos usando a API de serviço da Web

Leia um recurso usando a API de serviço do Repositório (serviço da Web):
  1. Incluir arquivos de projeto
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Especificar o URI do recurso a ser lido
    Especifique uma string que contenha o URI do recurso a ser recuperado. Nesse caso, como o recurso nomeado testResource está na pasta chamada testFolder , seu URI é "/testFolder/testResource" . Ao usar um idioma compatível com o Microsoft .NET Framework (por exemplo, C#), armazene o URI em um System.String objeto.
  4. Ler o recurso
    Chame o método do RepositoryServiceService objeto readResource e passe o URI do recurso como o primeiro parâmetro. Passe null pelos outros dois parâmetros.
Consulte também:

Atualização de recursos

Você pode recuperar e atualizar o conteúdo dos recursos no repositório. Quando você atualiza recursos, o controle de acesso a esses recursos permanece inalterado entre as versões. Ao executar uma atualização, você tem a opção de aumentar a versão principal. Se você não optar por incrementar a versão principal, a versão secundária será atualizada automaticamente.
Quando você atualiza um recurso, a nova versão é criada com base nos atributos de recurso especificados. Ao atualizar um recurso, você especifica dois parâmetros importantes: o URI de destino e uma instância de recurso que contém todos os metadados atualizados. É importante observar que se você não estiver alterando um determinado atributo (por exemplo, o nome), o atributo ainda será necessário na instância transmitida. As relações criadas ao analisar o conteúdo são adicionadas à versão específica e não são encaminhadas, a menos que especificado.
Por exemplo, se você atualizar um arquivo XDP e ele contiver referências a outros recursos, essas referências adicionais também serão registradas. Suponha que form.xdp versão 1.0 tenha duas referências externas: um logotipo e uma folha de estilos, e você atualiza subsequentemente o form.xdp para que agora tenha três referências: um logotipo, uma folha de estilos e um arquivo de esquema. Durante a atualização, o repositório adicionará a terceira relação (ao arquivo de esquema) à tabela de relação pendente. Quando o arquivo de esquema estiver presente no repositório, a relação será formada automaticamente. Entretanto, se form.xdp versão 2.0 não usar mais o logotipo, form.xdp versão 2.0 não terá uma relação com o logotipo.
Todas as operações de atualização são atômicas e transacionais. Por exemplo, se dois usuários lerem o mesmo recurso e ambos decidirem atualizar a versão 1.0 para a versão 2.0, um deles terá êxito e um deles falhará, a integridade do repositório será mantida e ambos receberão uma mensagem confirmando o sucesso ou a falha. Se a transação não for confirmada, ela será revertida em caso de falha no banco de dados e expirará ou reverterá dependendo do servidor de aplicativos.
Você pode atualizar recursos programaticamente usando a API Java do serviço do Repositório ou a API do serviço da Web.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para atualizar um recurso, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço do Repositório.
  3. Recupere o recurso a ser atualizado.
  4. Atualize o recurso.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de ler programaticamente um recurso, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Recuperar o recurso a ser atualizado
Leia o recurso. Para obter mais informações, consulte Lendo recursos .
Atualizar o recurso
Defina as novas informações no recurso e chame o método do serviço Repositório para atualizar o recurso, especificando o URI, o recurso atualizado e como as informações da versão devem ser atualizadas.
Consulte também:

Atualizar recursos usando a API Java

Atualize um recurso usando a API de serviço do Repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Recuperar o recurso a ser atualizado
    Especifique o URI do recurso para recuperar e ler o recurso. Neste exemplo, o URI do recurso é "/testFolder/testResource" .
  4. Atualizar o recurso
    Atualize as informações do Resource objeto. Neste exemplo, para atualizar a descrição, chame o método do Resource objeto setDescription e passe a nova string de descrição como parâmetro.
    Em seguida, chame o ServiceClientFactory método do updateResource objeto e passe os seguintes parâmetros:
    • Um java.lang.String objeto que contém o URI do recurso.
    • O Resource objeto que contém as informações atualizadas do recurso.
    • Um boolean valor que indica se a versão principal ou secundária deve ser atualizada. Neste exemplo, um valor de true é passado para indicar que a versão principal deve ser aumentada.
Consulte também:

Atualizar recursos usando a API de serviço da Web

Atualize um recurso usando a API do repositório (serviço da Web):
  1. Incluir arquivos de projeto
    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Repositório.
    • Consulte o assembly do cliente Microsoft .NET.
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Recuperar o recurso a ser atualizado
    Especifique o URI do recurso a ser recuperado e leia o recurso. Neste exemplo, o URI do recurso é "/testFolder/testResource" . Para obter mais informações, consulte Lendo recursos .
  4. Atualizar o recurso
    Atualize as informações do Resource objeto. Neste exemplo, para atualizar a descrição, atribua um novo valor ao campo do Resource objeto description .
  5. Chame o RepositoryServiceService método do updateResource objeto e passe os seguintes parâmetros:
    • Um System.String objeto que contém o URI do recurso.
    • O Resource objeto que contém as informações atualizadas do recurso.
    • Um boolean valor que indica se a versão principal ou secundária deve ser atualizada. Neste exemplo, um valor de true é passado para indicar que a versão principal deve ser aumentada.
    • Enviar null para os dois parâmetros restantes.
Consulte também:

Procurando recursos

É possível construir consultas usadas para pesquisar recursos no repositório, incluindo histórico, recursos relacionados e propriedades.
É possível recuperar recursos relacionados para determinar dependências entre um formulário e seus fragmentos. Por exemplo, se você tiver um formulário, poderá determinar quais fragmentos ou recursos externos ele utiliza. Se você tiver uma imagem, também poderá descobrir quais formulários usam a imagem. Também é possível pesquisar recursos relacionados usando a filtragem com base nas propriedades. Por exemplo, é possível pesquisar por todos os formulários que usam uma imagem com um nome especificado ou localizar qualquer imagem usada por um formulário com um nome especificado. Também é possível pesquisar usando propriedades de recursos. Por exemplo, você pode realizar uma consulta para localizar todos os formulários ou recursos cujo nome começa com uma determinada string que pode incluir os curingas "%" e "_". Lembre-se de que as pesquisas baseadas em propriedades não se baseiam em relações; essas pesquisas são baseadas na suposição de que você tem conhecimento específico sobre um determinado recurso.
Declarações de consulta
Uma consulta contém uma ou mais declarações que são logicamente unidas com condições. Uma instrução consiste em um operando esquerdo, um operador e um operando direito. Além disso, você pode especificar a ordem de classificação a ser usada para os resultados da pesquisa. A ordem de classificação contém informações equivalentes a uma ORDER BY cláusula SQL e é composta por elementos que contêm os atributos nos quais a pesquisa se baseou, bem como um valor que indica se a ordem crescente ou decrescente deve ser usada.
Você pode procurar recursos de forma programática usando a API Java do serviço do Repositório. No momento, não é possível usar a API de serviço da Web para procurar recursos.
Comportamento de classificação
A ordem de classificação não é respeitada ao invocar o ResourceRepositoryClient método do objeto searchProperties e especificar uma ordem de classificação. Por exemplo, suponha que você crie um recurso com três propriedades personalizadas, onde os nomes dos atributos são name , secondName e asecondName . Em seguida, você cria um elemento de ordem de classificação no nome do atributo e define o ascending valor como true .
Em seguida, você chama o método do ResourceRepositoryClient objeto searchProperties e passa na ordem de classificação. A pesquisa retorna o recurso certo, com as três propriedades. No entanto, as propriedades não são classificadas pelo nome do atributo. Eles são devolvidos na ordem em que foram adicionados: name , secondName e asecondName .
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para procurar recursos, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço do Repositório.
  3. Especifique a pasta de destino para a pesquisa.
  4. Especifique os atributos usados na pesquisa.
  5. Crie a consulta usada na pesquisa.
  6. Crie a ordem de classificação para os resultados da pesquisa.
  7. Procure os recursos.
  8. Recupere os recursos do resultado da pesquisa.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de ler programaticamente um recurso, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Especificar a pasta de destino para a pesquisa
Crie uma string contendo o caminho base a partir do qual realizar a pesquisa. A sintaxe inclui barras, como neste exemplo: "/ path / folder ".
Especificar os atributos usados na pesquisa
Você pode basear sua pesquisa nos atributos contidos nos recursos. Especifique os valores dos atributos nos quais realizar a pesquisa.
Criar a consulta usada na pesquisa
Construa uma consulta usando declarações e condições. Cada instrução especificará o atributo no qual basear a pesquisa, a condição a ser usada e o valor do atributo a ser usado na pesquisa.
Criar a ordem de classificação para os resultados da pesquisa
A ordem de classificação é composta de elementos, cada um contendo um dos atributos usados na pesquisa e um valor indicando se a ordem crescente ou decrescente deve ser usada.
Procurar recursos
Procure os recursos usando a pasta, consulta e ordem de classificação. Além disso, indique a profundidade da pesquisa e um limite máximo do número de resultados a serem retornados.
Recuperar os recursos do resultado da pesquisa
Iterar pela lista de recursos retornada e extrair as informações para processamento adicional.
Consulte também:

Procurar recursos usando a API Java

Procure um recurso usando a API de serviço do Repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Especificar a pasta de destino para a pesquisa
    Especifique o URI do caminho base a partir do qual a pesquisa será executada. Neste exemplo, o URI do recurso é /testFolder .
  4. Especificar os atributos usados na pesquisa
    Especifique os valores dos atributos nos quais realizar a pesquisa. Os atributos existem dentro de um com.adobe.repository.infomodel.bean.Resource objeto. Neste exemplo, a pesquisa será realizada no atributo name; portanto, é usado um java.lang.String que contém o nome do Resource objeto, que é testResource nesse caso.
  5. Criar a consulta usada na pesquisa
    Para criar uma consulta, crie um com.adobe.repository.query.Query objeto chamando o construtor padrão para a Query classe e adicione instruções à consulta.
    Para criar uma instrução, chame o construtor para a com.adobe.repository.query.Query.Statement classe e passe os seguintes parâmetros:
    • Um operando esquerdo que contém a constante de atributo de recurso. Neste exemplo, como o nome do recurso é usado como a base para a pesquisa, o valor estático Resource.ATTRIBUTE_NAME é usado.
    • Um operador que contém a condição usada na pesquisa pelo atributo. O operador deve ser uma das constantes estáticas na Query.Statement classe. Neste exemplo, o valor estático Query.Statement.OPERATOR_BEGINS_WITH é usado.
    • Um operando direito contendo o valor do atributo no qual realizar a pesquisa. Neste exemplo, o atributo name, um String contendo o valor "testResource" , é usado. Especifique o namespace do operando esquerdo, chamando o método do Query.Statement objeto setNamespace e transmitindo um dos valores estáticos contidos na com.adobe.repository.infomodel.bean.ResourceProperty classe. Neste exemplo, ResourceProperty.RESERVED_NAMESPACE_REPOSITORY é usado.
    Adicione cada instrução à consulta, chamando o Query método do objeto addStatement e transmitindo o Query.Statement objeto.
  6. Criar a ordem de classificação para os resultados da pesquisa
    Para especificar a ordem de classificação usada nos resultados da pesquisa, crie um com.adobe.repository.query.sort.SortOrder objeto chamando o construtor padrão para a SortOrder classe e adicione elementos à ordem de classificação.
    Para criar um elemento para a ordem de classificação, chame um dos construtores para a com.adobe.repository.query.sort.SortOrder.Element classe. Neste exemplo, como o nome do recurso é usado como a base para a pesquisa, o valor estático Resource.ATTRIBUTE_NAME é usado como o primeiro parâmetro e a ordem crescente (um boolean valor de true ) é especificada como o segundo parâmetro.
    Adicione cada elemento à ordem de classificação, invocando o SortOrder método do addSortElement objeto e transmitindo o SortOrder.Element objeto.
  7. Procurar recursos
    Para pesquisar com resources base nas propriedades do atributo, chame o método do ResourceRepositoryClient searchProperties objeto e passe os seguintes parâmetros:
    • Um String que contém o caminho base do qual a pesquisa será executada. Nesse caso, "/testFolder" é usado.
    • A consulta usada na pesquisa.
    • A profundidade da pesquisa. Nesse caso, com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE é usado para indicar que o caminho base e todas as suas pastas devem ser usados.
    • Um int valor que indica a primeira linha a partir da qual selecionar o conjunto de resultados não paginados. Neste exemplo, 0 é especificado.
    • Um int valor que indica o número máximo de resultados a serem retornados. Neste exemplo, 10 é especificado.
    • A ordem de classificação usada na pesquisa. O método retorna um conjunto java.util.List de Resource objetos na ordem de classificação especificada.
  8. Recuperar os recursos do resultado da pesquisa
    Para recuperar os recursos contidos no resultado da pesquisa, repita o processo List e converta cada objeto em um Resource para extrair suas informações. Neste exemplo, o nome de cada recurso é exibido.
Consulte também:

Criando Relações de Recursos

Você pode especificar relações entre recursos no repositório. Existem três tipos de relações:
  • Dependência : um relacionamento no qual um recurso depende de outros recursos, o que significa que todos os recursos relacionados são necessários no repositório.
  • Associação (sistema de arquivos) : uma relação na qual um recurso está localizado em uma determinada pasta.
  • Personalizado : uma relação especificada entre recursos. Por exemplo, se um recurso tiver sido descontinuado e outro recurso tiver sido introduzido no repositório, você poderá especificar sua própria relação de substituição.
Você pode criar seus próprios relacionamentos personalizados. Por exemplo, se você armazenar um arquivo HTML no repositório e ele usar uma imagem, poderá especificar uma relação personalizada para relacionar o arquivo HTML à imagem (já que normalmente somente os arquivos XML são associados a imagens usando uma relação de dependência definida pelo repositório). Outro exemplo de relacionamento personalizado seria se você quisesse criar uma exibição diferente do repositório com uma estrutura de gráfico cíclica em vez de uma estrutura em árvore. Você poderia definir um gráfico circular junto com um visualizador para atravessar essas relações. Por fim, você pode indicar que um recurso substitui outro, mesmo que os dois recursos sejam completamente diferentes. Nesse caso, você pode definir um tipo de relacionamento fora do intervalo reservado e criar uma relação entre esses dois recursos. Seu aplicativo seria o único cliente que poderia detectar e processar o relacionamento, e poderia ser usado para realizar pesquisas nesse relacionamento.
Você pode especificar programaticamente relações entre recursos usando a API Java do serviço do Repositório ou a API do serviço da Web.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para especificar uma relação entre dois recursos, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço do Repositório.
  3. Especifique os URIs dos recursos a serem relacionados.
  4. Crie a relação.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de ler programaticamente um recurso, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Especificar os URIs dos recursos a serem relacionados
Crie strings que contêm os URIs do recurso a ser relacionado. A sintaxe inclui barras, como neste exemplo: "/ path / resource ".
Criar a relação
Chame o método de serviço Repositório para criar e especificar o tipo de relacionamento.
Consulte também:

Criar recursos de relacionamento usando a API Java

Crie recursos de relacionamento usando a API Java do serviço do Repositório, execute as seguintes tarefas:
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Especificar os URIs dos recursos a serem relacionados
    Especifique os URIs dos recursos a serem relacionados. Nesse caso, como os recursos são nomeados testResource1 e testResource2 estão localizados na pasta nomeada testFolder , seus URIs são "/testFolder/testResource1" e "/testFolder/testResource2" . Os URIs são armazenados como java.lang.String objetos. Neste exemplo, os recursos são gravados primeiro no repositório e seus URIs são recuperados. Para obter mais informações sobre como escrever um recurso, consulte Gravando recursos .
  4. Criar a relação
    Chame o ResourceRepositoryClient método do createRelationship objeto e passe os seguintes parâmetros:
    • O URI do recurso de origem.
    • O URI do recurso de destino.
    • O tipo de relacionamento, que é uma das constantes estáticas na com.adobe.repository.infomodel.bean.Relation classe. Neste exemplo, uma relação de dependência é estabelecida especificando o valor Relation.TYPE_DEPENDANT_OF .
    • Um boolean valor que indica se o recurso de destino é atualizado automaticamente para o identificador com.adobe.repository.infomodel.Id baseado no novo recurso principal. Neste exemplo, devido à relação de dependência, o valor true é especificado. Você também pode recuperar uma lista de recursos relacionados para um determinado recurso, invocando o método do ResourceRepositoryClient objeto getRelated e transmitindo os seguintes parâmetros:
    • O URI do recurso para o qual recuperar recursos relacionados. Neste exemplo, o recurso de origem ( "/testFolder/testResource1" ) é especificado.
    • Um boolean valor que indica se o recurso especificado é o recurso de origem no relacionamento. Neste exemplo, o valor true é especificado porque esse é o caso.
    • O tipo de relacionamento, que é uma das constantes estáticas na Relation classe. Neste exemplo, uma relação de dependência é especificada usando o mesmo valor usado anteriormente: Relation.TYPE_DEPENDANT_OF . O getRelated método retorna um conjunto java.util.List de Resource objetos através dos quais você pode iterar para recuperar cada um dos recursos relacionados, convertendo os objetos contidos no List para Resource que você o faça. Neste exemplo, testResource2 deve estar na lista de recursos retornados.
Consulte também:

Criar recursos de relacionamento usando a API de serviço da Web

Crie recursos de relacionamento usando a API do repositório (serviço da Web):
  1. Incluir arquivos de projeto
    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Repositório.
    • Consulte o assembly do cliente Microsoft .NET.
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Especificar os URIs dos recursos a serem relacionados
    Especifique os URIs dos recursos a serem relacionados. Nesse caso, como os recursos são nomeados testResource1 e testResource2 estão localizados na pasta nomeada testFolder , seus URIs são "/testFolder/testResource1" e "/testFolder/testResource2" . Ao usar um idioma compatível com o Microsoft .NET Framework (por exemplo, C#), os URIs são armazenados como System.String objetos. Neste exemplo, os recursos são gravados primeiro no repositório e seus URIs são recuperados. Para obter mais informações sobre como escrever um recurso, consulte Gravando recursos .
  4. Criar a relação
    Chame o RepositoryServiceService método do createRelationship objeto e passe os seguintes parâmetros:
    • O URI do recurso de origem.
    • O URI do recurso de destino.
    • O tipo de relacionamento. Neste exemplo, uma relação de dependência é estabelecida especificando o valor 3 .
    • Um boolean valor que indica se o tipo de relação foi especificado. Neste exemplo, o valor true é especificado.
    • Um boolean valor que indica se o recurso de destino é atualizado automaticamente para o identificador Id baseado no novo recurso principal. Neste exemplo, devido à relação de dependência, o valor true é especificado.
    • Um boolean valor que indica se o cabeçalho de destino foi especificado. Neste exemplo, o valor true é especificado.
    • Enviar null para o último parâmetro. Você também pode recuperar uma lista de recursos relacionados para um determinado recurso, invocando o método do RepositoryServiceService objeto getRelated e transmitindo os seguintes parâmetros:
    • O URI do recurso para o qual recuperar recursos relacionados. Neste exemplo, o recurso de origem ( "/testFolder/testResource1" ) é especificado.
    • Um boolean valor que indica se o recurso especificado é o recurso de origem no relacionamento. Neste exemplo, o valor true é especificado porque esse é o caso.
    • Um boolean valor que indica se o recurso de origem foi especificado. Neste exemplo, o valor true é fornecido.
    • Uma matriz de números inteiros contendo os tipos de relacionamento. Neste exemplo, uma relação de dependência é especificada usando o mesmo valor na matriz como foi usado anteriormente: 3 .
    • Enviar null para os dois parâmetros restantes. O getRelated método retorna uma matriz de objetos que podem ser convertidos em Resource objetos através dos quais você pode iterar para recuperar cada um dos recursos relacionados. Neste exemplo, testResource2 deve estar na lista de recursos retornados.
Consulte também:

Bloquear recursos

Você pode bloquear um recurso ou conjunto de recursos para uso exclusivo por um usuário específico ou uso compartilhado entre mais de um usuário. Um bloqueio compartilhado é uma indicação de que algo acontecerá com o recurso, mas não impede que mais ninguém tome ações com esse recurso. Um bloqueio compartilhado deve ser considerado um mecanismo de sinalização. Um bloqueio exclusivo significa que o usuário que bloqueou o recurso vai alterar o recurso, e o bloqueio garante que ninguém mais possa fazer isso até que o usuário não precise mais de acesso ao recurso e tenha liberado o bloqueio. Se um administrador do repositório desbloquear um recurso, todos os bloqueios exclusivos e compartilhados nesse recurso serão removidos automaticamente. Esse tipo de ação destina-se a situações em que um usuário não está mais disponível e não desbloqueou o recurso.
Quando um recurso está bloqueado, um ícone de cadeado é exibido quando você exibe a guia Recursos localizada no Workbench, como mostra a ilustração a seguir.
Você pode controlar programaticamente o acesso aos recursos usando a API Java do serviço do Repositório ou a API do serviço da Web.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para bloquear e desbloquear recursos, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço do Repositório.
  3. Especifique o URI do recurso a ser bloqueado.
  4. Bloquear o recurso.
  5. Recupere os bloqueios do recurso.
  6. Desbloquear o recurso
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de ler programaticamente um recurso, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Especificar o URI do recurso a ser bloqueado
Crie uma string contendo o URI do recurso a ser bloqueado. A sintaxe inclui barras, como neste exemplo: "/ path / resource ".
Bloquear o recurso
Chame o método de serviço Repositório para bloquear o recurso, especificando o URI, o tipo de bloqueio e a profundidade de bloqueio.
Recuperar os bloqueios do recurso
Chame o método de serviço Repositório para recuperar os bloqueios do recurso, especificando o URI.
Desbloquear o recurso
Chame o método de serviço Repositório para desbloquear o recurso, especificando o URI.
Consulte também:

Bloquear recursos usando a API Java

Bloquear recursos usando a API de serviço do Repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Especificar o URI do recurso a ser bloqueado
    Especifique o URI do recurso a ser bloqueado. Nesse caso, como o recurso nomeado testResource está na pasta chamada testFolder , seu URI é "/testFolder/testResource" . O URI é armazenado como um java.lang.String objeto.
  4. Bloquear o recurso
    Chame o ResourceRepositoryClient método do lockResource objeto e passe os seguintes parâmetros:
    • O URI do recurso.
    • O escopo do cadeado. Neste exemplo, como o recurso será bloqueado para uso exclusivo, o escopo de bloqueio será especificado como com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE .
    • A profundidade do cadeado. Neste exemplo, como o bloqueio se aplicará somente ao recurso específico e nenhum de seus membros ou filhos, a profundidade de bloqueio é especificada como Lock.DEPTH_ZERO .
    A versão sobrecarregada do lockResource método que requer quatro parâmetros lança uma exceção. Certifique-se de usar o lockResource método que requer três parâmetros, conforme mostrado nesta apresentação.
  5. Recuperar os bloqueios do recurso
    Chame o método do ResourceRepositoryClient objeto getLocks e passe o URI do recurso como parâmetro. O método retorna uma Lista de objetos de bloqueio pela qual você pode iterar. Neste exemplo, o proprietário, a profundidade e o escopo do bloqueio são impressos para cada objeto chamando cada método de bloqueio getOwnerUserId , getDepth``getType e métodos, respectivamente.
  6. Desbloquear o recurso
    Chame o método do ResourceRepositoryClient objeto unlockResource e passe o URI do recurso como parâmetro. Para obter mais informações, consulte a Referência da API do AEM Forms.
Consulte também:

Bloquear recursos usando a API de serviço da Web

Bloquear recursos usando a API de serviço do Repositório (serviço da Web):
  1. Incluir arquivos de projeto
    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Repositório usando o Base64.
    • Consulte o assembly do cliente Microsoft .NET.
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Especificar o URI do recurso a ser bloqueado
    Especifique uma string contendo o URI do recurso a ser bloqueado. Nesse caso, como o recurso nomeado testResource está na pasta testFolder , seu URI é "/testFolder/testResource" . Ao usar um idioma compatível com o Microsoft .NET Framework (por exemplo, C#), armazene o URI em um System.String objeto.
  4. Bloquear o recurso
    Chame o RepositoryServiceService método do lockResource objeto e passe os seguintes parâmetros:
    • O URI do recurso.
    • O escopo do cadeado. Neste exemplo, como o recurso será bloqueado para uso exclusivo, o escopo de bloqueio será especificado como 11 .
    • A profundidade do cadeado. Neste exemplo, como o bloqueio se aplicará somente ao recurso específico e nenhum de seus membros ou filhos, a profundidade de bloqueio é especificada como 2 .
    • Um int valor que indica o número de segundos até que o bloqueio expire. Neste exemplo, o valor de 1000 é usado.
    • Enviar null para o último parâmetro.
  5. Recuperar os bloqueios do recurso
    Chame o método do RepositoryServiceService objeto getLocks e passe o URI do recurso como o primeiro parâmetro e null para o segundo parâmetro. O método retorna uma object matriz contendo Lock objetos pelos quais você pode iterar. Neste exemplo, o proprietário, a profundidade e o escopo do bloqueio são impressos para cada objeto acessando os campos de cada Lock objeto ownerUserId , depth e type , respectivamente.
  6. Desbloquear o recurso
    Chame o método do RepositoryServiceService objeto unlockResource e passe o URI do recurso como o primeiro parâmetro e null para o segundo parâmetro.
Consulte também:

Excluindo recursos

Você pode excluir programaticamente os recursos de um determinado local no repositório usando a API Java (SOAP) do serviço do Repositório.
Quando você exclui um recurso, a exclusão normalmente é permanente, embora em alguns casos os repositórios ECM possam armazenar as versões do recurso de acordo com seus mecanismos de histórico. Portanto, ao excluir um recurso, é importante ter certeza de que você nunca precisará desse recurso novamente. Os motivos comuns para excluir um recurso incluem a necessidade de aumentar o espaço disponível no banco de dados. É possível excluir uma versão de um recurso, mas se você fizer isso, deverá especificar o identificador do recurso, e não seu identificador lógico (LID) ou caminho. Se você excluir uma pasta, tudo nessa pasta, incluindo subpastas e recursos, será automaticamente excluído.
Os recursos relacionados não são excluídos. Por exemplo, se você tiver um formulário que usa o arquivo logo.gif e excluir logo.gif, uma relação será armazenada na tabela de relacionamento pendente. Como alternativa, para a substituição da versão, defina o status do objeto da versão mais recente como obsoleto.
Uma operação de exclusão não é segura para transações em sistemas ECM. Por exemplo, se você tentar excluir 100 recursos e a operação falhar no 50º recurso, as primeiras 49 instâncias serão excluídas, mas o restante não será. Caso contrário, o comportamento padrão será revertido (sem compromisso).
Ao usar o com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources() método com repositório ECM (EMC Documentum Content Server e IBM FileNet P8 Content Manager), a transação não será revertida se a exclusão falhar para um dos recursos especificados, o que significa que os arquivos que foram excluídos não podem ser removidos.
Para obter mais informações sobre o serviço Repositório, consulte Referência de serviços para formulários AEM.

Resumo das etapas

Para excluir um recurso, siga estas etapas:
  1. Incluir arquivos de projeto.
  2. Criar um cliente de serviço do Repositório.
  3. Especifique o URI do recurso a ser excluído.
  4. Exclua o recurso.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, inclua os arquivos proxy.
Criar o cliente de serviço
Antes de ler programaticamente um recurso, você deve estabelecer uma conexão e fornecer credenciais. Isso é feito criando um cliente de serviço.
Especificar o URI do recurso a ser excluído
Crie uma string contendo o URI do recurso a ser excluído. A sintaxe inclui barras, como neste exemplo: "/ path / resource ". Se o recurso a ser excluído for uma pasta, a exclusão será recursiva.
Excluir o recurso
Chame o método de serviço Repositório para excluir o recurso, especificando o URI.
Consulte também:

Excluir recursos usando a API Java (SOAP)

Exclua um recurso usando a API do repositório (Java):
  1. Incluir arquivos de projeto
    Inclua arquivos JAR do cliente no caminho de classe do seu projeto Java.
  2. Criar o cliente de serviço
    Crie um ResourceRepositoryClient objeto usando seu construtor e transmitindo um ServiceClientFactory objeto que contenha propriedades de conexão.
  3. Especificar o URI do recurso a ser excluído
    Especifique o URI do recurso a ser recuperado. Nesse caso, como o recurso chamado testResourceToBeDeleted está na pasta chamada testFolder, seu URI é /testFolder/testResourceToBeDeleted . O URI é armazenado como um java.lang.String objeto. Neste exemplo, o recurso é gravado primeiro no repositório e seu URI é recuperado. Para obter mais informações sobre como escrever um recurso, consulte Gravando recursos .
  4. Excluir o recurso
    Chame o método do ResourceRepositoryClient objeto deleteResource e passe o URI do recurso como parâmetro.
Consulte também:

Excluir recursos usando a API de serviço da Web

Exclua um recurso usando a API do repositório (serviço da Web):
  1. Incluir arquivos de projeto
    • Crie um assembly de cliente Microsoft .NET que consuma o WSDL do Repositório usando o Base64.
    • Consulte o assembly do cliente Microsoft .NET.
  2. Criar o cliente de serviço
    Usando o assembly do cliente Microsoft .NET, crie um RepositoryServiceService objeto chamando seu construtor padrão. Defina sua Credentials propriedade usando um System.Net.NetworkCredential objeto que contenha o nome de usuário e a senha.
  3. Especificar o URI do recurso a ser excluído
    Especifique o URI do recurso a ser recuperado. Nesse caso, como o recurso nomeado testResourceToBeDeleted está na pasta chamada testFolder , seu URI é "/testFolder/testResourceToBeDeleted" . Neste exemplo, o recurso é gravado primeiro no repositório e seu URI é recuperado. Para obter mais informações sobre como escrever um recurso, consulte Gravando recursos .
  4. Excluir o recurso
    Chame o método do RepositoryServiceService objeto deleteResources e passe uma System.String matriz que contenha o URI do recurso como o primeiro parâmetro. Enviar null para o segundo parâmetro.
Consulte também: