Monday Mar 09, 2015

Governance made easy – Oracle API Catalog 12c by André Evensen

clip_image002Oracle recently launched a new product in their governance portfolio. As more and more applications, particularly in the mobile domain, rely on external APIs, the need for proper governance is ever growing.

Many organizations use ad hoc tools like spread sheets and wikis to keep track of their APIs. The API Catalog 12c may allow organizations to replace these tools with an online catalog that provides visibility to their APIs for application development.

The API Catalog is a lightweight product that positions itself as a stepping-stone on the way to “real” SOA governance. It includes a meta-model for API assets and tools for automatically populating it with APIs from specified servers. Developers can use the catalog to search for APIs they want to use.

Simplified, the API Catalog seem to provide answers to three important questions:

  • What APIs exist?
  • What do these APIs do?
  • How can they be consumed?

I will describe, from a high level perspective, how the API Catalog addresses these questions and why this may be a great tool for your organization. Read the complete article here.

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Sunday Mar 08, 2015

API Catalog 12c Full Overview by Luis Weir

clip_image002Oracle has recently released Oracle Enterprise Repository (OER) 12c and Oracle API Catalog (OAC) 12c.I am particularly exited on the latter as it aims to simplify management of APIs and promises to be able to create catalog of your services and APIs rapidly. Furthermore, although OER 12c maintains the same richness as in OER 11g, this product is targeted to advance users that are in need to address more complex governance requirements whereas OAC it’s a light-weight version of OER however tailored to address specific use cases of API management such as cataloguing, discovering and rating APIs.
This blog is about my first impression when installing, configuring and using Oracle API Catalog. In the blog I provide all steps I followed to achieve these tasks and at the end I provide a summary of my experience and feedback of the product.

Installation Pre-requisites

  • Download Weblogic Server 12.1.3 and OER 12.1.3 software binaries from following link (note that OAC uses same OER installer)

http://www.oracle.com/technetwork/middleware/repository/downloads/index.html

  • You will need an Oracle Database installed (you may also download database from previous link). If you already have an environment with an Oracle Database available you can check supported versions from following link

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

  • Ensure you have installed JDK 7.0 Update 55 or later. You can download it from the following link:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

  • Oracle API Catalog Home Page and Installation Guide:

https://docs.oracle.com/middleware/1213/oac/index.html
https://docs.oracle.com/middleware/1213/oac/install-cat/toc.htm

Installation

Firstly install Oracle Database and Weblogic Server as per instructions.

Then continue with installation of OAC 12c as per following instructions: https://docs.oracle.com/middleware/1213/oac/install-cat/intro.htm#CATIG146
Following key screenshots taken during installation of Weblogic Server and OAC and also some tips: Read the complete article here.

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Saturday Mar 07, 2015

In-depth look into Oracle API Catalog (OAC) 12c by Robert van Molken


clip_image002With the release of Oracle Enterprise Repository 12c another product was released. Oracle API Catalog 12c (OAC) allows you to build a catalog of your organization APIs. OAC provides a layer of visibility to those APIs so application development knows what and which one to use.  OAC includes a simple metamodel for an API asset, automation to populate OAC, and the ability for users to search OAC for APIs and understand the details of the APIs to assess their fit in the user’s application.

Installation

I’m not going to bore you with the details about the installation by giving a installation guide. It took me about 40 minutes from scratch (excluding downlOERoad time). The steps are describes in the installation guide Oracle provides. OAC is part of the OER 12c installation jar, but can be licensed and installed, as an own managed domain, without licensing and installing OER.

The steps to take on high level (from scratch):

  1. Download and install Oracle Database, Fusion Middleware Infrastructure 12c, Oracle Enterprise Repository 12c, RCU patch 18791727 and Weblogic patch 18718889 (these last two are important, else you can’t install OAC).
  2. Run RCU (oracle_common/bin/rcu.sh|bat) and create the OAC repository
  3. Run Weblogic Domain creation (weblogic/bin/config.sh|bat) and create a new which includes OAC.
  4. After installation and startup of weblogic and managed service you can find the OAC console at url: http://serverhost:8111/oac

Note: if you harvesting from another weblogic server (like SOA Suite 12c), the weblogic patch should also be installed there.

Taking the first steps

When taking my first steps the official getting started guide can help you a lot. OAC has four high-level features. OAC collects services, it has a harvester which creates API assets in OAC. After harvesting you can add metadata to the API assets like description, tags and documentation. After harvesting and editing an API asset it can be published so it is visible for application development. Published APIs can be discovered and used  through the API Catalog console and via the Oracle JDeveloper Oracle Enterprise Repository plug-in.

Read the complete article here.

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Friday Mar 06, 2015

API article series by Niall Commiskey

clip_image001Thanks for the nice API management introduction:

Installing API Catalog

Using the API Catalog for harvesting SOA service APIs

Using API Catalog for harvesting Service Bus APIs

developer -

