Airsupply Allgemeine Informationen

https://ext.supplyon.de/service/airsupply/SitePages/Home.aspx - in SupplyOn Confluence

Advanced Shipping Notification aka Despatch Advice

Create a new ASN on the UI, then add 1 to the second to last place of generated UX/UE number (the last place is the checksum). Then try to import the ASN. It won't work because of wrong checksum, but the importer will calculate the right checksum and it will write it in the error message.

The invoice information is held in the table TAIRPOLINEITEM (cInvoice* columns) and seems to be written in the database with the help of BillableObject import ( see BillableObjectStatusInboundXMLHandler.processRootElement()).

• NOP → New Order Published
• SAWC → Supplier Accepted With Changes
• OPEN
• CANREQ → Cancellation Request
• CANCELLED
• PARTSHIP → Partially Shipped
• SHIPPED
• PARTREC → Partially Received
• RECEIVED
• CCOR → Customer Changed Order Request
• SCOR → Supplier Changed Order Request
• REJECTED

Mit der “Send Mail” Funktionalität kann man dem anderen Benutzer eine bestimmte PO “zeigen”. Der Benutzer muss im System existieren. Testen kann man diese Funktionalität auf folgende Weise:

• Eine PO in der PO Overview maske selektieren und auf “Send Mail” Button klicken
• Es soll ein Fenster vom Mail-Client aufgehen in dem ein Link drinnen ist.
• Link kopieren
• In dem Browser abmelden (wichtig, da sonst die alte Session bleibt, wir brauchen aber eine neue)
• Link in die Adresszeile reinkopieren
• Den Rechnernamen in dem Link anpassen (“localhost” mit “kalaschnikowv01” ersetzen) und “Enter” drücken. Auf einem nicht-Lokalen System ist die Anpassung nicht notwendig.
• Login-Maske wird angezeigt. Dort anmelden.
• Der Browser soll nun die gewählte PO anzeigen.

Diese Beschreibung ist leider unvollständig, da ich grad jetzt das auf diese Art nicht hinbekomme.

Als Voraussetzung müssen im SOAPUI 2 Services laufen:

• Business Directory
• Api_Sopi_Mockservice

Um die POEMA (aka OSP aka One Shot POs) POs testen zu können muss man sich auf der folgenden Seite anmelden:

• http://kalaschnikowv01:8380/idp-sig-unreg oder http://kalaschnikowv01:8380/unreg

Daraufhin wird die Seite mit den ganzen Benutzern angezeigt, sowie mit einem Feld wo man ein Token eingeben muss. Das Token bekommt man aus der Tabelle TPORTALACL. Ungefähr so:

SELECT * FROM TPORTALACL WHERE CEMAIL LIKE '%kalaschnikow%' ORDER BY cCreationDate DESC

Dann das Token von der notwendigen cBOID (Business Object ID, z.B. PO header Id) eingeben und als entsprechende Supplier User anmelden. Die User Id sollte dabei stehen (CSMAID?).

(Wie oben erwähnt hat diese Art leider nicht funktioniert. Grundsätzlich müsste es aber auf diese Art klappen. Und es hat schon mal bei mir geklappt.)

Das war ein Tipp von Burkhard. Für meine Zwecke hat es erstmal ausgereicht.

Die Ansicht bekommt man den Code manipiluert. SASUserContext:

    public boolean isUnregSupplier() {
        return true;
//        return this.unregisteredSupplier;
    }

Evtl. muss man auch die checkForSessionBlockingPage() null liefern lassen.

Dann sich als Supplier anmelden. Die Sicht sollte der eines unregistrierten Suppliers entsprechen.

Als Mailserver kann man Smtp4dev verwenden. Um dies zu tun:

• Server starten (z.B. per TypeAndRun)
• http://localhost:5000 aufrufen

Api_Sopi_Mockservice should deliver as response to “createBOAccessTokensSCD” <userRegistered>false</userRegistered> for your user.

Api_Sopi_Mockservice should deliver as response to “createBOAccessTokensSCD” <userRegistered>true</userRegistered> for your user.

• First import a OSP (<SO-Order type=“CREATE”…)
• After that change the content of an important field of this OSP and import it again (<SO-Order type=“CHANGE”). Important field is for example field CollabRequestedQuantity or CollabPromisedQuantity.

