Show Menu
ARGOMENTI×

Protezione dei documenti con i criteri

Informazioni su Document Security Service
Il servizio Document Security consente agli utenti di applicare in modo dinamico le impostazioni per la salvaguardia della riservatezza ai documenti Adobe PDF e di mantenere il controllo sui documenti, indipendentemente dalla loro diffusione.
Il servizio Document Security impedisce la diffusione delle informazioni oltre la portata dell'utente, consentendo agli utenti di mantenere il controllo sul modo in cui i destinatari utilizzano il documento PDF protetto tramite criterio. Un utente può specificare chi può aprire un documento, limitare il suo utilizzo e monitorare il documento dopo averlo distribuito. Un utente può inoltre controllare in modo dinamico l'accesso a un documento protetto tramite criterio e può revocare l'accesso al documento anche in modo dinamico.
Il servizio Document Security protegge anche altri tipi di file come i file Microsoft Word (file DOC). Potete utilizzare l'API client di Document Security per lavorare con questi tipi di file. Sono supportate le versioni seguenti:
  • File di Microsoft Office 2003 (DOC, XLS, PPT)
  • File di Microsoft Office 2007 (DOCX, XLSX, PPTX)
  • PTC Pro/E, file
Per maggiore chiarezza, nelle due sezioni seguenti viene illustrato come utilizzare i documenti Word:
Potete eseguire le seguenti attività utilizzando il servizio Document Security:
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Creazione di criteri

Potete creare criteri a livello di programmazione utilizzando l'API Java di Document Security o l'API del servizio Web. Un criterio è una raccolta di informazioni che include le impostazioni di protezione dei documenti, gli utenti autorizzati e i diritti di utilizzo. Potete creare e salvare un numero qualsiasi di criteri, utilizzando le impostazioni di protezione appropriate per situazioni e utenti diversi.
I criteri consentono di eseguire le operazioni seguenti:
  • Specificate gli utenti che possono aprire il documento. I destinatari possono appartenere o essere esterni all'organizzazione.
  • Specificare il modo in cui i destinatari possono utilizzare il documento. È possibile limitare l’accesso a diverse funzioni di Acrobat e Adobe Reader. Queste funzioni includono la possibilità di stampare e copiare il testo, aggiungere firme e aggiungere commenti a un documento.
  • Modificate le impostazioni di accesso e protezione in qualsiasi momento, anche dopo la distribuzione del documento protetto tramite criterio.
  • Monitorare l’uso del documento dopo averlo distribuito. È possibile vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile verificare quando un utente ha aperto il documento.

Creazione di un criterio tramite i servizi Web

Quando create un criterio utilizzando l'API del servizio Web, fate riferimento a un file XML PDF (Portable Document Rights Language) esistente che descrive il criterio. Le autorizzazioni dei criteri e l'entità sono definite nel documento PDRL. Il seguente documento XML è un esempio di documento PDRL.
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Policy PolicyInstanceVersion="1" PolicyID="5DA3F847-DE76-F9CC-63EA-49A8D59154DE" PolicyCreationTime="2004-08-30T00:02:28.294+00:00" PolicyType="1" PolicySchemaVersion="1.0" PolicyName="SDK Test Policy -4344050357301573237" PolicyDescription="An SDK Test policy" xmlns="https://www.adobe.com/schema/1.0/pdrl">
       <PolicyEntry>
          <ns1:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns1="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns2:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns2="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns3:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns3="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns4:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns4="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>all_internal_users</PrincipalName>
          </Principal>
       </PolicyEntry>
       <PolicyEntry>
          <ns5:Permission PermissionName="com.adobe.aps.onlineOpen" Access="ALLOW" xmlns:ns5="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns6:Permission PermissionName="com.adobe.aps.offlineOpen" Access="ALLOW" xmlns:ns6="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns7:Permission PermissionName="com.adobe.aps.pdf.copy" Access="ALLOW" xmlns:ns7="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns8:Permission PermissionName="com.adobe.aps.pdf.printLow" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns8="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns9:Permission PermissionName="com.adobe.aps.policySwitch" Access="ALLOW" xmlns:ns9="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns10:Permission PermissionName="com.adobe.aps.revoke" Access="ALLOW" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" xmlns:ns10="https://www.adobe.com/schema/1.0/pdrl" />
 
          <ns11:Permission PermissionName="com.adobe.aps.pdf.edit" Access="ALLOW" xmlns:ns11="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns12:Permission PermissionName="com.adobe.aps.pdf.editNotes" Access="ALLOW" xmlns:ns12="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns13:Permission PermissionName="com.adobe.aps.pdf.fillAndSign" Access="ALLOW" xmlns:ns13="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <ns14:Permission PermissionName="com.adobe.aps.pdf.printHigh" Access="ALLOW" xmlns:ns14="https://www.adobe.com/schema/1.0/pdrl" xmlns="https://www.adobe.com/schema/1.0/pdrl-ex" />
 
          <Principal PrincipalNameType="SYSTEM">
             <PrincipalDomain>EDC_SPECIAL</PrincipalDomain>
 
             <PrincipalName>publisher</PrincipalName>
          </Principal>
       </PolicyEntry>
 
       <OfflineLeasePeriod>
          <Duration>P31D</Duration>
       </OfflineLeasePeriod>
 
       <AuditSettings isTracked="true" />
 
       <PolicyValidityPeriod isAbsoluteTime="false">
          <ValidityPeriodRelative>
             <NotBeforeRelative>PT0S</NotBeforeRelative>
 
             <NotAfterRelative>P20D</NotAfterRelative>
          </ValidityPeriodRelative>
       </PolicyValidityPeriod>
 </Policy>
 

Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per creare un criterio, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Impostate gli attributi del criterio.
  4. Creare una voce del criterio.
  5. Registra il criterio.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-rightsmanagement-client.jar
  • namespace.jar (se AEM Forms è distribuito su JBoss)
  • jaxb-api.jar (se AEM Forms è distribuito su JBoss)
  • jaxb-impl.jar (se AEM Forms è distribuito su JBoss)
  • jaxb-libs.jar (se AEM Forms è distribuito su JBoss)
  • jaxb-xjc.jar (se AEM Forms è distribuito su JBoss)
  • relaxngData.jar (se AEM Forms è distribuito su JBoss)
  • xsdlib.jar (se AEM Forms è distribuito su JBoss)
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar
  • jbossall-client.jar (utilizzate un file JAR diverso se AEM Forms non è distribuito su JBoss)
Per informazioni sulla posizione di questi file JAR, consultate Inclusione di file libreria Java AEM Forms.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security.
Impostare gli attributi del criterio
Per creare un criterio, impostate gli attributi del criterio. Un attributo obbligatorio è il nome del criterio. I nomi dei criteri devono essere univoci per ciascun set di criteri. Un set di criteri è semplicemente una raccolta di criteri. Possono essere presenti due criteri con lo stesso nome se i criteri appartengono a set di criteri separati. Tuttavia, due criteri all'interno di un singolo set di criteri non possono avere lo stesso nome.
Un altro attributo utile da impostare è il periodo di validità. Un periodo di validità è il periodo di tempo durante il quale un documento protetto tramite criterio è accessibile ai destinatari autorizzati. Se non impostate questo attributo, il criterio è sempre valido.
Un periodo di validità può essere impostato su una delle seguenti opzioni:
  • Numero impostato di giorni in cui il documento è accessibile a partire dal momento in cui viene pubblicato
  • Una data di fine dopo la quale il documento non è accessibile
  • Un intervallo di date specifico per il quale il documento è accessibile
  • Always valid
È possibile specificare solo una data di inizio, che determina la validità del criterio dopo la data di inizio. Se si specifica solo una data di fine, il criterio è valido fino alla data di fine. Tuttavia, viene generata un'eccezione se non sono definite sia una data di inizio che una data di fine.
Quando impostate gli attributi che appartengono a un criterio, potete anche impostare le impostazioni di cifratura. Queste impostazioni di cifratura hanno effetto quando il criterio viene applicato a un documento. È possibile specificare i seguenti valori di cifratura:
  • AES256 : Rappresenta l’algoritmo di cifratura AES con una chiave a 256 bit.
  • AES128 : Rappresenta l’algoritmo di cifratura AES con una chiave a 128 bit.
  • ​NoEncryption: Non rappresenta la cifratura.
Quando specificate l’ NoEncryption opzione, non potete impostare l’ PlaintextMetadata opzione su false . Se tentate di farlo, viene generata un'eccezione.
Per informazioni su altri attributi che potete impostare, consultate la descrizione dell' Policy interfaccia nella Guida di riferimento delle API per AEM Forms.
Creare una voce di criterio
Una voce di criterio associa entità, che sono gruppi e utenti, e autorizzazioni a un criterio. Un criterio deve avere almeno una voce del criterio. Si supponga, ad esempio, di eseguire le seguenti operazioni:
  • Create e registrate una voce del criterio che consente a un gruppo di visualizzare solo un documento mentre è in linea e impedisce ai destinatari di copiarlo.
  • Associate l'immissione dei criteri al criterio.
  • Proteggere un documento con il criterio utilizzando Acrobat.
Queste azioni consentono ai destinatari di visualizzare il documento solo online e non di copiarlo. Il documento rimane protetto finché non viene rimossa la protezione.
Registrazione del criterio
Per poter utilizzare un nuovo criterio, è necessario registrarlo. Dopo aver registrato un criterio, potete utilizzarlo per proteggere i documenti.

Creare un criterio utilizzando l'API Java