Users with the developer role have the ability to search OAC for published APIs from the OAC console or using the Oracle Enterprise Repository JDeveloper plug-in. The developer can examine the API metadata to better understand the API. The developer also has the ability to declare interest in the API and submit ratings and reviews for an API.

curator -

In addition to the capabilities available to the developer role, users with the curator role can run the harvester to create new API assets in OAC. After API assets have been created, curators edit them to update their metadata. The curator also has the ability to publish an API, which makes the API available for discovery by developers.

admin -

In addition to the capabilities available to the curator and the developer roles, users with the admin role have access to the Adminpage in OAC. From this page users with this role can administer the infrastructure of OAC by editing system settings, creating new users, creating new departments, managing sessions, and using the import/export tool. Users with this role can also configure the security features included with OAC.

Read the all the articles here.

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Tuesday Feb 17, 2015

API Manager available for download

Description of subscribe.png followsThis is the initial release of the Oracle API Manager 12c. Please see the Documentation tab for Release Notes, Installation Guides and other release specific information. You can also view the Oracle SOA Release Notes Page provided for this release.

For more information please visit

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Thursday Feb 12, 2015

Creating a Mobile-Optimized REST API Using Oracle Service Bus by Steven Davelaar

clip_image002

Fusion Middleware A-Team architect Steven Davelaar kicks off a new series that shows you how to use Oracle Service Bus (OSB) 12c to transform SOAP-based enterprise system interfaces into a mobile-optimized REST-JSON API.  Read part 1 and Read part 2

Introduction

To build functional and performant mobile apps, the back-end data services need to be optimized for mobile consumption. RESTful web services using JSON as payload format are widely considered as the best architectural choice for integration between mobile apps and back-end systems. At the same time, most existing enterprise back-end systems provide a SOAP-based web service application programming interface (API) or proprietary file-based interfaces. In this article series we will discuss how Oracle Service Bus (OSB) 12c can be used to transform these enterprise system interfaces into a mobile-optimized REST-JSON API. This architecture layer is sometimes referred to as Mobile Oriented Architecture (MOA) or Mobile Service Oriented Architecture (MOSOA). A-Team has been working on a number of projects with OSB 12c to build this architecture layer. We will explain step-by-step how to build this layer, and we will  share tips, lessons learned and best practices we discovered along the way. In this first part we will discuss how to design the REST API.

Main Article

Design Considerations

Let’s start with the first challenge: how do you design an API that is truly optimized for mobile apps? A common pitfall is to start with the back-end web services, and take that back-end payload as a starting point. While that may limit the complexity of transformations you have to do in OSB 12c (you could even use the automated “Publish-As-REST” function on a SOAP business service) it leads to an API which is everything but optimized for mobile. This brings us to our first recommendation:

The REST API design should be driven by the mobile developer.

He (or she) is the only one who can combine all the requirements, information and knowledge required for a good design:

  • he designs and builds the various screens, knows the supported form factors and knows exactly which data should be retrieved for which screen.
  • he knows the requirements for working in offline mode, and knows how this can be supported and implemented using his mobile development tool set.
  • he is responsible for data caching strategies to optimize performance in both online and offline scenarios
  • he decides which read and write actions can be performed in a background thread not impacting the user-perceived performance.

To illustrate how the above aspects impact the design of the API, we will introduce the sample “human resources” app that we will use throughout this article series. Lets start with the three screen mockups our API should support: Read the complete article here.

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Wednesday Feb 11, 2015

SOA/API developer tool tips by Luis Augusto Weir

clip_image001Having been delivering SOA projects for over a decade, I’ve come across many tools some of which I hate and avoid using them (unless a client demands so)  and others that have made my life easier when delivering projects.

The below table is a recollection of tools I have used or come across which  I find useful and recommend SOA/API practitioners to use or at least evaluate. Enjoy :)

SDLC

Tool Name

Description + Links

Project/Scrum Management and Collaboration

Jira

Jira when used for scrum management is In my opinion is the the best tool I've used for managing scrums specially in an offshore / onshore distributed environment. It also has capabilities to manage GIT repositories which makes this an ideal tool for a complete cloud/based agile project with users all over the world.
https://www.atlassian.com/software/jira

Agilo

I used this tool some time back successfully in a large onsite SOA project and it worked very well for us. Product has come along way since then and It's more feature rich than it used to be. It has a 30 day trial.
http://agilosoftware.com/

Trello

Very simple, lean and easy to use project/task management and collaboration tool. It’s free for any number of users, can log-in using Google account.
Thanks Darren Atkinson for this tip!
https://trello.com
Furthermore there are some awesome plug-ins to use it for Agile projects:

https://www.burndownfortrello.com/

http://scrumfortrello.com/

Coop App

very clean UI supporting features such as share status updates, questions, links, and others.
http://coopapp.com/

PBworks

Suite of tools including in-app instant messaging, live notifications of changes to work spaces, live editing of documents, voice collaboration, wiki, and others. Can be used for full collaboration including project management.
http://www.pbworks.com/

Configuration Management

GitHub