Dieser “Mini-Prozess” (eigentlich ein Teil des PO-Prozesses) ist dafür gedacht um dem Kunden die Information zu liefern, die ihm hilft über die “Qualität” eines Lieferanten zu urteilen.

Für jede PO, die an diesem Prozess teilnimmt (die Konfiguration hängt an dem Kunden), wird beim Übergang in den finalen Status (RECEIVED) eine OTD-Line erstellt. Und beim Rückkehr aus diesem Status wird diese OTD Line wieder gelöscht.

Für die einfachen Tests (und wenn es passend ist) kann man OTD-Lines auf folgende Weise erzeugen:

1. eine Order raussuchen, die bereits eine OTD-Line hat
2. Status dieser Order auf RECEIVED setzen. Wenn er bereits auf RECEIVED steht, muss man ihn erstmal auf was anderes setzen.
3. Dann erscheint der OTD-Satz in der OTD-Übersicht. Der Customer kann dann aber keine Aktionen darauf ausführen. D.h. man muss sich als Lieferant anmelden und erst dann gehen die Buttons “Accept” oder “Reject”.

Die “Cause”-Listen werden aus der Tabelle TOTD_CAUSES erzeugt. Dabei werden die Daten für die Corporate Group Id (NICHT OrgId!) ausgesucht. Die Id einer Corporate Group ist in der Tabelle TORGANIZATION_SCD bei der jeweiligen Organization in der Spate CParentId eingetragen.

Die PO, die im OTD Prozess teilnehmen soll, muss Flag “OTDRelevant” auf “true” stehen haben. Außerdem die Organization muss für das Prozess OTD freigeschaltet sein. Das wird in der Tabelle tOTD_OrgConfig gemacht (1=freigeschaltet).

See also:
OTD Spezifikationen bei SupplyOn
Seeburger Wikipage über OTD

Meine Testdaten / User / etc. kann man u.a. im Ticket rm29905 abgucken.

To see the table open the following as source code!

id | name | name3 otd enabled buyer/seller group id

2017484 | TST_GBU_BCG1 | GBU_BCG1 1 buyer group (of 2017488) 2017488 | TST_GBU_B11 | GBU_CG1_B1 1 buyer 2017484 101700 | Airbus France | AFR1 1 buyer 100011 101659 | Airbus Deutschland | AGE 1 buyer 100011 101715 | Goodrich Actuation Systems| GOODR 1 seller 100027 2017479 | PO Buyer Industrial | PO Buyer Indust 1 buyer group (of 2017480) 2017480 | PO Buyer Industrial France| POFR 1 buyer 2017480

NCR ist eine Nachricht, die vom Lieferanten geschickt wird, wenn der Lieferant irgendwas nicht garantieren kann (Qualität?/Liefermenge?). Dann muss der Kunde diese NCR akzeptieren oder ablehnen.

To send a cancellation request supplier must click on “Cancel NCR” button. But this button should be first enabled. And it will be enabled only if the NCR is status INCOMPLETE. So before we need to set the status to INCOMPLETE. To do it we need to send a NCR Response message (with JMS client). The message can be found under D:\development\testdata\ncr .

There are 2 upload scenarios: creation and update. To test both at first send a NCR and download it. Then:

• for Create: change the value Supplier Ref.No. (first column in CSV)
• for Update: don't change (!) the value Supplier Ref.No., but change something different (E.g. affected quantity). It is also no good idea to change relation fields (customer/supplier group, orgname, CPs etc.) or material reference fields.

There are the following processes and their process definion builders:

• NCR → ConcessionProcessDefinition
  • Concession → ConcessionProcessDefinition
    • Airbus → AirbusProcessDefinition
      • Equipment (POE) → EquipmentProcessDefinition
      • StandardPart (POM) → StandardPartProcessDefinition
    • NonAirbus → NonAirbusProcessDefinition
  • NOE → NoeProcessDefinition

The process definition builders are used to manage fields, their visibility and “mandatoriness”.

To manage buttons visibility and “mandatoriness” the following schema will be used:

• on the server side we define it in the screen (e.g. NCRDetailsScreen.getButtonSpec()). We define there the json, which will be sent to the client. Then the client (our JavaScript code) decides if the button should be visible or not, mandatory or optional.