Create un criterio utilizzando l'API di Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un DocumentSecurityClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Impostate gli attributi del criterio.
    • Creare un Policy oggetto richiamando il InfomodelObjectFactory metodo statico dell'oggetto createPolicy . Questo metodo restituisce un Policy oggetto.
    • Impostate l'attributo nome del criterio richiamando il metodo dell' Policy setName oggetto e passando un valore di stringa che specifica il nome del criterio.
    • Impostate la descrizione del criterio richiamando il metodo dell' Policy oggetto setDescription e passando un valore di stringa che specifica la descrizione del criterio.
    • Impostare il set di criteri a cui appartiene il nuovo criterio richiamando il metodo dell' Policy setPolicySetName oggetto e passando un valore di stringa che specifica il nome del set di criteri. (È possibile specificare null per questo valore di parametro che determina l'aggiunta del criterio al set di criteri Criteri personali.)
    • Creare il periodo di validità del criterio richiamando il InfomodelObjectFactory metodo statico dell'oggetto createValidityPeriod . Questo metodo restituisce un ValidityPeriod oggetto.
    • Impostare il numero di giorni per i quali un documento protetto tramite criterio è accessibile richiamando il metodo dell' ValidityPeriod setRelativeExpirationDays oggetto e passando un valore intero che specifica il numero di giorni.
    • Impostare il periodo di validità del criterio richiamando il metodo dell' Policy oggetto setValidityPeriod e passando l' ValidityPeriod oggetto.
  4. Creare una voce del criterio.
    • Creare una voce del criterio richiamando il InfomodelObjectFactory metodo statico dell'oggetto createPolicyEntry . Questo metodo restituisce un PolicyEntry oggetto.
    • Specificate le autorizzazioni del criterio richiamando il InfomodelObjectFactory metodo statico dell'oggetto createPermission . Passa un membro di dati statici appartenente all' Permission interfaccia che rappresenta l'autorizzazione. Questo metodo restituisce un Permission oggetto. Ad esempio, per aggiungere l'autorizzazione che consente agli utenti di copiare dati da un documento PDF protetto tramite criterio, passare Permission.COPY . Ripetete questo passaggio per ogni autorizzazione da aggiungere.
    • Aggiungete l'autorizzazione alla voce del criterio richiamando il metodo dell' PolicyEntry oggetto addPermission e passando l' Permission oggetto. Ripetete questo passaggio per ogni Permission oggetto creato.
    • Creare l'entità del criterio richiamando il InfomodelObjectFactory metodo statico dell'oggetto createSpecialPrincipal . Passa un membro di dati appartenente all' InfomodelObjectFactory oggetto che rappresenta l'entità. Questo metodo restituisce un Principal oggetto. Ad esempio, per aggiungere come entità l’editore del documento, passare InfomodelObjectFactory.PUBLISHER_PRINCIPAL .
    • Aggiungete l'entità alla voce del criterio richiamando il PolicyEntry metodo dell'oggetto e passando l' setPrincipal``Principal oggetto.
    • Aggiungete la voce del criterio al criterio richiamando il metodo dell' Policy oggetto addPolicyEntry e passando l' PolicyEntry oggetto.
  5. Registra il criterio.
    • Creare un PolicyManager oggetto richiamando il DocumentSecurityClient metodo dell' getPolicyManager oggetto.
    • Registrare il criterio richiamando il metodo dell' PolicyManager oggetto registerPolicy e passando i seguenti valori:
      • L' Policy oggetto che rappresenta il criterio da registrare.
    • Una stringa che rappresenta il set di criteri a cui appartiene il criterio.
    Se per creare l' DocumentSecurityClient oggetto si utilizza un account amministratore di moduli AEM all'interno delle impostazioni di connessione, è necessario specificare il nome del set di criteri quando si richiama il registerPolicy metodo. Se passate un null valore per il set di criteri, il criterio viene creato nel set di criteri Criteri personali degli amministratori.
    Se utilizzate un utente di Document Security all'interno delle impostazioni di connessione, potete richiamare il registerPolicy metodo sovraccarico che accetta solo il criterio. In altre parole, non è necessario specificare il nome del set di criteri. Tuttavia, il criterio viene aggiunto al set di criteri denominato Criteri personali. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome di set di criteri quando si richiama il registerPolicy metodo.
    Quando create un criterio, fate riferimento a un set di criteri esistente. Se specificate un set di criteri che non esiste, viene generata un'eccezione.
Per esempi di codice che utilizzano il servizio Document Security, consultate quanto segue:
  • "Avvio rapido (modalità SOAP): Creazione di un criterio tramite l'API Java"

Creazione di un criterio tramite l'API del servizio Web

Create un criterio utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un DocumentSecurityServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un DocumentSecurityServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Impostate gli attributi del criterio.
    • Creare un PolicySpec oggetto utilizzando il relativo costruttore.
    • Impostate il nome del criterio assegnando un valore stringa al membro dati dell' PolicySpec oggetto name .
    • Impostare la descrizione del criterio assegnando un valore stringa al membro dati dell' PolicySpec oggetto description .
    • Impostare l'insieme di criteri a cui apparterrà il criterio assegnando un valore stringa al membro PolicySpec dati dell'oggetto policySetName . È necessario specificare un nome di set di criteri esistente. Potete specificare null per questo valore di parametro che determina l'aggiunta del criterio ai criteri personali .
    • Impostate il periodo di tempo consentito per il criterio offline assegnando un valore intero al membro PolicySpec dati dell' offlineLeasePeriod oggetto.
    • Impostare il membro dati dell' PolicySpec oggetto policyXml con un valore di stringa che rappresenta i dati XML PDRL. Per eseguire questa operazione, creare un oggetto .NET StreamReader utilizzando il relativo costruttore. Trasmettere la posizione di un file PDRL XML che rappresenta il criterio al StreamReader costruttore. Quindi, richiamare il metodo dell' StreamReader oggetto ReadLine e assegnare il valore restituito a una variabile di stringa. Eseguire un'iterazione sull' StreamReader oggetto finché il ReadLine metodo restituisce null. Assegnare la variabile stringa al membro dati dell' PolicySpec oggetto policyXml .
  4. Creare una voce del criterio.
    Non è necessario creare una voce del criterio al momento della creazione di un criterio tramite l'API del servizio Web di Document Security. La voce del criterio è definita nel documento PDF.
  5. Registra il criterio.
    Registrare il criterio richiamando il metodo dell' DocumentSecurityServiceClient oggetto registerPolicy e passando i seguenti valori:
    • L' PolicySpec oggetto che rappresenta il criterio da registrare.
    • Una stringa che rappresenta il set di criteri a cui appartiene il criterio. È possibile specificare un null valore che determina l'aggiunta del criterio al set di criteri MyPolices .
    Se per creare l' DocumentSecurityClient oggetto si utilizza un account amministratore di moduli AEM all'interno delle impostazioni di connessione, specificare il nome del set di criteri quando si richiama il registerPolicy metodo.
    Se utilizzate un utente Document Security all'interno delle impostazioni di connessione, potete richiamare il registerPolicy metodo sovraccarico che accetta solo il criterio. In altre parole, non è necessario specificare il nome del set di criteri. Tuttavia, il criterio viene aggiunto al set di criteri denominato Criteri personali. Se non si desidera aggiungere il nuovo criterio a questo set di criteri, specificare un nome di set di criteri quando si richiama il registerPolicy metodo.
    Quando create un criterio e specificate un set di criteri, accertatevi di specificare un set di criteri esistente. Se specificate un set di criteri che non esiste, viene generata un'eccezione.
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Creazione di un criterio tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Creazione di un criterio tramite l'API del servizio Web"

Modifica dei criteri

Potete modificare un criterio esistente utilizzando l'API Java di Document Security o l'API del servizio Web. Per apportare modifiche a un criterio esistente, è necessario recuperarlo, modificarlo e quindi aggiornare il criterio sul server. Ad esempio, si supponga di recuperare un criterio esistente e di estenderne il periodo di validità. Prima che la modifica abbia effetto, è necessario aggiornare il criterio.
Potete modificare un criterio quando i requisiti aziendali cambiano e il criterio non riflette più tali requisiti. Invece di creare un nuovo criterio, potete semplicemente aggiornare un criterio esistente.
Per modificare gli attributi del criterio utilizzando un servizio Web (ad esempio, utilizzando classi proxy Java create con JAX-WS), è necessario verificare che il criterio sia registrato con il servizio Document Security. Potete quindi fare riferimento al criterio esistente utilizzando il PolicySpec.getPolicyXml metodo e modificare gli attributi del criterio utilizzando i metodi applicabili. Ad esempio, potete modificare il periodo di tempo consentito per l'utilizzo non in linea richiamando il PolicySpec.setOfflineLeasePeriod metodo.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per modificare un criterio esistente, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Recuperare un criterio esistente.
  4. Modificare gli attributi dei criteri.
  5. Aggiornare il criterio.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di poter eseguire un'operazione Document Security Service a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un RightsManagementClient oggetto. Se utilizzate l'API del servizio Web di Document Security, create un RightsManagementServiceService oggetto.
Recuperare un criterio esistente
È necessario recuperare un criterio esistente per modificarlo. Per recuperare un criterio, specificate il nome del criterio e il set al quale il criterio appartiene. Se specificate un null valore per il nome del set di criteri, il criterio viene recuperato dal set di criteri Criteri personali.
Impostare gli attributi del criterio
Per modificare un criterio, modificate il valore degli attributi del criterio. L'unico attributo di criterio che non potete modificare è l'attributo name. Ad esempio, per modificare il periodo di tempo consentito dal criterio per l'utilizzo non in linea, potete modificare il valore dell'attributo del periodo consentito non in linea del criterio.
Quando si modifica il periodo di tempo consentito per un criterio offline utilizzando un servizio Web, il offlineLeasePeriod campo nell' PolicySpec interfaccia viene ignorato. Per aggiornare il periodo di tempo consentito per l'utilizzo non in linea, modificare l' OfflineLeasePeriod elemento nel documento XML PDRL. Fare quindi riferimento al documento PDF XML aggiornato utilizzando il membro dati dell' PolicySpec interfaccia policyXML .
Per informazioni su altri attributi che potete impostare, consultate la descrizione dell' Policy interfaccia nella Guida di riferimento delle API per AEM Forms.
Aggiornare il criterio
Prima che le modifiche apportate a un criterio vengano applicate, è necessario aggiornare il criterio con il servizio Document Security. Le modifiche ai criteri di protezione dei documenti vengono aggiornate al successivo aggiornamento della sincronizzazione del documento protetto tramite criterio con il servizio Document Security.

Modificare i criteri esistenti utilizzando l'API Java

