Friday, August 19, 2016

#520 ICS 16.3.3. New Administration features - Notifications, Logging levels & Logging in general














Notifications

Here I set hourly reporting via email.














I wait an hour and quelle surprise -













Logging Levels

























This is akin to the functionality available via the Fusion Middleware EM control.
Ok, it seems very techie, requiring an appreciation of the components and services listed,
but this is a tech feature, aimed at those doing troubleshooting etc. and not your Citizen Integrator.

Talking about logging, what are the log files available to you as an ICS user?

Let's investigate this via a simple example -


































Here is the response -












I now look at the ICS Administration tab -

























We see 2 sets of files to download -

Let's look at the Activity Stream -












Here I see the Request coming in to ICS -

I see my new contact, Jelllo Biafra.



















Here I also see the request being passed out from ICS to Sales Cloud














We also see the response from Sales Cloud -











Let's now look at the Diagnostic logs -














Note the extra AdminServer folder.

Here you find the typical weblogic logfiles -





















Thursday, August 18, 2016

#519 First steps in building an API on Apiary.io













I just signed up for a free account and got going.

Let's look at the first 3 activities in the Apiary workflow -












Here we decide on the domain space semantics and the architectural style to be used.
Then we can jump into the design, creating an API blueprint. Apiary provides you with an excellent editor for doing this.































Just amend the default API Blueprint accordingly.

 Here I change the Name and the Introduction.



As you can see, my api will allow one to create, retrieve, update and delete customers in the CustomersDB.

Here I define the Resource:




I then define the api as follows -



The Result -














Just a couple of points to note, the blueprint is divided into sections.
These are marked by the # symbol.

# is for metadata, such as the api name and definition







FORMAT: 1A entry just identifies the document as an API Blueprint.
Essentially adhering to version 1A of the specification.

Note HOST, this refers to the production URI of your API.

## is for Resources
I have defined 2 -








### is for actions of those Resources




Note the inclusion of the HTTP Method.


The action can include Request / Response definitions -






















Let's look at the definition of Get a Customer based on custid -























I click on Get a Customer based on custid -























Before I can Try, I need to Publish.












Once published, I have access to a Mock Server, which I can use for sanity testing.





















Here is  the expected Response -

























Apiary will also generate the client code in a variety of languages - here is JavaScript -



Here is the full list -

























Apart from the Mock Server - Apiary also has a Debugging Proxy, you can leverage -











The full API Blueprint Specification is here

BTW. Instead of using the API Blueprint to describe your API, you can also use Swagger.
Check out the Apiary doc here

Once the API has been designed, you can share it.
For example, you can invite folks to review it or even go the whole hog and create a team.



















As an individualist anarchist, I just invited myself.
Note, one can giving view or edit rights.






























I click on the link in the email and quelle surprise -

















As the Irish were wont to say, now you're sucking diesel!






Tuesday, August 9, 2016

#517 Real-Time Integration Business Insight now available as a cloud service

That was quick...

























Insight is now available as a service as part of SOA CS 16.3.3.


















More details on docs.oracle.com

























Just click here