Invocar AEM Forms mediante Remoting invoking-aem-forms-using-remoting

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Los procesos creados en Workbench se pueden invocar mediante Remoting. Es decir, puede invocar un proceso AEM Forms desde una aplicación cliente creada con Flex. Esta función se basa en los servicios de datos.

NOTE
Al utilizar Remoting, se recomienda invocar procesos creados en Workbench en lugar de los servicios de AEM Forms. Sin embargo, es posible invocar los servicios de AEM Forms directamente. (Consulte Codificación de documentos de PDF mediante Remoting, en AEM Forms Developer Center).
NOTE
Si un servicio de AEM Forms no está configurado para permitir el acceso anónimo, las solicitudes de un cliente de Flex resultan en un desafío para el explorador web. El usuario debe introducir las credenciales de nombre de usuario y contraseña.

El siguiente proceso breve de AEM Forms, llamado MyApplication/EncryptDocument, se puede invocar mediante Remoting. (Para obtener información sobre este proceso, como sus valores de entrada y salida, consulte Ejemplo de proceso de corta duración.)

iu_iu_encryptdocumentprocess2

NOTE
Para invocar un proceso de AEM Forms mediante una aplicación de Flex, asegúrese de que un extremo remoto esté habilitado. De forma predeterminada, un punto final remoto está habilitado cuando se implementa un proceso.

Cuando se invoca este proceso, realiza las siguientes acciones:

  1. Obtiene el documento de PDF no protegido que se pasa como valor de entrada. Esta acción se basa en la variable SetValue operación. El nombre del parámetro de entrada es inDoc y su tipo de datos es document. (El document el tipo de datos es un tipo de datos disponible desde Workbench).
  2. Codifica el documento del PDF con una contraseña. Esta acción se basa en la variable PasswordEncryptPDF operación. El nombre del valor de salida para este proceso es outDoc y representa el documento de PDF cifrado con contraseña. El tipo de datos de outDoc es document.
  3. Guarda el documento de PDF cifrado con contraseña como archivo de PDF en el sistema de archivos local. Esta acción se basa en la variable WriteDocument operación.
NOTE
La variable MyApplication/EncryptDocument no se basa en un proceso de AEM Forms existente. Para seguir junto con los ejemplos de código, cree un proceso denominado MyApplication/EncryptDocument usando Workbench.
NOTE
Para obtener información sobre el uso de Remoting para invocar un proceso de larga duración, consulte Invocación de procesos de larga vida centrados en el ser humano.

Consulte también

Inclusión del archivo de biblioteca Flex de AEM Forms

Gestión de documentos con AEM Forms Remoting (obsoleto para AEM formularios)

Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting

Autenticación de aplicaciones cliente creadas con Flex

Pasar documentos seguros para invocar procesos mediante Remoting

Invocación de servicios de componentes personalizados mediante Remoting

Creación de una aplicación cliente creada con Flex que invoca un proceso prolongado centrado en el ser humano

Crear aplicaciones de Flash Builder que realizan autenticación SSO mediante tokens HTTP

Para obtener información sobre cómo mostrar datos de proceso en un control de gráfico de Flex, consulte Visualización de datos de proceso de AEM Forms en gráficos de Flex.

NOTE
Asegúrese de colocar el archivo cross-domain.xml en el lugar adecuado. Por ejemplo, suponiendo que haya implementado AEM Forms en JBoss, coloque este archivo en la siguiente ubicación: <install_directory>\Adobe_Experience_Manager_forms\jboss\server\lc_turnkey\deploy\jboss-web.deployer\ROOT.war.

Inclusión del archivo de biblioteca Flex de AEM Forms including-the-aem-forms-flex-library-file

Para invocar mediante programación procesos de AEM Forms mediante Remoting, agregue el archivo adobe-remoting-provider.swc a la ruta de clase de su proyecto de Flex. Este archivo SWC se encuentra en la siguiente ubicación:

  • <install_directory>\Adobe_Experience_Manager_forms\sdk\misc\DataServices\Client-Libraries

    donde <install_directory> es el directorio donde está instalado AEM Forms.

Consulte también

Invocación de AEM Forms mediante AEM Forms Remoting (obsoleto para formularios AEM)

Gestión de documentos con AEM Forms Remoting (obsoleto para AEM formularios)

Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting

Autenticación de aplicaciones cliente creadas con Flex

Gestión de documentos con Remoting handling-documents-with-remoting

Uno de los tipos Java no primitivos más importantes que se usa en AEM Forms es el com.adobe.idp.Document Clase . Normalmente, un documento es necesario para invocar una operación de AEM Forms. Es principalmente un documento PDF, pero puede contener otros tipos de documentos, como SWF, HTML, XML o un archivo DOC. (Consulte Pasar datos a servicios de AEM Forms mediante la API de Java.)

Una aplicación cliente creada con Flex no puede solicitar directamente un documento. Por ejemplo, no se puede iniciar Adobe Reader para solicitar una dirección URL que genere un archivo de PDF. Las solicitudes para tipos de documentos, como documentos de Microsoft Word y PDF, devuelven un resultado que es una dirección URL. Es responsabilidad del cliente mostrar el contenido de la dirección URL. El servicio de Gestión de documentos ayuda a generar la información de tipo de contenido y dirección URL. Las solicitudes de documentos XML devuelven el documento XML completo en el resultado.

Pasar un documento como parámetro de entrada passing-a-document-as-an-input-parameter

Una aplicación cliente creada con Flex no puede pasar un documento directamente a un proceso de AEM Forms. En su lugar, la aplicación cliente utiliza una instancia de la variable mx.rpc.livecycle.DocumentReference La clase ActionScript pasa parámetros de entrada a una operación que espera una com.adobe.idp.Document instancia. Una aplicación cliente de Flex tiene varias opciones para configurar una DocumentReference objeto:

  • Cuando el documento se encuentra en el servidor y se conoce su ubicación, establezca la propiedad referenceType del objeto DocumentReference en REF_TYPE_FILE. Establezca la propiedad fileRef en la ubicación del archivo, como se muestra en el siguiente ejemplo:
 ... var docRef: DocumentReference = new DocumentReference();
 docRef.referenceType = DocumentReference.REF_TYPE_FILE;
 docRef.fileRef = "C:/install/adobe/cs2/How to Uninstall.pdf"; ...
  • Cuando el documento se encuentra en el servidor y conoce su URL, establezca la propiedad referenceType del objeto DocumentReference en REF_TYPE_URL. Establezca la propiedad url en la dirección URL, como se muestra en el siguiente ejemplo:
... var docRef: DocumentReference = new DocumentReference();
docRef.referenceType = DocumentReference.REF_TYPE_URL;
docRef.url = "https://companyserver:8080/DocumentManager/116/7855"; ...
  • Para crear un objeto DocumentReference a partir de una cadena de texto en la aplicación cliente, establezca la propiedad referenceType del objeto DocumentReference en REF_TYPE_INLINE. Establezca la propiedad text en el texto que se incluirá en el objeto, como se muestra en el siguiente ejemplo:
