Changes between Version 8 and Version 9 of docs/j2slayouttoolbox/automatiser


Ignore:
Timestamp:
Jun 18, 2016 6:33:45 PM (17 months ago)
Author:
rloubejac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • docs/j2slayouttoolbox/automatiser

    v8 v9  
    1 = J2S Layout Toolbox - automatiser =
     1= J2S !LayoutToolbox - automatiser =
     2[[PageOutline]]
    23
    34{{{
     
    1112<h1 id="présentation">Présentation</h1>
    1213
    13 <p>J2S Net Toolbox est un serveur de requêtes TCP/IP. </p>
    14 
    15 <p>Seul, J2S Net Toolbox sait traiter nativement certains types de requêtes comme &#8220;ExportDocToPDF&#8221; qui permet de demander à Adobe InDesign d’exécuter un script JavaScript (voir plus bas pour la description de cette requête). </p>
    16 
    17 <p>J2S Layout Toolbox est le moteur permettant de fabriquer une mise en page. </p>
    18 
    19 <p>C’est une extension à J2S Net Toolbox. </p>
    20 
    21 <p>Les requêtes J2S Net Toolbox sont des structures XML. Pour déclencher cette requête, il faut poster cette structure XML en employant le protocole de communication J2S Net Toolbox. Une fois le traitement terminé, J2S Net Toolbox renvoie une structure XML contenant le résultat. </p>
    22 
    23 <h1 id="communiqueravecj2snettoolbox">Communiquer avec J2S Net Toolbox</h1>
    24 
    25 <p>J2S Net Toolbox est un serveur TCP/IP qui &#8220;écoute&#8221; les requêtes sur le port 60666 par défaut. </p>
     14<p>J2S NetToolbox est un serveur de requêtes TCP/IP. </p>
     15
     16<p>Seul, J2S NetToolbox sait traiter nativement certains types de requêtes comme &#8220;ExportDocToPDF&#8221; qui permet de demander à Adobe InDesign d’exécuter un script JavaScript (voir plus bas pour la description de cette requête). </p>
     17
     18<p>J2S LayoutToolbox est le moteur permettant de fabriquer une mise en page. </p>
     19
     20<p>C’est une extension à J2S NetToolbox. </p>
     21
     22<p>Les requêtes J2S !NetToolbox sont des structures XML. Pour déclencher cette requête, il faut poster cette structure XML en employant le protocole de communication J2S NetToolbox. Une fois le traitement terminé, J2S NetToolbox renvoie une structure XML contenant le résultat. </p>
     23
     24<h1 id="communiqueravecj2snettoolbox">Communiquer avec J2S NetToolbox</h1>
     25
     26<p>J2S NetToolbox est un serveur TCP/IP qui &#8220;écoute&#8221; les requêtes sur le port 60666 par défaut. </p>
    2627
    2728<p>Les requêtes sont des structures XML préfixées par un entête. L’entête est composé du préfixe &#8220;J2SX&#8221; de quatre octets suivi de quatre autres octets contenant la longueur de la structure XML au format &#8220;big endian&#8221;. </p>
     
    5859</code></pre>
    5960
    60 <p>Pour demander à J2S Net Toolbox d’écouter un autre port, il faut éditer le fichier &#8220;NTBConfigurationFile.xml&#8221;. Il suffit alors de changer l’attribut &#8220;portIn&#8221; dans la ligne originale suivante :</p>
     61<p>Pour demander à J2S NetToolbox d’écouter un autre port, il faut éditer le fichier &#8220;NTBConfigurationFile.xml&#8221;. Il suffit alors de changer l’attribut &#8220;portIn&#8221; dans la ligne originale suivante :</p>
    6162
    6263<pre><code>&lt;tcpIp portIn=&quot;60666&quot; portOut=&quot;60667&quot; /&gt; 
     
    6970<p>Sous Windows, il se trouve à côté du plug-in ou dans le dossier des préférences d’Adobe InDesign. </p>
    7071
    71 <h1 id="lastructuredelarequêtej2snettoolbox">La structure de la requête J2S Net Toolbox</h1>
     72<h1 id="lastructuredelarequêtej2snettoolbox">La structure de la requête J2S NetToolbox</h1>
    7273
    7374<p>Une requête est composée d&#8217;un élément XML racine &#8220;Request&#8221; qui possède un attribut &#8220;name&#8221; et un nombre variable d&#8217;attributs et éléments fils secondaires. </p>
     
    7778<p>Chaque requête possède son lot propre de paramètres passés dans les attributs ou dans les éléments fils de l&#8217;élément &#8220;Request&#8221; racine. </p>
    7879
    79 <p>Par exemple, cette requête va demander à J2S Net Toolbox sa version :</p>
     80<p>Par exemple, cette requête va demander à J2S NetToolbox sa version :</p>
    8081
    8182<pre><code>&lt;?xml version=”1.0” encoding=”UTF-8” standalone=”no” ?&gt;
     
    8384</code></pre>
    8485
    85 <p>J2S Net Toolbox répondra par exemple :</p>
     86<p>J2S NetToolbox répondra par exemple :</p>
    8687
    8788<pre><code>&lt;ResultList err=&quot;0&quot;&gt;
     
    9192<p></ResultList> </p>
    9293
    93 <p>À noter que J2S Module Editor permet de voir la requête envoyée à J2S Net Toolbox pour exécuter un module (lancer J2S Module Editor, afficher la console après une exécution). </p>
    94 
    95 <h1 id="exploiterunmoduledefichej2slayouttoolbox">Exploiter un module de fiche J2S Layout Toolbox</h1>
     94<p>À noter que J2S Module Editor permet de voir la requête envoyée à J2S NetToolbox pour exécuter un module (lancer J2S Module Editor, afficher la console après une exécution). </p>
     95
     96<h1 id="exploiterunmoduledefichej2slayouttoolbox">Exploiter un module de fiche J2S LayoutToolbox</h1>
    9697
    9798<h2 id="créerunemiseenpageexécuterunmodule">Créer une mise en page (exécuter un module)</h2>
    9899
    99 <p>J2S Layout Toolbox ajoute un nouveau type de requête à J2S Net Toolbox : &#8220;CreateLabel&#8221;. </p>
     100<p>J2S LayoutToolbox ajoute un nouveau type de requête à J2S NetToolbox : &#8220;CreateLabel&#8221;. </p>
    100101
    101102<p>&#8220;CreateLabel&#8221; nécessite les paramètres suivants :
     
    132133<p></Root> </p>
    133134
    134 <p>Ce fichier décrit les traitements qui vont être effectués par J2S Layout Toolbox : </p>
     135<p>Ce fichier décrit les traitements qui vont être effectués par J2S LayoutToolbox : </p>
    135136
    136137<ul>
     
    155156</ul></li>
    156157<li>Sous le nœud &#8220;Document&#8221;, &#8220;Spread&#8221; permet d&#8217;indiquer qu&#8217;il faut créer une planche (un &#8220;spread&#8221;). Dans cette page sera placé un enregistrement grâce au nœud &#8220;Label&#8221;.</li>
    157 <li>&#8220;Label&#8221; permet d’exécuter un module J2S Layout Toolbox :
     158<li>&#8220;Label&#8221; permet d’exécuter un module J2S LayoutToolbox :
    158159
    159160<ul>
     
    166167<h3 id="exemple">Exemple</h3>
    167168
    168 <p>L’exemple effectue un appel J2S Net Toolbox qui crée un fichier Adobe InDesign à l’aide de J2S Layout Toolbox. </p>
     169<p>L’exemple effectue un appel J2S NetToolbox qui crée un fichier Adobe InDesign à l’aide de J2S LayoutToolbox. </p>
    169170
    170171<p>Le code source se trouve dans le fichier &#8220;CockpitCreateLabel.py&#8221;. </p>
     
    209210<p>Sous la balise &#8220;UpdateFields&#8221;, on indique les champs à mettre à jour avec des balises &#8220;DBField&#8221; : Le choix des produits à mettre à jour se fait par l&#8217;attribut &#8220;dbPath&#8221; qui peut prendre des jokers &#8220;*&#8221; et &#8220;?&#8221; pour faire des mises à jour multiples. </p>
    210211
    211 <h1 id="exploiterunmoduledepagej2slayouttoolbox">Exploiter un module de page J2S Layout Toolbox</h1>
     212<h1 id="exploiterunmoduledepagej2slayouttoolbox">Exploiter un module de page J2S LayoutToolbox</h1>
    212213
    213214<h2 id="créerunemiseenpageexécuter">Créer une mise en page (exécuter)</h2>
     
    247248</code></pre>
    248249
    249 <h1 id="lesrequêtesj2snettoolbox">Les requêtes J2S Net Toolbox</h1>
     250<h1 id="lesrequêtesj2snettoolbox">Les requêtes J2S NetToolbox</h1>
    250251
    251252<h2 id="grouperlesrequêtes">Grouper les requêtes</h2>
     
    806807</table>
    807808
    808 <p>En plus de ces erreurs propres à J2S Layout Toolbox et à J2S Net Toolbox, les erreurs liées au système peuvent être émises (erreur Mac OS ou Windows). </p>
     809<p>En plus de ces erreurs propres à J2S LayoutToolbox et à J2S NetToolbox, les erreurs liées au système peuvent être émises (erreur Mac OS ou Windows). </p>
    809810
    810811<p>De même, des erreurs propres à Adobe InDesign peuvent être mentionnées (la plus courante est l&#8217;erreur générique 1 qui indique qu&#8217;un traitement Adobe InDesign a échoué).</p>