Modificate un criterio esistente utilizzando l'API di Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un RightsManagementClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperare un criterio esistente.
    • Creare un PolicyManager oggetto richiamando il RightsManagementClient metodo dell' getPolicyManager oggetto.
    • Creare un oggetto Policy che rappresenti il criterio da aggiornare richiamando il metodo dell' PolicyManager oggetto getPolicy e passando i seguenti valori"
      • Una stringa che rappresenta il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che il set di criteri venga utilizzato MyPolicies .
      • Una stringa che rappresenta il nome del criterio.
  4. Impostate gli attributi del criterio.
    Modificate gli attributi del criterio per soddisfare i requisiti aziendali. Ad esempio, per modificare il periodo di tempo consentito dal criterio offline, richiamare il Policy metodo dell'oggetto setOfflineLeasePeriod .
  5. Aggiornare il criterio.
    Aggiornare il criterio richiamando il metodo dell' PolicyManager oggetto updatePolicy . Passa l' Policy oggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate Avvio rapido (modalità SOAP): Modifica di un criterio tramite la sezione Java API.

Modifica dei criteri esistenti tramite l'API del servizio Web

Modificate un criterio esistente utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un RightsManagementServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un RightsManagementServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperare un criterio esistente.
    Creare un oggetto PolicySpec che rappresenti il criterio da modificare richiamando il metodo dell' RightsManagementServiceClient oggetto getPolicy e passando i seguenti valori:
    • Una stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che il set di criteri venga utilizzato MyPolicies .
    • Un valore di stringa che specifica il nome del criterio.
  4. Impostate gli attributi del criterio.
    Modificate gli attributi del criterio per soddisfare i requisiti aziendali.
  5. Aggiornare il criterio.
    Aggiornare il criterio richiamando il metodo dell' RightsManagementServiceClient oggetto updatePolicyFromSDK e passando l' PolicySpec oggetto che rappresenta il criterio da aggiornare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Modifica di un criterio tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Modifica di un criterio tramite l'API del servizio Web"

Eliminazione dei criteri

Potete eliminare un criterio esistente utilizzando l'API Java di Document Security o l'API del servizio Web. Una volta eliminato, un criterio non può più essere utilizzato per proteggere i documenti. Tuttavia, i documenti protetti tramite criterio esistenti che utilizzano il criterio sono ancora protetti. Potete eliminare un criterio quando diventa disponibile un criterio più recente.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per eliminare un criterio esistente, eseguire le operazioni seguenti:
  1. Includi file di progetto
  2. Creare un oggetto Document Security Client API.
  3. Eliminate il criterio.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un RightsManagementClient oggetto. Se utilizzate l'API del servizio Web di Document Security, create un RightsManagementServiceService oggetto.
Eliminare il criterio
Per eliminare un criterio, è necessario specificare il criterio da eliminare e il set al quale il criterio appartiene. L'utente le cui impostazioni sono utilizzate per richiamare AEM Forms deve disporre dell'autorizzazione necessaria per eliminare il criterio; in caso contrario si verifica un'eccezione. Analogamente, se si tenta di eliminare un criterio che non esiste, si verifica un'eccezione.

Eliminare i criteri tramite l'API Java

Eliminate un criterio utilizzando l'API di Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un RightsManagementClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Eliminate il criterio.
    • Creare un PolicyManager oggetto richiamando il RightsManagementClient metodo dell' getPolicyManager oggetto.
    • Eliminare il criterio richiamando il metodo dell' PolicyManager oggetto deletePolicy e passando i seguenti valori:
      • Una stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che il set di criteri venga utilizzato MyPolicies .
      • Un valore di stringa che specifica il nome del criterio da eliminare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (modalità SOAP): Eliminazione di un criterio tramite l'API Java"

Eliminare i criteri tramite l'API del servizio Web

Eliminate un criterio utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un RightsManagementServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un RightsManagementServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Eliminate il criterio.
    Per eliminare un criterio, richiamate il metodo dell' RightsManagementServiceClient oggetto deletePolicy e passate i seguenti valori:
    • Una stringa che specifica il nome del set di criteri a cui appartiene il criterio. È possibile specificare null che il set di criteri venga utilizzato MyPolicies .
    • Un valore di stringa che specifica il nome del criterio da eliminare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Eliminazione di un criterio tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Eliminazione di un criterio tramite l'API del servizio Web"

Applicazione dei criteri ai documenti PDF

È possibile applicare un criterio a un documento PDF per proteggere il documento. Applicando un criterio a un documento PDF, è possibile limitare l'accesso al documento. Non è possibile applicare un criterio a un documento se il documento è già protetto con un criterio.
Mentre il documento è aperto, è inoltre possibile limitare l'accesso alle funzioni di Acrobat e Adobe Reader, compresa la possibilità di stampare e copiare il testo, apportare modifiche e aggiungere firme e commenti a un documento. Inoltre, è possibile revocare un documento PDF protetto tramite criterio quando non si desidera più che gli utenti accedano al documento.
È possibile monitorare l'utilizzo di un documento protetto tramite criterio dopo averlo distribuito. In altre parole, potete vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile verificare quando un utente ha aperto il documento.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per applicare un criterio a un documento PDF, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Recuperare un documento PDF a cui viene applicato un criterio.
  4. Applicare un criterio esistente al documento PDF.
  5. Salvate il documento PDF protetto tramite criterio.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un DocumentSecurityClient oggetto. Se utilizzate l'API del servizio Web di Document Security, create un DocumentSecurityServiceService oggetto.
Recupero di un documento PDF
È possibile recuperare un documento PDF per applicare un criterio. Dopo aver applicato un criterio al documento PDF, gli utenti possono utilizzare il documento con restrizioni. Ad esempio, se il criterio non consente l'apertura del documento offline, gli utenti devono essere online per aprire il documento.
Applicare un criterio esistente al documento PDF
Per applicare un criterio a un documento PDF, fare riferimento a un criterio esistente e specificare a quale set di criteri appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verifica un'eccezione.
Salvare il documento PDF
Dopo che il servizio Document Security ha applicato un criterio a un documento PDF, potete salvare il documento PDF protetto tramite criterio come file PDF.
Consulta anche

Applicazione di un criterio a un documento PDF tramite l'API Java

Applicare un criterio a un documento PDF utilizzando l'API Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un RightsManagementClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperare un documento PDF.
    • Creare un oggetto java.io.FileInputStream che rappresenti il documento PDF utilizzando il relativo costruttore. Passa un valore di stringa che specifica la posizione del documento PDF.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Applicare un criterio esistente al documento PDF.
    • Creare un DocumentManager oggetto richiamando il RightsManagementClient metodo dell' getDocumentManager oggetto.
    • Applicare un criterio al documento PDF richiamando il metodo dell' DocumentManager oggetto protectDocument e passando i seguenti valori:
      • L' com.adobe.idp.Document oggetto che contiene il documento PDF a cui viene applicato il criterio.
      • Una stringa che specifica il nome del documento.
      • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Potete specificare un null valore che determina l'utilizzo del set di MyPolicies criteri.
      • Una stringa che specifica il nome del criterio.
      • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore successivo del parametro deve essere null).
      • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere null (se questo parametro è nullo, il valore del parametro precedente deve essere null ).
      • Un com.adobe.livecycle.rightsmanagement.Locale che rappresenta le impostazioni internazionali utilizzate per selezionare il modello di MS Office. Questo valore del parametro è facoltativo e non viene utilizzato per i documenti PDF. Per proteggere un documento PDF, specificare null .
      Il protectDocument metodo restituisce un RMSecureDocumentResult oggetto che contiene il documento PDF protetto tramite criterio.
  5. Salvare il documento PDF.
    • Richiamare il metodo dell' RMSecureDocumentResult oggetto getProtectedDoc per ottenere il documento PDF protetto tramite criterio. Questo metodo restituisce un com.adobe.idp.Document oggetto.
    • Creare un java.io.File oggetto e assicurarsi che l'estensione del file sia PDF.
    • Richiamare il metodo dell' com.adobe.idp.Document oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal getProtectedDoc metodo).
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (modalità EJB): Applicazione di un criterio a un documento PDF tramite l'API Java"
  • "Avvio rapido (modalità SOAP): Applicazione di un criterio a un documento PDF tramite l'API Java"
Consulta anche

Applicazione di un criterio a un documento PDF tramite l'API del servizio Web

Applicare un criterio a un documento PDF utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un RightsManagementServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un RightsManagementServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Trasmettere un valore di stringa che specifica il WSDL al servizio Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperare un documento PDF.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF a cui è applicato un criterio.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. Determinare la dimensione dell'array di byte ottenendo la System.IO.FileStream proprietà dell' Length oggetto.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream oggetto Read . Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Applicare un criterio esistente al documento PDF.
    Applicare un criterio al documento PDF richiamando il metodo dell' RightsManagementServiceClient oggetto protectDocument e passando i seguenti valori:
    • L' BLOB oggetto che contiene il documento PDF a cui viene applicato il criterio.
    • Una stringa che specifica il nome del documento.
    • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Potete specificare un null valore che determina l'utilizzo del set di MyPolicies criteri.
    • Una stringa che specifica il nome del criterio.
    • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro successivo deve essere null ).
    • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro precedente deve essere null ).
    • Un RMLocale valore che specifica il valore delle impostazioni internazionali (ad esempio, RMLocale.en ).
    • Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore del criterio.
    • Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite criterio.
    • Un parametro di output della stringa utilizzato per memorizzare il tipo mime (ad esempio, application/pdf ).
    Il protectDocument metodo restituisce un BLOB oggetto che contiene il documento PDF protetto tramite criterio.
  5. Salvare il documento PDF.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto tramite criterio.
    • Creare un array di byte che memorizza il contenuto dei dati dell' BLOB oggetto restituito dal protectDocument metodo. Compilare l'array di byte ottenendo il valore del membro BLOB dati dell' MTOM oggetto.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
    • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo dell' System.IO.BinaryWriter oggetto Write e passando l'array di byte.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Applicazione di un criterio a un documento PDF tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Applicazione di un criterio a un documento PDF tramite l'API del servizio Web"

Rimozione di criteri dai documenti PDF