... var docRef: DocumentReference = new DocumentReference();
docRef.referenceType = DocumentReference.REF_TYPE_INLINE;
docRef.text = "Text for my document";  // Optionally, you can override the server’s default character set  // if necessary:  // docRef.charsetName=CharacterSetName  ...
  • Cuando el documento no esté en el servidor, utilice el servlet Remoting upload para cargar un documento en AEM Forms. Lo nuevo en AEM Forms es la capacidad de cargar documentos seguros. Al cargar un documento seguro, debe utilizar un usuario que tenga la función * Usuario de la aplicación de carga de documentos *. Sin esta función, el usuario no puede cargar un documento seguro. Se recomienda utilizar el inicio de sesión único para cargar un documento seguro. (Consulte Pasar documentos seguros para invocar procesos mediante Remoting.)

    note note
    NOTE
    si AEM Forms está configurado para permitir la carga de documentos no seguros, puede utilizar un usuario que no tenga la función de usuario de la aplicación de carga de documentos para cargar un documento. Un usuario también puede tener el permiso Carga de documento . Sin embargo, si AEM Forms está configurado para permitir solo documentos seguros, asegúrese de que el usuario tenga la función de usuario de la aplicación de carga de documentos o el permiso de carga de documentos. Consulte Configuración de AEM Forms para aceptar documentos seguros y no seguros*.

    Las funciones de carga de Flash estándar se usan para la URL de carga designada: https://SERVER:PORT/remoting/lcfileupload. A continuación, puede usar la variable DocumentReference donde sea un parámetro de entrada de tipo Document se espera
     private function startUpload():void  {  fileRef.addEventListener(Event.SELECT, selectHandler);  fileRef.addEventListener("uploadCompleteData", completeHandler);  try  {   var success:Boolean = fileRef.browse();  }    catch (error:Error)  {   trace("Unable to browse for files.");  }  }      private function selectHandler(event:Event):void {  var request:URLRequest = new  URLRequest("https://SERVER:PORT/remoting/lcfileupload")  try   {   fileRef.upload(request);   }    catch (error:Error)   {   trace("Unable to upload file.");   }  }    private function completeHandler(event:DataEvent):void  {   var params:Object = new Object();   var docRef:DocumentReference = new DocumentReference();   docRef.url = event.data as String;   docRef.referenceType = DocumentReference.REF_TYPE_URL;  }El inicio rápido de Remoting utiliza el servlet de carga de Remoting para pasar un archivo PDF a la variable MyApplication/EncryptDocumentproceso. (Consulte Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting.)


private
function startUpload(): void  {
 fileRef.addEventListener(Event.SELECT, selectHandler);
 fileRef.addEventListener("uploadCompleteData", completeHandler);
 try  {
  var success: Boolean = fileRef.browse();
 }
 catch (error: Error)  {
  trace("Unable to browse for files.");
 }
}
private
function selectHandler(event: Event): void {
 var request: URLRequest = new  URLRequest("https://SERVER:PORT/remoting/lcfileupload")  try  {
  fileRef.upload(request);
 }
 catch (error: Error)  {
  trace("Unable to upload file.");
 }
}
private
function completeHandler(event: DataEvent): void  {
 var params: Object = new Object();
 var docRef: DocumentReference = new DocumentReference();
 docRef.url = event.data as String;
 docRef.referenceType = DocumentReference.REF_TYPE_URL;
}

El inicio rápido de Remoting utiliza el servlet de carga de Remoting para pasar un archivo PDF a la variable MyApplication/EncryptDocumentproceso. (Consulte Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting.)

Devolver un documento a una aplicación cliente passing-a-document-back-to-a-client-application

Una aplicación cliente recibe un objeto de tipo mx.rpc.livecycle.DocumentReference para una operación de servicio que devuelve un com.adobe.idp.Document como parámetro de salida. Dado que una aplicación cliente trata de objetos de ActionScript y no de Java, no puede devolver un objeto Document basado en Java a un cliente de Flex. En su lugar, el servidor genera una dirección URL para el documento y la devuelve al cliente. La variable DocumentReference del objeto referenceType la propiedad especifica si el contenido está en la variable DocumentReference o debe recuperarse de una dirección URL en la DocumentReference.url propiedad. La variable DocumentReference.contentType especifica el tipo de documento.

Consulte también

Invocación de AEM Forms mediante AEM Forms Remoting (obsoleto para formularios AEM)

Inclusión del archivo de biblioteca Flex de AEM Forms

Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting

Autenticación de aplicaciones cliente creadas con Flex

Pasar documentos seguros para invocar procesos mediante Remoting

Invocación de un proceso de corta duración al pasar un documento no seguro mediante Remoting invoking-a-short-lived-process-by-passing-an-unsecure-document-using-remoting

Para invocar un proceso de AEM Forms desde una aplicación creada con Flex, realice las siguientes tareas:

  1. Cree un mx:RemoteObject instancia.
  2. Cree un ChannelSet instancia.
  3. Pasa los valores de entrada necesarios.
  4. Gestione los valores devueltos.
NOTE
En esta sección se explica cómo invocar un proceso de AEM Forms y cargar un documento cuando AEM Forms está configurado para cargar documentos no seguros. Para obtener información sobre cómo invocar procesos de AEM Forms y cargar documentos seguros, y cómo configurar AEM Forms para aceptar documentos seguros y no seguros, consulte Pasar documentos seguros para invocar procesos mediante Remoting.

Creación de una instancia mx:RemoteObject

Puede crear un mx:RemoteObject para invocar un proceso de AEM Forms creado en Workbench. Para crear un mx:RemoteObject especifique los siguientes valores:

  • id: El nombre del mx:RemoteObject que representa el proceso que se va a invocar.
  • destino: Nombre del proceso de AEM Forms que se va a invocar. Por ejemplo, para invocar la variable MyApplication/EncryptDocument procesar, especificar MyApplication/EncryptDocument.
  • resultado: Nombre del método Flex que gestiona el resultado.

Dentro de mx:RemoteObject , especifique un <mx:method> que especifica el nombre del método de invocación del proceso. Normalmente, el nombre de un método de invocación de Forms es invoke.

El siguiente ejemplo de código crea una mx:RemoteObject instancia que invoca la variable MyApplication/EncryptDocument proceso.

 <mx:RemoteObject id="EncryptDocument" destination="MyApplication/EncryptDocument" result="resultHandler(event);">
          <mx:method name="invoke" result="handleExecuteInvoke(event)"/>
      </mx:RemoteObject>

Creación de un canal en AEM Forms

Una aplicación cliente puede invocar AEM Forms especificando un Canal en MXML o ActionScript, como se muestra en el siguiente ejemplo de ActionScript. El canal debe ser un AMFChannel, SecureAMFChannel, HTTPChannelo SecureHTTPChannel.

     ...
     private function refresh():void{
         var cs:ChannelSet= new ChannelSet();
         cs.addChannel(new AMFChannel("my-amf",
             "https://yourlcserver:8080/remoting/messagebroker/amf"));
         EncryptDocument.setCredentials("administrator", "password");
         EncryptDocument.channelSet = cs;
     }
     ...

