Skip to content

Releases: dbosoft/YaNco

Release 5.0 alpha.2

20 Mar 07:21
@fw2568 fw2568
v5.0-alpha.2
f53cfd5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Release 5.0 alpha.2 Pre-release
Pre-release

This release should only be consumed by those who are interested in the new features coming in the v5 release.

Not ready for production!

If you add it to a production project, you should only do so to see (potentially) how many breaking changes there are.

Breaking changes

see https://github.com/dbosoft/YaNco/releases/v5.0-alpha.1 for alpha.1 breaking changes

Transactional RfcHandlers have to return Eff<RT,RfcRc>

Transactional handlers now have to return a effect (Eff). All unhandeled errors that occur in a transactional rfc handler will be logged and responded back to the SAP backend with RfcRc.RFC_EXTERNAL_FAILURE.

Reduced number of traits

This is breaking only between alpha.1 and alpha.2:
Instead of using one trait per IO implementation we have reduced traits to HasSAPRfc<RT> for clients and HasSAPRfcServer<RT> for servers. This reduced the complexity for runtime type constraint.

New Features

Added extension method RunIO to IRfcContext

As IRfcRuntime is deprecated but IRfcContext is not, we have to provide a way that users can access IO effects from a RfcContext.
RunIO provides a bridge from IRfcContext to the new functional API. The effect constructed with this method will be run with the build-in SPRfcRuntime.

Internals

  • Cleaned up code quality issues throughout the project.
  • Updated sample ExportMATMAS to functional style.
  • Dependencies have been updated to latested versions,
  • Disabled security warnings for ASPNET Core 2.x as it is only used in samples.
Assets 2

Release 5.0 alpha.1

16 Mar 14:04
@fw2568 fw2568
v5.0-alpha.1
463b5eb
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Release 5.0 alpha.1 Pre-release
Pre-release

This release should only be consumed by those who are interested in the new features coming in the v5 release.

Not ready for production!

If you add it to a production project, you should only do so to see (potentially) how many breaking changes there are.

Breaking changes

Removed AllowStartOfPrograms from IRfcRuntime and IConnection

AllowStartOfPrograms was marked as obsolete in the previous release and has been removed.

RfcErrorInfo replaced by RfcError

Within language-ext the logic of error types (e.g. used in Either,L,R) has changed from a struct (like RfcErrorInfo) to a class hierarchy starting with the error type Error. Therefore, we have replaced RfcErrorInfo with the new type RfcError in all APIs.
RfcError is syntactically compatible with RfcErrorInfo and it can be converted between the two types. So you can simply replace RfcErrorInfo with RfcError in all your code.

Deprecation of RfcRuntime