I have been using this tool recently but found it amazing specially because of the GitHub client which is not intrusive to filesystem (like Tortoise and that create issues some times in the local file system) and very easy to use. It's social collaborative capabilities are awesome but also supports private projects however this latter feature it's not free. Also there are tutorials online.
https://github.com/
try.github.com

Get all tips from Luis here.

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Saturday Jan 31, 2015

API Catalog to Simplify API Management By Mala Ramakrishnan

Oracle is extending its API Management solution with a new product, API Catalog. This will give customers the ability to simplify the publication of API services that are developed in Oracle SOA Suite and other sources. Oracle API Catalog will be part of Oracle's broader API Management solution portfolio. Oracle API Catalog also integrates seamlessly with with Oracle Mobile Suite portfolio of products for mobile enablement. Oracle API Catalog harvests services in Oracle Fusion Middleware to allow one-click publish, submit ratings, or manage re-use across other consuming applications. Oracle's API Catalog is SOAP as well as REST/JSON compliant to easily support mobile mobile applications.

clip_image001

Here is a validation by one of our beta customers Peter Osborne, IT Technical Lead at LG&E and KU Services Company: "The Oracle API Catalog is a straightforward, easy-to-use governance tool for capturing what services exist, what these services do, and how they can be consumed. Within hours of installation, an organization can begin cataloging their SOAP and REST web services, regardless of the underlying service technology. The harvesting functionality provides a jump start on aggregating service details, while minimizing manual data entry and the risk of duplication and error. Finally, the included JDeveloper plug-in completes the lifecycle by providing a mechanism within JDeveloper to easily view and consume documented services."

To find out more information on Oracle API Catalog, visit us: Website and explore our Datasheet.

Thanks to Andre, Lucas and Luis for the first community feedback. Send us your feedback via twitter @soacommunity #APIcatalog12c & #OER12c

clip_image002André Evensen @anevensen ·  2h 2 hours ago

Harvesting services from WSDLs and publishing to #APIcatalog12c, works like a charm. @soacommunity #OracleSOA

clip_image004

clip_image002[1]André Evensen @anevensen ·  8h 8 hours ago

Newly released #APIcatalog12c installed on SOA Suite 12c. Next: Harvesting services! @soacommunity #OER12c

clip_image006

clip_image007Luis Augusto Weir @Luisw19 ·  10h 10 hours ago

Publish your #API in minutes with #OAC new killer tool to manage APIs @soacommunity @oracleace @OTNArchBeat http://tinyurl.com/oac12c

clip_image008Lucas Jellema @lucasjellema ·  11h 11 hours ago

Oracle Enterprise Repository 12c is available for download at http://www.oracle.com/technetwork/middleware/repository/overview/index.html … - including the brand new API Catalog @soacommunity

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Monday Jan 26, 2015

API Management – An Overview of API Catalog and API Manager at Fusion Middleware Partner Community Forum 2015

The Fusion Middleware Partner Community Forum takes place March 3rd & 4th in Budapest Hungary. During this annual conference You as an Oracle Partner can get the latest updates on the Fusion Middleware 12c solutions. “The Cloud Platform for Digital Business” will be the theme of the 20th conference. Keynotes will be delivered from Amit Zavery, Andrew Sutherland and SOA, BPM and Mobile product management including live demos. On the second day you can choose between three tracks: SOA, BPM or WebLogic and Mobile. As part of the SOA track Robert and Yogesh will present:

Oracle API Management – An Overview of API Catalog and API Manager incl. a demo

Mobile applications increasingly use Application Programming interfaces (APIs) in addition to enterprise systems of record in their development. The importance of an API economy is growing by the day. As the number of APIs produced and consumed by enterprises increases, thanks to an exponential growth of mobiles, tablets, smart devices and computing platforms, the management and visibility of these APIs becomes increasingly important.

Oracle API Catalog (OAC) and the upcoming Oracle API Manager allow organizations to easily manage their APIs and build a catalog of their APIs, powered by the industry leading Oracle Service Bus backbone (in case of API Manager), thus providing visibility and control to the enterprise and a social catalog to API consumers for application development. Come and find out more on this session, incl. the exciting demo.

Robert van Mölken

clip_image002

Amis

Senior Integration Specialist,

Twitter

Blog

Linkedin

Yogesh Sontakke

clip_image002[4]

Oracle Corporation

Principal Product Manager

LinkedIn

Twitter

For details please visit our Fusion Middleware Partner Community Forum registration page here.

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

Tuesday Jan 20, 2015

2 Minute Tech Tip: Tools for SOA Governance and API Management by Luis Weir

clip_image002

Watch the video here

SOA & BPM Partner Community

For regular information on Oracle SOA Suite become a member in the SOA & BPM Partner Community for registration please visit www.oracle.com/goto/emea/soa (OPN account required) If you need support with your account please contact the Oracle Partner Business Center.

Blog Twitter LinkedIn image[7][2][2][2] Facebook clip_image002[8][4][2][2][2] Wiki

About





Search

Archives
« May 2015
SunMonTueWedThuFriSat
     
13
23
24
25
26
27
28
29
30
31
      
Today