Asigne la variable ChannelSet a la instancia de mx:RemoteObject del channelSet (como se muestra en el ejemplo de código anterior). Por lo general, se importa la clase channel en una instrucción de importación en lugar de especificar el nombre completo cuando se invoca la variable ChannelSet.addChannel método.

Pasar valores de entrada

Un proceso creado en Workbench puede tomar cero o más parámetros de entrada y devolver un valor de salida. Una aplicación cliente pasa parámetros de entrada dentro de un ActionScript con campos que corresponden a parámetros que pertenecen al proceso de AEM Forms. El proceso de corta duración, llamado MyApplication/EncryptDocument, requiere un parámetro de entrada denominado inDoc. El nombre de la operación expuesta por el proceso es invoke (el nombre predeterminado de un proceso de corta duración). (Consulte Invocación de AEM Forms mediante AEM Forms Remoting (obsoleto para formularios AEM).)

El siguiente ejemplo de código pasa un documento de PDF al MyApplication/EncryptDocument proceso:

     ...
     var params:Object = new Object();

     //Document is an instance of DocumentReference
     //that store an unsecured PDF document
     params["inDoc"] = pdfDocument;

     // Invoke an operation synchronously:
     EncryptDocument.invoke(params);
     ...

En este ejemplo de código, pdfDocument es DocumentReference instancia que contiene un documento PDF no protegido. Para obtener información sobre un DocumentReference, consulte Gestión de documentos con AEM Forms Remoting (obsoleto para AEM formularios).

Invocación de una versión específica de un servicio

Puede invocar una versión específica de un servicio de Forms utilizando un _version en el mapa de parámetros de la invocación. Por ejemplo, para invocar la versión 1.2 del MyApplication/EncryptDocument servicio:

 var params:Object = new Object();
 params["inDoc"] = pdfDocument;
 params["_version"] = "1.2"
 var token:AsyncToken = echoService.echoString(params);

La variable version debe ser una cadena que contenga un solo punto. Los valores a la izquierda, la versión principal y la versión secundaria derecha del periodo deben ser enteros. Si no se especifica este parámetro, se invoca la versión principal activa.

Gestión de valores devueltos

Los parámetros de salida de proceso de AEM Forms se deserializan en objetos de ActionScript desde los que la aplicación cliente extrae parámetros específicos por nombre, como se muestra en el siguiente ejemplo. (El valor de salida de la variable MyApplication/EncryptDocument nombre del proceso outDoc.)

     ...
     var res:Object = event.result;
     var docRef:DocumentReference = res["outDoc"] as DocumentReference;
     ...

Invocación del proceso MyApplication/EncryptDocument

Puede invocar la variable MyApplication/EncryptDocument procese siguiendo estos pasos:

  1. Cree un mx:RemoteObject mediante ActionScript o MXML. Consulte Creación de una instancia mx:RemoteObject .
  2. Configure un ChannelSet para comunicarse con AEM Forms y asociarla con el mx:RemoteObject instancia. Consulte Crear un canal en AEM Forms.
  3. Llame al evento ChannelSet login para el método de setCredentials para especificar el valor del identificador de usuario y la contraseña. (Consulte Uso del inicio de sesión único.)
  4. Rellenar un mx.rpc.livecycle.DocumentReference con un documento de PDF no protegido para pasar a la MyApplication/EncryptDocument proceso. (Consulte Pasar un documento como parámetro de entrada.)
  5. Codificar el documento del PDF llamando a la función mx:RemoteObject del invoke método. Pase el Object que contiene el parámetro de entrada (que es el documento PDF no protegido). Consulte Pasar valores de entrada.
  6. Recupere el documento de PDF cifrado con contraseña que se devuelve del proceso. Consulte Gestión de valores devueltos.

Inicio rápido: Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting

Autenticación de aplicaciones cliente creadas con Flex authenticating-client-applications-built-with-flex

El administrador de usuarios de formularios AEM puede autenticar una solicitud Remoting desde una aplicación de Flex de varias maneras, incluido el inicio de sesión único de AEM Forms mediante el servicio de inicio de sesión central, la autenticación básica y la autenticación personalizada. Cuando no se habilita el inicio de sesión único ni el acceso anónimo, una solicitud Remoting resulta en una autenticación básica (la predeterminada) o personalizada.

La autenticación básica se basa en la autenticación básica J2EE estándar del contenedor de aplicaciones web. Para la autenticación básica, un error HTTP 401 provoca un desafío en el explorador. Esto significa que cuando intenta conectarse a una aplicación de Forms mediante RemoteObject y aún no ha iniciado sesión desde la aplicación de Flex, el explorador le solicita un nombre de usuario y una contraseña.

Para la autenticación personalizada, el servidor envía un error al cliente para indicar que se requiere autenticación.

NOTE
Para obtener información sobre cómo realizar la autenticación mediante tokens HTTP, consulte Creación de aplicaciones de Flash Builder que realizan autenticación SSO mediante tokens HTTP.

Uso de la autenticación personalizada using-custom-authentication

La autenticación personalizada se habilita en la consola de administración cambiando el método de autenticación de Básico a Personalizado en el extremo remoto. Si utiliza la autenticación personalizada, la aplicación cliente llama a la función ChannelSet.login método para iniciar sesión y ChannelSet.logout para cerrar la sesión.

NOTE
En la versión anterior de AEM Forms, las credenciales se enviaban a un destino llamando a la función RemoteObject.setCredentials método. La variable setCredentials El método no pasó realmente las credenciales al servidor hasta que el componente intentó conectarse al servidor por primera vez. Por lo tanto, si el componente generó un evento de error, no se puede saber con certeza si el error se produjo debido a un error de autenticación o por otro motivo. La variable ChannelSet.login se conecta al servidor cuando lo llama para que pueda gestionar un problema de autenticación inmediatamente. Aunque puede seguir utilizando la variable setCredentials , se recomienda usar la variable ChannelSet.login método.

Dado que varios destinos pueden utilizar los mismos canales y el objeto ChannelSet correspondiente, al iniciar sesión en un destino, el usuario inicia sesión en cualquier otro destino que utilice el mismo canal o canales. Si dos componentes aplican credenciales diferentes al mismo objeto ChannelSet, se utilizan las últimas credenciales aplicadas. Si varios componentes utilizan el mismo objeto ChannelSet autenticado, llamando a la función logout registra todos los componentes fuera de los destinos.

El ejemplo siguiente utiliza la variable ChannelSet.login y ChannelSet.logout métodos con un control RemoteObject. Esta aplicación realiza las siguientes acciones:

  • Crea un ChannelSet en el creationComplete que representa los canales utilizados por el RemoteObject componente
  • Pasa las credenciales al servidor llamando a la función ROLogin en respuesta a un evento de clic de botón
  • Utiliza el componente RemoteObject para enviar una cadena al servidor como respuesta a un evento de clic de botón. El servidor devuelve la misma cadena al componente RemoteObject
  • Utiliza el suceso result del componente RemoteObject para mostrar la cadena en un control TextArea
  • Cierre la sesión del servidor llamando a la función ROLogout en respuesta a un evento de clic de botón
 <?xml version=”1.0”?>
 <!-- security/SecurityConstraintCustom.mxml -->
 <mx:Application xmlns:mx=”https://www.adobe.com/2006/mxml” width=”100%”
     height=”100%” creationComplete=”creationCompleteHandler();”>

     <mx:Script>
         <![CDATA[
             import mx.controls.Alert;
             import mx.messaging.config.ServerConfig;
             import mx.rpc.AsyncToken;
             import mx.rpc.AsyncResponder;
             import mx.rpc.events.FaultEvent;
             import mx.rpc.events.ResultEvent;
             import mx.messaging.ChannelSet;

             // Define a ChannelSet object.
             public var cs:ChannelSet;

             // Define an AsyncToken object.
             public var token:AsyncToken;

             // Initialize ChannelSet object based on the
             // destination of the RemoteObject component.
             private function creationCompleteHandler():void {
                 if (cs == null)
                 cs = ServerConfig.getChannelSet(remoteObject.destination);
             }

             // Login and handle authentication success or failure.
             private function ROLogin():void {
                 // Make sure that the user is not already logged in.
                 if (cs.authenticated == false) {
                     token = cs.login(“sampleuser”, “samplepassword”);
                     // Add result and fault handlers.
                     token.addResponder(new AsyncResponder(LoginResultEvent,
                     LoginFaultEvent));
                 }
             }

             // Handle successful login.
             private function LoginResultEvent(event:ResultEvent,
                 token:Object=null):void  {
                     switch(event.result) {
                         case “success”:
                             authenticatedCB.selected = true;
                             break;
                             default:
                     }
                 }

                 // Handle login failure.
                 private function LoginFaultEvent(event:FaultEvent,
                     token:Object=null):void {
                         switch(event.fault.faultCode) {
                             case “Client.Authentication”:
                                 default:
                                 authenticatedCB.selected = false;
                                 Alert.show(“Login failure: “ + event.fault.faultString);
                     }
                 }

                 // Logout and handle success or failure.
                 private function ROLogout():void {
                     // Add result and fault handlers.
                     token = cs.logout();
                     token.addResponder(new
                         AsyncResponder(LogoutResultEvent,LogoutFaultEvent));
                 }

                 // Handle successful logout.
                 private function LogoutResultEvent(event:ResultEvent,
                     token:Object=null):void {
                         switch (event.result) {
                             case “success”:
                                 authenticatedCB.selected = false;
                                 break;
                                 default:
                     }
                 }

                 // Handle logout failure.
                 private function LogoutFaultEvent(event:FaultEvent,
                     token:Object=null):void {
                         Alert.show(“Logout failure: “ + event.fault.faultString);
                 }
                 // Handle message recevied by RemoteObject component.
                 private function resultHandler(event:ResultEvent):void {
                     ta.text += “Server responded: “+ event.result + “\n”;
                 }

                 // Handle fault from RemoteObject component.
                 private function faultHandler(event:FaultEvent):void {
                     ta.text += “Received fault: “ + event.fault + “\n”;
                 }
             ]]>
     </mx:Script>
     <mx:HBox>
         <mx:Label text=”Enter a text for the server to echo”/>
         <mx:TextInput id=”ti” text=”Hello World!”/>
         <mx:Button label=”Login”
             click=”ROLogin();”/>
         <mx:Button label=”Echo”
             enabled=”{authenticatedCB.selected}”
             click=”remoteObject.echo(ti.text);”/>
         <mx:Button label=”Logout”
             click=”ROLogout();”/>
         <mx:CheckBox id=”authenticatedCB”
             label=”Authenticated?”
             enabled=”false”/>
     </mx:HBox>
     <mx:TextArea id=”ta” width=”100%” height=”100%”/>

     <mx:RemoteObject id=”remoteObject”
         destination=”myDest”
         result=”resultHandler(event);”
         fault=”faultHandler(event);”/>
 </mx:Application>

La variable login y logout los métodos devuelven un objeto AsyncToken. Asigne controladores de eventos al objeto AsyncToken para que el evento de resultado gestione una llamada correcta y para que el evento de error gestione un error.

Uso del inicio de sesión único using-single-sign-on

AEM usuarios de formularios pueden conectarse a varias aplicaciones web de AEM Forms para realizar una tarea. A medida que los usuarios pasan de una aplicación web a otra, no es eficiente exigirles que inicien sesión por separado en cada aplicación web. El mecanismo de inicio de sesión único de AEM Forms permite a los usuarios iniciar sesión una vez y, a continuación, acceder a cualquier aplicación web de AEM Forms. Dado que los desarrolladores de AEM Forms pueden crear aplicaciones cliente para utilizarlas con AEM Forms, también deben poder aprovechar el mecanismo de inicio de sesión único.

Cada aplicación web de AEM Forms está empaquetada en su propio archivo Web Archive (WAR), que luego se empaqueta como parte de un archivo Enterprise Archive (EAR). Dado que un servidor de aplicaciones no permite compartir datos de sesión entre distintas aplicaciones web, AEM Forms utiliza cookies HTTP para almacenar información de autenticación. Las cookies de autenticación permiten al usuario iniciar sesión en una aplicación de Forms y luego conectarse a otras aplicaciones web de AEM Forms. Esta técnica se conoce como inicio de sesión único.

Los desarrolladores de AEM Forms escriben aplicaciones cliente para ampliar la funcionalidad de las guías del formulario (obsoleto) y para personalizar Workspace. Por ejemplo, una aplicación de Workspace puede iniciar un proceso. A continuación, la aplicación cliente utiliza un extremo remoto para recuperar datos del servicio Forms.

Cuando se invoca un servicio de AEM Forms mediante AEM Forms Remoting (obsoleto para AEM formularios), la aplicación cliente pasa la cookie de autenticación como parte de la solicitud. Como el usuario ya se ha autenticado, no se requiere inicio de sesión adicional para establecer una conexión desde la aplicación cliente al servicio AEM Forms.

NOTE
Si falta una cookie o no es válida, no hay redirección implícita a una página de inicio de sesión. Por lo tanto, aún puede llamar a un servicio anónimo.

Puede evitar el mecanismo de inicio de sesión único de AEM Forms escribiendo una aplicación cliente que inicie sesión y cierre la sesión por su cuenta. Si omite el mecanismo de inicio de sesión único, puede utilizar autenticación básica o personalizada con la aplicación.

Dado que este mecanismo no utiliza el mecanismo de inicio de sesión único de AEM Forms, no se escribe ninguna cookie de autenticación en el cliente. Las credenciales de inicio de sesión se almacenan en la variable ChannelSet para el canal remoto. Por lo tanto, cualquier RemoteObject llamadas que realice del mismo modo ChannelSet se realizan en el contexto de esas credenciales.

Configuración del inicio de sesión único en AEM Forms setting-up-single-sign-on-in-aem-forms

Para utilizar el inicio de sesión único en AEM Forms, instale el componente de flujo de trabajo de formularios, que incluye el servicio de inicio de sesión centralizado. Una vez que un usuario inicia sesión correctamente, el servicio de inicio de sesión centralizado devuelve una cookie de autenticación al usuario. Cada solicitud posterior a una aplicación web de Forms contiene la cookie . Si la cookie es válida, se considera que el usuario está autenticado y no tiene que iniciar sesión de nuevo.