È possibile rimuovere un criterio da un documento protetto tramite criterio per rimuovere la protezione dal documento. Se non si desidera più che il documento sia protetto tramite un criterio. Se desiderate aggiornare un documento protetto tramite criterio con un criterio più recente, invece di rimuovere il criterio e aggiungere il criterio aggiornato, è più efficiente cambiare il criterio.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per rimuovere un criterio da un documento PDF protetto tramite criterio, effettuare le seguenti operazioni:
  1. Includi file di progetto
  2. Creare un oggetto Document Security Client API.
  3. Recuperare un documento PDF protetto tramite criterio.
  4. Rimuovere il criterio dal documento PDF.
  5. Salvare il documento PDF non protetto.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security.
Recupero di un documento PDF protetto tramite criterio
È possibile recuperare un documento PDF protetto tramite criterio per rimuovere un criterio. Se tentate di rimuovere un criterio da un documento PDF non protetto da un criterio, causerete un'eccezione.
Rimuovere il criterio dal documento PDF
È possibile rimuovere un criterio da un documento PDF protetto tramite criterio a condizione che nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere l' SWITCH_POLICY autorizzazione per rimuovere un criterio da un documento PDF. Inoltre, anche l'utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.
Salvare il documento PDF non protetto
Dopo che il servizio Document Security ha rimosso un criterio da un documento PDF, potete salvare il documento PDF non protetto come file PDF.
Consulta anche

Rimozione di un criterio da un documento PDF tramite l'API Java

Rimuovere un criterio da un documento PDF protetto tramite criterio utilizzando l'API Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un DocumentSecurityClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperare un documento PDF protetto tramite criterio.
    • Creare un java.io.FileInputStream oggetto che rappresenti il documento PDF protetto tramite criterio utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Rimuovere il criterio dal documento PDF.
    • Creare un DocumentManager oggetto richiamando il DocumentSecurityClient metodo dell' getDocumentManager oggetto.
    • Rimuovere un criterio dal documento PDF richiamando il DocumentManager metodo dell' removeSecurity oggetto e passando l' com.adobe.idp.Document oggetto che contiene il documento PDF protetto tramite criterio. Questo metodo restituisce un com.adobe.idp.Document oggetto contenente un documento PDF non protetto.
  5. Salvare il documento PDF non protetto.
    • Creare un java.io.File oggetto e assicurarsi che l'estensione del file sia PDF.
    • Richiamare il metodo dell' Document oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal removeSecurity metodo).
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (modalità SOAP): Rimozione di un criterio da un documento PDF tramite l'API Java"

Rimozione di un criterio tramite l'API del servizio Web

Rimuovere un criterio da un documento PDF protetto tramite criterio utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un DocumentSecurityServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un DocumentSecurityServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperare un documento PDF protetto tramite criterio.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare il documento PDF protetto tramite criterio da cui viene rimosso il criterio.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Rimuovere il criterio dal documento PDF.
    Rimuovere il criterio dal documento PDF richiamando il DocumentSecurityServiceClient metodo dell' removePolicySecurity oggetto e passando l' BLOB oggetto che contiene il documento PDF protetto tramite criterio. Questo metodo restituisce un BLOB oggetto contenente un documento PDF non protetto.
  5. Salvare il documento PDF non protetto.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF non protetto.
    • Creare un array di byte che memorizza il contenuto dei dati dell' BLOB oggetto restituito dal removePolicySecurity metodo. Compilare l'array di byte ottenendo il valore del campo dell' BLOB oggetto MTOM .
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Rimozione di un criterio da un documento PDF tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Rimozione di un criterio da un documento PDF tramite l'API del servizio Web"
Consulta anche

Revoca dell'accesso ai documenti

È possibile revocare l'accesso a un documento PDF protetto tramite criterio in modo che tutte le copie del documento non siano accessibili agli utenti. Quando un utente tenta di aprire un documento PDF revocato, viene reindirizzato a un URL specificato in cui è possibile visualizzare un documento modificato. È necessario specificare a livello di programmazione l'URL al quale l'utente viene reindirizzato. Quando revocate l'accesso a un documento, la modifica ha effetto alla successiva sincronizzazione dell'utente con il servizio Document Security aprendo il documento protetto tramite criterio online.
La capacità di revocare l'accesso a un documento offre ulteriore protezione. Ad esempio, si supponga che sia disponibile una versione più recente di un documento e che non si desideri più che qualcuno visualizzi la versione obsoleta. In questa situazione, l'accesso al documento precedente può essere revocato e nessuno può visualizzare il documento a meno che l'accesso non venga ripristinato.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per revocare un documento protetto tramite criterio, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Recuperare un documento PDF protetto tramite criterio.
  4. Revoca del documento protetto tramite criterio.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security.
Recupero di un documento PDF protetto tramite criterio
È necessario recuperare un documento PDF protetto tramite criterio per revocarlo. Non è possibile revocare un documento già revocato o non protetto tramite criterio.
Se si conosce il valore dell'identificatore di licenza del documento protetto tramite criterio, non è necessario recuperare il documento PDF protetto tramite criterio. Tuttavia, nella maggior parte dei casi, è necessario recuperare il documento PDF per ottenere il valore dell'identificatore di licenza.
Revoca del documento protetto tramite criterio
Per revocare un documento protetto tramite criterio, specificate l'identificatore di licenza del documento protetto tramite criterio. Inoltre, è possibile specificare l'URL di un documento che l'utente può visualizzare quando cerca di aprire il documento revocato. Si supponga quindi che venga revocato un documento obsoleto. Quando un utente tenta di aprire il documento revocato, visualizzerà un documento aggiornato invece del documento revocato.
Se si tenta di revocare un documento già revocato, viene generata un'eccezione.
Consulta anche

Revoca l'accesso ai documenti tramite l'API Java

Revocare l'accesso a un documento PDF protetto tramite criterio utilizzando l'API Document Security (Java):
  1. Includi file di progetto
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto API client Document Security
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un DocumentSecurityClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recupero di un documento PDF protetto tramite criterio
    • Creare un java.io.FileInputStream oggetto che rappresenti il documento PDF protetto tramite criterio utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Revoca del documento protetto tramite criterio
    • Creare un DocumentManager oggetto richiamando il DocumentSecurityClient metodo dell' getDocumentManager oggetto.
    • Recuperare il valore dell'identificatore di licenza del documento protetto tramite criterio richiamando il DocumentManager metodo dell' getLicenseId oggetto. Passa l' com.adobe.idp.Document oggetto che rappresenta il documento protetto tramite criterio. Questo metodo restituisce un valore di stringa che rappresenta il valore dell’identificatore di licenza.
    • Creare un LicenseManager oggetto richiamando il DocumentSecurityClient metodo dell' getLicenseManager oggetto.
    • Revocare il documento protetto tramite criterio richiamando il metodo dell' LicenseManager oggetto revokeLicense e passando i seguenti valori:
      • Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito dal DocumentManager metodo dell' getLicenseId oggetto).
      • Un membro di dati statici dell' License interfaccia che specifica il motivo della revoca del documento. Ad esempio, potete specificare License.DOCUMENT_REVISED .
      • Un java.net.URL valore che specifica la posizione in cui si trova il documento rivisto. Se non desiderate reindirizzare un utente a un altro URL, potete passare null .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (modalità SOAP): Revoca di un documento tramite l'API Java"

Revoca dell'accesso ai documenti tramite l'API del servizio Web

Revocare l'accesso a un documento PDF protetto tramite criterio utilizzando l'API di Document Security (servizio Web):
  1. Includi file di progetto
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto API client Document Security
    • Creare un DocumentSecurityServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un DocumentSecurityServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recupero di un documento PDF protetto tramite criterio
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF protetto tramite criterio revocato.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF protetto tramite criterio da revocare e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Revoca del documento protetto tramite criterio
    • Recuperare il valore dell'identificatore di licenza del documento protetto tramite criterio richiamando il DocumentSecurityServiceClient metodo dell' getLicenseID oggetto e passando l' BLOB oggetto che rappresenta il documento protetto tramite criterio. Questo metodo restituisce un valore di stringa che rappresenta l’identificatore della licenza.
    • Revocare il documento protetto tramite criterio richiamando il metodo dell' DocumentSecurityServiceClient oggetto revokeLicense e passando i seguenti valori:
      • Valore stringa che specifica il valore dell'identificatore di licenza del documento protetto tramite criterio (specificare il valore restituito dal DocumentSecurityServiceService metodo dell' getLicenseId oggetto).
      • Un membro di dati statici dell' Reason enum che specifica il motivo della revoca del documento. Ad esempio, potete specificare Reason.DOCUMENT_REVISED .
      • Un string valore che specifica la posizione dell'URL in cui si trova il documento rivisto. Se non desiderate reindirizzare un utente a un altro URL, potete passare null .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Revoca di un documento tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Revoca di un documento tramite l'API del servizio Web"
Consulta anche

Ripristino dell'accesso ai documenti revocati

È possibile ripristinare l'accesso a un documento PDF revocato, in modo che tutte le copie del documento revocato siano accessibili agli utenti. Quando un utente apre un documento ripristinato revocato, può visualizzare il documento.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per ripristinare l'accesso a un documento PDF revocato, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Recuperare l'identificatore di licenza del documento PDF revocato.
  4. Ripristinare l'accesso al documento PDF revocato.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un DocumentSecurityClient oggetto. Se utilizzate l'API del servizio Web di Document Security, create un DocumentSecurityServiceService oggetto.
Recuperare l'identificatore di licenza del documento PDF revocato
Per ripristinare un documento PDF revocato, è necessario recuperare l’identificatore di licenza del documento PDF revocato. Dopo aver ottenuto il valore dell'identificatore di licenza, potete ripristinare un documento revocato. Se si tenta di ripristinare un documento che non viene revocato, verrà generata un'eccezione.
Ripristino dell'accesso al documento PDF revocato
Per ripristinare l'accesso a un documento PDF revocato, è necessario specificare l'identificatore di licenza del documento revocato. Se si tenta di ripristinare l'accesso a un documento PDF non revocato, si verificherà un'eccezione.
Consulta anche

Ripristino dell'accesso ai documenti revocati tramite l'API Java

