RSJ-Labelprinter - follow the QR-Code RSJ-Next Generation Label Printing System - makes workflow easier RSJ-Software, Company Logo

Reusable Sidebar

Sie müssen das Rad nicht neu erfinden, wenn Sie LPSNG in Ihre Anwendung integrieren wollen: Unsere Reusable Sidebar Technologie erlaubt eine extrem einfache Integration in Ihre Anwendungen (Web oder nativ).

Ein Vorteil dieser Form der Integration ist, dass Verbesserungen und Erweiterungen der Technologie ohne Änderung Ihrer Anwendung automatisch genutzt werden können.

Bewährte Technologie

RSJ verwendet die Reusable Sidebar Technologie in den neuen Versionen der Add-Ins für Google Sheets, Microsoft Excel 365 und Microsoft Office 2013.

Was Sie machen müssen

  1. Laden Sie ein JavaScript von uns in Ihrem HTML Header
  2. Definieren Sie ein div auf Ihrer Web Seite, in dem unser Sidebar angezeigt werden soll.
  3. Registrieren Sie Iher Anwendung in LPSNG (Hinweis: Dazu benötigen Sie ein Pro Abo)
  4. Rufen Sie unseren Code in der Initialisierung Ihrer Web Seite auf
  5. Implementieren Sie eine (oder mehrere) einfache Callback Funktionen

HTML Einbindung

<html>
 <head>
  .....
  <script src="https://lpsng.rsj.de/sidebar/sidebar.js"></script>
 </head>
 <body>
 ......
  <div id="sidebarContents"></div>
 </body>
<html>

Hinweis: Die JavaScript Datei kann in Source Form geladen und angezeigt werden um die Anpassungsmöglichkeiten besser zu verstehen.

Anforderungen an die Web Seite

Der Reusable Sidebar beruht auf der Nutzung von IFRAMEs.

Wenn Sie unseren Code selbst aus einem sandboxed IFRAME aufrufen benötigen wir folgende Rechte:

  • allow-same-origin
  • allow-forms
  • allow-scripts
  • allow-popups
  • allow-popups-to-escape-sandbox

Registrierung Ihrer Applikation

  1. Gehen Sie auf Application Management
  2. Fügen Sie Ihre Applikation hinzu
  3. Setzen Sie die Redirect URL auf /loginComplete.html
  4. Notiren Sie bitte clientid und clientsecret

JavaScript Code

function getData(completion, options) {

   var data= [
       { barcode:"4012345123456", productName:"Coca Cola", price: "1.42", 
           labelCount: 10},
       { barcode:"4191709413901", productName:"dotnetpro", price: "14.90", 
           labelCount: 5}
       ];

   var job= {
       title:"Test Job",
       name: "Test Job",
       description: "Job description",
       data: JSON.stringify(data)
       };

   completion(job);
   };

function DoPrint(completion, options) {
   getData(completion, options);
   };

var conf= {
   div: "sidebarContents",        // div id fuer sidebar
   clientId: "..........",        // client_id aus "Application Managements"
   clientSecret: "............",  // client_secret 
   getData: getData
   };

window.LpsngEmbedded(conf);

Verpflichtende Konfigurationsparameter

divdiv id des Sidebars
clientIdclient_id aus Applikations Management
clientSecretclient_secret aus Applikations Management
getDataDatenquelle für Jobs

Weitere Konfigruationsparameter

Die an window.LpsngEmbedded übergebenen Konfigurationsparmeter erlauben es den Sidebar noch besser an Ihre Anwendung anzupassen:

debugAnzeige des Sidebar Statuses und der Kommunikation zwsichen den Frames im Debug Log
loginPartnerName des Login Partners
accessTokenAccess Token
userUser ID (GUID)
designAusgewähltes Design (GUID)
loadStateFunktion um die (User spezifischen) Sidebar Einstellungen zu Laden
storeStateFunction um die (User spezifischen) Sidebar Einstelllungen zu speichern
extensionsDefinition zusätzlicher UI Element
extensions.buttonTitleTitel vor den Buttons
extensions.buttonsBeschreibung der Buttons
extensions.optionTitleTitelk vor den Optionen
extensions.optionsDefinition der Optionen
urlBaseBasisadresse einer anderen LPSNG Webseite. Wird für RSJ interne Tests genutzt.
handlerHandler für Interfarme Messages. Nur für besondere Einsatzfälle (zB die Google Apps Script Integration).

Test Seite

Wir haben eine Testseite erstellt. Diese zeigt auch eine Vielzahl zusätzlicher Debug Informationen an.

Sie finden die Testseite hier.

Einsatzmöglichkeiten

Kontakt

Gerne helfen wir mit weiteren Informationen:

Name
Company
Email
Phone
How can we help you?

Or contact us directly:

RSJ Software GmbH
Grubmuehl 20
82131 Stockdorf
Germany

Phone: +49 89 89 41 42-0
Fax: +49 89 89 41 42-80
E-Mail: info@rsj.de

© Copyright 2011-2016 by RSJ Software GmbH Stockdorf. All rights reserved. - Version:1.11.0034