Escribir una aplicación cliente que utilice el inicio de sesión único writing-a-client-application-that-uses-single-sign-on

Al aprovechar el mecanismo de inicio de sesión único, espera que los usuarios inicien sesión utilizando el servicio de inicio de sesión centralizado antes de iniciar una aplicación cliente. Es decir, una aplicación cliente no inicia sesión a través del explorador o llamando a la función ChannelSet.login método.

Si utiliza el mecanismo de inicio de sesión único de AEM Forms, configure el extremo Remoting para utilizar la autenticación personalizada, no la básica. De lo contrario, al utilizar la autenticación básica, un error de autenticación provoca un desafío en el explorador, que no desea que vea el usuario. En su lugar, la aplicación detecta el error de autenticación y, a continuación, muestra un mensaje que indica al usuario que inicie sesión con el servicio de inicio de sesión centralizado.

Una aplicación cliente accede a AEM Forms a través de un extremo remoto mediante el uso de la variable RemoteObject , como se muestra en el siguiente ejemplo.

 <?xml version="1.0"?>
 <mx:Application
        backgroundColor="#FFFFFF">

       <mx:Script>
          <![CDATA[

            import mx.controls.Alert;
            import mx.rpc.events.FaultEvent;

            // Prompt user to login on a fault.
            private function faultHandler(event:FaultEvent):void
            {
             if(event.fault.faultCode=="Client.Authentication")
             {
                 Alert.show(
                     event.fault.faultString + "\n" +
                     event.fault.faultCode + "\n" +
                     "Please login to continue.");
             }
         }
          ]]>
       </mx:Script>

       <mx:RemoteObject id="srv"
           destination="product"
           fault="faultHandler(event);"/>

       <mx:DataGrid
           width="100%" height="100%"
           dataProvider="{srv.getProducts.lastResult}"/>

       <mx:Button label="Get Data"
           click="srv.getProducts();"/>

 </mx:Application>

Inicio de sesión como usuario nuevo mientras la aplicación Flex sigue en ejecución

Una aplicación creada con Flex incluye la cookie de autenticación con cada solicitud a un servicio de AEM Forms. Por motivos de rendimiento, AEM Forms no valida la cookie en cada solicitud. Sin embargo, AEM Forms detecta cuándo se sustituye una cookie de autenticación por otra cookie de autenticación.

Por ejemplo, se inicia una aplicación cliente y, mientras la aplicación está activa, se utiliza el servicio de inicio de sesión centralizado para cerrar la sesión. A continuación, puede iniciar sesión como un usuario diferente. El inicio de sesión como un usuario diferente sustituye la cookie de autenticación existente por una cookie de autenticación para el nuevo usuario.

En la siguiente solicitud de la aplicación cliente, AEM Forms detecta que la cookie ha cambiado y cierra la sesión del usuario. Por lo tanto, la primera solicitud después de un cambio de cookie falla. Todas las solicitudes posteriores se realizan en el contexto de la nueva cookie y se realizan correctamente.

Cierre de sesión

Para cerrar la sesión de AEM Forms e invalidar una sesión, la cookie de autenticación debe eliminarse del equipo del cliente. Como el propósito del inicio de sesión único es permitir que un usuario inicie sesión una vez, no desea que una aplicación cliente elimine la cookie. Esta acción cierra la sesión del usuario.

Por lo tanto, llame a la función RemoteObject.logout en una aplicación cliente genera un mensaje de error en el cliente que especifica que la sesión no se ha cerrado. En su lugar, el usuario puede utilizar el servicio de inicio de sesión centralizado para cerrar la sesión y eliminar la cookie de autenticación.

Cerrar sesión mientras la aplicación Flex sigue en ejecución

Puede iniciar una aplicación cliente creada con Flex y utilizar el servicio de inicio de sesión centralizado para cerrar la sesión. Como parte del proceso de cierre de sesión, se elimina la cookie de autenticación. Si se realiza una solicitud remota sin una cookie, o con una cookie no válida, la sesión del usuario se invalida. Esta acción es en efecto un cierre de sesión. La próxima vez que la aplicación cliente intente conectarse a un servicio de AEM Forms, se solicitará al usuario que inicie sesión.

Consulte también

Invocación de AEM Forms mediante AEM Forms Remoting (obsoleto para formularios AEM)

Gestión de documentos con AEM Forms Remoting (obsoleto para AEM formularios)

Inclusión del archivo de biblioteca Flex de AEM Forms

Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting

Pasar documentos seguros para invocar procesos mediante Remoting

Pasar documentos seguros para invocar procesos mediante Remoting passing-secure-documents-to-invoke-processes-using-remoting

Puede pasar documentos seguros a AEM Forms cuando invoque un proceso que requiera uno o más documentos. Al pasar un documento seguro, está protegiendo la información comercial y los documentos confidenciales. En este caso, un documento puede hacer referencia a un documento PDF, un documento XML, un documento Word, etc. Cuando AEM Forms está configurado para permitir documentos seguros, es necesario pasar un documento seguro a AEM Forms desde una aplicación cliente escrita en Flex. (Consulte Configuración de AEM Forms para aceptar documentos seguros y no seguros.)

Al pasar un documento seguro, utilice el inicio de sesión único y especifique un usuario de formularios AEM que tenga la función * Usuario de aplicación de carga de documento *. Sin esta función, el usuario no puede cargar un documento seguro. Puede asignar una función mediante programación a un usuario. (Consulte Administración de funciones y permisos.)

NOTE
Cuando cree una función nueva y desee que los miembros de la misma carguen documentos seguros, asegúrese de especificar el permiso Carga de documento.

AEM Forms admite una operación denominada getFileUploadToken que devuelve un token que se pasa al servlet de carga. La variable DocumentReference.constructRequestForUpload requiere una dirección URL a AEM Forms junto con el token devuelto por el LC.FileUploadAuthenticator.getFileUploadToken método. Este método devuelve un URLRequest objeto que se utiliza en la invocación al servlet de carga. El siguiente código muestra esta lógica de aplicación.

     ...
         private function startUpload():void
         {
             fileRef.addEventListener(Event.SELECT, selectHandler);
             fileRef.addEventListener("uploadCompleteData", completeHandler);
             try
             {
         var success:Boolean = fileRef.browse();
             }
             catch (error:Error)
             {
                 trace("Unable to browse for files.");
             }

         }

          private function selectHandler(event:Event):void
             {
             var authTokenService:RemoteObject = new RemoteObject("LC.FileUploadAuthenticator");
             authTokenService.addEventListener("result", authTokenReceived);
             authTokenService.channelSet = cs;
             authTokenService.getFileUploadToken();
             }

         private function authTokenReceived(event:ResultEvent):void
             {
             var token:String = event.result as String;
             var request:URLRequest = DocumentReference.constructRequestForUpload("http://localhost:8080", token);

             try
             {
           fileRef.upload(request);
             }
             catch (error:Error)
             {
             trace("Unable to upload file.");
             }
             }

         private function completeHandler(event:DataEvent):void
         {

             var params:Object = new Object();
             var docRef:DocumentReference = new DocumentReference();
             docRef.url = event.data as String;
             docRef.referenceType = DocumentReference.REF_TYPE_URL;
         }
         ...

)

