Application en ligne

Présentation

NOTE : Certaines commandes d'application en ligne peuvent modifier temporairement l'application active.

Cette interface est exportée vers Python. Elle est donc conforme aux conventions de dénomination de Python.

Créer l'application en ligne

Cette méthode crée une application en ligne.

# Create online application
online_application = online.create_online_application()

Valeurs préparées

Cet exemple montre comment écrire des valeurs préparées.

try:
    # Trying to create online application
    online_application = online.create_online_application()
 
    print("app:" + str(online_application.application_state) + "op:" + online_application.operation_state.ToString("f"))
 
    for expression in online_application.get_prepared_expressions():
        online_application.set_prepared_value(expression, '')
        print "%s: '%s' '%s'" % (expression, online_application.read_value(expression), online_application.get_prepared_value(expression))
 
    for expression in online_application.get_forced_expressions():
        online_application.set_unforce_value(expression)
        print "%s: '%s' '%s'" % (expression, online_application.read_value(expression), online_application.get_prepared_value(expression))
 
    assert len(online_application.get_prepared_expressions()) == 0, "Still some prepared values remain."
    assert len(online_application.get_forced_expressions()) == 0, "Still some prepared values remain."
 
    # Preparing a value and forcing it
    online_application.set_prepared_value("POU.testoutput", "123")
    online_application.force_prepared_values()
 
    # Preparing a value and writing it    online_application.set_prepared_value("POU.testint", "INT#1147")
    online_application.write_prepared_values()
 
except Exception as exception:
    print("Error: " + str(exception))
    if not system.trace:
       print("Please turn on the 'Script Tracing' function to get detailed information about the script execution.")

Exécuter l'ouverture de session sur l'application

Cette méthode applique l'ouverture de session à l'application. Si une connexion à l'application a été effectuée auparavant, elle sera désactivée et une nouvelle connexion sera établie.

Elle est constituée de deux paramètres :

oLe premier paramètre est l'option de modification.

oLe second paramètre supprime les applications antérieures, s'il est défini sur la valeur True.

# Get the project reference
project_reference = projects.primary
 
# Fetch the active application
active_application = project_reference.active_application
 
# Create the online application for it
online_application = online.create_online_application(active_application)
 
# Log in to the device.
online_application.login(OnlineChangeOption.Try, True)

Déconnexion de l'application

Cette méthode effectue la déconnexion de l'application. Si l'application n'est pas connectée, rien ne se passe.

# Get the project reference
project_reference = projects.primary
 
# Fetch the active application
active_application = project_reference.active_application
 
# Create the online application for it
online_application = online.create_online_application(active_application)
 
# Log in to the device.
online_application.logout()

Démarrer l'application

Cette méthode démarre l'application.

# Get the project reference
project_reference = projects.primary
 
# Fetch the active application
active_application = project_reference.active_application
 
# Create the online application for it
online_application = online.create_online_application(active_application)
 
# Log in to the device.
online_application.login(OnlineChangeOption.Try, True)
 
# Start the application, if necessary
if not online_application.application_state == ApplicationState.run:
    online_application.start()
 
    # Let the app do its work for some time
    system.delay(1000)

Arrêter l'application

Cette méthode arrête l'application.

# Get the project reference
project_reference = projects.primary
 
# Fetch the active application
active_application = project_reference.active_application
 
# Create the online application for it
online_application = online.create_online_application(active_application)
 
# Log in to the device.
online_application.login(OnlineChangeOption.Try, True)
 
# Stop the application, if necessary
if online_application.application_state == ApplicationState.run:
    online_application.stop()