Ripristinate l'accesso a un documento revocato utilizzando l'API Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un DocumentSecurityClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperare l'identificatore di licenza del documento PDF revocato.
    • Creare un java.io.FileInputStream oggetto che rappresenta il documento PDF revocato utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
    • Creare un DocumentManager oggetto richiamando il DocumentSecurityClient metodo dell' getDocumentManager oggetto.
    • Recuperare il valore dell'identificatore di licenza del documento revocato richiamando il metodo dell' DocumentManager oggetto getLicenseId e passando l' com.adobe.idp.Document oggetto che rappresenta il documento revocato. Questo metodo restituisce un valore di stringa che rappresenta l’identificatore della licenza.
  4. Ripristinare l'accesso al documento PDF revocato.
    • Creare un LicenseManager oggetto richiamando il DocumentSecurityClient metodo dell' getLicenseManager oggetto.
    • Ripristinare l'accesso al documento PDF revocato richiamando il metodo dell' LicenseManager oggetto unrevokeLicense e passando il valore dell'identificatore di licenza del documento revocato.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (modalità SOAP): Ripristino dell'accesso a un documento revocato tramite l'API del servizio Web"

Ripristino dell'accesso ai documenti revocati tramite l'API del servizio Web

Ripristinate l'accesso a un documento revocato utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un DocumentSecurityServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un DocumentSecurityServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperare l'identificatore di licenza del documento PDF revocato.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF revocato al quale viene ripristinato l'accesso.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta il percorso del file del documento PDF revocato e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Ripristinare l'accesso al documento PDF revocato.
    • Recuperare il valore dell'identificatore di licenza del documento revocato richiamando il metodo dell' DocumentSecurityServiceClient oggetto getLicenseID e passando l' BLOB oggetto che rappresenta il documento revocato. Questo metodo restituisce un valore di stringa che rappresenta l’identificatore della licenza.
    • Ripristinare l'accesso al documento PDF revocato richiamando il metodo dell' DocumentSecurityServiceClient oggetto unrevokeLicense e passando un valore stringa che specifica il valore dell'identificatore di licenza del documento PDF revocato (passare il valore restituito dal metodo dell' DocumentSecurityServiceClient oggetto getLicenseId ).
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Ripristino dell'accesso a un documento revocato tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Ripristino dell'accesso a un documento revocato tramite l'API del servizio Web"
Consulta anche

Verifica dei documenti PDF protetti tramite criterio

Potete utilizzare l'API di Document Security Service (Java e il servizio Web) per ispezionare i documenti PDF protetti tramite criterio. L'ispezione dei documenti PDF protetti tramite criterio restituisce informazioni sul documento PDF protetto tramite criterio. Ad esempio, è possibile determinare il criterio utilizzato per proteggere il documento e la data in cui il documento è stato protetto.
Non è possibile eseguire questa operazione se la versione di LiveCycle in uso è 8.x o precedente. In AEM Forms è stato aggiunto il supporto per l'ispezione di documenti protetti tramite criterio. Se si tenta di esaminare un documento protetto tramite criterio utilizzando LiveCycle 8.x (o versioni precedenti), viene generata un'eccezione.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per esaminare un documento PDF protetto tramite criterio, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Recuperare un documento protetto tramite criterio da esaminare.
  4. Ottenete informazioni sul documento protetto tramite criterio.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un RightsManagementClient oggetto. Se utilizzate l'API del servizio Web di Document Security, create un RightsManagementServiceService oggetto.
Recuperare un documento protetto tramite criterio da esaminare
Per esaminare un documento protetto tramite criterio, recuperatelo. Se tentate di ispezionare un documento non protetto con un criterio o revocato, viene generata un'eccezione.
Ispezionare il documento
Dopo aver recuperato un documento protetto tramite criterio, potete controllarlo.
Ottenere informazioni sul documento protetto tramite criterio
Dopo aver esaminato un documento PDF protetto tramite criterio, potete ottenere informazioni su di esso. Ad esempio, è possibile determinare il criterio utilizzato per proteggere il documento.
Se si protegge un documento con un criterio che appartiene a Criteri personali e quindi si chiama RMInspectResult.getPolicysetName o RMInspectResult.getPolicysetId , viene restituito null.
Se il documento è protetto tramite un criterio contenuto in un set di criteri (diverso da Criteri personali), RMInspectResult.getPolicysetName e RMInspectResult.getPolicysetId restituisce stringhe valide.
Consulta anche

Inspect Policy Protected PDF Documents using Java API

Esaminate un documento PDF protetto tramite criterio utilizzando l'API di Document Security Service (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, consultate Inclusione di file libreria Java AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione. (Vedere Impostazione delle proprietà di connessione.)
    • Creare un RightsManagementClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperare un documento protetto tramite criterio da esaminare.
    • Creare un java.io.FileInputStream oggetto che rappresenti il documento PDF protetto tramite criterio utilizzando il relativo costruttore. Passa un valore di stringa che specifica la posizione del documento PDF.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Esaminare il documento.
    • Creare un DocumentManager oggetto richiamando il RightsManagementClient metodo dell' getDocumentManager oggetto.
    • Esaminare il documento protetto tramite criterio richiamando il LicenseManager metodo dell' inspectDocument . Passa l' com.adobe.idp.Document oggetto che contiene il documento PDF protetto tramite criterio. Questo metodo restituisce un RMInspectResult oggetto che contiene informazioni sul documento protetto tramite criterio.
  5. Ottenete informazioni sul documento protetto tramite criterio.
    Per ottenere informazioni sul documento protetto tramite criterio, richiamare il metodo appropriato che appartiene all' RMInspectResult oggetto. Ad esempio, per recuperare il nome del criterio, richiamare il metodo dell' RMInspectResult oggetto getPolicyName .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (modalità SOAP): Ispezione dei documenti PDF protetti tramite criterio tramite l'API Java"

Inspect Policy Protected PDF Documents using the web service API

Esaminate un documento PDF protetto tramite criterio utilizzando l'API di Document Security Service (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un RightsManagementServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un RightsManagementServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperare un documento protetto tramite criterio da esaminare.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF da esaminare.
    • Creare un System.IO.FileStream oggetto richiamandone il costruttore. Passare un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream oggetto Read . Trasmettere l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Esaminare il documento.
    Esaminare il documento protetto tramite criterio richiamando il RightsManagementServiceClient metodo dell' inspectDocument . Passa l' BLOB oggetto che contiene il documento PDF protetto tramite criterio. Questo metodo restituisce un RMInspectResult oggetto che contiene informazioni sul documento protetto tramite criterio.
  5. Ottenete informazioni sul documento protetto tramite criterio.
    Per ottenere informazioni sul documento protetto tramite criterio, ottenere il valore del campo appropriato che appartiene all' RMInspectResult oggetto. Ad esempio, per recuperare il nome del criterio, ottenere il valore del campo dell' RMInspectResult oggetto policyName .
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Ispezione dei documenti PDF protetti tramite criterio tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Ispezione dei documenti PDF protetti tramite criterio tramite l'API del servizio Web"
Consulta anche

Creazione di filigrane

Le filigrane garantiscono la sicurezza di un documento identificando in modo univoco il documento e controllando la violazione del copyright. Ad esempio, è possibile creare e inserire una filigrana con l'indicazione Riservato su tutte le pagine di un documento. Dopo la creazione di una filigrana, potete includerla come parte di un criterio. In altre parole, potete impostare l'attributo della filigrana del criterio con la filigrana appena creata. Dopo che un criterio contenente una filigrana è stato applicato a un documento, la filigrana viene visualizzata nel documento protetto tramite criterio.
Le filigrane possono essere create solo dagli utenti con privilegi di amministratore Document Security. È quindi necessario specificare tale utente quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per creare una filigrana, effettuate le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Impostare gli attributi delle filigrane.
  4. Registra la filigrana con il servizio Document Security.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un RightsManagementClient oggetto. Se utilizzate l'API del servizio Web di Document Security, create un RightsManagementServiceService oggetto.
Impostare gli attributi delle filigrane
Per creare una nuova filigrana, è necessario impostare gli attributi della filigrana. L'attributo name deve sempre essere definito. Oltre all'attributo name, è necessario impostare almeno uno dei seguenti attributi:
  • Testo personalizzato
  • DateIncluso
  • UserIdInclused
  • NomeUtenteIncluso
Nella tabella seguente sono elencate le coppie chiave-valore richieste per la creazione di una filigrana tramite i servizi Web.
Nome chiave
Descrizione
Valore
WaterBackCmd:IS_USERNAME_ENABLED
Specifica se il nome utente dell'utente che apre il documento fa parte della filigrana.
True o False
WaterBackCmd:IS_USERID_ENABLED
Specifica se l'identificazione dell'utente che apre il documento fa parte della filigrana.
True o False
WaterBackCmd:IS_CURRENTDATE_ENABLED
Specifica se la data corrente fa parte della filigrana.
True o False
WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Se questo valore è true, il valore del testo personalizzato deve essere specificato utilizzando WaterBackCmd:SRCTEXT .
True o False
WaterBackCmd:OPACITY
Specifica l’opacità della filigrana. Il valore predefinito è 0,5 se non è specificato.
Un valore compreso tra 0,0 e 1,0.
WaterBackCmd:ROTATION
Specifica la rotazione della filigrana. Il valore predefinito è 0 gradi.
Un valore compreso tra 0 e 359.
WaterBackCmd:SCALE
Se questo valore è specificato, WaterBackCmd:IS_SIZE_ENABLED deve essere presente e il valore deve essere true. Se questo attributo non è specificato, il comportamento predefinito è adatto alla pagina.
Un valore maggiore di 0.0 e inferiore o uguale a 1.0.
WaterBackCmd:HORIZ_ALIGN
Specifica l'allineamento orizzontale della filigrana. Il valore predefinito è center.
a sinistra, al centro o a destra
WaterBackCmd:VERT_ALIGN
Specifica l'allineamento verticale della filigrana. Il valore predefinito è center.
top, center o bottom
WaterBackCmd:IS_USE_BACKGROUND
Specifica se la filigrana è uno sfondo. Il valore predefinito è false.
True o False
WaterBackCmd:IS_SIZE_ENABLED
True se viene specificata una scala personalizzata. Se questo valore è true, è necessario specificare anche SCALE. Se questo valore è false, il valore predefinito è adatto alla pagina.
True o False
WaterBackCmd:SRCTEXT
Specifica il testo personalizzato per una filigrana. Se questo valore è presente, WaterBackCmd:IS_CUSTOMTEXT_ENABLED deve essere presente e impostato su true.
True o False
Tutte le filigrane devono avere uno dei seguenti attributi definiti:
  • WaterBackCmd:IS_USERNAME_ENABLED
  • WaterBackCmd:IS_USERID_ENABLED
  • WaterBackCmd:IS_CURRENTDATE_ENABLED
  • WaterBackCmd:IS_CUSTOMTEXT_ENABLED