Configuración de AEM Forms para aceptar documentos seguros y no seguros configuring-aem-forms-to-accept-secure-and-unsecure-documents

Puede utilizar la consola de administración para especificar si los documentos son seguros al pasar un documento de una aplicación cliente de Flex a un proceso de AEM Forms. De forma predeterminada, AEM Forms está configurado para aceptar documentos seguros. Puede configurar AEM Forms para que acepte documentos seguros siguiendo los pasos siguientes:

  1. Inicie sesión en la consola de administración.
  2. Haga clic en Configuración.
  3. Haga clic en Configuración del sistema principal.
  4. Haga clic en Configuraciones.
  5. Asegúrese de que la opción Permitir carga de documentos no segura desde aplicaciones Flex no esté seleccionada.
NOTE
Para configurar AEM Forms para que acepte documentos no seguros, seleccione la opción Permitir carga de documentos no segura desde aplicaciones de Flex . A continuación, reinicie una aplicación o servicio para asegurarse de que la configuración surta efecto.

Inicio rápido: Invocación de un proceso de corta duración al pasar un documento seguro mediante Remoting quick-start-invoking-a-short-lived-process-by-passing-a-secure-document-using-remoting

El siguiente ejemplo de código invoca la variable MyApplication/EncryptDocument.Un usuario debe iniciar sesión para hacer clic en el botón Seleccionar archivo que se utiliza para cargar un archivo PDF e invocar el proceso. Es decir, una vez que el usuario está autenticado, el botón Seleccionar archivo está habilitado. La siguiente ilustración muestra la aplicación cliente Flex después de autenticar a un usuario. Observe que la casilla de verificación autenticada está activada.

iu_iu_secureremotelogin

si AEM Forms está configurado para permitir que solo se carguen documentos seguros y el usuario no tiene la función * Usuario de aplicación de carga de documentos *, se produce una excepción. Si el usuario tiene esta función, se carga el archivo y se invoca el proceso.

 <?xml version="1.0" encoding="utf-8"?>
 <mx:Application  xmlns="*"
      creationComplete="initializeChannelSet();">
        <mx:Script>
        <![CDATA[
      import mx.rpc.livecycle.DocumentReference;
      import flash.net.FileReference;
      import flash.net.URLRequest;
      import flash.events.Event;
      import flash.events.DataEvent;
      import mx.messaging.ChannelSet;
      import mx.messaging.channels.AMFChannel;
      import mx.rpc.events.ResultEvent;
      import mx.collections.ArrayCollection;
      import mx.rpc.AsyncToken;
      import mx.controls.Alert;
      import mx.rpc.events.FaultEvent;
      import mx.rpc.AsyncResponder;

      // Classes used in file retrieval
      private var fileRef:FileReference = new FileReference();
      private var docRef:DocumentReference = new DocumentReference();
      private var parentResourcePath:String = "/";
      private var now1:Date;
      private var serverPort:String = "hiro-xp:8080";

      // Define a ChannelSet object.
      public var cs:ChannelSet;

      // Define an AsyncToken object.
      public var token:AsyncToken;

       // Holds information returned from AEM Forms
      [Bindable]
      public var progressList:ArrayCollection = new ArrayCollection();


      // Handles a successful login
     private function LoginResultEvent(event:ResultEvent,
         token:Object=null):void  {
             switch(event.result) {
                 case "success":
                     authenticatedCB.selected = true;
                     btnFile.enabled = true;
                     btnLogout.enabled = true;
                     btnLogin.enabled = false;
                         break;
                     default:
                 }
             }


 // Handle login failure.
 private function LoginFaultEvent(event:FaultEvent,
     token:Object=null):void {
     switch(event.fault.faultCode) {
                 case "Client.Authentication":
                         default:
                         authenticatedCB.selected = false;
                         Alert.show("Login failure: " + event.fault.faultString);
                 }
             }


      // Set up channel set to invoke AEM Forms
      private function initializeChannelSet():void {
        cs = new ChannelSet();
        cs.addChannel(new AMFChannel("remoting-amf", "https://" + serverPort + "/remoting/messagebroker/amf"));
        EncryptDocument2.channelSet = cs;
      }

     // Call this method to upload the file.
      // This creates a file picker and lets the user select a PDF file to pass to the EncryptDocument process.
      private function uploadFile():void {
        fileRef.addEventListener(Event.SELECT, selectHandler);
        fileRef.addEventListener(DataEvent.UPLOAD_COMPLETE_DATA,completeHandler);
        fileRef.browse();
      }

      // Gets called for selected file. Does the actual upload via the file upload servlet.
      private function selectHandler(event:Event):void {
              var authTokenService:RemoteObject = new RemoteObject("LC.FileUploadAuthenticator");
         authTokenService.addEventListener("result", authTokenReceived);
         authTokenService.channelSet = cs;
         authTokenService.getFileUploadToken();
      }

     private function authTokenReceived(event:ResultEvent):void
     {
     var token:String = event.result as String;
     var request:URLRequest = DocumentReference.constructRequestForUpload("https://hiro-xp:8080", token);

     try
     {
           fileRef.upload(request);
     }
     catch (error:Error)
     {
         trace("Unable to upload file.");
     }
 }

      // Called once the file is completely uploaded.
      private function completeHandler(event:DataEvent):void {

        // Set the docRef’s url and referenceType parameters
        docRef.url = event.data as String;
        docRef.referenceType=DocumentReference.REF_TYPE_URL;
        executeInvokeProcess();
      }

     //This method invokes the EncryptDocument process
      public function executeInvokeProcess():void {
         //Create an Object to store the input value for the EncryptDocument process
           now1 = new Date();

         var params:Object = new Object();
         params["inDoc"]=docRef;

         // Invoke the EncryptDocument process
         var token:AsyncToken;
         token = EncryptDocument2.invoke(params);
         token.name = name;
      }

      // AEM Forms  login method
      private function ROLogin():void {
         // Make sure that the user is not already logged in.

         //Get the User and Password
         var userName:String = txtUser.text;
         var pass:String = txtPassword.text;

        if (cs.authenticated == false) {
             token = cs.login(userName, pass);

         // Add result and fault handlers.
         token.addResponder(new AsyncResponder(LoginResultEvent,    LoginFaultEvent));
                 }
             }

      // This method handles a successful process invocation
      public function handleResult(event:ResultEvent):void
      {
            //Retrieve information returned from the service invocation
          var token:AsyncToken = event.token;
          var res:Object = event.result;
          var dr:DocumentReference = res["outDoc"] as DocumentReference;
          var now2:Date = new Date();

           // These fields map to columns in the DataGrid
          var progObject:Object = new Object();
          progObject.filename = token.name;
          progObject.timing = (now2.time - now1.time).toString();
          progObject.state = "Success";
          progObject.link = "<a href='" + dr.url + "'> open </a>";
          progressList.addItem(progObject);
      }

      // Prompt user to login on a fault.
       private function faultHandler(event:FaultEvent):void
            {
             if(event.fault.faultCode=="Client.Authentication")
             {
                 Alert.show(
                     event.fault.faultString + "\n" +
                     event.fault.faultCode + "\n" +
                     "Please login to continue.");
             }
            }

       // AEM Forms  logout method
     private function ROLogout():void {
         // Add result and fault handlers.
         token = cs.logout();
         token.addResponder(new AsyncResponder(LogoutResultEvent,LogoutFaultEvent));
     }

     // Handle successful logout.
     private function LogoutResultEvent(event:ResultEvent,
         token:Object=null):void {
         switch (event.result) {
         case "success":
                 authenticatedCB.selected = false;
                 btnFile.enabled = false;
                 btnLogout.enabled = false;
                 btnLogin.enabled = true;
                 break;
                 default:
             }
     }

     // Handle logout failure.
     private function LogoutFaultEvent(event:FaultEvent,
             token:Object=null):void {
             Alert.show("Logout failure: " + event.fault.faultString);
     }

          private function resultHandler(event:ResultEvent):void {
          // Do anything else here.
          }
        ]]>

      </mx:Script>
      <mx:RemoteObject id="EncryptDocument" destination="MyApplication/EncryptDocument" result="resultHandler(event);">
          <mx:method name="invoke" result="handleResult(event)"/>
      </mx:RemoteObject>

       <!--//This consists of what is displayed on the webpage-->
      <mx:Panel id="lcPanel" title="EncryptDocument  (Deprecated for AEM forms) AEM Forms Remoting Example"
           height="25%" width="25%" paddingTop="10" paddingLeft="10" paddingRight="10"
           paddingBottom="10">
         <mx:Label width="100%" color="blue"
                text="Select a PDF file to pass to the EncryptDocument process"/>
        <mx:DataGrid x="10" y="0" width="500" id="idProgress" editable="false"
           dataProvider="{progressList}" height="231" selectable="false" >
          <mx:columns>
            <mx:DataGridColumn headerText="Filename" width="200" dataField="filename" editable="false"/>
            <mx:DataGridColumn headerText="State" width="75" dataField="state" editable="false"/>
            <mx:DataGridColumn headerText="Timing" width="75" dataField="timing" editable="false"/>
            <mx:DataGridColumn headerText="Click to Open" dataField="link" editable="false" >
             <mx:itemRenderer>
                <mx:Component>
                   <mx:Text x="0" y="0" width="100%" htmlText="{data.link}"/>
                </mx:Component>
             </mx:itemRenderer>
            </mx:DataGridColumn>
          </mx:columns>
        </mx:DataGrid>
        <mx:Button label="Select File" click="uploadFile()"  id="btnFile" enabled="false"/>
        <mx:Button label="Login" click="ROLogin();" id="btnLogin"/>
        <mx:Button label="LogOut" click="ROLogout();" enabled="false" id="btnLogout"/>
        <mx:HBox>
         <mx:Label text="User:"/>
         <mx:TextInput id="txtUser" text=""/>
         <mx:Label text="Password:"/>
         <mx:TextInput id="txtPassword" text="" displayAsPassword="true"/>
         <mx:CheckBox id="authenticatedCB"
             label="Authenticated?"
             enabled="false"/>
     </mx:HBox>
      </mx:Panel>
 </mx:Application>

