Asignar derechos de uso assigning-usage-rights
Los ejemplos de este documento solo son para AEM Forms en un entorno JEE.
Acerca del servicio Acrobat Reader DC extensions about-the-acrobat-reader-dc-extensions-service
El servicio de extensiones de Acrobat Reader DC permite a su organización compartir fácilmente documentos interactivos de PDF mediante la ampliación de la funcionalidad de Adobe Reader. El servicio de extensiones de Acrobat Reader DC es totalmente compatible con cualquier documento de PDF, hasta PDF 1.7 incluido. Funciona con Adobe Reader 7.0 y versiones posteriores. El servicio añade derechos de uso a un documento de PDF, activando funciones que normalmente no están disponibles cuando se abre un documento de PDF con Adobe Reader. Los usuarios de terceros no requieren software ni complementos adicionales para trabajar con los documentos con derechos activados.
Puede realizar estas tareas mediante el servicio de extensiones de Acrobat Reader DC:
- Aplicar derechos de uso a documentos de PDF. Para obtener más información, consulte Aplicar derechos de uso a documentos de PDF.
- Quitar derechos de uso de documentos de PDF. Para obtener más información, consulte Quitar derechos de uso de documentos de PDF.
- Recuperar detalles de credenciales. Para obtener más información, consulte Recuperando información de credenciales.
Aplicar derechos de uso a documentos de PDF applying-usage-rights-to-pdf-documents
Puede aplicar derechos de uso a documentos de PDF mediante la API de cliente Java y el servicio web de extensiones de Acrobat Reader DC. Los derechos de uso pertenecen a una funcionalidad que está disponible de forma predeterminada en Acrobat pero no en Adobe Reader, como la capacidad de agregar comentarios a un formulario o rellenar los campos del formulario y guardarlo. Los documentos PDF a los que se les han aplicado derechos de uso se denominan “documentos con derechos activados”. Un usuario que abre un documento con derechos activados en Adobe Reader puede realizar las operaciones que están habilitadas para ese documento específico.
applyUsageRights
método, que forma parte de la API de Java, puede establecer el isModeFinal
parámetro del ReaderExtensionsOptionSpec
objeto a false
. Esto hace que el contador de formularios procesados no se actualice y mejore el rendimiento. Si no le preocupa actualizar el contador de formularios procesados, se recomienda configurar la variable isModeFinal
parámetro a false
.Resumen de los pasos summary-of-steps
Para aplicar derechos de uso a un documento de PDF, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto Cliente de extensiones de Acrobat Reader DC.
- Recupere un documento de PDF.
- Especifique los derechos de uso que desea aplicar.
- Aplicar derechos de uso al documento de PDF.
- Guarde el documento de PDF con los derechos activados.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de cliente de extensiones de Acrobat Reader DC
Para realizar mediante programación una operación de servicio de extensiones de Acrobat Reader DC, debe crear un objeto de cliente de servicio de extensiones de Acrobat Reader DC. Si utiliza la API de Java de extensiones de Acrobat Reader DC, cree una ReaderExtensionsServiceClient
objeto. Si utiliza la API del servicio web de extensiones de Acrobat Reader DC, cree un ReaderExtensionsServiceService
objeto.
Recuperación de un documento de PDF
Recupere un documento de PDF para aplicar derechos de uso. Los documentos de PDF con derechos activados contienen un diccionario de derechos de uso. Cuando Adobe Reader abre un documento que contiene dicho diccionario, solo habilita los derechos de uso especificados en el diccionario para ese documento. Si el documento no contiene un diccionario de derechos de uso, el servicio de extensiones de Acrobat Reader DC crea uno. Si ya contiene un diccionario, el servicio de extensiones de Acrobat Reader DC sobrescribe los derechos de uso existentes con los especificados. El diccionario especifica qué derechos de uso están habilitados. Cuando un usuario abre el documento en Adobe Reader, solo se permiten los derechos de uso especificados en el diccionario.
Especificar los derechos de uso que aplicar
Los derechos de uso que puede establecer están determinados por una credencial que compra a Adobe Systems Incorporated. Las credenciales suelen proporcionar permiso para establecer un grupo de derechos de uso relacionados, como los que pertenecen a los formularios interactivos. Cada credencial proporciona el derecho de crear un determinado número de documentos de PDF con derechos activados. Una credencial de evaluación le da derecho a crear un número ilimitado de borradores de documentos.
Aplicar derechos de uso al documento de PDF
Para aplicar derechos de uso a un documento de PDF, debe hacer referencia al alias de la credencial que está utilizando para aplicar derechos de uso (una credencial suele instalarse durante la instalación de AEM Forms). Además, debe especificar el documento del PDF al que se aplican los derechos de uso. Para obtener información sobre cómo configurar una credencial, consulte la guía de instalación e implementación para su servidor de aplicaciones.
Guardar el documento de PDF con los derechos activados
Una vez que el servicio de extensiones de Acrobat Reader DC aplique los derechos de uso a un documento de PDF, puede guardar el documento de PDF con los derechos activados como archivo de PDF.
Consulte también
Aplicar derechos de uso mediante la API de Java
Aplicar derechos de uso mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de la API del servicio Acrobat Reader DC Extensions
Aplicar derechos de uso mediante la API de Java apply-usage-rights-using-the-java-api
Aplique derechos de uso a un documento de PDF mediante la API de extensiones de Acrobat Reader DC (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-reader-extensions-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto Cliente de extensiones de Acrobat Reader DC.
- Crear un
ServiceClientFactory
que contiene las propiedades de conexión. - Crear un
ReaderExtensionsServiceClient
usando su constructor y pasando el objetoServiceClientFactory
objeto.
- Crear un
-
Recupere un documento de PDF.
- Crear un
java.io.FileInputStream
que representa el documento de PDF utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de PDF. - Crear un
com.adobe.idp.Document
usando su constructor y pasando el objetojava.io.FileInputStream
objeto.
- Crear un
-
Especifique los derechos de uso que desea aplicar.
- Crear un
UsageRights
que representa los derechos de uso mediante su constructor. - Para aplicar cada derecho de uso, invoque un método correspondiente que pertenezca a
UsageRights
objeto. Por ejemplo, para agregar la variableenableFormFillIn
derecho de uso, invoque elUsageRights
del objetoenableFormFillIn
método y pasetrue
. (Repita este paso para cada derecho de uso que desee aplicar).
- Crear un
-
Aplicar derechos de uso al documento de PDF.
-
Crear un
ReaderExtensionsOptionSpec
mediante su constructor. Este objeto contiene opciones en tiempo de ejecución que requiere el servicio de extensiones de Acrobat Reader DC. Al invocar este constructor, debe especificar los siguientes valores:- El
UsageRights
que contiene los derechos de uso que se aplicarán al documento. - Valor de cadena que especifica un mensaje que ve un usuario cuando se abre el documento de PDF con derechos habilitados en Adobe Reader 7.x. Este mensaje no se muestra en Adobe Reader 8.0.
- El
-
Aplicar derechos de uso al documento de PDF invocando el
ReaderExtensionsServiceClient
del objetoapplyUsageRights
y pasando los siguientes valores:- El
com.adobe.idp.Document
que contiene el documento del PDF al que se aplican los derechos de uso. - Valor de cadena que especifica el alias de la credencial que le permite aplicar derechos de uso.
- Un valor de cadena que especifica el valor de contraseña correspondiente. (Actualmente este parámetro se ignora. Puedes pasar
null
.)
- El
-
El
ReaderExtensionsOptionSpec
que contiene opciones en tiempo de ejecución.
El
applyUsageRights
El método devuelve un valorcom.adobe.idp.Document
que contiene el documento de PDF con derechos activados. -
-
Guarde el documento de PDF con los derechos activados.
- Crear un
java.io.File
y asegúrese de que la extensión del archivo es .pdf. - Invoque el
com.adobe.idp.Document
del objetocopyToFile
para copiar el contenido delcom.adobe.idp.Document
al archivo (asegúrese de utilizar la variablecom.adobe.idp.Document
objeto que ha devuelto elapplyUsageRights
método).
- Crear un
Consulte también
Aplicar derechos de uso a documentos de PDF
Inicio rápido (modo SOAP):Aplicar derechos de uso mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Aplicar derechos de uso mediante la API de servicio web apply-usage-rights-using-the-web-service-api
Aplicar derechos de uso a un documento de PDF mediante la API de extensiones de Acrobat Reader DC (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms. -
Cree un objeto Cliente de extensiones de Acrobat Reader DC.
-
Crear un
ReaderExtensionsServiceClient
mediante su constructor predeterminado. -
Crear un
ReaderExtensionsServiceClient.Endpoint.Address
mediante el uso del objetoSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Asegúrese de especificar?blob=mtom
.) -
Crear un
System.ServiceModel.BasicHttpBinding
al obtener el valor de la variableReaderExtensionsServiceClient.Endpoint.Binding
field. Convierta el valor devuelto enBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
field aWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario del formulario de la al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- AEM Asigne el nombre de usuario del formulario de la al campo
-
-
Recupere un documento de PDF.
- Crear un
BLOB
mediante su constructor. ElBLOB
se utiliza para almacenar un documento de PDF al que se aplican derechos de uso. - Crear un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo elSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con datos de flujo invocando el método
System.IO.FileStream
del objetoRead
método. Pase a leer la matriz de bytes, la posición inicial y la longitud de la secuencia. - Rellene el
BLOB
al asignar suMTOM
con el contenido de la matriz de bytes.
- Crear un
-
Especifique los derechos de uso que desea aplicar.
- Crear un
UsageRights
que representa los derechos de uso mediante su constructor. - Asigne el valor a cada derecho de uso que se deba aplicar
true
al miembro de datos correspondiente que pertenece aUsageRights
objeto. Por ejemplo, para agregar la variableenableFormFillIn
derecho de uso, asignartrue
a laUsageRights
del objetoenableFormFillIn
miembro de datos. (Repita este paso para cada derecho de uso que desee aplicar).
- Crear un
-
Aplicar derechos de uso al documento de PDF.
-
Crear un
ReaderExtensionsOptionSpec
mediante su constructor. Este objeto contiene opciones en tiempo de ejecución que requiere el servicio de extensiones de Acrobat Reader DC. -
Asigne el
UsageRights
objeto aReaderExtensionsOptionSpec
del objetousageRights
miembro de datos. -
Asigne a la variable un valor de cadena que especifique el mensaje que ve un usuario cuando se abre el documento de PDF con derechos habilitados en Adobe Reader
ReaderExtensionsOptionSpec
del objetomessage
miembro de datos. -
Aplicar derechos de uso al documento de PDF invocando el
ReaderExtensionsServiceClient
del objetoapplyUsageRights
y pasando los siguientes valores:- El
BLOB
que contiene el documento del PDF al que se aplican los derechos de uso. - Valor de cadena que especifica el alias de la credencial que le permite aplicar derechos de uso.
- Un valor de cadena que especifica el valor de contraseña correspondiente. (Actualmente este parámetro se ignora. Puedes pasar
null
.)
- El
-
El
ReaderExtensionsOptionSpec
que contiene opciones en tiempo de ejecución.
El
applyUsageRights
El método devuelve un valorBLOB
que contiene el documento de PDF con derechos activados. -
-
Guarde el documento de PDF con los derechos activados.
- Crear un
System.IO.FileStream
invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento de PDF con derechos activados. - Cree una matriz de bytes que almacene el contenido de datos del
BLOB
objeto que ha devuelto elapplyUsageRights
método. Rellene la matriz de bytes obteniendo el valor deBLOB
del objetoMTOM
miembro de datos. - Crear un
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
objeto. - Escriba el contenido de la matriz de bytes en un archivo PDF invocando el método
System.IO.BinaryWriter
del objetoWrite
y pasando la matriz de bytes.
- Crear un
Consulte también
Aplicar derechos de uso a documentos de PDF
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
Quitar derechos de uso de documentos de PDF removing-usage-rights-from-pdf-documents
Puede quitar los derechos de uso de un documento con derechos activados. La eliminación de los derechos de uso de un documento de PDF con derechos activados también es necesaria para realizar otras operaciones de AEM Forms en él. Por ejemplo, debe firmar digitalmente (o certificar) un documento PDF antes de establecer los derechos de uso. Por lo tanto, si desea realizar operaciones en un documento con derechos activados, debe quitar los derechos de uso del documento de PDF, realizar el resto de operaciones, como firmar digitalmente el documento y, a continuación, volver a aplicar los derechos de uso al documento.
Resumen de los pasos summary_of_steps-1
Para quitar los derechos de uso de un documento de PDF con derechos activados, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto Cliente de extensiones de Acrobat Reader DC.
- Recupere un documento de PDF con derechos activados.
- Quite los derechos de uso del documento de PDF.
- Guarde el documento del PDF.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de cliente de extensiones de Acrobat Reader DC
Para poder realizar mediante programación una operación de servicio de extensiones de Acrobat Reader DC, debe crear un objeto de cliente de servicio de extensiones de Acrobat Reader DC. Si utiliza la API de Java, cree un ReaderExtensionsServiceClient
objeto. Si utiliza la API del servicio web de extensiones de Acrobat Reader DC, cree un ReaderExtensionsServiceService
objeto.
Recuperar un documento de PDF con derechos activados
Recupere un documento de PDF con derechos activados para eliminar los derechos de uso.
Quitar derechos de uso del documento de PDF
Después de recuperar un documento de PDF con derechos activados, puede quitar los derechos de uso. Después de quitar los derechos de uso, el documento de PDF no tendrá ninguna funcionalidad adicional cuando se visualice en Adobe Reader.
Guardar el documento del PDF
Puede guardar el documento de PDF que ya no contiene derechos de uso como archivo de PDF. Una vez guardado como archivo de PDF, el documento de PDF se puede ver en Adobe Reader o Acrobat.
Consulte también
Eliminación de derechos de uso mediante la API de Java
Eliminación de derechos de uso mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de la API del servicio Acrobat Reader DC Extensions
Aplicar derechos de uso a documentos de PDF
Eliminación de derechos de uso mediante la API de Java remove-usage-rights-using-the-java-api
Elimine los derechos de uso de un documento de PDF con derechos activados mediante la API de extensiones de Acrobat Reader DC (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-reader-extensions-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto Cliente de extensiones de Acrobat Reader DC.
Crear un
ReaderExtensionsServiceClient
mediante su constructor y pasando un objetoServiceClientFactory
que contiene las propiedades de conexión. -
Recupere un documento de PDF.
- Crear un
java.io.FileInputStream
que representan el documento de PDF con derechos activados utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de PDF. - Crear un
com.adobe.idp.Document
usando su constructor y pasando el objetojava.io.FileInputStream
objeto.
- Crear un
-
Quite los derechos de uso del documento de PDF.
Quite los derechos de uso del documento de PDF invocando el
ReaderExtensionsServiceClient
del objetoremoveUsageRights
y pasando elcom.adobe.idp.Document
que contiene el documento de PDF con derechos activados. Este método devuelve uncom.adobe.idp.Document
que contiene un documento de PDF que no tiene derechos de uso. -
Aplicar derechos de uso al documento de PDF.
- Crear un
java.io.File
y asegúrese de que la extensión del archivo es .PDF. - Invoque el
Document
del objetocopyToFile
para copiar el contenido delDocument
al archivo (asegúrese de utilizar la variableDocument
objeto que ha devuelto elremoveUsageRights
método).
- Crear un
Consulte también
Quitar derechos de uso de documentos de PDF
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Eliminación de derechos de uso mediante la API de servicio web remove-usage-rights-using-the-web-service-api
Elimine los derechos de uso de un documento de PDF con derechos activados mediante la API de extensiones de Acrobat Reader DC (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms. -
Cree un objeto Cliente de extensiones de Acrobat Reader DC.
-
Crear un
ReaderExtensionsServiceClient
mediante su constructor predeterminado. -
Crear un
ReaderExtensionsServiceClient.Endpoint.Address
mediante el uso del objetoSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Asegúrese de especificar?blob=mtom
.) -
Crear un
System.ServiceModel.BasicHttpBinding
al obtener el valor de la variableReaderExtensionsServiceClient.Endpoint.Binding
field. Convierta el valor devuelto enBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
field aWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario del formulario de la al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- AEM Asigne el nombre de usuario del formulario de la al campo
-
-
Recupere un documento de PDF.
- Crear un
BLOB
mediante su constructor. ElBLOB
se utiliza para almacenar el documento de PDF con derechos activados del que se eliminan los derechos de uso. - Crear un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo elSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con datos de flujo invocando el método
System.IO.FileStream
del objetoRead
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer. - Rellene el
BLOB
al asignar suMTOM
con el contenido de la matriz de bytes.
- Crear un
-
Quite los derechos de uso del documento de PDF.
Quite los derechos de uso del documento de PDF invocando el
ReaderExtensionsServiceClient
del objetoremoveUsageRights
y pasando elBLOB
que contiene el documento de PDF con derechos activados. Este método devuelve unBLOB
que contiene un documento de PDF que no tiene derechos de uso. -
Aplicar derechos de uso al documento de PDF.
- Crear un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo PDF. - Cree una matriz de bytes que almacene el contenido de datos del
BLOB
objeto que ha devuelto elremoveUsageRights
método. Rellene la matriz de bytes obteniendo el valor deBLOB
del objetoMTOM
miembro de datos. - Crear un
System.IO.BinaryWriter
invocando su constructor y pasando el objetoSystem.IO.FileStream
objeto.
- Crear un
Consulte también
Quitar derechos de uso de documentos de PDF
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef
Recuperando información de credenciales retrieving-credential-information
Puede recuperar información sobre las credenciales que se utilizaron para aplicar derechos de uso a un documento de PDF con derechos activados. Al recuperar información sobre una credencial, puede obtener información como la fecha después de la cual el certificado ya no es válido.
Resumen de los pasos summary_of_steps-2
Para recuperar información sobre la credencial que se utilizó para aplicar derechos de uso a un documento de PDF, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto Cliente de extensiones de Acrobat Reader DC.
- Recupere un documento de PDF con derechos activados.
- Recupere información sobre la credencial.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Crear un objeto de cliente de extensiones de Acrobat Reader DC
Para poder realizar mediante programación una operación de servicio de extensiones de Acrobat Reader DC, debe crear un objeto de cliente de servicio de extensiones de Acrobat Reader DC. Si utiliza la API de Java, cree un ReaderExtensionsServiceClient
objeto. Si utiliza la API del servicio web de extensiones de Acrobat Reader DC, cree un ReaderExtensionsServiceService
objeto.
Recuperar un documento de PDF con derechos activados
Recupere un documento de PDF con derechos habilitados para recuperar información sobre la credencial. También puede recuperar información sobre una credencial especificando su alias; sin embargo, si desea recuperar información sobre una credencial que se utilizó para aplicar derechos de uso a un documento de PDF específico con derechos activados, deberá recuperar el documento.
Recuperar información sobre la credencial
Después de recuperar un documento de PDF con derechos activados, puede obtener información sobre la credencial que se utilizó para aplicarle derechos de uso. Puede obtener la siguiente información sobre la credencial:
- Mensaje que se muestra en Adobe Reader cuando se abre el documento de PDF con derechos habilitados.
- La fecha a partir de la cual la credencial deja de ser válida.
- La fecha antes de la cual la credencial no es válida.
- Los derechos de uso establecidos para este documento de PDF con derechos activados.
- El número de veces que se ha utilizado la credencial.
Consulte también
Eliminación de derechos de uso mediante la API de Java
Eliminación de derechos de uso mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicios rápidos de la API del servicio Acrobat Reader DC Extensions
Recuperar información de credenciales mediante la API de Java retrieve-credential-information-using-the-java-api
Recuperar información de credenciales mediante la API de extensiones de Acrobat Reader DC (Java):
-
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-reader-extensions-client.jar, en la ruta de clase del proyecto Java.
-
Cree un objeto Cliente de extensiones de Acrobat Reader DC.
Crear un
ReaderExtensionsServiceClient
mediante su constructor y pasando un objetoServiceClientFactory
que contiene las propiedades de conexión. -
Recupere un documento de PDF.
- Crear un
java.io.FileInputStream
que representan el documento PDF con derechos activados mediante su constructor y pasando un valor de cadena que especifica la ubicación del documento PDF con derechos activados. - Crear un
com.adobe.idp.Document
usando su constructor y pasando el objetojava.io.FileInputStream
objeto.
- Crear un
-
Quite los derechos de uso del documento de PDF.
- Recupere información sobre las credenciales utilizadas para aplicar derechos de uso al documento de PDF invocando el
ReaderExtensionsServiceClient
del objetogetDocumentUsageRights
y pasando elcom.adobe.idp.Document
que contiene el documento de PDF con derechos activados. Este método devuelve unGetUsageRightsResult
que contiene información de credenciales. - Recupere la fecha a partir de la cual la credencial ya no es válida invocando el
GetUsageRightsResult
del objetogetNotAfter
método. Este método devuelve unjava.util.Date
que representa la fecha a partir de la cual la credencial deja de ser válida. - Recupere el mensaje que se muestra en Adobe Reader cuando se abre el documento de PDF con derechos activados invocando el
GetUsageRightsResult
del objetogetMessage
método. Este método devuelve un valor de cadena que representa el mensaje.
- Recupere información sobre las credenciales utilizadas para aplicar derechos de uso al documento de PDF invocando el
Consulte también
Recuperando información de credenciales
Inicio rápido (modo SOAP): Recuperación de información de credenciales mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Recuperar información de credenciales mediante la API de servicio web retrieve-credential-information-using-the-web-service-api
Recuperar información de credenciales mediante la API de extensiones de Acrobat Reader DC (servicio web):
-
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms. -
Cree un objeto Cliente de extensiones de Acrobat Reader DC.
-
Crear un
ReaderExtensionsServiceClient
mediante su constructor predeterminado. -
Crear un
ReaderExtensionsServiceClient.Endpoint.Address
mediante el uso del objetoSystem.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Asegúrese de especificar?blob=mtom
.) -
Crear un
System.ServiceModel.BasicHttpBinding
al obtener el valor de la variableReaderExtensionsServiceClient.Endpoint.Binding
field. Convierta el valor devuelto enBasicHttpBinding
. -
Configure las variables
System.ServiceModel.BasicHttpBinding
del objetoMessageEncoding
field aWSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM. -
Habilite la autenticación HTTP básica realizando las siguientes tareas:
- AEM Asigne el nombre de usuario del formulario de la al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Asigne el valor de contraseña correspondiente al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Asignar el valor constante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Asignar el valor constante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- AEM Asigne el nombre de usuario del formulario de la al campo
-
-
Recupere un documento de PDF.
- Crear un
BLOB
mediante su constructor. ElBLOB
se utiliza para almacenar un documento de PDF con derechos activados. - Crear un
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento de PDF con derechos habilitados y el modo en que se abre el archivo. - Cree una matriz de bytes que almacene el contenido del
System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo elSystem.IO.FileStream
del objetoLength
propiedad. - Rellene la matriz de bytes con datos de flujo invocando el método
System.IO.FileStream
del objetoRead
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer. - Rellene el
BLOB
al asignar suMTOM
con el contenido de la matriz de bytes.
- Crear un
-
Quite los derechos de uso del documento de PDF.
- Recupere información sobre las credenciales utilizadas para aplicar derechos de uso al documento de PDF invocando el
ReaderExtensionsServiceClient
del objetogetDocumentUsageRights
y pasando elcom.adobe.idp.Document
que contiene el documento de PDF con derechos activados. Este método devuelve unGetUsageRightsResult
que contiene información de credenciales. - Recupere la fecha a partir de la cual la credencial ya no es válida obteniendo el valor del
GetUsageRightsResult
del objetonotAfter
miembro de datos. El tipo de datos de este miembro de datos esSystem.DateTime
. - Recupere el mensaje que se muestra cuando se abre el documento de PDF con derechos habilitados en Adobe Reader obteniendo el valor del
GetUsageRightsResult
del objetomessage
miembro de datos. El tipo de datos de este miembro de datos es una cadena. - Recupere el número de veces que se utiliza la credencial obteniendo el valor del
GetUsageRightsResult
del objetouseCount
miembro de datos. El tipo de datos de este miembro de datos es un número entero.
- Recupere información sobre las credenciales utilizadas para aplicar derechos de uso al documento de PDF invocando el
Consulte también
Recuperando información de credenciales
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef