Como's

Items

Cómo se inicia el periodo de prueba?

Cómo iniciar el periodo de prueba con el OLM básico

Cómo iniciar el periodo de prueba con el OLM avanzado

Cómo extender el periodo de prueba

Cómo registrar una aplicación utilizando una clave de registración?

Cómo registrar una aplicación utilizando el OLM?

Cómo rentar su aplicación por día, mes, año, etc?

Cómo borrar los datos de registración?

COMO SE INICIA EL PERIODO DE PRUEBA (TRIAL)?

Items relacionados:

Ejemplo 1: Iniciar periodo trial

Ejemplo 7: Iniciar Periodo trial con el OLM avanzado

Métodos fuera de linea  (dos opciones):

(1) En forma automática la primera vez que se ejecuta la aplicación utilizando el método MakeTrial(). Por ejemplo en el siguiente llamado al método:

MakeTrial(0,2,1,date,30,'000');

Solicitamos la generación de un periodo de prueba de 30 días para el index 0 con un máximo de 2 usuarios concurrentes y solo una instancia permitida, comenzando con la fecha actual del sistema y un campo Values = '000'. Este método solo se llama la primera vez que se ejecuta el programa, cuando todavía no existen datos de registración, cuando GetKeyData() devuelve un estado (Status = Unregistered).

El problema con este método es que el usuario puede descubrir donde se guardan los datos de registración y borrarlos, haciendo que el estado sea nuevamente Unregistered reiniciando así un nuevo periodo de prueba.

(2) No iniciar el periodo de prueba en forma automática y pedir al usuario que solicite una clave de registración para iniciarlo en forma manual. Esto significa que antes que el usuario complete este trámite la aplicación va a permanecer en estado Unregistered y aquí Ud. decide que hacer en su programa en este periodo a) no permitir la ejecución de la aplicación y b) permitir la ejecución en modalidad restringida. Creo que esta última es la mejor opción. Vea los esquemas de protección B,C,E y F.

Este método es más seguro que el de la opción 1 ya que si el usuario borra los datos de registración la aplicación volverá a su estado original Unregistered.

Métodos en linea (dos opciones):

Para esta modalidad utilizaremos el Online License Manager (OLM), para la opción 1) con la versión básica y en la opción 2) utilizando la versión avanzada. Para cualquiera de las dos opciones la operación es totalmente transparente al usuario y este no necesitará manipular claves de registración para lograrlo.

Iniciar el periodo de evaluación con el OLM básico:

Para el modo básico se utiliza el método OnlineGetKeyB(): Este método es seguro ya que si el usuario borra los datos de registración el periodo se reestablece al estado anterior ya que en el sitio web se guarda la clave con la que se registró la primera vez la que es utilizada para reestablecer nuevamente el periodo. Esto significa que si faltaban 5 días para expirar, al reestablecer los datos de registración seguirán faltando 5 días. Vea los ejemplos 1 y siguientes.

El llamado al método se hace de la siguiente manera:

AVLock.OnlineGetKeyB('000',0,0,30,1); 

Los parámetros son:

'000' : Values.

0 : Kind (0=Trial).

0 : número de clave (index).

30 : dias autorizados.

1 : instancias autorizadas.

Iniciar el periodo de evaluación  con el OLM avanzado:

Vea una implementación en el ejemplo 6 donde se utiliza el botón [Start with Advanced OLM] para hacer un llamado al método OnlineStartTrial().

OnlineStartTrial(0,2,1,30,'007');

Los parámetros son:

0 : número de clave (index).

2 : usuarios autorizados.

1 : instancias autorizadas.

30 : dias autorizados.

'026' : Values.

Para el modo avanzado se utiliza el método OnlineStartTrial(), puede ver en los esquemas siguientes los pasos involucrados.

Otro esquema de OnlineStartTrial con más detalles:

1. (en rojo). Se realiza un llamado al método OnlineStartTrial().

En el OLM se establecen valores por defecto para los valores del periodo trial que serán utilizados si como parámetros se pasan valores cero o vacíos:

$trialdays      = 30;

$extendays      = 15;

$trialusers     = 1;

$trialinstances = 1;

$trialvalues    = '000';

2. (en verde). El script advancedolm.php en el servidor genera una clave de registración para el índice enviado como parámetro y genera un nuevo registro en el OLM para manejar este indice y envia la clave calculada como respuesta al computador donde es guardada en las propiedades del componente y en los datos de registración. Si se hace este llamado estando ya iniciado el periodo trial, en lugar de crear un nuevo registro en el OLM se lee la clave desde el registro existente y se la retorna al computador, esto impide que el periodo trial pueda ser iniciado más de una vez.