Consulte también

Invocación de AEM Forms mediante AEM Forms Remoting (obsoleto para formularios AEM)

Gestión de documentos con AEM Forms Remoting (obsoleto para AEM formularios)

Inclusión del archivo de biblioteca Flex de AEM Forms

Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting

Autenticación de aplicaciones cliente creadas con Flex

Invocación de servicios de componentes personalizados mediante Remoting invoking-custom-component-services-using-remoting

Puede invocar servicios ubicados en un componente personalizado mediante Remoting. Por ejemplo, considere el componente Banco que contiene el servicio al cliente. Puede invocar operaciones que pertenecen al servicio de atención al cliente utilizando una aplicación cliente escrita en Flex. Antes de ejecutar el inicio rápido asociado con esta sección, debe crear el componente personalizado Banco.

El servicio al cliente expone una operación denominada createCustomer. En esta conversación se describe cómo crear una aplicación cliente de Flex que invoque el servicio al cliente y cree un cliente. Esta operación requiere un objeto complejo de tipo com.adobe.livecycle.sample.customer.Customer que representa al nuevo cliente. La siguiente ilustración muestra la aplicación cliente que invoca el servicio Cliente y crea un nuevo cliente. La variable createCustomer la operación devuelve un valor de identificador de cliente. El valor del identificador se muestra en el cuadro de texto Identificador de cliente .

iu_iu_flexnewcust

En la tabla siguiente se enumeran los controles que forman parte de esta aplicación cliente.

Nombre de control
Descripción
txtFirst
Especifica el nombre del cliente.
txtLast
Especifica el apellido del cliente.
txtPhone
Especifica el número de teléfono del cliente.
txtStreet
Especifica el nombre de la calle del cliente.
txtState
Especifica el estado del cliente.
txtZIP
Especifica el código postal del cliente.
txtCity
Especifica la ciudad del cliente.
txtCustId
Especifica el valor del identificador de cliente al que pertenece la nueva cuenta. Este cuadro de texto se rellena con el valor devuelto de la variable createCustomer operación.

Asignación de tipos de datos complejos de AEM Forms mapping-aem-forms-complex-data-types

Algunas operaciones de AEM Forms requieren tipos de datos complejos como valores de entrada. Estos tipos de datos complejos definen los valores de tiempo de ejecución utilizados por la operación. Por ejemplo, el informe de createCustomer la operación requiere un Customer que contiene valores en tiempo de ejecución requeridos por el servicio. Sin el tipo complejo, el servicio al cliente lanza una excepción y no realiza la operación.

Al invocar un servicio de AEM Forms, cree objetos de ActionScript que se asignen a los tipos complejos de AEM Forms necesarios. Para cada tipo de datos complejo que requiera una operación, cree un objeto de ActionScript independiente.

En la clase de ActionScript, utilice la variable RemoteClass etiqueta de metadatos para asignarla al tipo complejo de AEM Forms. Por ejemplo, al invocar al createCustomer , cree una clase de ActionScript que se asigne a com.adobe.livecycle.sample.customer.Customer tipo de datos.

La siguiente clase de ActionScript denominada Customer muestra cómo asignar al tipo de datos de AEM Forms com.adobe.livecycle.sample.customer.Customer.

 package customer

 {
     [RemoteClass(alias="com.adobe.livecycle.sample.customer.Customer")]
     public class Customer
     {
            public var name:String;
            public var street:String;
            public var city:String;
            public var state:String;
            public var phone:String;
            public var zip:int;
        }
 }

El tipo de datos completo del tipo complejo de AEM Forms se asigna a la etiqueta de alias.

Los campos de la clase de ActionScript coinciden con los campos que pertenecen al tipo complejo de AEM Forms. Los seis campos ubicados en la clase Customer ActionScript coinciden con los campos que pertenecen a com.adobe.livecycle.sample.customer.Customer.