The RfcRuntime was the central class to abstract between the Netweaver SDK API and YaNco. Originally YaNco was built with several runtime versions (either a managed C++ implementation or an Interopt version). These days the RfcRuntime is only used for unit testing, but is quite difficult to handle.
The RfcRuntime is no longer used internally. Instead, we now use the language-ext runtime concept (see also https://github.com/louthy/language-ext/wiki/How-to-deal-with-side-effects). This abstracts between all operations that perform IO (calls to SAP Netweaver RFC SDK) and our library.

The default runtime we use is SAPRfcRuntime which is a struct that provides access to IO effects (e.g. RfcConnectionEff). However all types have been updated to support also a custom runtime that users build for their applications (for example a runtime with Console support).

For example, RfcContext is now also available as RfcContext<RT>, where RT is the type of runtime to use. All new types also no longer use EitherAsync<RfcError,R>, but Aff<RT, R> (or the synchronous version Eff<RT,R>). Aff is the type of an asynchronous effect that is not executed immediately, but only in the context of a runtime.

Also the ConnectionBuilder and RfcServerBuilder are now implemented as generic type ConnectionBuilder<RT> and RfcServerBuilder<RT>. If you use the generic version, you opt for the new runtime concept, so the Build() methods of both builders will now return an Aff<RT, R> instead of a Func<Either<RfcError,R>.

The non generic versions of these types are still available. So common use cases should work without any change.
But if you have used deeper APIs, you will have some types where you may need to add the runtime generic type parameter to your code.

You will also have to rewrite all unit tests that replaced calls on IRfcRuntime with mocked IO effects. See our unit tests for an example.

Connection was replaced by Connection<RT>

The non-generic version of Connection was removed.
This will typically only be noticed during unit testing, as you don't normally need to create the connection yourself.

ConnectionBuilder runtime methods results change

If you have configured a runtime using the ConfigureRuntime method, you may notice that the result types within the builder have changed. The updated version of ConfigureRuntime no longer configures an IRfcRuntime, but the settings within the build-in SAPRfcRuntime.
If you used method UseFactory to inject another runtime factory you have to change it to UseSettingsFactory and to change the factory result from IRfcRuntime to SAPRfcRuntimeSettings.

Rfc Servers and callbacks are only supported with runtime type

For callbacks and RFC servers, we have removed support for the non-generic versions, as adding them would have required a lot of duplicate code. Since RFC servers are also a more expert feature, we feel that this change will not have a big impact.

This applies to to following types: CalledFunction, IRfcServer, RfcServer, RfcServerContext, ITransactionalRfcHandler
The context within a called function is also only available as IRfcContext, but this is consistent with the following change.

Function handlers now have to return effects (Eff or Aff)

In older versions function handlers had to return EitherAsync<RfcError,Unit>. This was changed to Aff<RT,Unit>. Also the Process method on a CalledFunction<RT> processing chain now has to return a Eff or Aff. ProcessAsync is still supported and will be wrapped into a Aff internally.

This change also removes an inconsistency in how errors are handled after the Process step of the function chain.
The Reply method of the called function chain no longer allows you to access the error of the process step if you return an Either. Instead, the error is always returned to the ABAP backend and Reply is not called.

New features

Side-effect free functional API

As explained above, one of the key improvements in moving to the new runtime concept was the isolation of I/O operations.
Therefore, we now provide a new API that can be used to create pure functional code.

Please see the README for a high-level introduction to these patterns.
Typically, there is a learning curve to fully understand the concept of the new runtime, but once mastered, it allows you to write pure functional code like this: https://github.com/dbosoft/YaNco/blob/main/samples/net6.0/ExportMATMAS

For classic OO integration (and dependency injection via a dependency container), the RfcContext is still available and supported.
However, under the hood it just wraps to the functional API as the RfcContext has an internal managed runtime behind it that is created on the fly.

New types SAPRfcRuntime and TestSAPRfcRuntime

The SAPRfcRuntime was allready explained in detail above. The TestSAPRfcRuntime should be used for unit testing, by setting its IO implementations to mock implementions. We have not added any mock types to the library as we assume that you use a mocking framework like Moq.

IO interfaces

The IRfcRuntime was splitted into following IO interfaces. Please note that we followed the naming convention of language-ext that IO interfaces don't start with an I.

  • SAPRfcTypeIO
    Used for type creation and type information lookup

  • SAPRfcStructureIO
    Used for SAP structure management

  • SAPRfcTableIO
    Used for table management and navigation to table rows.

  • SAPRfcFunctionIO
    IO operations for SAP functions like creation of function descriptions and invocation of functions.

  • SAPRfcConnectionIO
    Used for deep level connection IO that are normally only executed within a IConnection.

  • SAPRfcServerIO
    Used for deep level server IO that are normally only executed within a IRfcServer.

  • SAPRfcFieldIO
    IO methods for mapping and reading of field values either directly from the NW RFC SDK or via a field mapper.

New class SAPRfc<RT>

The SAPRfc<RT> is a static class that implements a number of common use cases for interacting with SAP systems as a client. It is pure functional without any side-effects.
Highlighted methods:

  • useConnection
    This method takes a Aff<RT,IConnection> as input (as from the ConnectionBuilder<RT>.Build method) and allows to use the IConnection with the provided function.
  • useContext
    This method also takes a Aff<RT,IConnection> as input, but then provides a IRfcContext<RT> within the function. In this case the connection will be managed by the context.
Assets 2
1 Join discussion

Release 4.3.4

16 Mar 21:59
@fw2568 fw2568
v4.3.4
27295b3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Release 4.3.4 Latest
Latest

What's Changed

  • Bug fix: CachingConverterResolver concurrency by @fw2568 in #282

Full Changelog: v4.3.3...v4.3.4

Contributors

fw2568
Assets 2

v4.3.3

13 Nov 18:35
@fw2568 fw2568
v4.3.3
baed345
Compare
Choose a tag to compare
v4.3.3

What's Changed

New Contributors

Full Changelog: v4.3.2...v4.3.3

Contributors

prodehghan
Assets 2

v4.3.2

25 Jul 12:02
@fw2568 fw2568
v4.3.2
8142882
Compare
Choose a tag to compare
v4.3.2

Bug fixes:

Create runtime only once per ConnectionBuilder by @fw2568 in #243

Full Changelog: v4.3.1...v4.3.2

Contributors

fw2568
Assets 2

Release 4.3.1

16 Jun 14:20
@fw2568 fw2568
v4.3.1
05717ec
Compare
Choose a tag to compare
Release 4.3.1

Bug fixes:

Don't throw InvalidOperationException by @fw2568 in #234

Contributors

fw2568
Assets 2

Release 4.3

02 Mar 18:27
@fw2568 fw2568
v4.3
61c8bda
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Release 4.3

⭐ New Features

🚀 Improvements

  • Convert structures and tables to AbapValue by @fw2568 in #195
  • Get connection attributes by @fw2568 in #198
  • Uppercase fields, parameter and options by @fw2568 in #186

🏃 Internals

Full Changelog: v4.2.1...v4.3

Contributors

fw2568 and dependabot
Assets 2

Release 4.3 - Release Candidate 1

09 Nov 12:00
@fw2568 fw2568
v4.3-rc.1
7b6fdf5
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Release 4.3 - Release Candidate 1 Pre-release
Pre-release

⭐ New Features

🚀 Improvements

  • Convert structures and tables to AbapValue by @fw2568 in #195
  • Uppercase fields, parameter and options by @fw2568 in #186
  • Get connection attributes by @fw2568 in #198

🏃 Internals

Full Changelog: v4.2.1...v4.3-rc.1

Contributors

fw2568 and dependabot
Assets 2

Release 4.2.2

07 Nov 21:49
@fw2568 fw2568
v4.2.2
db7ed40
Compare
Choose a tag to compare
Release 4.2.2

What's Changed

  • uppercase fields, parameter and options by @fw2568 in #186
  • Convert structures and tables to AbapValue by @fw2568 in #195

Full Changelog: v4.2.1...v4.2.2

Contributors

fw2568
Assets 2

Release 4.2.1

02 Jun 15:37
@fw2568 fw2568
v4.2.1
4bc9e4b
Compare
Choose a tag to compare
Release 4.2.1
  • Bug: left state of SetStructure and SetTable is discarded by @fw2568 in #178

🚀 Improvements

Fix release with no functional improvements.

🏃 Internals

  • Bump Microsoft.SourceLink.GitHub from 1.0.0 to 1.1.1 by @dependabot in #139
  • Bump GitVersion.MsBuild from 5.7.0 to 5.8.1 by @dependabot in #140
  • Bump Microsoft.Extensions.Configuration.EnvironmentVariables from 3.1.20 to 3.1.22 by @dependabot in #145
  • added input mapping example by @fw2568 in #146
  • Bump Microsoft.Extensions.Configuration from 3.1.20 to 3.1.22 by @dependabot in #143
  • Bump Microsoft.Extensions.Configuration.CommandLine from 3.1.20 to 3.1.22 by @dependabot in #144
  • Bump Microsoft.Extensions.Configuration.UserSecrets from 3.1.20 to 3.1.22 by @dependabot in #142
  • Bump GitVersion.MsBuild from 5.8.1 to 5.9.0 by @dependabot in #155
  • Bump Microsoft.NET.Test.Sdk from 17.0.0 to 17.1.0 by @dependabot in #151
  • Bump coverlet.collector from 3.1.0 to 3.1.2 by @dependabot in #150
  • Bump CompareNETObjects from 4.74.0 to 4.76.0 by @dependabot in #153
  • Bump JetBrains.Annotations from 2021.3.0 to 2022.1.0 by @dependabot in #165
  • Bump GitVersion.MsBuild from 5.9.0 to 5.10.1 by @dependabot in #164
  • sample app: create sales document by @fw2568 in #175

Full Changelog: v4.2...v4.2.1

Contributors

fw2568 and dependabot
Assets 2