Tutti gli altri attributi sono facoltativi.
Registrazione della filigrana
Prima di poter essere utilizzata, è necessario registrare una nuova filigrana con il servizio Document Security. Dopo aver registrato una filigrana, è possibile utilizzarla all'interno dei criteri.
Consulta anche

Creare filigrane tramite l'API Java

Create una filigrana utilizzando l'API di Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar , nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un RightsManagementClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Impostare gli attributi della filigrana
    • Creare un Watermark oggetto richiamando il InfomodelObjectFactory metodo statico dell'oggetto createWatermark . Questo metodo restituisce un Watermark oggetto.
    • Impostate l'attributo nome della filigrana richiamando il metodo dell' Watermark setName oggetto e passando un valore di stringa che specifica il nome del criterio.
    • Impostare l'attributo di sfondo della filigrana richiamando il metodo dell' Watermark oggetto setBackground e passando true . Impostando questo attributo, la filigrana viene visualizzata sullo sfondo del documento.
    • Impostare l'attributo di testo personalizzato della filigrana richiamando il metodo dell' Watermark oggetto setCustomText e passando un valore di stringa che rappresenta il testo della filigrana.
    • Impostare l'attributo di opacità della filigrana richiamando il metodo dell' Watermark setOpacity oggetto e passando un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che la filigrana è completamente trasparente.
  4. Registra la filigrana.
    • Creare un WatermarkManager oggetto richiamando il RightsManagementClient metodo dell' getWatermarkManager oggetto. Questo metodo restituisce un WatermarkManager oggetto.
    • Registrare la filigrana richiamando il metodo dell' WatermarkManager oggetto registerWatermark e passando l'oggetto Watermark che rappresenta la filigrana da registrare. Questo metodo restituisce un valore di stringa che rappresenta il valore di identificazione della filigrana.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (modalità SOAP): Creazione di una filigrana mediante l'API Java"

Creare filigrane mediante l'API del servizio Web

Create una filigrana utilizzando l'API di Document Security (servizio Web):
  1. Creare un oggetto Document Security Client API.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un RightsManagementServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un RightsManagementServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Impostate gli attributi della filigrana.
    • Creare un WatermarkSpec oggetto richiamando il WatermarkSpec costruttore.
    • Impostare il nome della filigrana assegnando un valore di stringa al membro dati dell' WatermarkSpec oggetto name .
    • Impostare l'attributo della id filigrana assegnando un valore di stringa al membro di dati dell' WatermarkSpec oggetto id .
    • Per ogni proprietà della filigrana da impostare, creare un MyMapOf_xsd_string_To_xsd_anyType_Item oggetto separato.
    • Impostare il valore chiave assegnando un valore al membro MyMapOf_xsd_string_To_xsd_anyType_Item dati dell' key oggetto (ad esempio, WaterBackCmd:OPACITY) ).
    • Impostare il valore assegnando un valore al membro MyMapOf_xsd_string_To_xsd_anyType_Item dati dell'oggetto (ad esempio, value .25 ).
    • Create a MyArrayOf_xsd_anyType object. Per ciascun MyMapOf_xsd_string_To_xsd_anyType_Item oggetto, richiamare il MyArrayOf_xsd_anyType metodo dell' Add . Passate l' MyMapOf_xsd_string_To_xsd_anyType_Item oggetto.
    • Assegnare l' MyArrayOf_xsd_anyType oggetto al membro dati dell' WatermarkSpec oggetto values .
  4. Registra la filigrana.
    Registrare la filigrana richiamando il metodo dell' RightsManagementServiceClient oggetto registerWatermark e passando l'oggetto WatermarkSpec che rappresenta la filigrana da registrare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate i seguenti esempi di avvio rapido:
  • "Avvio rapido (MTOM): Creazione di una filigrana mediante l'API del servizio Web"
  • "Avvio rapido (SwaRef): Creazione di una filigrana mediante l'API del servizio Web"
Consulta anche

Modifica delle filigrane

Potete modificare una filigrana esistente utilizzando l'API Java di Document Security o l'API del servizio Web. Per apportare modifiche a una filigrana esistente, recuperarla, modificarne gli attributi e quindi aggiornarla sul server. Ad esempio, supponete di recuperare una filigrana e modificarne l’attributo di opacità. Prima che la modifica abbia effetto, è necessario aggiornare la filigrana.
Quando modificate una filigrana, la modifica ha effetto sui documenti futuri a cui è applicata la filigrana. In altre parole, i documenti PDF esistenti contenenti la filigrana non vengono modificati.
Le filigrane possono essere modificate solo dagli utenti con diritti di amministratore di Document Security. È quindi necessario specificare tale utente quando si definiscono le impostazioni di connessione necessarie per creare un oggetto client del servizio Document Security.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per modificare una filigrana, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Recuperate la filigrana da modificare.
  4. Impostare gli attributi delle filigrane.
  5. Aggiorna la filigrana.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security. Se utilizzate l'API Java, create un DocumentSecurityClient oggetto. Se utilizzate l'API del servizio Web di Document Security, create un DocumentSecurityServiceService oggetto.
Recuperare la filigrana da modificare
Per modificare una filigrana, è necessario recuperare una filigrana esistente. È possibile recuperare una filigrana specificandone il nome o il valore identificativo.
Impostare gli attributi delle filigrane
Per modificare una filigrana esistente, modificate il valore di uno o più attributi della filigrana. Quando si aggiorna una filigrana a livello di programmazione utilizzando un servizio Web, è necessario impostare tutti gli attributi impostati originariamente, anche se il valore non cambia. Ad esempio, si supponga che siano impostati i seguenti attributi di filigrana: WaterBackCmd:IS_USERID_ENABLED , WaterBackCmd:IS_CUSTOMTEXT_ENABLED , WaterBackCmd:OPACITY e WaterBackCmd:SRCTEXT . Anche se l'unico attributo che si desidera modificare è WaterBackCmd:OPACITY , è necessario impostare gli altri valori.
Quando utilizzate l'API Java per modificare una filigrana, non è necessario specificare tutti gli attributi. Impostate l’attributo della filigrana da modificare.
Per informazioni sui nomi degli attributi delle filigrane, consultate Creazione di filigrane .
Aggiornare la filigrana
Dopo aver modificato gli attributi di una filigrana, è necessario aggiornare la filigrana.
Consulta anche

Modificare le filigrane mediante l'API Java

Modificare una filigrana utilizzando l'API di Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un DocumentSecurityClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperate la filigrana da modificare.
    Creare un WatermarkManager oggetto richiamando il DocumentSecurityClient metodo dell' getWatermarkManager oggetto e passando un valore di stringa che specifica il nome della filigrana. Questo metodo restituisce un Watermark oggetto che rappresenta la filigrana da modificare.
  4. Impostate gli attributi della filigrana.
    Impostare l'attributo di opacità della filigrana richiamando il metodo dell' Watermark setOpacity oggetto e passando un valore intero che specifica il livello di opacità. Il valore 100 indica che la filigrana è completamente opaca e il valore 0 indica che la filigrana è completamente trasparente.
    In questo esempio viene modificato solo l’attributo opacità.
  5. Aggiorna la filigrana.
    • Aggiornare la filigrana richiamando il metodo dell' WatermarkManager oggetto updateWatermark Watermark e passando l'oggetto il cui attributo è stato modificato.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate Avvio rapido (modalità SOAP): Modifica di una filigrana tramite la sezione Java API.

Modificare le filigrane mediante l'API del servizio Web

Modificare una filigrana utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un DocumentSecurityServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un RightsManagementServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperate la filigrana da modificare.
    Recuperare la filigrana da modificare richiamando il metodo dell' DocumentSecurityServiceClient oggetto getWatermarkByName . Passa un valore di stringa che specifica il nome della filigrana. Questo metodo restituisce un WatermarkSpec oggetto che rappresenta la filigrana da modificare.
  4. Impostate gli attributi della filigrana.
    • Per ogni proprietà della filigrana da aggiornare, creare un MyMapOf_xsd_string_To_xsd_anyType_Item oggetto separato.
    • Impostare il valore chiave assegnando un valore al membro MyMapOf_xsd_string_To_xsd_anyType_Item dati dell' key oggetto (ad esempio, WaterBackCmd:OPACITY) ).
    • Impostare il valore assegnando un valore al membro MyMapOf_xsd_string_To_xsd_anyType_Item dati dell'oggetto (ad esempio, value .50 ).
    • Create a MyArrayOf_xsd_anyType object. Per ciascun MyMapOf_xsd_string_To_xsd_anyType_Item oggetto, richiamare il MyArrayOf_xsd_anyType metodo dell' Add . Passate l' MyMapOf_xsd_string_To_xsd_anyType_Item oggetto.
    • Assegnare l' MyArrayOf_xsd_anyType oggetto al membro dati dell' WatermarkSpec oggetto values .
  5. Aggiorna la filigrana.
    Aggiornare la filigrana richiamando il metodo dell' DocumentSecurityServiceClient oggetto updateWatermark e passando l' WatermarkSpec oggetto che rappresenta la filigrana da modificare.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente Guida rapida:
  • "Avvio rapido (MTOM): Modifica di una filigrana mediante l'API del servizio Web"

Ricerca di eventi