NOTE
Una buena manera de determinar los nombres de campo que pertenecen a un tipo complejo de Forms es ver el WSDL de un servicio en un explorador web. Un WSDL especifica los tipos complejos de un servicio y los miembros de datos correspondientes. Se utiliza el siguiente WSDL para el servicio al cliente: https://[yourServer]:[yourPort]/soap/services/CustomerService?wsdl.

La clase Customer ActionScript pertenece a un paquete denominado customer. Se recomienda colocar todas las clases de ActionScript que se asignen a tipos de datos AEM Forms complejos en su propio paquete. Cree una carpeta en la carpeta src del proyecto de Flex y coloque el archivo de ActionScript en ella, como se muestra en la siguiente ilustración.

iu_iu_customeras

Inicio rápido: Invocación del servicio personalizado del cliente mediante Remoting quick-start-invoking-the-customer-custom-service-using-remoting

El siguiente ejemplo de código invoca al servicio de atención al cliente y crea un nuevo cliente. Cuando ejecute este ejemplo de código, asegúrese de rellenar todos los cuadros de texto. Además, asegúrese de crear el archivo Customer.as que se asigna a com.adobe.livecycle.sample.customer.Customer.

NOTE
Para poder ejecutar este inicio rápido, debe crear e implementar el componente personalizado Banco.
 <?xml version="1.0" encoding="utf-8"?>
 <mx:Application  layout="absolute" backgroundColor="#B1ABAB">

 <mx:Script>
            <![CDATA[

      import flash.net.FileReference;
      import flash.net.URLRequest;
      import flash.events.Event;
      import flash.events.DataEvent;
      import mx.messaging.ChannelSet;
      import mx.messaging.channels.AMFChannel;
      import mx.rpc.events.ResultEvent;
      import mx.collections.ArrayCollection;
      import mx.rpc.AsyncToken;
      import mx.managers.CursorManager;
      import mx.rpc.remoting.mxml.RemoteObject;


      // Custom class that corresponds to an input to the
      // AEM Forms encryption method
      import customer.Customer;

      // Classes used in file retrieval
      private var fileRef:FileReference = new FileReference();
      private var parentResourcePath:String = "/";
      private var serverPort:String = "hiro-xp:8080";
      private var now1:Date;
      private var fileName:String;

      // Prepares parameters for encryptPDFUsingPassword method call
      public function executeCreateCustomer():void
      {

        var cs:ChannelSet= new ChannelSet();
     cs.addChannel(new AMFChannel("remoting-amf", "https://" + serverPort + "/remoting/messagebroker/amf"));

     customerService.setCredentials("administrator", "password");
     customerService.channelSet = cs;

     //Create a Customer object required to invoke the Customer service's
     //createCustomer operation
     var myCust:Customer = new Customer();

     //Get values from the user of the Flex application
     var fullName:String = txtFirst.text +" "+txtLast.text ;
     var Phone:String = txtPhone.text;
     var Street:String = txtStreet.text;
     var State:String = txtState.text;
     var Zip:int = parseInt(txtZIP.text);
     var City:String = txtCity.text;

     //Populate Customer fields
     myCust.name = fullName;
     myCust.phone = Phone;
     myCust.street= Street;
     myCust.state= State;
     myCust.zip = Zip;
     myCust.city = City;

     //Invoke the Customer service's createCustomer operation
     var params:Object = new Object();
        params["inCustomer"]=myCust;
     var token:AsyncToken;
        token = customerService.createCustomer(params);
        token.name = name;
      }

      private function handleResult(event:ResultEvent):void
      {
          // Retrieve the information returned from the service invocation
          var token:AsyncToken = event.token;
          var res:Object = event.result;
          var custId:String = res["CustomerId"] as String;

          //Assign to the custId to the text box
          txtCustId.text = custId;
      }


      private function resultHandler(event:ResultEvent):void
      {

      }
            ]]>
 </mx:Script>
 <mx:RemoteObject id="customerService" destination="CustomerService" result="resultHandler(event);">
 <mx:method name="createCustomer" result="handleResult(event)"/>
 </mx:RemoteObject>


 <mx:Style source="../bank.css"/>
     <mx:Grid>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="New Customer" fontSize="16" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="First Name:" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtFirst"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:Button label="Create Customer" id="btnCreateCustomer" click="executeCreateCustomer()"/>
                         </mx:GridItem>
                     </mx:GridRow>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="Last Name" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtLast"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="Phone" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtPhone"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="Street" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtStreet"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="State" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtState"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="ZIP" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtZIP"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                     <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="City" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtCity"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                             <mx:GridRow width="100%" height="100%">
                         <mx:GridItem width="100%" height="100%">
                             <mx:Label text="Customer Identifier" fontSize="12" fontWeight="bold"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                             <mx:TextInput styleName="textField" id="txtCustId" editable="false"/>
                         </mx:GridItem>
                         <mx:GridItem width="100%" height="100%">
                         </mx:GridItem>
                     </mx:GridRow>
                 </mx:Grid>
 </mx:Application>

Hoja de estilo

Este inicio rápido contiene una hoja de estilos denominada* bank.css*. El siguiente código representa la hoja de estilo que se utiliza.

 /* CSS file */
 global
 {
          backgroundGradientAlphas: 1.0, 1.0;
          backgroundGradientColors: #525152,#525152;
          borderColor: #424444;
          verticalAlign: middle;
          color: #FFFFFF;
          font-size:12;
          font-weight:normal;
 }

 ApplicationControlBar
 {
          fillAlphas: 1.0, 1.0;
          fillColors: #393839, #393839;
 }

 .textField
 {
          backgroundColor: #393839;
          background-disabled-color: #636563;
 }


 .button
 {
          fillColors: #636563, #424242;
 }

 .dropdownMenu
 {
          backgroundColor: #DDDDDD;
          fillColors: #636563, #393839;
          alternatingItemColors: #888888, #999999;
 }

 .questionLabel
 {

 }

 ToolTip
 {
        backgroundColor: black;
        backgroundAlpha: 1.0;
        cornerRadius: 0;
        color: white;
 }

 DateChooser
 {
        cornerRadius: 0; /* pixels */
        headerColors: black, black;
        borderColor: black;
        themeColor: black;
        todayColor: red;
        todayStyleName: myTodayStyleName;
        headerStyleName: myHeaderStyleName;
        weekDayStyleName: myWeekDayStyleName;
        dropShadowEnabled: true;
 }

 .myTodayStyleName
 {
        color: white;
 }

 .myWeekDayStyleName
 {
        fontWeight: normal;
 }

 .myHeaderStyleName
 {
        color: red;
        fontSize: 16;
        fontWeight: bold;
 }

Consulte también

Invocación de AEM Forms mediante AEM Forms Remoting (obsoleto para formularios AEM)

Gestión de documentos con AEM Forms Remoting (obsoleto para AEM formularios)

Inclusión del archivo de biblioteca Flex de AEM Forms

Invocación de un proceso de corta duración pasando un documento no seguro usando (obsoleto para formularios AEM) AEM Forms Remoting

Autenticación de aplicaciones cliente creadas con Flex

Pasar documentos seguros para invocar procesos mediante Remoting

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da