Note that if you use the android-apt plugin or the kotlin-android plugin, you may use apt or kapt respectively instead of compile for postman-processor, e.g. Raas prompts on Workday UI. Our end-to-end integrations with third-party applications or services make it easy. Capture requests and cookies from your browser into Postman to speed up your debugging workflow through the Postman Interceptor or the Postman proxy. With the WID, you query Get_Import_Processes to retrieve the status. Related Articles. . It turns out to be very simple, anyone finds it helpful. Postman REST Client serves a lot of purposes like sending requests and inspecting responses. We've written a similar tutorial on getting invoices from the Netsuite API using Python here! I have ask my HR team for access to Workdays API so I can start to convert our automation to use Workday API calls. This short video explains how you can get to REST APIs in Workdayhttps://www.integratehelp.com/#workdayhcmtrainings, #workdayhcm, #workdayintegration, #RestAPI Wipro Ltd. - Minneapolis, MN. Postman's collection folders make it easy to keep your API requests and elements organized. There is nothing fancy or unexpected in making a class parcelable. Then you use Get_Import_Process_Messages to retrieve the messages. Retrieve Workdays Objects by List. Site design / logo 2023 Stack Exchange Inc; user contributions licensed under CC BY-SA. You signed in with another tab or window. Select Mock Servers in the sidebar, select a mock server, and select Edit Configuration. As a note from the authors (whove built an entire Workday integration), we truly believe the quickest way to get a Workday integration is via a unified API provider, such as Merge.. First approach: Right click in the connection managers panel and click "New Connection" and Select ZS-HTTP connection from the connection type list and click OK. OR . Add the following lines to your build.gradle file, replacing $postman_version with latest version from Maven Central. Our intelligent data core is able to ingest data from outside Workday, and securely blend it with financial and people data in Workday. More importantly, at this point you will be requested to select which permissions to give your application. The HCM and FIN modules of WorkDay - a cloud based management application - is going live on July 1, 2021. You, like most developers, are probably used to a dictionary. Workday Financial Management The finance system that creates value. Your collections can also contain JavaScript code to tie requests together or automate common workflows, and you can use scripting to visualize your API responses as charts and graphs. As companies look to transform into API-first businesses, they're leveraging the Postman API Platform for these three key benefits:. What should I do when an employer issues a check and requests my personal banking access details? Get integrations up and running fast. This isnt the end, though youll need to adjust the query to be more precise. It further allows you to visualize your data and also provides in-built support for variables. Workday request works in SoapUI but not in Postman. See what theyve built and get inspired. To help you think about the structure of SOAP, you can think of a SOAP Request as a package/ The Envelope is being the packaging, the Header is the Sent from Address, and the Body is the letter/contents of the package. Can someone please tell me what is written on this score? HubSpot's API documentation is split into two sections: reference docs and integration guides. Workday Human Capital Management The HCM system that adapts to change. No problem. Our Unified API has also smoothed out pagination and authentication.. When you send this request, the body will be empty, but the ID of the created account will be in the OData-EntityId header value. Search Workday for Public Web Services; Open the report; Hover over Human Resources and click the three dots to access the menu; Click Web Service, then View WSDL 2) For HOW TO, enter the procedure in steps. The simplest (and cheapest, in terms of processing) method: More information: Retrieve a table row using the Web API. Link collections to your APIs to add API elements like mocks, monitors, and tests to your APIs. Last Modified on 11/26/2019 6:06 pm MST. Note: Client Id and Client secret are the . Postman is an API platform for building and using APIs. My company is migrating our HCM system over to Workday. Give the Apideck HRIS API a try. Get in touch if you want to submit a tip. Did you spot any incorrect or missing data? The same class from above now becomes this: That's all you need to do get Postman working! When creating the application, note that the application must have a unique name within the company. It simplifies every step of the API lifecycle allowing you to create, share, test, and document APIs easily. . 1. jbrag 2 yr. ago. Developer Center Contact Center Management Workdays API Methods Retrieve Workdays Objects by List. How are small integers and of certain approximate numbers generated in computations managed in memory? Our customers build all kinds of apps with Workday. The response includes the JobId property, which contains the GUID of the asynchronous duplicate detection job that detects and logs duplicate records. Reference docs. However, to make this part easier, we have included a live template that you can use in Android Studio. As a REST endpoint, these prompts are passed as request parameters. Postman Resources; Client Side Configuration. It is a full ESB platform that can call http(s) SOAP and REST services. Please remove the xtt:align="right" from each tag, like below Sign up and start using Postman now for free . Web API requests should include certain HTTP headers. Mainly, it looks like you're missing the authentication pieces via a SOAPHandler for the WS-Security Credentials. Set the body of the request with information about the account to create. We wrote an annotation processor that can read through a class that you mark as a candidate for processing, and it will generate all the code in the Creator and in writeToParcel(Parcel, int). For more information and a list of the affected resources, see our documentation. Only top scored, non community-wiki answers of a minimum length are eligible, Site design / logo 2023 Stack Exchange Inc; user contributions licensed under CC BY-SA. Professional Summary:<br> Around 5+ years of Workday experience developing Inbound/ Outbound integrations Using Core Connector, Workday Studio, EIBs, PICOF/PECI, Custom Reports and working as . Collections offer features to collaborate with the team members, generate tests for your API, run the requests automatically, authorization config, pre-request scripts, and any variables you want to share among the collection's requests. Watch the video to see how Postman is revolutionizing the way they work. Take a look at Workday's documentation on Workday's internal community on how to set this up. Postman also doesn't work with obfuscation, so you if you have obfuscation turned on, you'll need to keep all of your parceled classes. Check out Merge if you're looking to add 40+ HRIS integrations with one HR API. More information: Update and delete table rows using the Web API. Put someone on the same pedestal as another, Finding valid license for project utilizing AGPL 3.0 libraries, Sci-fi episode where children were actually adults. Imran S. asked Dec 18, 2016 at 12:15. We first need to create the service principal with the following Azure CLI command: az ad sp create-for-rbac --role Contributor. Postman; API automation; Creating Test Cases; Integration experience; Workday experience is a must; Financial experience; The interview process will be two stages. This will be required to create a Workday REST connection. You need to have an environment that was created by using the steps described in Set up a Postman environment. You can also generate Postman Collections for multiple stages of your API lifecyclefor mocks, documentation, tests, monitors, and moreall from the specification file, all in sync. Financial, workforce, and operational analytics; benchmarking; and data management. Your results should appear in the right pannel. Pre requirements Establishing connection using SoapUI: Import the WSDL file. Thats why we give developers the tools they need to create unique finance and people solutions, right in Workday. Read time: 2 mins Get a list of all workday objects of an account. You can change the mock server's name, environment, network delay, and privacy setting. The POST method will create a new resource with that information. What information do I need to ensure I kill the same process, not one spawned much later with the same PID? get. It covers a bunch of the gotchas, including handling the security aspect. BulkDetectDuplicatesResponse ComplexType is returned as a response from BulkDetectDuplicates action. Its not so much about using SOAP in ServiceNow to import Workday data, but rather how to speed up the process of getting the right data, parsing it, and extracting it efficiently. The Workday SOAP API docs for the Human Resources web service can be found here (other versions here). Postman's schema editor makes it easy to work with specification files of any size, and it validates specifications with a built-in linting engine. After step four, you'll need to follow different processes depending on which Workday API endpoints you wish to pull data from. Adjusting the XPath query at the top will allow for rapid iteration, as the results are immediately shown on the right side of the page. https://community.workday.com/rest/oauth. I cut my teeth with the old HR Integrations application, which included a Workday integration (among others). With a rich set of SOAP and REST APIs, work with your data, processes, and resources to connect apps or external systems seamlessly. Use Raster Layer as a Mask over a polygon in QGIS. E2E automation solutions for Cloud based Financial and HR applications for world's leading clients. Postman simplifies each step of the API lifecycle and streamlines collaboration so you can create better APIsfaster. Easily store, catalog, and collaborate around all your API artifacts on one central platform. You can research all the various ways to authenticate with the Azure REST APIs here: Azure REST API Authentication. The Postman platform includes a comprehensive set of tools that help accelerate the API lifecyclefrom design, testing, documentation, and mocking to the sharing and discoverability of your APIs. Youll need to tweak this request body to fit the API endpoint youd like to call. You can also simulate network latency in your mock server by specifying custom delays for responses. Paste that URL into the request and set the authentication to Basic. When you send this request, the account record with the given accountid gets deleted. It can be quite confusing. Select the Authorization tab. Fill up the values as shown in the image. How to provision multi-tier a file system across fast and slow storage while combining capacity? Interceptor can catch requests and responses. I havent, so I dont pay much attention to those API docs. postman; workday-api; Share. Working with Workday WS v32.1, this is still an issue but the solution applies. Base URL. A new panel will open up with different values. Note: You can import and work with the rest of the Okta API using the link at the top of each API reference page, or see all Postman collections. Postman can write to the Parcel any of the following types. Can dialogue be put in the same paragraph as action text? Use Postman with the Web API But instead of just getting those pages, you have to grab the whole H book. http://dovetailsoftware.com/hr/gcox/2014/ To add to the responses already here, you may need to also add in your credentials in the SOAP header, like so: And if you're like most software developers, you want to avoid tedious and tiresome like the plague. We encourage you to join the SailPoint . If you annotate a private field with, Postman cannot populate final fields. This content is blocked due to your cookie preferences for this site. Unfortunately, there is still some boiler plate code you have to deal with. API Use at WashU for the Workday Implementation. Postman is intended to be used in cases where you have parcelable classes with a lot of fields that need to be serialized. Spellcaster Dragons Casting with legendary actions? The ID returned from workday's API is actually the Workday ID, not Worker ID. The data we send in a POST request is . Every day millions of developers do amazing things with APIs, together. Engagement Window Customization . Determining the right combination of Response_Group parameters can be challenging, as some will enable an information chunk and others will enable even more, but then others will restrict some of the information that was just allowed via another parameter. Save time by using prebuilt templates to tackle some of the most common high-effort integration work. Content Discovery initiative 4/13 update: Related questions using a Machine Possible to consume badly formed Fault Messages? Workday Adaptive Planning The planning system that integrates with any ERP/GL or data source. Every request should include the Accept header value of application/json, even when no response body is expected. SoapUI. At Merge, weve built an API that lets you easily pull from Workday using REST (no SOAP required). Contribute to requirement analysis, conduct client meetings, create functional document. SOAP is a giant pain in the ass at best, if you ask me. Restart Android Studio. New external SSD acting up, no eject option. Imran S. Imran S. 935 2 2 gold badges 15 15 silver badges 32 32 bronze badges. The response from the preceding RetrieveDuplicates function should look like this: Use a POST request with the actions listed in Web API Action Reference to perform operations that have side effects. They are a good reference, but mostly its a bunch of jargon that assumes that youve already taken the 100- and 200-level classes on Workday and web services. Every request should include the Accept header value of application/json, even when no response body is expected.The current OData version is 4.0, so include header OData-Version: 4.0.Include the OData-MaxVersion header so that there is no ambiguity about the version when there are new releases of OData. Open Technologies Invest in the knowledge, specifications, standards, tooling, data, people, and organizations that define the next 50 years of the API economy. Merge is a leading provider of HRIS, Payroll, and Accounting integrations for B2B companies. Lastly, navigate to Action > API Client > Manage Refresh Tokens for Integrations. "App development with Workday is fast and secure given our ability to reuse established data structures and design patterns.". In a traditional REST API call we would use method=GET, but with SOAP well be calling POST to the Get_Workers_Request endpoint to access this data. The following example retrieves two properties from a specific account and expands information about the related primary contact to include a full name. The request in the example just shown submits an asynchronous duplicate detection job that runs in the background. For this post, I will be sharing with you how I was able to establish connection with Workday API using Postman and SoapUI. See a wide selection of detailed use cases from nearly every industry on the Postman case studies page. A library that implements Parcelable for you. The sourcing system that works with all ERP, P2P, or analytics applications. 9999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999999 Improve this question. Connect and share knowledge within a single location that is structured and easy to search. To learn more, see our tips on writing great answers. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Postman Idioms. Oct 2021 - Present1 year 7 months. The resulting response will look similar to this: Weve shortened the response here, but the response will likely include fields like the employees contact information, hire date, weekly hours and more! Click on the Human_Resources link to see the list of specific CRUD operations available and their associated descriptions.. For this tutorial, you'll be making GET and POST calls to the endpoint using the Get_Employee operation to fetch employee data and the Add_Vaccination operation . [System.Xml.Serialization.XmlElementAttribute("Request_Criteria", typeof(Asset_Book_Rule_Request_CriteriaType), Order = Official answer from Workday is as follows In this article, we'll cover how to understand Workday's SOAP API, how to set proper permissions in Workday, and how to write a GET request to Workday's SOAP API in Python. Postman (initial setup) To grab the installation package of Postman, I would like to redirect to this site. The Workday ID or WID is a direct reference to any object . A good search phrase To preface; I'm not familiar with Workday Studio, and there don't seem to be any public docs, so there may be some nuance here that this answer misses. Asking for help, clarification, or responding to other answers. You can authenticate via WS-Security when interacting with Workday's native SOAP web services. SOAPUI is required. In Workday, obtain the Workday REST API endpoint that the Prism class requires as a parameter. The SOAP blocks are Envelope, Header, Body, and Fault. workers. There you go! Expand the project and choose the service you want to send request. Postman monitors help you stay up to date on the health and performance of your APIs. The HTTP methods and values you use depend on the type of operations you want to perform. (At least it lets you get a single book, not the entire encyclopedia set, I guess.). Modify the XML body request, just like what we did in the Postman. All details can be found here A Postman collection consists of a group of HTTP requests. Within the body, you also likely need to add the Request_References parameter and apply a value (likely an employee number) to the parameter that will limit the response to just a single worker (or maybe a handful) to start. To set up authorization for a collection. Except, that is, for when I get an itch about the WD integration for a customer taking 17+ hours to complete due to the amount of (useless) data that comes back for each worker. { You can also define filters for your prompts. I finally figured this out after debugging a working SOAP UI example by installing wireshark and forcing my request over HTTP! Use a POST request to send data to create a record. Well then want to make the call by calling requests with the URL and request body. Youve successfully pulled the employees object from the Workday API. The result? Connect and share knowledge within a single location that is structured and easy to search. REST API for Oracle Enterprise Performance Management Cloud ; REST API Examples with Postman; Example: Using REST APIs to Upload with Postman; Example: Using REST APIs to Upload with Postman The API client automatically detects the language of the response, links, and format text inside the body to make inspection easy. Under the Type drop-down options, select Basic Auth and enter your username and password you enabled in the Zendesk Support admin interface. What if there's a field I don't want to include in the Parcel? Include your credentials in your body request - username and password. Read on to learn about our latest update to Merge Link, and how you can display requested data in your products linking flow. Note. Make documentation a core part of your API workflow with Postman's automatic documentation features. Is there a free software for modeling and graphical visualization crystals with defects? Note that Postman will compile if it encounters a List or a Map, but if one of the items is not of a type that Postman can handle, it will throw a runtime exception when it tries to write the object to the parcel. After you've imported the Users API collection and added your Okta org information to your environment, you're ready to send a . To call a different endpoint, change the bsvc payload in the SOAP body to the endpoint of your choosing. Modify the XML body request, just like what we did in the Postman. Note that to deal with pagination, you need to set a page number for the request as well. So I've added this to the original XML and removed the Basic Auth header from the request and it works. But I digress. You are now able to establish connection to your Workday tenant and you may now integrate the API to your apps. The API reference documents the classes, methods, and non-method properties comprising the API. With enterprise-class scalability, security, and reliability, you can deploy new capabilities efficiently. Discover the latest APIs, Collections and Workspaces by Workday on Postman Public API Network They are a good reference, but mostly it's a bunch of jargon that assumes that you've already taken the 100- and 200-level classes on Workday and web services. Postman can store and manage API specifications, documentation, workflow recipes, test cases and results, metrics, and everything else related to APIs. You can sign up and get started with Postman for free. The Workday SOAP API docs for the Human Resources web service can be found here (other versions here). This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. Click the Reference menu then select an API. The Postman platform includes a comprehensive set of tools that help accelerate the API lifecyclefrom design, testing, documentation, and mocking to the sharing and discoverability of your APIs. In this article, we outline the how and the why behind our brand new single tenant offering for enterprise customers. Workday offers an integration platform with an Eclipse based IDE. Remember to save the Client ID and Client Secret before clicking Done. This means the cached database is not being populated. The duplicates are detected according to the published duplicate rules for the table type. So we did. With enterprise-class integration technology at its core. It really is a trial-and-error situation until you find the data you need and nothing more. In that case, instead of annotating the class with @Parceled, annotate the fields you want included with @Parceled. By clicking Accept all cookies, you agree Stack Exchange can store cookies on your device and disclose information in accordance with our Cookie Policy. I found the following blog post extremely helpful when consuming Workday services. As the name suggests, collections help you organize your workspace. Solution. Copyright 2023 API Tracker, an Apideck product. All other fields will be ignored. So, the plan here is that you are going to send requests externally to Workday using their public API. Call an API endpoint related to the data you need to check whether you get a response from Workday with the credentials you use. The Postman API client is the foundational tool of Postman, and it enables you to easily explore, debug, and test your APIs while also enabling you to define complex API requests for HTTP, REST, SOAP, GraphQL, and WebSockets. Please rectify and retry. To help you decide which tools work best for your API automation tests, this article presents a review and comparison of three popular tools for API testing: SoapUI, Postman, and the Katalon Platform. The API client automatically detects the language of the response, links, and format text inside the body to make . Project and resource management, billing, time tracking, expenses, and more. Admissions, financial aid, student records, advising, and more. The way to send attachments (to incidents in this case) using the Jetty API Rest architecture in Remedy is not clear in most articles, so I share the method that worked for me using Postman. 3. High Productivity through superior discoverability and collaboration. Is blocked due to your APIs finds it helpful Netsuite API using Python here ERP/GL or data source specific and. An issue but the solution applies the Postman do when an employer issues a check and requests my banking! By list full name v32.1, this is still an issue but the solution applies write to the endpoint your. At least it lets you easily pull from Workday with the WID, you can Sign and. Class from above now becomes this: that 's all you need to create record... Response includes the JobId property, which included a live template that you are going to send data create. Developers do amazing things with APIs, together is an API platform building... Tracking, expenses, and document APIs easily the response, links, and text. The end, though youll need to have an environment that was created by the... S collection folders make it easy day millions of developers do amazing things with APIs, together of annotating class... Automation to use Workday API using Python here the original XML and removed the Basic Auth enter... By calling requests with the given accountid gets deleted not the entire encyclopedia set, will! Postman and SoapUI you to visualize your data and also provides in-built support variables! Following types action text requirement analysis, conduct Client meetings, create functional document with all ERP P2P... Client ID and Client secret before clicking Done use depend on the health and performance of API. Eclipse based IDE Postman for free to grab the installation package of Postman, I.... Actually the Workday SOAP API docs for the WS-Security credentials the example shown. The image data and also provides in-built support for variables public API: questions. Our latest update to Merge postman workday api, and securely blend it with financial people... Document APIs easily the query to be very simple, anyone finds it helpful CLI command: ad... The status obtain the Workday SOAP API docs for the request in the example just shown submits an duplicate! All ERP, P2P, or responding to other answers figured this out debugging... Parcelable classes with a lot of purposes like sending requests and cookies from your browser into to. Workflow with Postman 's automatic documentation features this out after debugging a working SOAP UI example installing... The end, though youll need to create a new resource with information. Following blog POST extremely helpful when consuming Workday services new panel will open up with different values set I! Clarification, or analytics applications to any branch on this score part of your.. The cached database is not being populated request, just like what we did the! Please remove the xtt: align= '' right '' from each tag postman workday api like developers. Soap web services two properties from a specific account and expands information about the related primary Contact include! Content Discovery initiative postman workday api update: related questions using a Machine Possible to consume formed... 'S all you need to check whether you get a list of all Workday Objects of an account a... Your APIs to add API elements like mocks, monitors, and Fault what should do... Use in Android Studio badges 32 32 bronze badges your cookie preferences for site... Workday & # x27 ; s collection folders make it easy to search consume badly formed Fault?... Values you use into two sections: reference docs and integration guides this means the database!, replacing $ postman_version with latest version from Maven Central a Postman collection consists of a of. Badges 15 15 silver badges 32 32 bronze badges gold badges 15 15 silver badges 32 32 badges! Retrieve the status your workspace covers a bunch of the most common high-effort work... Api requests and elements organized it helpful like mocks, monitors, and reliability, have., Postman can not populate final fields REST endpoint, change the bsvc payload in the SOAP are., Postman can write to the Parcel so I dont pay much attention those... Wide selection of detailed use cases from nearly every industry on the health and performance your. And elements organized API lifecycle allowing you to create a record and tests your... Better APIsfaster delays for responses requirements Establishing connection using SoapUI: Import the WSDL file modify the body... We did in the Parcel create-for-rbac -- role Contributor, header, body, and Accounting integrations for companies... World & # x27 ; s API is actually the Workday ID, not Worker.... Give developers the tools they need to be very simple, anyone finds it helpful )! Duplicates are detected according to the original XML and removed the Basic header... Have included a Workday REST connection solutions for cloud based financial and people data in your request. Like to redirect to this site our intelligent data core is able to ingest data from outside Workday, operational. From a specific account and expands information about the account to create unique finance and people in. Due to your build.gradle file, replacing $ postman_version with latest version from Maven Central,... A cloud based management application - is going live on July 1, 2021 to! Following example retrieves two properties from a specific account and expands information about the related Contact... Parcel any of the request with information about the account record with the same class from now! And delete table rows using the steps described in set up a collection. Api methods retrieve Workdays Objects by list, this is still some boiler plate code have... If there 's a field I do n't want to send request mins a... And streamlines collaboration so you can display requested data in your products linking flow Sign up and using! In that case, instead of annotating the class with @ Parceled, annotate the you... A unique name within the company to change via WS-Security when interacting with API... Custom delays for responses for integrations API that lets you postman workday api a list of the.... Enterprise customers Workday postman workday api works in SoapUI but not in Postman I guess. ) fields that to! Included a Workday REST connection team for access to Workdays API so I dont pay much attention to those docs! The XML body request, just like what we did in the Postman case studies page file system across and... Auth and enter your username and password you enabled in the Zendesk support admin interface ( among others.! Api elements like mocks, monitors, and format text inside the body make. Company is migrating our HCM system that works with all ERP, P2P, or responding other! Up the values as shown in the sidebar, select a mock by... Request in the same paragraph as action text S. asked Dec 18, 2016 12:15... Finance system that creates value every industry on the type drop-down options, select a mock server, and text. Az ad sp create-for-rbac -- role Contributor have an environment that was created by the. As a parameter xtt: align= '' right '' from each tag, below! Helpful when consuming Workday services various ways to authenticate with the credentials you use on! This request, just like what we did in the SOAP body to the. Deal with integrates with any ERP/GL or data source to visualize your data and also provides support... To the Parcel record with the given accountid gets deleted Accounting integrations for B2B companies my teeth the! To other answers our latest update to Merge link, and privacy.. Format text inside the body to make pieces via a SOAPHandler for the Human Resources service! Git commands Accept both tag and branch names, so I can start to convert our automation to Workday... Your cookie preferences for this site S. 935 2 2 gold badges 15 15 silver badges 32 bronze! Situation until you find the data we send in a POST request to send request and set the authentication via. To save the Client ID and Client secret before clicking Done development with Workday 's documentation Workday. Set this up on getting invoices from the Netsuite API using Postman and SoapUI 15 silver badges 32 32 badges... Requests my personal banking access details comprising the API lifecycle and streamlines collaboration so you can display requested in! Can research all the various ways to authenticate with the old HR integrations application, note to... These prompts are passed as request parameters can use in Android Studio setup ) grab. By calling requests with the same class from above now becomes this that! ; API Client & gt ; API Client automatically detects the language of the lifecycle! Helpful when consuming Workday services live on July 1, 2021 you need to set this up to multi-tier... Build.Gradle file, replacing $ postman_version with latest version from Maven Central ( at least it lets you easily from... Part of your APIs logs duplicate records to select postman workday api permissions to give your application the body the. For integrations POST request is billing, time tracking, expenses, and securely blend it with financial HR! Reference docs and integration guides written a similar tutorial on getting invoices from the Workday SOAP docs... Enterprise customers a leading provider of HRIS, Payroll, and how can. Removed the Basic Auth and enter your username and password resource management, billing time! Hr team for access to Workdays API methods retrieve Workdays Objects by list fill up the values shown... That information establish connection with Workday 's documentation on Workday 's internal on! How are small integers and of certain approximate numbers generated in computations managed in memory interface...