Il servizio Rights Management tiene traccia delle azioni specifiche eseguite, ad esempio l'applicazione di un criterio a un documento, l'apertura di un documento protetto tramite criterio e la revoca dell'accesso ai documenti. Il controllo degli eventi deve essere abilitato per il servizio Rights Management o gli eventi non vengono tracciati.
Gli eventi rientrano in una delle seguenti categorie:
  • Gli eventi di amministratore sono azioni correlate a un amministratore, ad esempio la creazione di un nuovo account di amministratore.
  • Gli eventi del documento sono azioni correlate a un documento, ad esempio la chiusura di un documento protetto tramite criterio.
  • Gli eventi dei criteri sono azioni correlate a un criterio, ad esempio la creazione di un nuovo criterio.
  • Gli eventi di servizio sono azioni relative al servizio Rights Management, ad esempio la sincronizzazione con la directory dell'utente.
Potete cercare eventi specifici utilizzando l'API Java di Rights Management o l'API del servizio Web. Cercando gli eventi, è possibile eseguire attività quali la creazione di un file di registro di determinati eventi.
Per ulteriori informazioni sul servizio Rights Management, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per cercare un evento Rights Management, effettuate le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Rights Management Client API.
  3. Specificate l'evento per il quale eseguire la ricerca.
  4. Cercate l’evento.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto Rights Management Client API
Prima di poter eseguire un'operazione del servizio Rights Management in modo programmatico, dovete creare un oggetto client del servizio Rights Management. Se utilizzate l'API Java, create un DocumentSecurityClient oggetto. Se utilizzate l'API del servizio Web Rights Management, create un DocumentSecurityServiceService oggetto.
Specificare gli eventi da cercare
È necessario specificare l'evento da cercare. Ad esempio, è possibile cercare l'evento policy create, che si verifica quando viene creato un nuovo criterio.
Ricerca dell’evento
Dopo aver specificato l'evento da cercare, potete utilizzare l'API Java di Rights Management o l'API del servizio Web di Rights Management per cercare l'evento.
Consulta anche

Cercare eventi utilizzando l'API Java

Cercate gli eventi utilizzando l'API Rights Management (Java):
  1. Includi file di progetto
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Rights Management Client API
    Creare un DocumentSecurityClient oggetto utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto che contiene le proprietà di connessione.
  3. Specificare gli eventi da cercare
    • Creare un EventManager oggetto richiamando il DocumentSecurityClient metodo dell' getEventManager oggetto. Questo metodo restituisce un EventManager oggetto.
    • Creare un EventSearchFilter oggetto richiamandone il costruttore.
    • Specificare l'evento per il quale eseguire la ricerca richiamando il metodo dell' EventSearchFilter oggetto setEventCode e passando un membro di dati statici appartenente alla EventManager classe che rappresenta l'evento per il quale eseguire la ricerca. Ad esempio, per cercare l'evento di creazione del criterio, passare EventManager.POLICY_CREATE_EVENT .
    È possibile definire criteri di ricerca aggiuntivi richiamando metodi EventSearchFilter oggetto. Ad esempio, richiamare il setUserName metodo per specificare un utente associato all'evento.
  4. Ricerca dell’evento
    Cercare l'evento richiamando il metodo dell' EventManager oggetto searchForEvents e passando l'oggetto EventSearchFilter che definisce i criteri di ricerca dell'evento. Questo metodo restituisce un array di Event oggetti.
Esempi di codice
Per esempi di codice che utilizzano il servizio Rights Management, consultate le seguenti Guide rapide:
  • "Avvio rapido (SOAP): Ricerca di eventi tramite l'API Java"

Cercare eventi utilizzando l'API del servizio Web

Cercare eventi utilizzando l'API Rights Management (servizio Web):
  1. Includi file di progetto
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Rights Management Client API
    • Creare un DocumentSecurityServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un DocumentSecurityServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Specificare gli eventi da cercare
    • Creare un EventSpec oggetto utilizzando il relativo costruttore.
    • Specificare l'inizio del periodo di tempo durante il quale si è verificato l'evento impostando il membro EventSpec dati dell'oggetto con firstTime.date DataTime l'istanza che rappresenta l'inizio dell'intervallo di date in cui si è verificato l'evento.
    • Assegnare il valore true al membro dati dell' EventSpec oggetto firstTime.dateSpecified .
    • Specificare la fine del periodo di tempo durante il quale si è verificato l'evento impostando il membro EventSpec dati dell'oggetto con lastTime.date DataTime l'istanza che rappresenta la fine dell'intervallo di date in cui si è verificato l'evento.
    • Assegnare il valore true al membro dati dell' EventSpec oggetto lastTime.dateSpecified .
    • Impostare l'evento da cercare assegnando un valore stringa al membro dati dell' EventSpec oggetto eventCode . Nella tabella seguente sono elencati i valori numerici che è possibile assegnare a questa proprietà:
    Tipo evento
    Valore
    ALL_EVENTS
    999
    USER_CHANGE_PASSWORD_EVENT
    1000
    USER_REGISTER_EVENT
    1001
    USER_PREREGISTER_EVENT
    1002
    USER_ACTIVATE_EVENT
    1003
    USER_DEACTIVATE_EVENT
    1004
    USER_AUTHENTICATE_EVENT
    1005
    USER_AUTHENTICATE_DENY_EVENT
    1006
    USER_ACCOUNT_LOCK_EVENT
    1007
    USER_DELETE_EVENT
    1008
    USER_UPDATE_PROFILE_EVENT
    1009
    DOCUMENT_VIEW_EVENT
    2000
    DOCUMENT_PRINT_LOW_EVENT
    2001
    DOCUMENT_PRINT_HIGH_EVENT
    2002
    DOCUMENT_SIGN_EVENT
    2003
    DOCUMENT_ADD_ANNOTATION_EVENT
    2004
    DOCUMENT_FORM_FILL_EVENT
    2005
    DOCUMENT_CLOSE_EVENT
    2006
    DOCUMENT_MODIFY_EVENT
    2007
    DOCUMENT_CHANGE_SECURITY_HANDLER_EVENT
    2008
    DOCUMENT_SWITCH_POLICY_EVENT
    2009
    DOCUMENT_REVOKE_EVENT
    2010
    $1
    2011
    DOCUMENT_SECURE_EVENT
    2012
    DOCUMENT_UNKNOWN_CLIENT_EVENT
    2013
    DOCUMENT_CHANGE_REVOKE_URL_EVENT
    2014
    POLICY_CHANGE_EVENT
    3000
    POLICY_ENABLE_EVENT
    3001
    POLICY_DISABLE_EVENT
    3002
    POLICY_CREATE_EVENT
    3003
    POLICY_DELETE_EVENT
    3004
    POLICY_CHANGE_OWNER_EVENT
    3005
    SERVER_CLIENT_SYNC_EVENT
    4000
    SERVER_SYNC_DIR_INFO_EVENT
    4001
    SERVER_SYNC_DIR_COMPLETE_EVENT
    4002
    SERVER_VERSION_MISMATCH_EVENT
    4003
    SERVER_CONFIG_CHANGE_EVENT
    4004
    SERVER_ENABLE_OFFLINE_ACCESS_EVENT
    4005
    ADMIN_ADD_EVENT
    5000
    ADMIN_DELETE_EVENT
    5001
    ADMIN_EDIT_EVENT
    5002
    ADMIN_ACTIVATE_EVENT
    5003
    ADMIN_DEACTIVATE_EVENT
    5004
    ERROR_DIRECTORY_SERVICE_EVENT
    6000
    CREATED_POLICYSET_EVENT
    7000
    DELETED_POLICYSET_EVENT
    7001
    MODIFIED_POLICYSET_EVENT
    7002
  4. Ricerca dell’evento
    Cercare l'evento richiamando il metodo dell' DocumentSecurityServiceClient oggetto searchForEvents e passando l'oggetto EventSpec che rappresenta l'evento per il quale eseguire la ricerca e il numero massimo di risultati. Questo metodo restituisce una MyArrayOf_xsd_anyType raccolta in cui ogni elemento è un' AuditSpec istanza. Utilizzando un' AuditSpec istanza, potete ottenere informazioni sull'evento, ad esempio l'ora in cui si è verificato. L' AuditSpec istanza contiene un membro timestamp dati che specifica queste informazioni.
Esempi di codice
Per esempi di codice che utilizzano il servizio Rights Management, consultate le seguenti Guide rapide:
  • "Avvio rapido (MTOM): Ricerca di eventi tramite l'API del servizio Web"
  • "Avvio rapido (SwaRef): Ricerca di eventi tramite l'API del servizio Web"
Consulta anche

Applicazione dei criteri ai documenti Word

Oltre ai documenti PDF, il servizio Rights Management supporta anche formati di documenti aggiuntivi, ad esempio documenti Microsoft Word (DOC) e altri formati di file Microsoft Office. Ad esempio, è possibile applicare un criterio a un documento Word per proteggerlo. Applicando un criterio a un documento Word, si limita l'accesso al documento. Non è possibile applicare un criterio a un documento se il documento è già protetto con un criterio.
È possibile monitorare l'utilizzo di un documento Word protetto tramite criterio dopo averlo distribuito. In altre parole, potete vedere come viene utilizzato il documento e chi lo sta utilizzando. Ad esempio, è possibile verificare quando un utente ha aperto il documento.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per applicare un criterio a un documento di Word, effettuare le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un oggetto Document Security Client API.
  3. Recuperare un documento Word a cui viene applicato un criterio.
  4. Applicare un criterio esistente al documento Word.
  5. Salvare il documento Word protetto tramite criterio.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, è necessario creare un oggetto client del servizio Document Security.
Recupero di un documento di Word
Per applicare un criterio è necessario recuperare un documento Word. Dopo aver applicato un criterio al documento Word, gli utenti possono utilizzare il documento con restrizioni. Ad esempio, se il criterio non consente l'apertura del documento offline, gli utenti devono essere online per aprire il documento.
Applicare un criterio esistente al documento Word
Per applicare un criterio a un documento Word, è necessario fare riferimento a un criterio esistente e specificare a quale set di criteri appartiene il criterio. L'utente che sta impostando le proprietà di connessione deve avere accesso al criterio specificato. In caso contrario, si verifica un'eccezione.
Salvare il documento Word
Dopo che il servizio Document Security applica un criterio a un documento Word, potete salvare il documento Word protetto tramite criterio come file DOC.
Consulta anche