Utilizando el Panel de Control del OLM podemos ver el registro generado por OnlineStartTrial(). Ingrese la url 'http://av-soft.com/olm4/s4cp.php, después se le solicitará el password, ingrese abc123, finalmente en search for coloque 12341 y para Into the field entre App ID. Verá un registro parecido al que se muestra abajo.

COMO EXTENDER EL PERIODO DE PRUEBA?

Método fuera de linea:

Debe enviarse al usuario una clave de tipo Trial para que este la registre. La clave contendrá los datos de inicio del periodo y la cantidad de días autorizados.

Método en linea:

Vea un ejemplo en el ejemplo 8, en la pestaña PrimaryRegistration y botón "Extend Trial". 

Aquí se utiliza el conjunto avanzado de scripts php para extender el período de evaluación. Se hace un llamado al método OnlineExtendTrial() con el script  'advancedolm.php' como vemos en la siguiente linea:

OnlineExtendTrial(0,1,1,15,'390');

Para que el usuario pueda extender su periodo trial antes Ud. debe autorizar la operación modificando el registro correspondiente asignando 'Y' al campo Éxtend'. Se puede hacer esto mediante el panel de control o desde el RegMonitor.

Desde el panel de control:

haga click sobre el icono Edit del registro correspondiente y pasará al cuadro de edición. Allí seleccione lo siguiente:

y haga click sobre el botón [Save Record]. Volverá a la pantalla anterior donde debe hacer click sobre [->Go] para refrescar los datos. Verá entonces que el campo Ext = 'Y', indicando que cuando se solicite la creación de una clave que extienda el periodo trial esto sea concedido.

Desde la utilidad RegMonitor:

Ingrese los valores corresponda para WebHost, Path, App ID, Encryption Key, InstallCode e Index y haga click sobre el botón [Go]. Entonces el registro se leerá desde el OLM y se rellenarán los campos con los valores correspondientes. Como se puede ver en la figura.  Seleccione "Allow to extend the trial period (Ext=Y)" y haga click sobre el botón [Save Data].

y recibirá el mensaje:

Finalmente avise al usuario que ya puede extender el período de evaluación. 

COMO REGISTRAR LA APLICACION UTILIZANDO UNA CLAVE DE REGISTRACION?

Items relacionados:

Ejemplo 1: Registrar aplicación utilizando claves

Ejemplo 7: Renovar la registración primaria en PC1

Los pasos a seguir con este método son los siguientes:

1. El usuario le envía el código de instalación (InstallCode)

   Ej: 058AF2-DF468A-166138-025661

2. Utilizando el InstallCode recibido de su usuario Ud. calcula la Clave de Registración utilizando la utilidad KeyGen (imagen de la izquierda).

Allí introduce los campos necesarios además del Installcode recibido del usuario y configura la clave a generar, en el ejemplo generamos una clave para el índice 0 con un solo usuario autorizado, dos instancias autorizadas, la clave será de tipo temporaria por 360 días a partir del 10/06/2008 y el campo Values = 730. La clave resultante es:W71DYGJ-96H2FGP-YAKJ70D-M8R08V9

3. Ud envía al usuario la clave de registración calculada. Para este ejemplo: W71DYGJ-96H2FGP-YAKJ70D-M8R08V9.

4. El usuario utiliza la clave recibida para registrar la aplicación. Para este paso tenemos dos opciones: En linea (ONLINE) y fuera de linea (OFFLINE). En el ejemplo 8 están implementadas ambas opciones.

a) ONLINE: La clave y demás datos de registración se guardan en la computadora local y también en la base de datos de la página web en el OLM. Se utiliza el método OnlineRegisterKey().

Otro esquema de OnlineRegisterKey() con más detalles:

El código utilizado en el ejemplo 8 para esta opción es el siguiente:

procedure TRegForm.BtnRegClick(Sender: TObject);

var s: string;

begin

if not testfields(True) then exit; //test fields Username, Company, Email and Registration Key

writeData; //Write Username, Company and Email to the Local Application data before to register

//try to register the key and post data to the OLM     

s:=Form1.AVLock.OnlineRegisterKey(trim(EdKey.Text));

if (s='50') then showmessage('Key registered successfully')

else showmessage('Registration Error: '+Form1.errormessage(s));

end;

b) OFFLINE: La clave y demás datos de registración se guardan solamente en la computadora local. El código utilizado en el Demo1 para esta opción es el siguiente:

procedure TRegForm.BtnReg2Click(Sender: TObject);

var err: integer;

   s:string;

begin

if not testfields(True) then exit; //test fields Username, Company, Email and Registration Key

writeData; //Write Username, Company and Email to the Local Application data before to register

err:=Form1.AVLockS31.RegisterKey(EdKey.Text); //try to register the key

case err of

   0: s:= 'Key registered successfully';

   1: s:= 'Key length mismatch';

   2: s:= 'Bad system date';

   3: s:= 'Registration was removed';

   4: s:= 'Invalid Registration Key';

   else s:= 'Unknown error';

end;

showmessage(s); //show operation result

end;

COMO REGISTRAR LA APLICACION MEDIANTE EL OLM?

Items relacionados: Cómo utilizar el panel de control del OLM

Usando el conjunto avanzado de scripts php se puede registrar la aplicación en forma definitiva o temporaria utilizando el método OnlineRenew(), invocando el script advancedolm.php y especificando el número de índice. En el ejemplo 8 se implementa con el botón [Activate].

Solo se debe utilizar cuando existe el registro correspondiente en el OLM, creado anteriormente al iniciar el periodo trial.

Igual que para extender el periodo trial, para que el usuario pueda activar la registración debemos modificar el registro correspondiente en el OLM utilizando el panel de control o la utilidad RegMonitor.

Veamos primero como hacerlo con el panel de Control del OLM. Ingrese la url 'http://av-soft.com/olm4/s4cp.php, después se le solicitará el password, ingrese abc123, finalmente en search for coloque 12341 y para Into the field entre App ID. Verá un registro parecido al que se muestra abajo.

Haciendo click sobre el icono Edit  ingresará al siguiente cuadro de edición:

Para habilitar al OLM para que genere una nueva clave de registración debemos seleccionar la opción:

e introducir los valores correspondientes en los campos Users, Instances y Values. Después especificar si la clave va a ser permanente o temporaria y en este ultimo caso especificar la cantidad de días del periodo a autorizar.

Finalmente hacer click en [Save Reciord], verá un mensaje como el siguiente:

Abajo puede ver como quedaron los datos correspondientes que definen la creación de la nueva clave.

Esto también se puede hacer utilizando el RegMonitor. Desde la pestaña [Olm Data] asigne los valores como se muestra en la figura de abajo y haga click sobre el botón [Save Data].

En este ejemplo vimos como se habilita para registración una nueva clave mediante el panel de control del OLM 4.0. En este caso permitimos 3 usuarios y 2 instancias. En Values pusimos 025. Seleccionamos una clave temporaria y establecimos la cantidad de días en 365.

Una vez modificado el registro del OLM, informamos al usuario que ya puede activar la aplicacion con los nuevos valores de registración. Entonces el susario activa esta nueva registración presionando el botón [Activate]

El código utilizado en el ejemplo 8 para este botón es el siguiente:

procedure TRegForm.BtnRenewalClick(Sender: TObject);

var s:string;

begin

if not testfields(False) then exit; //test fields Username, Company, Email and Registration Key

writeData; //Write Username, Company and Email to the Local Application data before to register

s:=Form1.AVLock.OnlineRenew(0);//try to renew the key

if (s='00') then showmessage('Renewal Applied') else showmessage(Form1.errormessage(s));

end;

En el OLM el script advancedolm.php calcula la clave según los datos del registro y devuelve la clave a la aplicación, la que finalmente efectúa la registración, obteniendo el mismo resultado que cuando la registración se hace ingresando la clave manualmente como vimos anteriormente.

COMO RENTAR LA APLICACION POR MES, AÑO, ETC?

Items relacionados:

Cómo registrar una aplicación utilizando una clave de registración?

Cómo registrar una aplicación utilizando el OLM?

Utilizando una de las opciones anteriores registre una clave temporaria por el periodo que desea rentar la aplicación.

COMO BORRAR LOS DATOS DE REGISTRACION?

Items relacionados.

Ejemplo 1: Borrar la registración existente

Métodos : Metodos de aplicación general y Métodos de acceso a internet

Para borrar los datos locales de registración utilice los métodos EraseReg() y EraseKey() y para borrar los datos en el OLM además de los locales utilice OnlineRemoveKey() con el OLM básico y OnlineRemoveReg() con el OLM avanzado.

He tratado de que esta ayuda sea lo más clara y completa posible, sin embargo es posible que hayan quedado aspectos sin considerar. Si Ud. nota que falta algo o ha encontrado errores o tiene alguna idea que podría ser útil para mejorar esta ayuda, por favor hágamelo saber.