getAllCustomerStatus(): [OPEN, WIP, APCA, REFUSED, REWORK, REPAIR, ACCEPTED, SCRAP/REJECTED, CANCELLATION REQUEST, CANCELLED, PREVALIDATION, INACTIVE]

getAllSupplierStatus(): [DRAFT, INCOMPLETE, REVISION, SPSA, CID]

getAllStatus(): [DRAFT, INCOMPLETE, REVISION, SPSA, CID, OPEN, WIP, APCA, REFUSED, REWORK, REPAIR, ACCEPTED, SCRAP/REJECTED, CANCELLATION REQUEST, CANCELLED, PREVALIDATION, INACTIVE]

Allowed status changes are sketched in the following document: https://doc.supplyon.de/pages/viewpage.action?pageId=64588194

The implementation is in the following classes:

• AirbusConcessionStatusModel for Concession Airbus
• ConcessionStatusModel for Concession Non Airbus
• NOEStatusModel for NOE

See also the class hierarchy of *StatusModel classes.

Important: The checks whether a status change is allowed or not are made in NCRStateEngine. After that every field will be checked in NCRVerifier.

The status PREVALIDATION can be enabled for Buyer organization in tOrganization_SCD.cPrevalidation. To enable it following values are possible:

• POM - enable only for “Material and Part” (aka POM) concessions
• 1 - enable for all concessions

NoE has been started as a “copy” of NCR process.

NoE does not have M2M interface.

To set status of a NoE to 'INCOMPLETE' login as Buyer and …

Der Prozess besteht aus folgenden Screens:

• VMI summary → Übersicht aller VMI Sätze, in der man sie filtern und sortieren kann.
• Inventory projection → Übersicht des Zustands des Lagers aufgeteilt nach Tagen. Dort werden Lieferungen und Bedarfe grafisch und tabellarisch angezeigt.
• …

• Beim Erstellen von einer ASN aus einer VMI wird die Liefermenge (Shipped Quantity) auf null gesetzt.
• Auf dem Screen “VMI Summary” ist es möglich als Buyer “Planned Receipts” zu uploaden. Um diese Funktionalität zu testen kann man die Daten vorher downloaden. Der Knopf heißt “Download > Planned Receipt full (CSV)”
• Einen Bedarf (Demand) kann man generieren, wenn man eine DELFORV(?) Nachricht importiert. Oder (Udo: wenn das genauso wie beim SCM ist) kann man Bedarfe als Buyer auch über GUI eingeben.

Excursions sind Anleitungen für den Benutzer, die man auf einem bestimmten Screen anschauen kann. Die Excursions werden mit dem Excursion Editor manipuliert. Der Link zum Editor befindet sich oben rechts (funktioniert als Toggle). Eine bestimmte Excursion für einen bestimmten Screen wird geladen, wenn der aktuelle Benutzer die ensprechende Rechte hat.

• Auf PRD nachschauen, was die höchste Id ist, die unter 500000 liegt (die über 500000 sind die, die händisch vom Smartiadmin angelegt wurden)
• Dann in den aktuellen SQL-Skripten schauen, welche JobId die höchste ist.
• Stand 19.02.2020 → 185000

Export an sich wird über einen Custom Job angestoßen (s. Smartiadmin). Normalerweise heißen solche Jobs “Scheduler”. Außerdem muss eine entsprechende Nachrichtenart registriert werden. Diese Nachrichtenart muss im Scheduler-Job angegeben werden. Die Nachrichtenarten sind aber kodiert. Momentan weiß ich nur, dass 20 - Order bedeutet.

This are only temporary changes for local testing. (I have them from Volker Hanf)

Line 158

//req.setRequestHeader("X-IAM-Call-Back-Ctx-Path", "<%=request.getContextPath() + "/base/md/oo/OrderingOfficerServlet/store"%>");

Line 362

return postData("<%=context.getConfig().getString("OOC_IAM_CALLBACK_URL", "/base/md/oo/spinplugin/store")%>", data);

Line 421 (button to test → click on it)

<input type="button" value="save" onclick="saveData();"/>

Link to open the JSP page

http://localhost:8380/base/md/oo/spinplugin?ObjUserID=SMA0000N0N1A&ObjCompanyID=101700&userID=SMA0000N0N1A&mode=EDIT&randomKey=99000184422086538