Applicazione di un criterio a un documento Word tramite l'API Java

Applicate un criterio a un documento Word utilizzando l'API Document Security (Java):
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Document Security Client API.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un DocumentSecurityClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperare un documento Word.
    • Creare un java.io.FileInputStream oggetto che rappresenta il documento Word utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento Word.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Applicare un criterio esistente al documento Word.
    • Creare un DocumentManager oggetto richiamando il DocumentSecurityClient metodo dell' getDocumentManager oggetto.
    • Applicare un criterio al documento Word richiamando il metodo dell' DocumentManager oggetto protectDocument e passando i seguenti valori:
      • L' com.adobe.idp.Document oggetto che contiene il documento Word a cui viene applicato il criterio.
      • Una stringa che specifica il nome del documento.
      • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Potete specificare un null valore che determina l'utilizzo del set di MyPolicies criteri.
      • Una stringa che specifica il nome del criterio.
      • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore successivo del parametro deve essere null).
      • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere null (se questo parametro è null , il valore del parametro precedente deve essere null ).
      • Un com.adobe.livecycle.rightsmanagement.Locale che rappresenta le impostazioni internazionali utilizzate per selezionare il modello di MS Office. Questo valore del parametro è facoltativo ed è possibile specificarlo null .
      Il protectDocument metodo restituisce un RMSecureDocumentResult oggetto che contiene il documento Word protetto tramite criterio.
  5. Salvare il documento Word.
    • Richiamare il metodo dell' RMSecureDocumentResult oggetto getProtectedDoc per ottenere il documento Word protetto tramite criterio. Questo metodo restituisce un com.adobe.idp.Document oggetto.
    • Creare un java.io.File oggetto e assicurarsi che l'estensione del file sia DOC.
    • Richiamare il metodo dell' com.adobe.idp.Document oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal getProtectedDoc metodo).
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente Guida rapida:
  • "Avvio rapido (modalità SOAP): Applicazione di un criterio a un documento Word tramite l'API Java"

Applicazione di un criterio a un documento Word tramite l'API del servizio Web

Applicare un criterio a un documento Word utilizzando l'API di Document Security (servizio Web):
  1. Includere i file di progetto.
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/DocumentSecurityService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto Document Security Client API.
    • Creare un DocumentSecurityServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un DocumentSecurityServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DocumentSecurityService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del DocumentSecurityServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo DocumentSecurityServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo DocumentSecurityServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recuperare un documento Word.
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento Word a cui è applicato un criterio.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. Determinare la dimensione dell'array di byte ottenendo la System.IO.FileStream proprietà dell' Length oggetto.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream oggetto Read . Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Applicare un criterio esistente al documento Word.
    Applicare un criterio al documento Word richiamando il metodo dell' DocumentSecurityServiceClient oggetto protectDocument e passando i seguenti valori:
    • L' BLOB oggetto che contiene il documento Word a cui viene applicato il criterio.
    • Una stringa che specifica il nome del documento.
    • Un valore di stringa che specifica il nome dell'insieme di criteri a cui appartiene il criterio. Potete specificare un null valore che determina l'utilizzo del set di MyPolicies criteri.
    • Una stringa che specifica il nome del criterio.
    • Una stringa che rappresenta il nome del dominio di gestione utenti dell'utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro successivo deve essere null ).
    • Una stringa che rappresenta il nome del nome canonico dell'utente manager utente che è l'editore del documento. Questo valore del parametro è facoltativo e può essere nullo (se questo parametro è nullo, il valore del parametro precedente deve essere null ).
    • Un RMLocale valore che specifica il valore delle impostazioni internazionali (ad esempio, RMLocale.en ).
    • Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore del criterio.
    • Parametro di output della stringa utilizzato per memorizzare il valore dell'identificatore protetto tramite criterio.
    • Un parametro di output della stringa utilizzato per memorizzare il tipo mime (ad esempio, application/doc ).
    Il protectDocument metodo restituisce un BLOB oggetto che contiene il documento Word protetto tramite criterio.
  5. Salvare il documento Word.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento Word protetto tramite criterio.
    • Creare un array di byte che memorizza il contenuto dei dati dell' BLOB oggetto restituito dal protectDocument metodo. Compilare l'array di byte ottenendo il valore del membro BLOB dati dell' MTOM oggetto.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
    • Scrivere il contenuto dell'array di byte in un file Word richiamando il metodo dell' System.IO.BinaryWriter oggetto Write e passando l'array di byte.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente Guida rapida:
  • "Avvio rapido (MTOM): Applicazione di un criterio a un documento Word tramite l'API del servizio Web"

Rimozione di criteri dai documenti di Word

È possibile rimuovere un criterio da un documento Word protetto tramite criterio per rimuovere la protezione dal documento. Se non si desidera più che il documento sia protetto tramite un criterio. Se si desidera aggiornare un documento Word protetto tramite criterio con un criterio più recente, invece di rimuovere il criterio e aggiungere il criterio aggiornato, è più efficiente cambiare il criterio.
Per ulteriori informazioni sul servizio Document Security, consultate Riferimento servizi per AEM Forms .

Riepilogo dei passaggi

Per rimuovere un criterio da un documento Word protetto tramite criterio, effettuare le seguenti operazioni:
  1. Includi file di progetto
  2. Creare un oggetto Document Security Client API.
  3. Recuperare un documento Word protetto tramite criterio.
  4. Rimuovere il criterio dal documento Word.
  5. Salvare i documenti Word non protetti.s
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.
Creare un oggetto API client Document Security
Prima di eseguire un'operazione del servizio Document Security a livello di programmazione, create un oggetto client del servizio Document Security.
Recupero di un documento Word protetto tramite criterio
Per rimuovere un criterio è necessario recuperare un documento Word protetto tramite criterio. Se tentate di rimuovere un criterio da un documento di Word non protetto da un criterio, causerete un'eccezione.
Rimuovere il criterio dal documento Word
È possibile rimuovere un criterio da un documento Word protetto tramite criterio a condizione che nelle impostazioni di connessione sia specificato un amministratore. In caso contrario, il criterio utilizzato per proteggere un documento deve contenere l' SWITCH_POLICY autorizzazione per rimuovere un criterio da un documento Word. Inoltre, anche l'utente specificato nelle impostazioni di connessione di AEM Forms deve disporre di tale autorizzazione. In caso contrario, viene generata un'eccezione.
Salvare il documento Word non protetto
Dopo che il servizio Document Security rimuove un criterio da un documento Word, potete salvare il documento Word non protetto come file DOC.
Consulta anche

Rimozione di un criterio da un documento Word tramite l'API Java

Rimuovete un criterio da un documento Word protetto tramite criterio utilizzando l'API di Document Security (Java):
  1. Includi file di progetto
    Includete file JAR client, ad esempio adobe-rightsmanagement-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto API client Document Security
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un RightsManagementClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recupero di un documento Word protetto tramite criterio
    • Creare un java.io.FileInputStream oggetto che rappresenti il documento Word protetto tramite criterio utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento Word.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.
  4. Rimuovere il criterio dal documento Word
    • Creare un DocumentManager oggetto richiamando il RightsManagementClient metodo dell' getDocumentManager oggetto.
    • Rimuovere un criterio dal documento Word richiamando il DocumentManager metodo dell' removeSecurity oggetto e passando l' com.adobe.idp.Document oggetto che contiene il documento Word protetto tramite criterio. Questo metodo restituisce un com.adobe.idp.Document oggetto che contiene un documento Word non protetto.
  5. Salvare il documento Word non protetto
    • Creare un java.io.File oggetto e assicurarsi che l'estensione del file sia DOC.
    • Richiamare il metodo dell' Document oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal removeSecurity metodo).
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente Guida rapida:
  • "Avvio rapido (modalità SOAP): Rimozione di un criterio da un documento Word tramite l'API Java"

Rimozione di un criterio da un documento Word tramite l'API del servizio Web

Rimuovete un criterio da un documento Word protetto tramite criterio utilizzando l'API di Document Security (servizio Web):
  1. Includi file di progetto
    Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .
    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.
  2. Creare un oggetto API client Document Security
    • Creare un RightsManagementServiceClient oggetto utilizzando il relativo costruttore predefinito.
    • Creare un RightsManagementServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/RightsManagementService?WSDL .) Non è necessario utilizzare l' lc_version attributo. Questo attributo viene utilizzato quando create un riferimento a un servizio.
    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del RightsManagementServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding .
    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom . Questo valore assicura che venga utilizzato MTOM.
    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:
      • Assegnare il nome utente dei moduli AEM al campo RightsManagementServiceClient.ClientCredentials.UserName.UserName .
      • Assegnare il valore della password corrispondente al campo RightsManagementServiceClient.ClientCredentials.UserName.Password .
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType .
    • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode .
  3. Recupero di un documento Word protetto tramite criterio
    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare il documento Word protetto tramite criterio dal quale viene rimosso il criterio.
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento di Word e la modalità di apertura del file.
    • Creare un array di byte che memorizza il contenuto dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM il campo con il contenuto dell'array di byte.
  4. Rimuovere il criterio dal documento Word
    Rimuovere il criterio dal documento Word richiamando il RightsManagementServiceClient metodo dell' removePolicySecurity oggetto e passando l' BLOB oggetto che contiene il documento Word protetto tramite criterio. Questo metodo restituisce un BLOB oggetto che contiene un documento Word non protetto.
  5. Salvare il documento Word non protetto
    • Creare un System.IO.FileStream oggetto richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento Word non protetto.
    • Creare un array di byte che memorizza il contenuto dei dati dell' BLOB oggetto restituito dal removePolicySecurity metodo. Compilare l'array di byte ottenendo il valore del campo dell' BLOB oggetto MTOM .
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
Esempi di codice
Per esempi di codice che utilizzano il servizio Document Security, consultate la seguente Guida rapida:
  • "Avvio rapido (MTOM): Rimozione di un criterio da un documento Word tramite l'API del servizio Web"
Consulta anche